Upstream has released updates that appear to apply and compile correctly Paper Changes: PaperMC/Paper@5e2a3bc0 Call EntityChangeBlockEvent with correct block when waxing (#12154) PaperMC/Paper@ab984a07 Always pass event block to damage source (#12158) PaperMC/Paper@7b4d44f5 Revert "Always pass event block to damage source (#12158)" PaperMC/Paper@e5a8ee84 Hide soul speed particles for vanished players (#12152) PaperMC/Paper@fcb2e815 Clear lastSection on game event listener removal PaperMC/Paper@636ae0cd Add missing Paper comments to player movement patch PaperMC/Paper@9be4e07a Pin snapshot dependencies (#12185) PaperMC/Paper@f12d33f0 Track codec writing PaperMC/Paper@1d9b3994 Add config option for failed beehive release cooldowns (#12186) PaperMC/Paper@5f2ee83e Fix first execution of async delayed/repeating tasks being sync (#12166) PaperMC/Paper@b00875f8 Add a method on Registry to get the size (#12182) PaperMC/Paper@ca261090 Don't process empty rcon commands (#12188) PaperMC/Paper@a501c459 Deprecate server config getters (#12189) PaperMC/Paper@7f3d3591 Use MiniMessage#deserialize(String, Pointered) in sendRichMessage for send messages (#12177) PaperMC/Paper@9b9f046f Remove broken code (#12171) PaperMC/Paper@fc56c728 Add methods for Creaking (#12094) PaperMC/Paper@f63dbeaf Fix cancelled HangingPlaceEvent inventory desync (#12161) PaperMC/Paper@9421f223 Make CustomArgumentType use parse(reader,source) (#12191) PaperMC/Paper@0a6e7435 Fix invulnerability damage and armour (#12190) Gale Changes: Dreeam-qwq/Gale@b2c11564 Updated Upstream (Paper) Dreeam-qwq/Gale@a9e4baae Updated Upstream (Paper) Dreeam-qwq/Gale@32a291bc [ci/skip] Update comment Purpur Changes: PurpurMC/Purpur@62cbd47a Updated Upstream (Paper) PurpurMC/Purpur@d41aaca1 Updated Upstream (Paper) PurpurMC/Purpur@3f8e6134 Fix EntityTameEvent not being called when `always-tame-in-creative` option is enabled (#1645) PurpurMC/Purpur@b34d675f fix `zombie_horse.spawn-chance` option not working
Leaf is a Paper fork designed to customized and high-performance, built on top of Gale with optimizations and fixes from other forks.
Warning
Leaf is a performance-oriented fork. Make sure to take backups before switching to it. Everyone is welcome to contribute by optimizing or reporting issues.
🍃 Features
- Based on Gale for better performance
- Async pathfinding, mob spawning and entity tracker
- Various optimizations blending from other forks
- Fully compatible with Bukkit, Spigot and Paper plugins
- Latest dependencies, keeping all dependencies in the newest version
- Allows all characters in usernames, including Chinese and other characters
- Fixes some Minecraft bugs
- Configurable UseItem distance for anarchy servers
- Mod Protocols support
- More customized relying on features of Purpur
- Support for Linear region file format
- Maintenance friendly, integrating with Sentry of Pufferfish to easy track all errors coming from your server in excruciating detail
- And more...
📈 bStats
📫 Contact
- Discord:
https://discord.com/invite/gfgAwdSEuM - QQ Group:
619278377
📫 Donation
If you love our work, feel free to donate via our Open Collective or Dreeam's AFDIAN :)
📥 Download
You can find the latest successful build in GitHub Action or Releases
Please note Java >= 21 is required.
📄 Documentation
Documentation on how to use/configure Leaf: docs.leafmc.one
📦 Building
Building a Paperclip JAR for distribution:
./gradlew applyAllPatches && ./gradlew createMojmapPaperclipJar
🧪 API
Maven
<repository>
<id>leafmc</id>
<url>https://maven.nostal.ink/repository/maven-snapshots/</url>
</repository>
<dependency>
<groupId>cn.dreeam.leaf</groupId>
<artifactId>leaf-api</artifactId>
<version>1.21.4-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
Gradle
repositories {
maven {
url = uri("https://maven.nostal.ink/repository/maven-snapshots/")
}
}
dependencies {
compileOnly("cn.dreeam.leaf:leaf-api:1.21.4-R0.1-SNAPSHOT")
}
java {
toolchain.languageVersion.set(JavaLanguageVersion.of(21))
}
⚖️ License
Paperweight files are licensed under MIT. Patches are licensed under MIT, unless indicated differently in their header. Binaries are licensed under GPL-3.0.
Also see PaperMC/Paper and PaperMC/Paperweight for the license of some material used by this project.
📜 Credits
Thanks to these projects below. Leaf includes some patches taken from them.
If these excellent projects hadn't appeared, Leaf wouldn't have become great.
🔥 Special Thanks
If you want to find a cheaper, high performance, stable with lower latency, then cloud of swordsman is a good choice! Registers and purchases in here.
如果你想找一个低价高性能, 低延迟的云服务商,剑客云是个不错的选择! 你可以在这里注册.
YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.

