A Cross-Platform Minecraft Development Library

📖 文档

完整文档 | Wiki

---

📦 依赖

中心仓库和快照

使用中心仓库，可选的中心快照仓库和本地仓库。

repositories {
    mavenCentral()
    maven {
        name = "CentralPortalSnapshots"
        url = uri("https://central.sonatype.com/repository/maven-snapshots/")
    }
    mavenLocal()
}
dependencies {
    compileOnly("org.mzverse:mzlib-minecraft:latest.release")
}

仅依赖核心模块：

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

我们强烈建议您使用最新版本，甚至如果您希望使用最新快照：将 latest.release 替换为 latest.integration。

如果希望依赖固定版本，替换latest.release，如10.0.1-beta.17

GitHub Packages

如果不想使用中心仓库（Why?），可使用 GitHub Packages。

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

repositories {
    var actionGithub: MavenArtifactRepository.() -> Unit = {
        credentials {
            username = if (System.getenv("CI") != null)
                System.getenv("GITHUB_ACTOR")
            else
                System.getenv("GITHUB_USERNAME")
            password = System.getenv("GITHUB_TOKEN")
        }
    }
    maven("https://maven.pkg.github.com/mzverse/mzlib", actionGithub)
}

---

🌟 简介

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