ServerUtilities

[!INFO] Git Commit: 7c510f38c88d761918246194eea5cfae2a923ece | Updated: 2026-10-02

ServerUtilities 是 GTNewHorizons 的服务器管理模组，作者 LatvianModder、mitchej123 与 GTNH Team，目标版本 Minecraft 1.7.10 / Forge 10.13.4.1614，RetroFuturaGradle 构建。

这是一个零内容型模组：全仓 608 个 Java 文件中，GameRegistry.register* 与 registerBlock / registerItem 的检索结果全部为空 —— 它不注册任何方块、物品、实体或方块实体，也不注册实体。全部价值集中在服务端行为上：44 条顶层服务端指令、8 条客户端指令、158 个配置项、69 个权限节点常量、44 个自定义封包、37 个事件类与 17 个 Mixin 条目。玩家在游戏里看不到任何新方块或物品；它的存在形式是聊天框指令、配置项、权限与 GUI。

命名说明

本分类的五个标识是互相独立的字符串，全部从源码与构建文件读出：

用途 值 来源
分类名 serverutilities 本 wiki 分类目录
modid serverutilities ServerUtilities.MOD_ID（ServerUtilities.java:36）；与 gradle.properties:10 的 modId 一致
资源域 serverutilities src/main/resources/assets/serverutilities/（7 个语言文件 + 111 张贴图）
根包名 serverutils gradle.properties:14 的 modGroup，与 modid 不同（无下划线）
jar 名 ServerUtilities gradle.properties:195 的 customArchiveBaseName

[!IMPORTANT] modid = 分类名 = 资源域，三者一致；根包名 serverutils 与它们都不同。目录名 ServerUtilities 为驼峰，与全小写的 modid 不一致。 另有一处内部名称差异：ServerUtilities.MOD_NAME 常量是 "Server Utilities"（带空格，ServerUtilities.java:37），而 mcmod.info 的 name 字段与 gradle.properties:6 的 modName 都是 "ServerUtilities"（无空格）。

依赖

硬依赖：仅 GTNHLib（0.11.49），声明于 @Mod(dependencies = "required-after:gtnhlib;after:navigator;")（ServerUtilities.java:33）与 dependencies.gradle:5 的 api(...)。GTNHLib 提供整套配置反射系统与 Mixin 框架；usesMixins = true 还使 UniMixins 成为事实上的必需依赖。Navigator 是 after: 级软依赖。

软依赖 8 个：Navigator、NotEnoughItems、EnderIO、Random-Things、Witchery、WAILA（runtimeOnlyNonPublishable，不随包发布）、Hodgepodge（反向集成，仅运行时反射读取其字段）。

明确不兼容：FTB Utilities —— CurseForge 元数据声明 incompatible:ftb-utilities-forge，客户端在 ServerUtilitiesClient.java:90-92 检测到 modid FTBU / FTBL 即抛错并强制退出。

排除目标：Ultramine（按类 org.ultramine.server.UltraminePlugin 匹配），PAUSE_WHEN_EMPTY 与 MAX_TICK_TIME 两个 Mixin 对它 addExcludedMod。

指令列表

  • 服务端指令总表 - 44 条顶层服务端指令的注册位置、权限等级与配置开关
  • 队伍指令 - /team 指令树，15 个子命令，4 种队伍类型与 7 级成员关系
  • 区块指令 - /chunks 指令树，10 个子命令，6 种领取结果
  • Rank 指令 - /ranks 指令树，8 个子命令，rank 图与优先级计算
  • 客户端指令 - 8 条纯客户端指令（5 固定 + 3 颜文字），以及未注册的 /list_achievements

配置项列表

权限节点列表

  • 权限节点 - 69 个固定节点常量、25 个 rank 可配置值、5 个自定义前缀与动态生成的方块/物品节点

API 接口列表

  • 事件 API - 37 个事件类，4 层继承树，8 个扩展点事件
  • API 接口 - 6 个注册表、5 组静态门面类与 6 条网络通道的入口

封包与同步列表

第三方模组集成列表