1
0
mirror of https://github.com/SKCraft/Launcher.git synced 2024-11-24 12:16:28 +01:00
🚀 Distribute your Minecraft modpacks with a custom launcher
Go to file
2014-02-22 13:30:26 -08:00
src/main Fixed typo with last commit 2014-02-17 20:18:52 -08:00
.gitignore Ignore /local_launcher.properties in Git. 2014-01-09 16:27:26 -08:00
LICENSE.txt Initial commit. 2014-01-08 15:09:06 -08:00
pom.xml Changed project version to 4.2.3-SNAPSHOT. 2014-01-29 14:30:25 -08:00
README.md Updated README with a better description of the project 2014-02-22 13:30:26 -08:00

SKCraft Launcher

This project provides an open-source Minecraft launcher platform for downloading, installing, and updating modpacks.

Introduction

We've maintained this launcher since the days of Minecraft Alpha (circa 2010) for sk89q's (who you may know as the author of WorldEdit, WorldGuard, etc.) Minecraft server. It continues to be maintained because other launchers are more difficult to use, require more work to do everything, have fewer features, have come and gone, and are not open source. (Plus, we can brand the entire launcher as needed and have full control over its direction.)

  • Users can very easily select and install modpacks. The interface makes it fairly clear the available options.
  • When building the modpack, convention is preferred over configuration. We do not like having to maintain configuration files (or perhaps just I).
  • The server modpack can be built from the same folder. (On previous launcher versions, we accomplished this with a separate Python script that was not released. It was a pretty old script, because it was made for the days when you had separate client and server .jar files for mods.)
  • The update system is extremely powerful and versatile, with incremental updates, file removal detection, optional feature/mod selection, and so on.

For those are familiar with the 3.x launcher series, be aware that 3.x also served as a general-purpose launcher. Unfortunately, that also split time away from "making a good modpack/server launcher" and so that goal has been suspended for the time being. With that in mind, you no longer ask users to install URLs for individual modpacks; rather, you provide a URL that has a list of all available modpacks. This was a long desired feature, but was never done due to time constraints.

This repository holds the 4.x version. As you may know, MC 1.6 changed how the game was launched. Since the 3.x codebase was fairly ancient, the launcher was rewritten to support MC 1.6 but primarily to also clean up the code. XML was dropped because we have to bundle a JSON library now anyway, and we all know how much everyone hates XML.

Lastly, the source in this repository is the one for my (sk89q) server, so you will have to remove the branding and change some property files. All of this is documented on the wiki.

Note that documentation may be lacking in some places. If you run into problems, do not be hesistant to ask. While the launcher versions have always had many features, documentation has always been lacking due to time constraints. The launcher also exists primarily for my server and not for the purpose of providing a platform, but we try to make as many resources available as possible.

Compiling

The launcher can be compiled using Maven.

mvn clean package

If you wish to import the project into an IDE, you must add support for Project Lombok.

Contributing

Pull requests can be submitted on GitHub, but we will accept them at our discretion. Please note that your code must follow Oracle's Java Code Conventions.

Contributions by third parties must be dual licensed under the two licenses described within LICENSE.txt (GNU General Public License, version 3, and the 3-clause BSD license).

License

The launcher is licensed under the GNU General Public License, version 3.