A simple launcher for Galimulator to allow 3rd party jars to modify the game behaviour a little bit easier
Note: This is the branch for the variant of SLL that uses sponge’s mixin implementation
to process mixins. Compared to the launcher-micromixin variant of SLL, the launcher-sponge
variant has a slower release cycle, meaning that not all features will be present.
This variant mostly exists in order to be able to test the compliance of micromixin.
Developers should use the micromixin variant whereever possible, unless a mod demands more
powerful features only present in the spongeian variant.
The starloader project on its own doesn’t do much other than providing a way
to loader secondary jars (extensions) as well as providing mixins and a bytecode
manipulation framework. As such most extensions should make use of Starloader-API
to avoid conflicts.
Nightly builds of this application are provided on our maven repository,
https://stianloader.org/maven/ .
We do have an IRC channel for anyone that is interested in modding the game in
general, although the main purpose of the channel will be to discuss Starloader.
Feel free to take a look at it at #galimulator-modding @ irc.esper.net
Due to how the the people over at Sponge compile their module-infos,
building SLL requires Java 16 or higher. Running SLL works with Java 1.8
and beyond regardless.
The project can be built via maven and a JDK 16 or higher (JDK 17 is recommended).
This can be easily done via mvn install on most systems.
The built jar is located in the target folder. (Note: you probably
don’t want the jar prefixed with “original-“)
On MacOS it has to be run manually via a Java 1.8 JRE (17 recommended) with a command such
as java -cp starloader-launcher-XYZ-all.jar de.geolykt.starloader.launcher.CLILauncher
Place the built starloader-launcher-XYZ-all.jar in the galimulator folder.
Then edit the config.json file in the galimulator folder to be
{"classPath": ["jar/galimulator-desktop.jar","starloader-launcher-XYZ-all.jar"],"mainClass": "de.geolykt.starloader.launcher.CLILauncher","vmArgs": ["-Dsun.java2d.dpiaware=true"]}
Make sure to modify the mainClass entry to be equal to the one shown above,
The starloader-launcher-XYZ-all.jar entry in the classPath entry should
correspond to the name of the starloader-launcher file you copied into the
galimulator folder.
Mods need to be added in a “mods” folder located in the galimulator directory.
All code is licensed under the Apache 2.0 license, allowing you to redistribute
the source.
Additionally a few portions of our code (i. e. large parts of the selfmodification and extension system)
was largely written by Minestom contributors, who have contributed their code under
the Apache 2.0 license