快速开始
Voidkit（无界套件）是一套支持 NeoForge / Forge / Fabric 的高版本服务器模组套件 （Minecraft 1.20.x – 1.21.x；一个仓库、按版本线分支维护）。 玩家用原版客户端即可进服，所有功能都在服务端完成。
一句话概括产品取向：装上就能用、用着舒服、不会因为几百个 mod 的环境而出问题。
三步跑起来
1. 构建（或下载 Release）
源码构建需要 JDK 21（Minecraft 1.21.1 的硬性要求）：
git clone https://github.com/KokuuWork/voidkit.git
cd voidkit
./build.sh build --continue
产物在各模块的 build/libs/ 下。
不想自己构建？Releases 里按需取：
| 取什么 | 资产 |
|---|---|
| 1.21.1 · NeoForge | voidkit-0.1.0-beta.4+mc1.21.1-neoforge.zip |
| 1.20.1 · Forge / NeoForge | voidkit-0.1.0-beta.4+mc1.20.1-forge.zip |
| 管理平台 VoidkitHub | voidkithub-<平台>-<架构>（6 平台，见管理平台） |
每个 zip 内含该版本线的全部 5 个 jar；也可以单独下载某个模块的 jar。
发布包命名规格
每个版本线（MC 版本 × 加载器）打一个 zip，里面是这一版全部 jar：
voidkit-0.1.0-beta.4+mc1.21.1-neoforge.zip
├── voidkit_core-0.1.0-beta.4+mc1.21.1-neoforge.jar ← 内核（必需）
├── voidkit_essentials-0.1.0-beta.4+mc1.21.1-neoforge.jar ← 基础指令，含权限 + 经济
├── voidkit_display-0.1.0-beta.4+mc1.21.1-neoforge.jar ← 展示层，含称号
├── voidkit_utility-0.1.0-beta.4+mc1.21.1-neoforge.jar
└── voidkit_web-0.1.0-beta.4+mc1.21.1-neoforge.jar
共 5 个 jar。原来 8 个 jar 已在 2026-10-13 做「一 jar 一 modId」的真源码合并：
perm+economy并入voidkit_essentials，title并入voidkit_display， 因此voidkit_perm/voidkit_economy/voidkit_title三个 modId 不再存在 （详见 安装与部署）。
文件名格式为 模组名-模组版本+mc版本-加载器 —— 多版本多加载器并存时，一眼就能看出一个 jar 属于哪条版本线。
1.20.1 线会同时产出
+mc1.20.1-forge.zip与+mc1.20.1-neoforge.zip两份 —— 内容完全相同， 只是后缀不同，方便只认「neoforge」字样的服主找到对的包（NeoForge 1.20.1 就是 Forge 47.1.x 的分支，同一个 jar 两种加载器都能用）。
构建发布包：
./build.sh bundleZip -PmcVersion=1.21.1 # → build/dist/voidkit-0.1.0-beta.4+mc1.21.1-neoforge.zip
./build.sh bundleZip -PmcVersion=1.20.1 # → 同时产出 +mc1.20.1-forge.zip 与 +mc1.20.1-neoforge.zip（内容相同）
2. 安装
把要用到的 jar 丢进服务端 mods/ 目录。
最少只需要 voidkit_core，其余按需添加。例如只要基础指令：
mods/
├── voidkit_core-0.1.0-beta.4+mc1.21.1-neoforge.jar ← 必需
├── voidkit_essentials-0.1.0-beta.4+mc1.21.1-neoforge.jar ← 家 / 传送 / 管理工具
└── voidkit_display-0.1.0-beta.4+mc1.21.1-neoforge.jar ← MOTD / TAB / 记分牌 / 聊天栏
只有
voidkit_core打包了 Kotlin 运行时，其余插件共享它，插件本体都只有几十 KB。
3. 配置
首次启动会在服务端根目录下生成 voidkit/ 配置目录（不是存档目录里 —— 存档可以随便删掉重开，玩家档案和 IP 记录不该跟着没）。
所有配置文件都带中文注释（JSONC：写入时按字段插 // 说明，读取时先剥注释再解析）， 打开就能看懂每个字段是干什么的。