原创 开源 前置/API legacy-lands-library | 旨在封装各种现有库以方便插件开发 2025-01-21

[MD] ## 概述 这是一个基于 [Fairy Framework](https://github.com/FairyProject/fairy) 构建的综合性库，为现代 Minecraft 插件开发提供了必要的工具和实用程序。它是跨平台的，支持 Spigot Paper 和 Folia。 ## 核心模块 - [**annotation**](annotation/README_ZHCN.md) - 强大的注解处理框架，具有灵活的扫描选项和生命周期管理。 - [**commons**](commons/README_ZHCN.md) - 基础工具集，包括 VarHandle 注入、任务调度和 JSON 操作。 - [**configuration**](configuration/README_ZHCN.md) - 基于 SimplixStorage 构建的灵活配置框架，支持序列化。 - [**mongodb**](mongodb/README_ZHCN.md) - 基于 Morphia 的精简 MongoDB 集成，用于高效数据持久化。 - [**cache**](cache/README_ZHCN.md) - 集成 Caffeine 和 Redis 的多级缓存系统，具有全面的锁机制与通用的线程安全资源管理框架。 - [**player**](player/README_ZHCN.md) - 高性能玩家数据管理，支持多级缓存和实时同步。 - [**script**](script/README_ZHCN.md) - 这是一个强大、灵活、可拓展且高性能的脚本执行引擎封装，支持 `Rhino`, `Nashorn`, `V8` 三种 `JavaScript` 引擎。 - [**experimental**](experimental/README.md) - 一些实验性的模块，可以显著提高性能，但可能过于复杂而无法使用或暂时不稳定。 - **security** - *即将推出。* ## 使用方法 虽然版本号目前仍是 SNAPSHOT，但这并不代表它不能用于生产环境。事实上，我们计划在一个大型插件开发项目中广泛使用此版本，并在充分验证其稳定性和功能性后，发布第一个正式版本。 ### 分发包说明 从 [Actions](https://github.com/LegacyLands/legacy-lands-library/actions) 下载： - `-javadoc`：生成的 API 文档 - `-plugin`：可直接用于服务器的编译插件 - `-sources`：包含源代码和编译类（推荐用于开发） 每个模块的 `README` 中都有详细文档 ### Maven 仓库 首先配置 GitHub 认证（[了解更多](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)） ```kotlin repositories { maven { url = uri("[URL]https://maven.pkg.github.com/LegacyLands/legacy-lands-library[/URL]") credentials { username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") } } } dependencies { compileOnly("net.legacy.library:模块名称:版本号") } ``` ### Jenkins [项目链接](http://129.226.219.222:8080/job/legacy-lands-library/) ## 社区 - [English Version](README.md) - [QQ 群](http://qq.legacylands.cn) - [Github Issues](https://github.com/LegacyLands/legacy-lands-library/issues) - [哔哩哔哩](https://space.bilibili.com/1253128469)（中文教程） 我们将在 [哔哩哔哩](https://space.bilibili.com/1253128469) 频道发布更多关于此模块和 [Fairy Framework](https://github.com/FairyProject/fairy) 的开发教程与经验分享！ ## 赞助商 本项目由 [LegacyLands](https://github.com/LegacyLands) 全力赞助和维护。 [Luminol](https://github.com/LuminolMC/Luminol) 是一个基于 Folia 的分支，具有许多有用的优化、可配置的原版特性和更多的 API 支持。 [PromptX](https://github.com/Deepractice/PromptX) 是 [Deepractice](https://github.com/Deepractice) 开发的 AI 应用原生的专业能力增强系统，在该项目中发挥关键作用。 ## Star 历史 [](https://star-history.com/#LegacyLands/legacy-lands-library&Date) [/MD]