FR | EN

Build

Prerequisites

• JDK 25 (JAVA_HOME pointing at it)
• Gradle 9.4.1 (wrapper provided — note that the Lophine base ships gradlew without the executable bit: use sh ./gradlew)
• The paperweight/paperclip forks of the Luminol lineage: Hyacinthusweight 2.0.15 and Hyacinthusclip 3.0.18, published to the local Maven repository. With LuminolMC gone, backup mirrors are maintained at forgejo.ekaii.fr/mc-upstreams/.

Compiling

export JAVA_HOME=/opt/homebrew/opt/openjdk/libexec/openjdk.jdk/Contents/Home  # JDK 25

# 1. paperweight/paperclip forks -> mavenLocal (backup mirrors)
git clone https://forgejo.ekaii.fr/mc-upstreams/Hyacinthusweight.git /tmp/hw && (cd /tmp/hw && sh ./gradlew publishToMavenLocal)
git clone https://forgejo.ekaii.fr/mc-upstreams/Hyacinthusclip.git   /tmp/hc && (cd /tmp/hc && sh ./gradlew publishToMavenLocal)

# 2. build the fork
cd luminol
sh ./gradlew applyAllPatches
sh ./gradlew --no-configuration-cache createPaperclipJar

• Output: luminol/lophine-server/build/libs/lophine-paperclip-26.2*.jar (internal paperclip name inherited from Lophine; the displayed server brand is configurable via misc.server_mod_name = "Folikaii").
• BUILD_NUMBER=<n> produces a 26.2.build.<n>-stable version (otherwise 26.2.local-SNAPSHOT).
• Reference build: clean applyAllPatches + green createPaperclipJar (JDK 25).

CI (Forgejo Actions)

Workflow	Role
build.yml	Builds the paperclip on push to ekaii-26.2/main + v* tags. Clones the mc-upstreams mirrors via the MC_UPSTREAMS_TOKEN secret, releases on tag. Runner: ubuntu-latest on lesannes (never on the NAS).
upstream-watch.yml	Watches Lophine exp/26.2-hardfork drift, opens/closes a drift issue. Non-destructive.

Repositories

Component	Forgejo (canonical)	GitHub mirror
Fork	forgejo.ekaii.fr/exo/folikaii	github.com/uncaney/*
Upstream mirrors (backup)	forgejo.ekaii.fr/mc-upstreams/*	—

Reference release: v26.2-ekaii-0.3.0 = base + picks + batch 5 (build.316).