{"id":33227668,"url":"https://github.com/winds-studio/leaf","last_synced_at":"2026-04-01T21:57:13.235Z","repository":{"id":50026133,"uuid":"499182897","full_name":"Winds-Studio/Leaf","owner":"Winds-Studio","description":"A Paper fork, focused on finding balance between performance, vanilla behavior and stability","archived":false,"fork":false,"pushed_at":"2026-01-27T16:39:09.000Z","size":21368,"stargazers_count":910,"open_issues_count":55,"forks_count":134,"subscribers_count":16,"default_branch":"ver/1.21.11","last_synced_at":"2026-01-28T02:24:48.261Z","etag":null,"topics":["gale","java","keyi","minecraft","minecraft-performance","minecraft-server-software","mirai","paper"],"latest_commit_sha":null,"homepage":"https://www.leafmc.one","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Winds-Studio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"open_collective":"Winds-Studio","custom":["https://afdian.com/a/Dreeam"]}},"created_at":"2022-06-02T15:06:59.000Z","updated_at":"2026-01-27T16:35:12.000Z","dependencies_parsed_at":"2023-12-22T19:23:16.555Z","dependency_job_id":"898a04b7-c1db-40c3-9e83-c93a476d0afd","html_url":"https://github.com/Winds-Studio/Leaf","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/Winds-Studio/Leaf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winds-Studio%2FLeaf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winds-Studio%2FLeaf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winds-Studio%2FLeaf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winds-Studio%2FLeaf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Winds-Studio","download_url":"https://codeload.github.com/Winds-Studio/Leaf/tar.gz/refs/heads/ver/1.21.11","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winds-Studio%2FLeaf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28939486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T10:18:23.202Z","status":"ssl_error","status_checked_at":"2026-01-31T10:18:22.693Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gale","java","keyi","minecraft","minecraft-performance","minecraft-server-software","mirai","paper"],"created_at":"2025-11-16T16:02:46.900Z","updated_at":"2026-01-31T11:01:06.433Z","avatar_url":"https://github.com/Winds-Studio.png","language":"Java","readme":"\u003cimg src=\"public/image/leaf_banner.png\" alt=\"Leaf\"\u003e\n\u003cdiv align=\"center\"\u003e\n\n[![Download](https://img.shields.io/badge/releases-blue?label=download\u0026style=for-the-badge\u0026colorA=19201a\u0026colorB=298046)](https://www.leafmc.one/download)⠀\n[![Github Actions Build](https://img.shields.io/github/actions/workflow/status/Winds-Studio/Leaf/build-12111.yml?\u0026style=for-the-badge\u0026colorA=19201a\u0026colorB=298046)](https://github.com/Winds-Studio/Leaf/actions)⠀\n[![Discord](https://img.shields.io/discord/1145991395388162119?label=discord\u0026style=for-the-badge\u0026colorA=19201a\u0026colorB=298046)](https://discord.gg/gfgAwdSEuM)\n[![Docs](https://img.shields.io/badge/leafmc.one/docs/-blue?label=docs\u0026style=for-the-badge\u0026colorA=19201a\u0026colorB=298046)](https://www.leafmc.one/docs/getting-started)\n\n**Leaf** is a [Paper](https://papermc.io/) fork designed to be customizable and high-performance.\n\u003c/div\u003e\n\n\u003e [!WARNING]\n\u003e Leaf is a performance-oriented fork. Make sure to take backups **before** switching to it. Everyone is welcome to contribute optimizations or report issues to help us improve.\n\n**English** | [中文](public/readme/README_CN.md)\n\n## 🍃 Features\n- **Based on [Paper](https://papermc.io/)** for generic performance and flexible API\n- **Async** pathfinding, mob spawning and entity tracker\n- **Various optimizations** blending from [other forks](#-credits) and our own\n- **Fully compatible** with Spigot and Paper plugins\n- **Latest dependencies**, keeping all dependencies up-to-date\n- **Allows all characters in usernames**, including Chinese and other characters\n- **Fixes** some Minecraft bugs\n- **Mod Protocols** support\n- **More customized** relying on features of [Purpur](https://github.com/PurpurMC/Purpur)\n- **Linear region file format**, to save disk space\n- **Maintenance friendly**, integrating with [Sentry](https://sentry.io/welcome/) of [Pufferfish](https://github.com/pufferfish-gg/Pufferfish) to easily track all errors coming from your server in extreme detail\n- And more...\n\n## 📈 bStats\n[![bStats Graph Data](https://bstats.org/signatures/server-implementation/Leaf.svg)](https://bstats.org/plugin/server-implementation/Leaf)\n\n## 📫 Contact\n- Discord: [`https://discord.com/invite/gfgAwdSEuM`](https://discord.com/invite/gfgAwdSEuM)\n- QQ Group: `619278377`\n\n## 📫 Donation\nIf you love our work, feel free to donate via our [Open Collective](https://opencollective.com/Winds-Studio) or [Dreeam's AFDIAN](https://afdian.com/a/Dreeam) :)\n\n## 📥 Download\nDownload Leaf from our [Website](https://www.leafmc.one/download) or get latest build in [GitHub Releases](https://github.com/Winds-Studio/Leaf/releases)\n\n## 📄 Documentation\nDocumentation about how to use/configure Leaf: [Leaf Docs](https://www.leafmc.one/docs/getting-started)\n\n## 📦 Building\nBuilding a Paperclip JAR for distribution:\n```bash\n./gradlew applyAllPatches \u0026\u0026 ./gradlew createMojmapPaperclipJar\n```\n\n\n## 📦 API\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n### Maven\n```xml\n\u003crepository\u003e\n    \u003cid\u003eleafmc\u003c/id\u003e\n    \u003curl\u003ehttps://maven.leafmc.one/snapshots/\u003c/url\u003e\n\u003c/repository\u003e\n```\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecn.dreeam.leaf\u003c/groupId\u003e\n    \u003cartifactId\u003eleaf-api\u003c/artifactId\u003e\n    \u003cversion\u003e1.21.11-R0.1-SNAPSHOT\u003c/version\u003e\n    \u003cscope\u003eprovided\u003c/scope\u003e\n\u003c/dependency\u003e\n```\n### Gradle\n```kotlin\nrepositories {\n  maven {\n    url = uri(\"https://maven.leafmc.one/snapshots/\")\n  }\n}\n\ndependencies {\n    compileOnly(\"cn.dreeam.leaf:leaf-api:1.21.11-R0.1-SNAPSHOT\")\n}\n\njava {\n  toolchain.languageVersion.set(JavaLanguageVersion.of(21))\n}\n```\n\u003c/details\u003e\n\n## ⚖️ License\nLeaf is licensed under various open source licenses from its upstream projects. See [LICENSE.md](LICENSE.md) for full details.\n\n## 📜 Credits\nThanks to these projects below. Leaf includes some patches taken from them.\u003cbr\u003e\nIf these excellent projects hadn't existed, Leaf wouldn't have become great.\n\n- [Gale](https://github.com/Dreeam-qwq/Gale) ([Original Repo](https://github.com/GaleMC/Gale))\n- [Pufferfish](https://github.com/pufferfish-gg/Pufferfish)\n- [Purpur](https://github.com/PurpurMC/Purpur)\n- \u003cdetails\u003e\n    \u003csummary\u003e🍴 Expand to see forks that Leaf takes patches from.\u003c/summary\u003e\n    \u003cp\u003e\n      • \u003ca href=\"https://github.com/KeYiMC/KeYi\"\u003eKeYi\u003c/a\u003e (R.I.P.)\n        \u003ca href=\"https://github.com/MikuMC/KeYiBackup\"\u003e(Backup)\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/etil2jz/Mirai\"\u003eMirai\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/Bloom-host/Petal\"\u003ePetal\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/fxmorin/carpet-fixes\"\u003eCarpet Fixes\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/Akarin-project/Akarin\"\u003eAkarin\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/Cryptite/Slice\"\u003eSlice\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/ProjectEdenGG/Parchment\"\u003eParchment\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/LeavesMC/Leaves\"\u003eLeaves\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/KaiijuMC/Kaiiju\"\u003eKaiiju\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/PlazmaMC/PlazmaBukkit\"\u003ePlazma\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/SparklyPower/SparklyPaper\"\u003eSparklyPaper\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/HaHaWTH/Polpot\"\u003ePolpot\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/plasmoapp/matter\"\u003eMatter\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/LuminolMC/Luminol\"\u003eLuminol\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/Gensokyo-Reimagined/Nitori\"\u003eNitori\u003c/a\u003e\u003cbr\u003e\n      • \u003ca href=\"https://github.com/Tuinity/Moonrise\"\u003eMoonrise\u003c/a\u003e (during 1.21.1)\u003cbr\u003e \n      • \u003ca href=\"https://github.com/Samsuik/Sakura\"\u003eSakura\u003c/a\u003e\u003cbr\u003e \n    \u003c/p\u003e\n\u003c/details\u003e\n\n## 🔥 Special Thanks\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003ca href=\"https://cloud.swordsman.com.cn/?i8ab42c\"\u003e\n        \u003cimg src=\"public/image/JiankeServer.jpg\" alt=\"Jianke Cloud Host\" width=\"250\"\u003e\n      \u003c/a\u003e\n      \u003cbr\u003e\n      \u003cb\u003ecloud of swordsman | 剑客云\u003c/b\u003e\n      \u003cp\u003eIf you want to find a cheaper, high performance, stable, lower latency host, then cloud of swordsman is a good choice! Registers and purchases in \u003ca href=\"https://cloud.swordsman.com.cn/?i8ab42c\"\u003ehere\u003c/a\u003e.\u003c/p\u003e\n      \u003cp\u003e如果你想找一个低价高性能、低延迟的云服务商，剑客云是个不错的选择！你可以在 \u003ca href=\"https://cloud.swordsman.com.cn/?i8ab42c\"\u003e这里\u003c/a\u003e 注册。\u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003ca href=\"https://www.rainyun.com/NzE2NTc1_\"\u003e\n        \u003cimg src=\"public/image/RainYun.jpg\" alt=\"雨云\" width=\"250\"\u003e\n      \u003c/a\u003e\n      \u003cbr\u003e\n      \u003cb\u003eRainYun | 雨云\u003c/b\u003e\n      \u003cp\u003eGlobal multi-line routing with cloud storage. Refund available within 7 days. Reliable uptime and expert support. RainYun — stable, cost-effective, and ready for fast cloud deployment. Visit \u003ca href=\"https://www.rainyun.com/NzE2NTc1_\"\u003eRainYun\u003c/a\u003e.\u003c/p\u003e\n      \u003cp\u003e国际多线路选择，配套云存储 — 购买服务后七天内不满意可以申请退订，强大的技术支持团队和高在线率客服。雨云云服务器，用稳定和性价比，助力您快速上云。点击前往 \u003ca href=\"https://www.rainyun.com/NzE2NTc1_\"\u003e雨云\u003c/a\u003e。\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd colspan=\"2\" align=\"center\"\u003e\n      \u003ca href=\"https://www.yourkit.com/\"\u003e\n        \u003cimg src=\"https://www.yourkit.com/images/yklogo.png\" alt=\"YourKit\" width=\"300\"\u003e\n      \u003c/a\u003e\n      \u003cp\u003eYourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of \u003ca href=\"https://www.yourkit.com/java/profiler/\"\u003eYourKit Java Profiler\u003c/a\u003e, \u003ca href=\"https://www.yourkit.com/dotnet-profiler/\"\u003eYourKit .NET Profiler\u003c/a\u003e, and \u003ca href=\"https://www.yourkit.com/youmonitor/\"\u003eYourKit YouMonitor\u003c/a\u003e.\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e","funding_links":["https://opencollective.com/Winds-Studio","https://afdian.com/a/Dreeam"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinds-studio%2Fleaf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwinds-studio%2Fleaf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinds-studio%2Fleaf/lists"}