GoldenTweaks

适用于 Minecraft 1.21.1 / NeoForge 的大型整合包兼容、优化与联动增强模组。

A NeoForge compatibility, bug-fix, optimization and mod-integration patch mod for Minecraft 1.21.1, built for large modpacks and long-running survival servers.

GoldenTweaks 是一层「补丁」：它本身不重做玩法，而是修复单个模组的崩溃与失效功能、抑制无害的日志刷屏、补上跨模组联动内容（配方、物品要素、材料），并尽量把行为做成可配置项。专为大型整合包与长期生存服务器设计。

GoldenTweaks is a patch layer: it ships no gameplay overhaul of its own. It fixes crashes and broken behaviour in individual mods, silences benign log spam, adds cross-mod content (recipes, item aspects, materials) that would otherwise require a custom modpack data pack, and exposes everything through a config file.

功能概览 / What it does

1. 兼容修复 / Compatibility fixes

每个模组一个 mixin 分包，修复崩溃、失效功能与版本漂移。neoforge.mods.toml 里声明了 126 个可选依赖，mixin 配置插件（GoldenTweaksMixinPlugin）按已加载的模组逐个决定 mixin 是否生效，并整组开关与模组绑定的兼容补丁，因此不会把补丁作用在未安装的模组上。

Per-mod mixin packages that repair crashes, dead features and version drift. neoforge.mods.toml declares 126 optional mod dependencies; the mixin config plugin (GoldenTweaksMixinPlugin) decides per mixin whether it applies, and gates whole groups on the mods that are loaded, so a patch is never applied against a mod that is not installed.

少数场景无法用 mixin 表达（别的模组自带写错的 mixin、语言文件拆分、Carry On 与航空学的交互），这些在 mixin 配置插件里用 ASM 字节码改写处理。

A handful of cases cannot be expressed as a mixin (wrong mixin shipped by another mod, language file splitting, Carry On + Aeronautics interaction); those are handled with ASM bytecode edits driven from the mixin config plugin.

2. 日志抑制 / Log spam suppression

mixin/shut/ 下 43 个 mixin 负责静默无害刷屏：音效引擎与音效管理器告警、模型/贴图/方块状态加载噪音、着色器管线报错、离线时的 Realms 可用性检查、配方管理器与标签加载的解码错误，以及一批模组的更新提示与调试日志。

43 mixins under mixin/shut/ silence benign output that otherwise floods latest.log in large packs: sound engine and sound manager warnings, model/sprite/blockstate loading noise, shader pipeline errors, Realms availability checks when offline, recipe manager and tag loader decode errors, and the periodic update notices / debug logs of a number of mods.

3. 体验增强 / Quality of life

4. 平衡调整 / Balance tweaks

全部为可配置开关，默认值保守 / All of these are config toggles with sane defaults:

• Evolved Mekanism 太阳能板发电倍率
• Mekanism Extras 回收工厂在绝对等级及以上支持堆叠升级
• 灾变（Cataclysm） 数值平衡
• Advanced Infusion 物品禁用
• Irons Jewelry 讲价折扣上限（次数与百分比）
• 神秘时代 缓存（对象标签、坩埚配方、研究树）、奥术合成缓存大小、魔导手册要素来源分页、奥术工作台支持原版配方、地裂伤害模式

5. 跨模组联动内容 / Cross-mod content

GoldenTweaks 自带一份大型数据包（data/goldentweaks/，约 1.97 万个 JSON），无需 KubeJS 或自定义整合包即可桥接模组：

GoldenTweaks ships a large data pack (data/goldentweaks/, ~19.7k JSON files) that bridges mods without requiring KubeJS or a custom pack:

