gorilla-devs / GDLauncher

GDLauncher is a simple, yet powerful Minecraft custom launcher with a strong focus on the user experience
https://gdevs.io
GNU General Public License v3.0
1.22k stars 245 forks source link
css custom-minecraft-launcher electron forge game hacktoberfest javascript jsx launcher minecraft minecraft-custom-launcher minecraft-launcher minecraft-server mod react ui ux vanilla

Try Out Carbon

GDLauncher has been rewritten from the ground up in a more efficient and reliable tech stack, and the new version, "Carbon" has already reached and surpassed feature-parity. We are now working on polishing the experience and adding new features, and while this version will still be available for download, it will no longer be maintained. Due to the very high number of game-breaking bugs recently reported, we recommend you to switch to the new GDLauncher Carbon as soon as possible.

GDLauncher

Maintenance PRs Welcome GitHub issues GitHub pull requests Discord GitHub code size in bytes Github All Releases

🦺 Support this project

Buy Me a Coffee at ko-fi.com

🎉 Join our community

GDLauncher Discord Server

Table of Contents (click to expand) - [GDLauncher](#gdlauncher) - [🦺 Support this project](#-support-this-project) - [🎉 Join our community](#-join-our-community) - [🎮 What is GDLauncher](#-what-is-gdlauncher) - [⚡️ Comparison with Twitch Launcher](#️-comparison-with-twitch-launcher) - [🚀 Getting Started](#-getting-started) - [🎮 Download](#-download) - [🎨 Features](#-features) - [Our features:](#our-features) - [You can also:](#you-can-also) - [Some of the features we are still working on are:](#some-of-the-features-we-are-still-working-on-are) - [💾 Compilation](#-compilation) - [⚙️ Requirements](#️-requirements) - [▶️ Steps](#️-steps) - [🚚 Packaging](#-packaging) - [🚀 Technologies](#-technologies) - [🎁 Contributing](#-contributing) - [❤️ Author](#️-author) - [📜 History](#-history) - [🎓 License](#-license)

Carbon has fully redesigned the UI and UX to make it more user-friendly and modern!

GDLauncher

🎮 What is GDLauncher

GDLauncher is a custom open-source Minecraft launcher written from the ground up in electron/react. Its main goal is to make it easy and enjoyable to manage different Minecraft versions and install forge/fabric, bringing the playing and modding experience to the next level!

⚡️ Comparison with Twitch Launcher

This is an example of the time that GDLauncher takes to install a modpack in comparison to Twitch. Both tests are running at the same time over a 1Gbps network to ensure that the network doesn't impact the comparison.

🚀 Getting Started

Below you will find everything you need to know about the launcher. If you want to download the latest stable release you can do it from our official website (gdlauncher.com). If you want to test the possibly unstable features, you can clone the repo and compile it yourself.

🎮 Download

To download the latest version, you can either click here and select the appropriate version for your operating system or visit our website.

🎨 Features

Our features:

You can also:

Some of the features we are still working on are:

💾 Compilation

These are the steps to compile it yourself.

⚙️ Requirements

You need the following software installed:

▶️ Steps

Install the dependencies and devDependencies.

$ cd GDLauncher
$ npm i

Start the development environment

$ npm run dev

For production environment...

$ npm run build && npm run start-prod

🚚 Packaging

To package the app for the local platform:

$ npm run release

🚀 Technologies

🎁 Contributing

You can find a list of unassigned tasks here. Feel free to ask anything on our discord if you need help or want other tasks.

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

❤️ Author

See also the list of contributors who participated in this project.

📜 History

This project started as a way for me to learn programming and get better at it. I initially developed it in C#.

After a while, I didn't really like the language, so I just started it again from scratch in React and Electron. It was here that a community started gathering around the project. In the meanwhile, I also found a job where I could learn even more about best practices, data structures, and more.

This is why I decided to rewrite it completely one more time, applying all the knowledge I gained at that time, and that made it possible to implement a lot of really cool features, that were really complicated to code from a technical point of view.

Here you can find the previous versions of the code:

🎓 License

This project is licensed under the GNU GPL V3.0 - see the LICENSE file for details.

If you need GDLauncher licensed under different conditions, please contact davide@gdevs.io

You are free to clone the repository and do whatever you want as long as you stick to the license above, just be aware that most of the assets available in the repository are licensed differently (check COPYING.md) so you are not allowed to redistribute those. Also keep in mind that some features will not be working unless you set them up yourself (such as analytics, error tracking..) because the private API keys are stored secretly.

We do not encourage clones of this project (to avoid fragmentation) so don't expect any help from us when trying to do that. We, however, encourage collaboration and growth on this official project and you're more than welcome to contribute.