Arbor

专为生存和无政府服务器设计，提供优化、可配置的原版特性和丰富的 API 支持

English | 中文

---

📌 关于本分支

Arbor 是 Luminol 的一个社区分支（fork）。

• 原始项目：Luminol，由原作者 EarthMe 创建与维护。
• 分支说明：原作者 EarthMe 欢迎社区自行分支并独立维护，前提是必须标明原作者与许可证。本项目遵循这一要求。
• 当前维护者：Little（本分支 Arbor 的维护者）。
• 许可证：本项目继承上游许可证，以 GNU 通用公共许可证第 3 版（GPLv3） 授权发布，该许可证由 Luminol → Folia → Paper / Spigot / Bukkit / CraftBukkit 逐级继承而来。详见 LICENSE.md。

感谢 EarthMe 及 Luminol 全体贡献者的工作。Arbor 在其成果之上继续开发，所有原始版权与署名均予保留。

---

✨ 核心特性

• 🔧 可配置的原版特性 - 灵活调整游戏机制以适应不同服务器需求
• 📊 Tpsbar 支持 - 实时监控服务器性能状态
• 🐛 Folia Bug 修复 - 针对 Folia 已知问题的专项修复
• 💾 多存档格式支持 - 支持 linear 和 b_linear（linear 重新实现）存档格式
• 🔌 扩展 API 支持 - 为插件开发者提供更多 API 接口（持续开发中）

📥 下载

稳定版本

所有发布版本都可以在 Releases 页面找到。

开发版本

如果您想体验最新功能，可以通过以下步骤自行构建。

构建步骤

# 克隆项目
git clone https://github.com/LittleOvO233/Arbor.git
cd Arbor

# 应用补丁并构建 Paperclip JAR
chmod 755 ./scripts/setup_and_build.sh && ./scripts/setup_and_build.sh

构建完成后，您可以在 arbor-server/build/libs 目录中找到生成的 JAR 文件。

🔌 API 使用

Gradle 配置

repositories {
    maven {
        url = "https://repo.bacteriawa.com/repository/maven-public/"
    }
}

dependencies {
    compileOnly("zone.little.arbor:arbor-api:26.1.2.build.+")
}

Maven 配置

<repositories>
    <repository>
        <id>repository</id>
        <url>https://repo.bacteriawa.com/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>zone.little.arbor</groupId>
        <artifactId>arbor-api</artifactId>
        <version>[26.1.2.build,)</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

💬 支持

获取帮助

• 📋 提交 Issue
• 💬 GitHub Discussions
• 📖 项目文档

🐛 问题反馈

当您遇到任何问题时，请向我们提问，我们将尽力解决。请记得：

• 📝 清楚描述问题 - 详细说明问题的具体表现
• 📋 提供完整日志 - 包含错误日志和相关配置信息
• 🔍 环境信息 - 说明服务器版本、插件列表等环境详情
• 🔄 复现步骤 - 如果可能，请提供问题复现的具体步骤

🤝 贡献代码

我们欢迎社区贡献！详细的贡献指南请查看：

• 📖 贡献指南 (中文)
• 📖 Contributing Guide (English)