1
0
mirror of https://github.com/SKCraft/Launcher.git synced 2024-11-27 12:46:22 +01:00
SKCraft-Launcher/README.md

92 lines
4.0 KiB
Markdown
Raw Normal View History

2014-01-09 00:09:06 +01:00
SKCraft Launcher
================
This project provides an open-source Minecraft launcher platform for creating, testing, distributing, installing, and updating modpacks. It has maintained for sk89q's server since Minecraft Alpha, but you are free to use it. [The older 3.x version was can be found elsewhere](https://github.com/sk89q/SKMCLauncher).
Unlike other launchers, modpacks for this launcher follow Minecraft's directory structure: just config/ and mods/ folders and you're good to go — no need to edit complicated files. You can use the provided GUI or build everything through command line tools.
2014-03-22 00:54:39 +01:00
2015-02-20 01:10:59 +01:00
## Screenshots
2014-03-22 00:54:39 +01:00
![Skinned](readme/launcher_skinned.png)
2014-03-22 00:54:39 +01:00
Or if you prefer it plain:
2014-03-22 00:54:39 +01:00
![Main Launcher](readme/launcher.png)
2014-03-22 00:54:39 +01:00
2015-02-20 01:10:59 +01:00
![Options](readme/options.png)
2014-03-22 00:54:39 +01:00
2015-02-20 01:10:59 +01:00
![Optional Features](readme/features.png)
2015-07-21 11:37:58 +02:00
![Console](readme/log.png)
Creating modpacks is easy with the provided Modpack Creator:
2015-07-21 11:37:58 +02:00
![Modpack Creator](readme/modpack_creator.png)
2015-07-21 11:37:58 +02:00
![Modpack Creator](readme/pack_manager.png)
2015-07-21 11:37:58 +02:00
![Optional Features Configuration](readme/configure_features.png)
2015-07-21 11:37:58 +02:00
![Build Modpacks](readme/packages_generator.png)
2015-02-20 01:10:59 +01:00
## Features
### For the modpack creator:
* No config files (aside from two at the start) needed to make a modpack -- you just make a folder with the modpack's files and run the builder tool on it
* Supports putting default files (config files, etc.) that are not overridden on a future update
* Supports the removal of files (which, from the PoV of the modpack creator, just involves deleting the file from the folder)
* Supports "optional" files or file sets that can be toggled on or off by the user
* The same directory can be used to create both a client modpack and a server modpack simultaneously (with server-only or client-only files) so you don't need to maintain two separate copies of the same files
### Technical features:
* Fast parallel downloads
* Incremental updates (downloading only changed files)
* Can update from ANY previous version to the latest version
* Updates can be resumed if they've failed or have been cancelled
* Updates also resume from where they left off
* Static file structure so it can be placed on a CDN without modification
* Files are deduplicated (on the file host) so you only ever have ONE version of a file across all modpacks and all modpack versions
* Option for users to enter a special key in the options dialog that can be used to show additional modpacks (i.e. private ones for testing) -- this requires some server-side code
* Can be used with a continuous integration system so you can combine it with your favorite version control (i.e. Git, SVN) and automatically deploy a new modpack update on push/tag
2014-01-29 23:28:43 +01:00
2015-02-20 01:10:59 +01:00
### Client features:
* Multiple modpacks are supported
* Custom news page for showing custom information
* Multiple profile support
* Log messages dialog with upload log option
* Options to adjust memory settings and Java flags
* Everything happens in a background thread so the UI never freezes
* All tasks have cancel buttons and (reasonably accurate) progress dialogs if things take too long
2015-03-20 22:58:52 +01:00
* Self-update mechanism
2015-02-20 01:10:59 +01:00
## Getting Started
* [Read the wiki](https://github.com/SKCraft/Launcher/wiki)
* [Forum to ask for help](http://forum.enginehub.org/forums/launcher.25/)
2015-02-21 00:51:56 +01:00
* [Join us on IRC: #sklauncher on EsperNet (irc.esper.net)](https://webchat.esper.net/?channels=sklauncher)
2015-02-20 01:10:59 +01:00
## Compiling
2014-01-29 23:28:43 +01:00
In your command prompt or terminal, run:
2014-03-22 00:54:39 +01:00
./gradlew clean build
2014-01-29 23:28:43 +01:00
If you are on Windows:
2014-01-29 23:28:43 +01:00
gradlew clean build
2014-01-29 23:28:43 +01:00
If you wish to import the project into an IDE, you must add support for Project Lombok (IntelliJ IDEA users: also enable annotation processing in compiler settings).
2014-01-29 23:28:43 +01:00
## Contributing
2014-01-09 00:09:06 +01:00
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.
2014-01-29 23:28:43 +01:00
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).
2014-01-29 23:28:43 +01:00
## License
2014-01-29 23:28:43 +01:00
The launcher is licensed under the GNU General Public License, version 3.