<img src="https://user-images.githubusercontent.com/37006668/75309971-71791f00-5807-11ea-9073-cc447354324f.png" width="200px" /> # The Minecraft Box <!-- Badges --> ![Dependencies status](https://david-dm.org/lukechu10/Minecraft-Box-Launcher.svg) ![ESLint status](https://github.com/lukechu10/Minecraft-Box-Launcher/workflows/ESLint%20(Typescript)/badge.svg) ![Build status](https://github.com/lukechu10/Minecraft-Box-Launcher/workflows/Build%20binaries%20and%20package/badge.svg) ![Test](https://github.com/lukechu10/Minecraft-Box-Launcher/workflows/Test/badge.svg) ![GitHub All Releases](https://img.shields.io/github/downloads/lukechu10/Minecraft-Box-Launcher/total) ![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/lukechu10/Minecraft-Box-Launcher?label=latest%20pre-release) ![GitHub Language](https://img.shields.io/github/languages/top/lukechu10/Minecraft-Box-Launcher?color=rgb%288%2C144%2C166%29) The **Minecraft Box** is a modern Minecraft launcher, designed to provide integrations with multiple Minecraft services, configurations and thirs party software. The launcher is made with web technologies including electronJS. ## Features Symbol | Meaning ------- | ----------- â | Availible in latest release / pre-release ð¨ | Work in Progress ð¦ | Planned - Core - Create new game instances â - Instances are isolated from each other and do not share saves, settings or mods â - Official news feed from www.minecraft.net ð¨ - Authentication - Official Yggsdrasil Mojang Authentication â - Offline Mojang Authentication ð¨ - Change skin inside launcher ð¨ - View previous skins ð¦ - Install - Install vanilla releases, snapshots and historical versions â - Reinstall corrupted versions â - Can show installation progress â - Install forge directly from launcher ð¦ - Install optifine directly from launcher ð¦ - Launch - Launch vanilla releases and snapshots â - Launch historical versions ð¦ - Launch with forge ð¦ - Launch with optifine ð¦ - Custom jar ð¨ - Launch offline ð¨ - View log output â - Java configuration - Custom java executable â - Custom java max and min memory â - Custom java arguments ð¨ - Instance configuration and management - Per-instance settings (seperate from global settings) ð¨ - World saves manager (view and install maps) â (partially) - Server manager â (partially) - Mods manager (quickly view and install forge mods) ð¦ - Install mod packs ð¦ - Minecraft settings viewer ð¦ - Installed versions viewer (view which versions are installed and can be played) ð¨ - UI - Dashboard with widget system ð¨ - Last played instance â - Mojang Account â - Hypixel related stats ð¦ ## Contributing See [CONTRIBUTING.md](https://github.com/lukechu10/Minecraft-Box-Launcher/blob/master/.github/CONTRIBUTING.md) for more details Thanks for showing interest in this project. There is still a lot of work todo before the launcher is useful. ### Seting up your environment Visual Studio Code is recommended for developping Minecraft Box. You can also use www.gitpod.io, which is browser based and free for contributing with similar features: [![Gitpod badge](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io#https://github.com/lukechu10/Minecraft-Box-Launcher) If for whatever reason non of these two options are availible, you can always use your favorite IDE. All the commands are specified in `package.json` if you don't mind working with the command line. ### Submitting changes Please send a GitHub Pull Request to Minecraft-Box-Launcher with a clear list of what you've done. Always write a clear log message for your commits. One-line messages are fine for small changes, but bigger changes should look like this: ```cmd $ git commit -m "A brief summary of the commit > > A paragraph describing what changed and its impact." ``` Check out [CONTRIBUTING.md](https://github.com/lukechu10/Minecraft-Box-Launcher/blob/master/.github/CONTRIBUTING.md) for more details on how to contribute to this project.