Luminara is a Forge-only Bukkit compatibility layer based on Arclight. It runs Forge mods and Bukkit plugins together on one Minecraft server.
| Component | Supported version |
|---|---|
| Minecraft | 1.20.1 |
| Forge | latest Forge promotion for Minecraft 1.20.1 |
| CraftBukkit package | v1_20_R1 |
| Java | 17 (64-bit) |
| Luminara | 1.0.15 |
Other Minecraft versions and Fabric, NeoForge, or hybrid loader configurations are not supported by this repository.
- Spigot-compatible Bukkit API on Forge.
- Forge mods from
mods/and Bukkit plugins fromplugins/. - Adventure, MiniMessage, signed-chat, and selected Paper API compatibility.
- Localized configuration through the bundled
i18n-configmodule. - Synchronous, vanilla-compatible world persistence defaults.
Use a 64-bit JDK 17 and the checked-in Gradle wrapper. An empty-cache build requires network access to the dependency repositories and to Mojang, Forge, and Spigot build services.
The build resolves the latest Forge promotion for Minecraft 1.20.1 at configuration time. Use -PforgeVersion=<version> to reproduce a specific Forge build or to work offline with a previously resolved version.
./gradlew check
./gradlew assembleDistribution
./gradlew verifyDistributionThe build is single-pass; do not run it twice and do not use --refresh-dependencies as a workaround. The distribution outputs are:
build/distributions/luminara-1.20.1-1.0.15.jarbuild/distributions/luminara-1.20.1-1.0.15.jar.sha256
Verify the checksum with:
(cd build/distributions && sha256sum -c luminara-1.20.1-1.0.15.jar.sha256)Run the end-to-end Forge mod and Bukkit plugin smoke test with:
./gradlew smokeServerUse gradlew.bat instead of ./gradlew on Windows.
- Put
luminara-1.20.1-1.0.15.jarin a new server directory. - Read the Minecraft EULA. If you accept it, create
eula.txtin that directory containing exactlyeula=true. - Start Luminara from that directory:
java -jar luminara-1.20.1-1.0.15.jar noguiThe launcher exits without prompting when eula.txt is missing or does not contain the exact accepted value. It never accepts the EULA on your behalf.
Add Forge 1.20.1 mods to mods/ and Bukkit plugins compatible with v1_20_R1 to plugins/. Back up the server before changing either set.
This repository has no GitHub Release, Maven publication, or custom binary publication workflow. CI may retain verification artifacts for seven days; those artifacts are not releases. Build the distribution from the reviewed stable/Trials branch when you need a binary.
Luminara is licensed under the GNU General Public License v3.0. Arclight attribution and upstream notices remain applicable to inherited code.