VoidkitVoidkit
指南
模块
反作弊
审计
管理平台
开发
GitHub
指南
模块
反作弊
审计
管理平台
开发
GitHub
  • 指南

    • 快速开始
    • 安装与部署
    • 配置文件
    • 命令速查
    • 权限节点参考
    • 版本与加载器
    • 文本语法
    • 架构
    • 常见问题

权限节点参考

Voidkit 的权限分成两类,判定方式不同 —— 理解这一点,后面所有节点都不用背。

类型判定默认典型
玩家命令直接查节点;节点若被登记为「公开」则默认放行开放/warp /spawn /home /tpa
管理命令voidkit.admin(或原版 OP)或该命令自己的节点,任一命中即放行关闭/setwarp /setspawn /tphere

公开节点:默认开、可关闭

「公开节点」是为「装上就能用」准备的:像 /warp /spawn 这种玩家日常命令, 如果默认值也是拒绝,服主装完套件还得先把权限配一遍,普通玩家才能回城 —— 这不合理。

所以这些节点被登记为公开:

  • 零配置下对所有玩家生效(不装/关掉权限模块也一样,见下);
  • 服主想关掉某个组,在该组加一条否定节点即可:
// 例:禁止 vip 组使用 /warp
{ "groups": { "vip": { "permissions": ["-voidkit.command.warp"] } } }

⚠️ 否定(-节点)优先于公开默认值 —— 判定顺序是 「玩家节点 → 各组按权重 → 公开节点 → 默认值」。 所以公开节点只是「没配置时的默认值」,不是「绕过权限」。

没装权限模块时怎么算?

没装/关掉权限模块(在 voidkit_essentials 里)时,内核用「只认原版 OP」的兜底实现, 但公开节点依然放行。也就是说:

场景/warp(公开)/setwarp(管理)
没装权限模块,普通玩家✅ 可用❌ 拒绝
没装权限模块,OP✅✅
装了权限模块,默认组✅(可用 -节点 关)❌ 除非给节点
装了权限模块,带 voidkit.admin✅✅

公开节点一览

节点命令模块
voidkit.command.home/sethome /home /delhome /homesessentials
voidkit.command.warp/warp /warpsessentials
voidkit.command.spawn/spawnessentials
voidkit.command.back/back /returnessentials
voidkit.command.tpa/tpa /tpahere /tpaccept /tpdeny /tpacancelessentials
voidkit.command.info/who /seen /playtime /tpsessentials
voidkit.command.hat/hatessentials
voidkit.command.enderchest/enderchest(打开自己的)essentials
voidkit.command.workbench/workbenchessentials
voidkit.command.title/title /title list /title set /title cleartitle
voidkit.menu.use/menu [名字]、右键绑定物品display
voidkit.economy.balance/balance /bal /baltopeconomy
voidkit.economy.pay/payeconomy
voidkit.economy.value/worth /valueeconomy
voidkit.economy.sell/selleconomy
voidkit.economy.shop/shopeconomy
voidkit.clearlag.trash/trashutility
voidkit.chat.color在聊天里使用 & 颜色码display
voidkit.chat.placeholder在聊天里使用 %变量%display

管理节点一览

默认关闭。给某人 voidkit.admin 他会拿到下面全部命令; 也可以只发其中某一条(例如只给某组 /setspawn)。

总节点

节点说明
voidkit.admin管理总节点。核心管理命令 + 所有管理子命令。原版 OP(等级 ≥2)等价

essentials

节点命令
voidkit.command.setwarp/setwarp /delwarp
voidkit.command.setspawn/setspawn
voidkit.command.teleport/tphere /tpo /tpall
voidkit.command.fly/fly(对自己;对他人另需 voidkit.admin)
voidkit.command.god/god
voidkit.command.heal/heal
voidkit.command.feed/feed
voidkit.command.speed/speed
voidkit.command.vanish/vanish /v
voidkit.command.enderchest/enderchest <玩家>(看别人)
voidkit.command.invsee/invsee <玩家>
voidkit.command.broadcast/broadcast
voidkit.command.mute/mute /unmute
voidkit.command.whois/whois <玩家>(会打印 IP 记录)
voidkit.command.<简写名>/day /night /sun /rain …
voidkit.command.gamerule/gr
voidkit.command.difficulty/diff
voidkit.command.gamemode/gm
voidkit.homes.limit.<N>家的数量上限,如 voidkit.homes.limit.10

其它模块

节点命令 / 用途模块
voidkit.announce/announcedisplay
voidkit.menu/menu list /menu reload /menu open <玩家> <菜单>display
voidkit.title.custom/title custom <文本>title
voidkit.title.vip / .builder / .admin示例:称号的拥有条件title
voidkit.economy.balance.others/balance <玩家>(查他人余额)economy
voidkit.economy.admin/eco give|take|seteconomy
voidkit.clearlag/clearlag /clearlag status /clearlag testutility
voidkit.clearlag.clear清空垃圾桶(/trash 界面里的「清空」按钮)utility
voidkit.perf/perf /perf chunksutility
voidkit.perf.notify接收 TPS/MSPT 超阈值提醒utility

独立模块

反作弊与审计的命令全部是管理命令(没有面向玩家的命令),且刻意不并入 voidkit.admin —— 这类权限敏感,应该单独授予,而不是「给了管理总权限就顺带拿到 封禁 / 密钥轮换 / 回滚世界」。

节点覆盖模块
voidkit.guard/guard status|mode|reload|whitelist、/guard fence export、/gscan /greport反作弊
voidkit.guard.ban/gban /gunban /gbanlist /gcheck反作弊
voidkit.guard.screen/gscreen /greports反作弊
voidkit.guard.key/guard key rotate|export(🚨 不可逆:旧客户端立即全失效)反作弊
voidkit.guard.fence/guard fence import反作弊
voidkit.inspector/inspect /inspect here|lookup|page|chain|status(只读)审计
voidkit.inspector.rollback/inspect preview /inspect rollback(会改世界)审计
voidkit.inspector.purge/inspect purge <天>(会删历史)审计

常见配置

只让 VIP 用 /fly:

{ "groups": { "vip": { "permissions": ["voidkit.command.fly"] } } }

禁止默认组使用传送点:

{ "groups": { "default": { "permissions": ["-voidkit.command.warp"] } } }

管理员组一把梭:

{ "groups": { "admin": { "permissions": ["*"] } } }

更多权限语法(通配、权重、临时权限)见 权限模块。

在 GitHub 上编辑此页
最后更新: 2026/10/13 11:25
Prev
命令速查
Next
版本与加载器