Tumble is a Minecraft server fork based on Lophine. It uses the Paper/Comfreyweight patch workflow and currently targets Minecraft 26.3.
- Purpur Anvil Setting.
- Configuration to bypass anvil "Too Expensive!" limit.
- AFK network optimization, ported from DeerFolia:
suppresses non-essential clientbound packets for AFK players and resynchronizes chunks and
entities when they become active again. Statistics:
/afknetstats(admin). - Bedrock-style stronghold generation, ported from DeerFoliaPlus:
replaces the 128 ring-based strongholds with an infinite random distribution, or keeps the
vanilla rings and randomizes only outside the ring zone (
keep_vanilla_rings). - Vanilla structure generation fixes, ported from the same project: 44 individually switchable template repairs (villages, trail ruins, trial chambers, bastions, ancient cities, abandoned camps/trees) plus a master switch. Restart required; only newly generated structures change.
LargeBarrel is provided by upstream Lophine (large_barrel carpet rule) and is no longer carried as a Tumble patch.
Features ported from other forks, with their upstream patches, sources and injection points, are tracked in the ported-feature registry in AGENTS.md.
- Git
- JDK 25 or newer
./gradlew applyAllPatches
./gradlew createPaperclipJarThe runnable server JAR is generated in tumble-server/build/libs.
TumbleMC welcomes everyone to contribute. Follow the instructions below to contribute your code!
Apply the patch stack before editing sources:
./gradlew applyAllPatchesEdit API code in paper-api or fork-specific API code in lophine-api. Edit server code in
paper-server, lophine-server, or tumble-server/src/minecraft. Commit changes in the generated
Git repository, then rebuild the corresponding patches. Common tasks include:
./gradlew rebuildPaperApiFeaturePatches
./gradlew :tumble-server:rebuildPaperServerFeaturePatches
./gradlew :tumble-server:rebuildMinecraftFeaturePatches
./gradlew rebuildLophineSingleFilePatchesDo not edit generated .patch files manually.
The Lophine upstream is pinned in gradle.properties so builds are reproducible. Update
lophineRef, apply the patches, resolve any conflicts in the generated source trees, and rebuild
the affected patches when updating upstream.
Tumble inherits the GNU General Public License version 3 from Lophine, Folia, Paper, Spigot,
Bukkit, and CraftBukkit. Some upstream contributions are available under more permissive terms;
see LICENSE.md and the files under licenses.