1
0
mirror of https://github.com/SKCraft/Launcher.git synced 2024-11-30 13:13:58 +01:00
SKCraft-Launcher/README.md

118 lines
4.3 KiB
Markdown
Raw Normal View History

2014-01-09 00:09:06 +01:00
SKCraft Launcher
================
2015-07-25 10:04:00 +02:00
SKCraft Launcher provides a platform for creating, testing, and distributing modpacks for groups of all sizes. It 100% open source and works on Windows, Mac OS X and Linux/BSD.
With this platform, you have **full control** of the modpacks that you choose to release.
2014-03-22 00:54:39 +01:00
2015-07-25 10:03:13 +02:00
### Many Features, Few Requirements
2014-03-22 00:54:39 +01:00
2015-07-25 10:03:13 +02:00
The only requirement is **have a website to host files — even Dropbox will work.** All files that you upload are "de-duplicated" so even if you have a dozen modpacks that use the same mod, you only have to host one copy of the file.
2014-03-22 00:54:39 +01:00
Yet you still have access to powerful features like:
2014-03-22 00:54:39 +01:00
* optional mods/files
2015-07-25 10:03:13 +02:00
* pre-installed default configuration files
* modpack-added Java flags
* JAR mods
2015-07-25 10:03:13 +02:00
* resource pack support
* non-standard modpack file support
* "hidden" modpacks that require a special access key **
2014-03-22 00:54:39 +01:00
** requires PHP support on your website
2014-03-22 00:54:39 +01:00
### Making Modpacks
2015-02-20 01:10:59 +01:00
2015-07-25 10:03:13 +02:00
Making modpacks is extremely easy: you can use our creator tools with 1-click modpack testing:
2015-07-21 11:37:58 +02:00
![Modpack Creator](readme/pack_manager.png)
2015-07-21 11:37:58 +02:00
You *don't* have to click a bunch of buttons or edit several cryptic config files to add a mod. All you need to do is create a folder that resembles the Minecraft data folder:
2015-07-21 11:37:58 +02:00
* src/**config**/
* src/**mods**/
* src/**resourcepacks**/
* loaders/
There's support for Minecraft Forge and LiteLoader too — just put their installer .jars into the loaders folder.
Now let's see how easy it is to create an "optional feature" that can turn off not only mods, but configuration files too:
2015-07-21 11:37:58 +02:00
![Optional Features Configuration](readme/configure_features.png)
2015-07-21 11:37:58 +02:00
### Great Client
2015-07-25 10:04:00 +02:00
The launcher has a beautiful dark UI that's elegant and easy to use (although a native UI is also available). Display your own webpages so users always know what's up when they start the game.
![Skinned](readme/launcher_skinned.png)
2015-07-25 10:04:00 +02:00
When it comes to launching your modpacks, users can start, abort, and resume updates at any time. Files are downloaded in parallel, and the launcher knows how to handle the removal of files from the modpack.
Users can select those optional features that you have added:
![Optional Features](readme/features.png)
2015-07-25 10:04:00 +02:00
The launcher can **even update itself**.
...and you can use it in portable mode too.
### More Features
All of the modpack tools can be used to create a server modpack alongside the client modpack!
2015-07-25 10:03:13 +02:00
You can optionally use **command line tools** only, without the GUI entirely. Combine the launcher with Git and Jenkins (or whatever you prefer) to automatically build modpack releases when you push a new version.
2015-07-25 10:03:13 +02:00
### History
The launcher has been in development since the early days of Minecraft Alpha. It has powered and always has powered sk89q's own server, SKCraft.
[The older 3.x version was can be found elsewhere](https://github.com/sk89q/SKMCLauncher).
2015-02-20 01:10:59 +01:00
## Additional Screenshots
2015-02-20 01:10:59 +01:00
You can also use the "plain" version of the launcher:
2015-02-20 01:10:59 +01:00
![Main Launcher](readme/launcher.png)
![Options](readme/options.png)
2015-02-20 01:10:59 +01:00
![Console](readme/log.png)
2015-02-20 01:10:59 +01:00
More of the Modpack Creator:
2014-01-29 23:28:43 +01:00
![Modpack Creator](readme/modpack_creator.png)
2015-02-20 01:10:59 +01:00
![Build Modpacks](readme/packages_generator.png)
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
If you find the launcher useful, you can [support me on Patreon](https://www.patreon.com/sk89q).
[![Support Me on Patreon](https://i.imgur.com/Sg03Bzc.png)](https://www.patreon.com/sk89q)
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 Lesser 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 Lesser General Public License, version 3.