the peak of cannoning
Fuji is a Minecraft server fork combining Leaf performance work with Sakura-derived cannoning mechanics. It is aimed at factions, raiding, technical Minecraft, and networks that need predictable TNT behavior without giving up Paper's plugin ecosystem.
Warning
The Minecraft 26.3 branch is experimental. Features and compatibility are still being validated. Back up your worlds and test plugins, cannon designs, and gameplay before considering a production migration.
Most general-purpose performance forks are not designed around the unusual demands of faction cannoning. Fuji brings together:
- Cannoning mechanics: Sakura-derived explosion, TNT, falling-block, and configurable cannon behavior, maintained as part of Fuji.
- Leaf's performance foundation: Paper compatibility plus Moonrise, asynchronous optimizations, and other Leaf-integrated improvements.
- Multi-world options: Leaf's optional parallel-world ticking can help separate independent worlds' workloads; it requires careful compatibility testing.
- PvP controls: Fuji-specific, opt-in knockback and packet-flush settings intended for testing responsiveness without changing vanilla defaults.
The goal is cannoning-focused mechanics on a high-performance Paper fork, not an automatic guarantee of cannon parity or lag-free raids.
Paper 26.3 → Leaf 26.3 ──────────────┐
├── Fuji 26.3
Sakura-derived / Fuji-maintained ────┘
cannoning patches
Fuji is based on Leaf's 26.3 source and carries selected Sakura-derived and Fuji-maintained patches. The 26.3 port is not a claim that every Sakura patch from earlier Minecraft versions has been revalidated.
- Sakura-derived configurable cannon mechanics and explosions
- TNT and falling-block behavior relevant to wall-breaking, sand, and concrete cannon designs
- World-specific cannon settings through
sakura-world.yml - Specialized options for explosions, durable materials, and technical gameplay
- Leaf's Paper-based optimization stack, including the Moonrise chunk system
- Optional asynchronous facilities, such as entity tracking and pathfinding
- Configurable performance features; experimental options should be benchmarked before deployment
- Per-world configurations alongside Paper, Leaf, and other inherited configuration systems
- Optional parallel-world ticking for workloads that are safe to separate
- Fuji's opt-in melee knockback synchronization and immediate packet flush controls
Cannoning note: A faster entity-tracking or client-position update rate does not change server-side TNT physics. Validate cannon timings and movement separately from packet smoothness.
Requirements: JDK 25, Git, and the included Gradle wrapper.
On Linux, macOS, or Git Bash:
git clone --branch 26.3 https://github.com/BadgersMC/Fuji.git
cd Fuji
./gradlew applyAllPatches
./gradlew createLeafclipJarOn Windows PowerShell, use .\gradlew.bat in place of ./gradlew. Enabling Git/Windows long-path support may be necessary for Paperweight's deep source paths.
The generated server JAR is expected under leaf-server/build/libs/. Run it with Java 25, accept the Minecraft EULA, and start with a disposable test world. Build task names are inherited from Leaf and may still use Leaf naming.
Fuji uses the Paperweight patch workflow. Edit the applied sources, commit the change in the appropriate applied-source repository, then regenerate its patch channel with the matching Gradle rebuild task. See CONTRIBUTING.md and AGENTS.md before modifying the tracker or other hot paths.
Fuji includes configurations from its upstream projects. For cannon and PvP behavior, start with the generated sakura-world.yml for the relevant world.
The following Fuji 26.3 knockback options are opt-in (shown as their configuration keys within the players.knockback section):
| Setting | Default | Purpose |
|---|---|---|
sync |
false |
Attempt to compensate certain melee knockback timing cases |
flush |
false |
Immediately flush the final melee knockback packet |
Other Sakura, Leaf, and Paper settings remain available according to the features in this branch. Do not copy an older version's full config into 26.3 without reviewing renamed or removed settings.
Fuji 26.3 is under active testing. Booting a server and loading plugins are useful checks, but they do not by themselves prove combat parity, TNT timing accuracy, plugin compatibility, or stability under cannon loads.
Before relying on a build, test repeated TNT shots, falling-block stacking, explosions in water, player knockback, entity visibility, saves/restarts, and your actual plugins on a separate server.
Fuji builds on the work of:
- Leaf — performance-focused Paper fork
- Sakura — cannoning mechanics and inspiration
- Paper — server and plugin-API foundation
- Gale, Purpur, Pufferfish, Moonrise, and the many contributors whose work Leaf incorporates
Please credit Leaf, Sakura, and the applicable original patch authors when distributing modified builds.
Fuji inherits multiple open-source licenses from its upstream dependencies and individual patches. See LICENSE.md and the individual patch headers for the applicable terms. Server binaries are GPL-3.0-only as described in the current license file.
藤 — Leaf × Sakura · Minecraft 26.3
\n