GTNH Credits

[!INFO] Git Commit: 468e59d | Updated: 2026-10-02

GTNH Credits 是一个纯客户端的 GTNH 整合包致谢界面 mod,为 GT New Horizons 提供一个统一的「鸣谢」入口,用以汇总整合包中所有贡献者。它实现自整合包提案 Centralized Credits Page #23582。

本 mod 不注册任何方块、物品、实体、TileEntity、配方、指令、键位、封包、成就或附魔。 这不是「内容较少」,而是它的设计定位 —— 全仓库 src/main/java 对 registerBlock / registerItem / registerTileEntity / GameRegistry.register / addRecipe / CommandHandler / registerKeyBinding / SimpleNetworkWrapper / EntityRegistry / registerWorldGenerator / OreDictionary.registerOre / Achievement / enchantment / Potion 等 26 个注册式 API 的 grep 命中数全部为 0。CommonProxy 的 preInit 与 init 两个方法体都是空的(CommonProxy.java:10,12),全部逻辑在 ClientProxy 里。

属性 值
modid gtnhcredits(GTNHCredits.MODID,GTNHCredits.java:13;与 gradle.properties 的 modId 一致)
包名 net.noiraude.gtnhcredits(gradle.properties 的 modGroup)
Minecraft 版本 1.7.10(gradle.properties:24 minecraftVersion = 1.7.10;@Mod 另有 acceptedMinecraftVersions = "[1.7.10]",GTNHCredits.java:10)
Forge 版本 10.13.4.1614(gradle.properties:27)
作者 Léa Gris(src/main/resources/mcmod.info:12 的 authorList)
侧别 客户端专用。所有 GUI / 控制器 / 资源加载类均带 @SideOnly(Side.CLIENT)
仓库结构 单仓库 3 个 Gradle 模块,共 304 个文件。根模块 src/ 仅 24 个文件,libCredits/ 22 个,creditsEditor/ 216 个(其中 158 个 Java、28 个 PNG 图标)—— 仓库体积的大头是编辑器和它的 Tango 图标集,而非 mod 本体

依赖

依赖 版本 作用域 说明
ModularUI2 2.3.45-1.7.10(build.properties:2) api(运行时必需) Credits 界面的全部控件、布局与富文本渲染都基于 ModularUI2。缺失则界面无法构建
Custom Main Menu 1.14.0(build.properties:3) compileOnly(可选) 集成其 ActionIMCEvent。未安装时带 @Optional.Method(modid = "custommainmenu") 的方法被 FML 剥离,本 mod 仍可正常运行

libCredits 是同仓库的 Java 8 子模块(JSON 解析 / 序列化、.lang 解析、模糊匹配、资源包路径常量),以 shadowImplementation 打进 mod jar 并重定位(dependencies.gradle:39;gradle.properties:133,140)。它是本 mod 的实现细节,不对外发布为 Maven 依赖。

三个 Gradle 模块

模块 形态 内容
根项目 Minecraft 1.7.10 Forge mod @Mod 入口、配置、客户端代理、主菜单集成、Credits 界面
libCredits Java 8 库(无 Minecraft 代码) credits.json 解析 / 序列化、.lang 解析 / 序列化、模糊匹配、键净化、资源包路径常量
creditsEditor Java 21 独立 Swing 桌面应用 编辑 credits.json 与 .lang 的可视化工具。不进入 mod jar,是本仓库中文件数最多的模块

界面列表

  • Credits 界面 - 分类列表 + 富文本正文的致谢页,含姓名筛选框与 Exact/Fuzzy 双模式切换
  • 主菜单 Credits 按钮 - 打开界面的两条路径:注入原版 GuiMainMenu(默认关闭)与 Custom Main Menu 的 sendIMC 动作

配置列表

  • GTNH Credits 配置 - config/gtnh-credits/gtnh-credits.cfg 的 6 个选项,分 menu_button 与 credits_screen 两个分区

数据文件列表

  • credits.json 数据文件 - 分类与人员数据格式、加载与覆盖顺序、打包内示例数据
  • lang 语言文件 - 分类名 / 描述 / 角色名的翻译键体系与键净化规则,打包内含 en_US 与 fr_FR

工具列表

  • GTNH Credits 编辑器 - 同仓库的独立桌面应用,可视化编辑 credits.json 与 .lang,支持撤销栈与 TSV 批量导入