模块总览
Voidkit 由 **1 个内核 + 4 个插件 jar(共 5 个 jar)**组成,另有 2 个独立发布的组件 (反作弊、审计)和 1 个管理平台。
2026-10-13 起把原来的 8 个 jar 做了「一 jar 一 modId」的真源码合并:
perm+economy的源码并入voidkit_essentials,title的源码并入voidkit_display。所以下面perm/title/economy三页依然保留(feature、权限节点、配置文件都没变),但它们不再是独立 jar / modId,也不需要单独下载 —— 装对应的voidkit_essentials/voidkit_display即可。
一览
| 模块 | 所在 jar / modId | 职责 | 独立仓库 |
|---|---|---|---|
| 内核 | voidkit_core | 插件契约、服务注册表、数据、文本/变量、多语言 | — |
| essentials | voidkit_essentials | 家 / 传送 / TPA / 出生点 / 管理工具 / 命令简写 | — |
| display | voidkit_display | MOTD / TAB / 记分牌 / 聊天栏 / 公告 / 菜单 | — |
| perm | 并入 voidkit_essentials | 权限(LuckPerms 风格组树) | — |
| title | 并入 voidkit_display | 称号 + 游戏内 GUI | — |
| economy | 并入 voidkit_essentials | 经济、商店、物品回收 | — |
| utility | voidkit_utility | 清扫 + 垃圾桶 + 性能监测 | — |
| web | voidkit_web | 管理 API 桥 | — |
| 反作弊 | voidkit_guard | 客户端 Agent + 服务端校验 | voidkit-guard-oss |
| 审计 | voidkit_inspector | 操作审计(COI 风格) | voidkit-inspector |
| 管理平台 | —(Go 程序) | 多服聚合的后台面板 | 本仓库 hub/ |
jar 粒度 ≠ 功能粒度
每个功能都是一个独立的 Feature,可以在 config.json 的 features 段、 /vk features 清单、或面板「模块」页里逐个开关。
| 模块 | 内含的功能(features id) |
|---|---|
core | core player-tracking |
essentials | homes warps spawn back tpa teleport admin-tools info command-alias |
display | motd tab scoreboard chat-format announce menu |
perm | permissions |
title | titles |
economy | economy |
utility | clearlag perf |
web | remote-api |
例:只想要「记分牌」不想要「聊天栏」,装
voidkit_display后把chat-format设为false即可,不用卸载整个 jar。