A Cross-Platform Minecraft Development Library

📖 文档

完整文档 | Wiki

---

📦 依赖

确保环境变量中有 GITHUB_USERNAME 和 GITHUB_TOKEN（token 需要 read:packages 权限）。

创建 Token

repositories {
    maven("https://maven.pkg.github.com/mzverse/mzlib") {
        credentials {
            username = System.getenv("GITHUB_USERNAME")
            password = System.getenv("GITHUB_TOKEN")
        }
    }
}

dependencies {
    compileOnly("org.mzverse:mzlib-minecraft:latest.integration")
}

仅依赖核心模块：

dependencies {
    compileOnly("org.mzverse:mzlib-core:latest.integration")
}

---

🌟 简介

MzLib 是一个跨平台的 Minecraft 开发类库，支持 Bukkit、Fabric、NeoForge。

特性

• 跨平台 - 统一 API，支持 Bukkit/Spigot/Paper、Fabric、NeoForge
• 版本兼容 - 支持 1.12 到最新版本，自动适配
• 丰富 API - 命令、物品、NBT、文本、数据包、库存、配方、权限等
• Wrapper 系统 - 优雅的原版类包装，无需反射
• 多语言 - 自动获取玩家客户端语言设置
• 数据修复 - 自动处理版本间数据格式变化

---

🚀 安装

Bukkit/Spigot/Paper

1. 下载插件：Releases
2. 放入 plugins 文件夹
3. 重启服务器

Docker 环境如需 MzLibAgent，将 MzLibAgent.jar 放入服务端根目录，启动参数添加 -javaagent:MzLibAgent.jar

Fabric/NeoForge

将对应平台的模块放入 mods 文件夹

---

🔨 构建

./gradlew shadowJar

产物位于 out 文件夹。

---

🎮 附属插件

• LoginAUI - 铁砧登录页面
• MzBackwards - 回跨版本显示优化
• MzItemStack - 自定义物品堆叠

---

💖 支持

• Mcbbs | Issues

---

📄 许可证

Mozilla Public License Version 2.0

---

🙏 鸣谢

• ASM
• Gson
• FastUtil

---

Made with ❤️ by MzVerse Team