• 神秘时代 —— 259 个命名空间共 18057 条物品要素、543 条实体要素、18 个坩埚配方、6 个注魔配方、奥术合成配方、38 个要素定义，以及 9 项自定义研究（缸中研究者、魔导显微扫描、碎片炼金、原始珍珠复制、符文石板、绯红仪式、终极锭注魔、注魔拦截器、扭曲理论净化）；另重做魔导手册「要素知识」页（要素来源列表、悬停显示已扫描物品、JEI/EMI 页数限制）
• Silent Gear —— 生成 637 个材料（其中 560 个是跨模组 compat/* 材料），让其它模组的金属、宝石、木材可以直接做工具部件
• 机械动力 —— 机械合成、序列组装、组合合成配方
• Extended Crafting / Spectrum / Alshanex Familiars / 东方小女仆 Spell —— 跨模组工作台配方
• Compact Machines —— 144 个房间模板，并可控制房间内生物生成
• 任务商店 —— 五档金币（倍率可配）与商店分类/条目
• Bountiful —— 37 个职业的悬赏池与悬赏令（炼金术士、秘术师、AE2 工程师、机械师、巫师、厨师等）
• AE2 自动样板上传 —— 样板供应商选择界面、图标同步与网络包

6. 本地化 / Localization

内置 111 个模组命名空间的简体中文语言文件（含 AE2、Croptopia、PackagedAuto 等的指南书正文），GoldenTweaks 自身的中英文本各 1068 个键。

Built-in Simplified Chinese (zh_cn) language files for 111 mod namespaces (including guide book page text for AE2, Croptopia, PackagedAuto and others), plus GoldenTweaks' own strings in both zh_cn and en_us (1068 keys each).

安装 / Installation

1. 安装 Java 21 与 Minecraft 1.21.1 对应的 NeoForge。

2. 把 goldentweaks-<版本>.jar 放进 .minecraft/mods/。

3. 可选：安装 Cloth Config 以获得游戏内配置界面；不装也能用，只是需要手动编辑配置文件。

4. Install Java 21 and NeoForge for Minecraft 1.21.1.

5. Drop goldentweaks-<version>.jar into .minecraft/mods/.

6. Optional: install Cloth Config to get the in-game config screen. Without it the config file still works, it is just edited by hand.

兼容补丁只在目标模组存在时生效，可以直接加入现有整合包。

The mod works with no other mods installed — every compatibility patch activates only when its target mod is present.

配置 / Configuration

注册两份 NeoForge 配置（config/goldentweaks-client.toml、config/goldentweaks-common.toml）：

Two NeoForge configs are registered (config/goldentweaks-client.toml, config/goldentweaks-common.toml):

所有取值在配置尚未加载时会回落到默认值，因此改动配置文件不会导致启动崩溃。

All values are readable without a config library: the code falls back to defaults while the config is not loaded yet, so tweaks never crash on a missing/edited file.

实现方式 / How it works

• Mixin（goldentweaks.mixins.json）—— 共 285 个：227 个通用 + 58 个仅客户端，按 balance/、feature/、fix/、optimization/、shut/ 分包，并镜像目标模组的包结构。

• Mixin 配置插件（GoldenTweaksMixinPlugin）—— 依据已加载模组列表（FMLLoader）逐个决定 mixin 是否生效，并承担少数无法用 mixin 表达的 ASM 改写。

• 入口（GoldenTweaks）—— 注册配置、物品、方块实体与事件处理器，全部以「模组存在」为前提。

• 数据包 —— 配方、物品/实体要素、Silent Gear 材料、悬赏池、标签、战利品表与结构追加。

• 网络 —— 少量 C2S/S2C 数据包：拾取请求、消耗品同步、材料书打开、样板供应商图标。

• Mixins (goldentweaks.mixins.json) — 285 mixins: 227 common + 58 client-only, split into balance/, feature/, fix/, optimization/ and shut/ packages that mirror the target mod's package layout.

• Mixin config plugin (GoldenTweaksMixinPlugin) — decides per mixin whether it applies, based on the loaded mod list (FMLLoader), and performs the few ASM transformations that mixins cannot express.

• Bootstrap (GoldenTweaks) — registers configs, items, block entities and event handlers for the mods that are actually present.

• Data pack — recipes, item/entity aspects, Silent Gear materials, bounty pools, tags, loot tables and structure additions.

• Networking — a small set of C2S/S2C packets for pickup requests, consumable sync, material book opening and pattern-provider icons.

已知限制 / Known limitations

• 仅支持 NeoForge 1.21.1，没有也不计划提供 Fabric 版本。

• 兼容补丁针对特定模组版本，模组更新后可能失效。

• mixin 由「模组是否存在」控制开关，但受支持模组的差异过大版本仍可能报错，遇到时请附上模组列表与 latest.log。

• 内置的 zh_cn 是第三方模组的社区质量翻译；若上游模组自带翻译，两者由资源包系统合并。

• NeoForge 1.21.1 only. There is no Fabric build and none is planned.

• Compatibility patches target specific mod versions. Mod updates can invalidate them.

• Mixins are gated by mod presence, but a supported mod running a very different version may still cause errors — report the mod list and latest.log when that happens.

• The bundled zh_cn files are community-quality translations of third-party mods; if the upstream mod ships its own translation, both are merged by the resource pack system.

许可证 / License

PolyForm Noncommercial License 1.0.0 © Fodoth_jinzi89。

源码可用于非商业用途（使用、修改、再分发）；商业分发需获得作者许可。

You may use, modify and redistribute this source for noncommercial purposes; commercial distribution requires the author's permission.