Skip to content
TumbleMCPublic

About

A fork of Lophine aiming to add functions that LuminolCraft SMP needs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Tumble

Tumble is a Minecraft server fork based on Lophine. It uses the Paper/Comfreyweight patch workflow and currently targets Minecraft 26.3.

Features

  • 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.

Requirements

  • Git
  • JDK 25 or newer

Building

./gradlew applyAllPatches
./gradlew createPaperclipJar

The runnable server JAR is generated in tumble-server/build/libs.

Development & Contribution

TumbleMC welcomes everyone to contribute. Follow the instructions below to contribute your code!

Apply the patch stack before editing sources:

./gradlew applyAllPatches

Edit 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 rebuildLophineSingleFilePatches

Do not edit generated .patch files manually.

Upstream

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.

License

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.

About

A fork of Lophine aiming to add functions that LuminolCraft SMP needs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors