Voidkit

无界套件 · 支持 NeoForge / Forge / Fabric 的高版本服务器模组套件

用服务端 mod 实现 Bukkit / Essentials / CMI 那一类通用服务器功能，外加独立发布的反作弊与操作审计组件，以及一个轻量管理平台。

玩家用原版客户端即可进服，不需要安装任何东西。

📖 完整文档 · 快速开始 · 命令速查 · 权限节点 · 版本与加载器 · 模块总览

🛠 Bug 维修群

项目还在测试版（beta），遇到任何问题都欢迎来群里找我们。

群名：【MC-玩了X年服务器终于不想玩了】

一键加群 → `498700382`

这是 Voidkit 的 Bug 维修群。 装不上、启动崩、模块不生效、配置改了不生效、和别的 mod 冲突 —— 都来群里说。

报 bug 请附上：服务端日志 里 Voidkit 模块 x / x 已启用 那一行、MC 与加载器版本、相关报错片段。
也可以直接开 Issue，但群里回复通常更快。
打不开链接、或想在手机上直接进群：搜索群号 498700382。

🚧 测试版说明

目前所有 release 都是测试版本（beta），尚未发布正式版。

功能多数未经系统实测，不建议用于生产环境 —— 请在小众测试服试用并反馈问题。版本号从 0.1.0-beta.4（beta0.4）起算，修复随版本持续推进，请始终以最新 Release 为准。

这是什么

Voidkit 面向几百个 mod 的大型科技整合包（已在 165 mod 的 SkyExplorer 实测）。目标不是堆功能，而是**「装上就能用、用着舒服、不会因为几百个 mod 的环境而出问题」**。

它解决三件事：

基础服务器功能 —— 家 / 传送 / TPA / 记分牌 / 聊天栏 / 清扫 / 经济 / 权限 / 称号， Bukkit 生态那一套，在 NeoForge 上用不了，这里补齐。
反作弊 —— 客户端 Agent + 服务端校验：哈希锁、中途复检、蜜罐协议、静默取证。
查破坏与回滚 —— CoreProtect 风格的审计，专为科技包设计：自动化产线不污染日志，真正的那次破坏才查得出来。

版本与加载器

一个仓库 + 版本线分支，同一套代码支撑多加载器、多版本：

Minecraft	NeoForge	Forge	Fabric
1.21.1	✅ 主线 `main`	✅ 已发布（`mc/1.21.1-forge`，需 Forge 52.x）	✅ 已发布（`feat/fabric`）
1.20.1	✅ 同一份 jar	✅ 同一份 jar（`mc/1.20.1`）	⏳ 规划中

1.20.1 的 Forge 与 NeoForge 共用一份 jar —— NeoForge 1.20.1 就是 Forge 47.1.x 的分支、且以 modId forge 注册，API 包名完全相同（net.minecraftforge.*）。已真机实测两种加载器均能加载；Release 里按加载器各给一个命名包（内容完全相同，取一份即可）。详见版本与加载器。

生态

仓库	内容	依赖
`voidkit`（本仓库）	内核 + 4 插件 jar（共 5 jar）+ Go 管理平台	—
`voidkit-inspector`	操作审计：来源分类 + 智能回滚五层（1.21.1 NeoForge/Forge、1.20.1 Forge）	`voidkit_core`
`voidkit-guard-oss`	反作弊（客户端 Agent + 服务端校验）	`voidkit_core`

模块

5 个 jar：1 个内核 + 4 个插件 jar，每个可单独安装、单独卸载、单独发布

jar	modId	职责	必需
`core/`	`voidkit_core`	内核：插件契约、服务注册表、数据、文本/变量、多语言	✅
`essentials/`	`voidkit_essentials`	家 / 传送点 / TPA / 出生点 / 管理工具 / 命令简写 + 权限 + 经济	可选
`display/`	`voidkit_display`	MOTD / TAB / 记分牌 / 聊天栏 / 公告 / 菜单 + 称号	可选
`utility/`	`voidkit_utility`	清扫 + 垃圾桶 + 性能监测	可选
`web/`	`voidkit_web`	管理 API 桥（唯一监听端口的）	可选
`hub/`	—（Go 程序）	管理平台：多服聚合的后台面板	可选
`inspector`	`voidkit_inspector`	审计：来源分类 + 智能回滚五层	独立发布
`guard`	`voidkit_guard`	反作弊	独立发布

为什么是 5 个 jar？ 2026-10-13 起把原来的 8 个 jar 做了「一 jar 一 modId」的真源码合并 （决策与实施见 MIGRATION.md）：perm + economy 的源码并入 voidkit_essentials， title 的源码并入 voidkit_display。因此 voidkit_perm / voidkit_economy / voidkit_title 三个 modId 不再存在，没有（也不会有）单独的 jar —— 要这些功能就装对应的 voidkit_essentials / voidkit_display。功能粒度、权限节点、数据目录（voidkit/perm/、voidkit/economy/、 voidkit/title/）全部不变，仍可逐个 features 开关。

只有 voidkit_core 打包了 Kotlin 运行时，其余插件共享它，插件本体都只有几十 KB。

少装任何一个都不会崩：内核只认接口，并给每个服务准备了保守的兜底实现。例如不装 voidkit_essentials（或把其中的权限模块关掉），权限判定退化成「只认原版 OP」，其余功能照常。

jar 粒度 ≠ 功能粒度：每个功能都是独立可关的 Feature，可以在配置的 features 段或面板「模块」页逐个开关，用 /vk features 查看当前清单与开关状态。

快速开始

需要 JDK 21（Minecraft 1.21.1 的要求）。

git clone https://github.com/KokuuWork/voidkit.git
cd voidkit
./build.sh build --continue          # 产物在各模块 build/libs/ 下

把 jar 丢进服务端 mods/ 目录，最少装 voidkit_core，其余按需。

不想自己构建？从 Releases 下载（均为测试版）—— 每个版本线一个整版 zip（1.21.1 · NeoForge / 1.21.1 · Forge / 1.21.1 · Fabric / 1.20.1 · Forge / 1.20.1 · NeoForge），管理平台 VoidkitHub 的 3 平台预编译二进制也在同一个 Release 里。

首次启动会在服务端根目录生成 voidkit/ 配置目录，所有配置文件都带中文注释，打开即可改。完整说明见安装部署。

常用命令

命令	说明
`/vk`	内核管理：`reload` `save` `token` `status` `features` `api`
`/sethome` `/home` `/delhome` `/homes`	家
`/setwarp` `/warp` `/warps` `/delwarp`	公共传送点
`/tpa` `/tpahere` `/tpaccept` `/tpdeny`	玩家互传
`/fly` `/god` `/heal` `/feed` `/vanish` `/invsee`	管理工具
`/hat` `/enderchest` `/workbench`	玩家自助（默认开放）
`/day` `/night` `/sun` `/rain` `/gr` `/diff` `/gm`	原版命令简写
`/clearlag` `/trash` `/perf`	清扫 / 垃圾桶 / 性能
`/announce` `/menu`	公告 / 菜单
`/perm` `/title`	权限 / 称号
`/balance` `/pay` `/baltop` `/sell` `/shop`	经济
`/inspect`（`/coi`）	操作审计
`/guard` `/gban` `/gscreen` `/greport`	反作弊

完整命令与权限节点见命令速查。

为什么适合大型整合包

零 mixin —— 不与整合包里已有的 mixin mod 争抢类改写
构造期零 IO —— 配置读取推迟到服务端启动阶段，不拖长启动关键路径
不做侵入性写入 —— 例如 MOTD 默认不会改写 server.properties
命令简写逐条容错 —— 名字被别的 mod 占了只跳过这一条，其余照常注册
周期任务默认保守，全部可配可关

文档

完整文档站：https://kokuuwork.github.io/voidkit/

章节	内容
快速开始	构建、安装、配置、命令、文本语法、架构、FAQ
模块	内核与各模块逐个详解
反作弊	VoidkitGuard
审计	VoidkitInspector
管理平台	VoidkitHub
开发	写插件、跨平台移植

开发与验证

./build.sh build --continue     # 构建全部模块（内置 JDK 21 与国内镜像）
tools/smoke-test.sh             # 端到端冒烟测试（起服 + 打 API 断言）

铁律：低耦合（每个组件只依赖 core）、插件间零编译依赖、构造期零 IO、零 mixin。详见开发指南与仓库根的 ARCHITECTURE.md、ROADMAP.md。

许可证

MIT

Name		Name	Last commit message	Last commit date
.github		.github
core		core
display		display
docs		docs
essentials		essentials
gradle/wrapper		gradle/wrapper
hub		hub
tools		tools
utility		utility
web		web
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmrc		.npmrc
ARCHITECTURE.md		ARCHITECTURE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MIGRATION.md		MIGRATION.md
PORTING-FABRIC.md		PORTING-FABRIC.md
README.md		README.md
ROADMAP.md		ROADMAP.md
build.gradle		build.gradle
build.sh		build.sh
file-issues-2.py		file-issues-2.py
file-issues-3.py		file-issues-3.py
file-issues-4.py		file-issues-4.py
file-issues-5.py		file-issues-5.py
file-issues-6.py		file-issues-6.py
file-issues-7.py		file-issues-7.py
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
mirror.init.gradle		mirror.init.gradle
package-lock.json		package-lock.json
package.json		package.json
settings.gradle		settings.gradle

Navigation Menu

Repository navigation

About

Repository files navigation

Voidkit

🛠 Bug 维修群

一键加群 → `498700382`

🚧 测试版说明

这是什么

版本与加载器

生态

模块

快速开始

常用命令

为什么适合大型整合包

文档

开发与验证

许可证

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Voidkit

🛠 Bug 维修群

一键加群 → 498700382

🚧 测试版说明

这是什么

版本与加载器

生态

模块

快速开始

常用命令

为什么适合大型整合包

文档

开发与验证

许可证

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

一键加群 → `498700382`