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 批量导入