Thaumcraft 4 Tweaks - 神秘时代4优化

请注意，本模组始终优先发布至 Curseforge。手动发布至 Modrinth 通常会紧随 CF 发布，但有时我可能会因懒惰/健忘而稍作延迟。如果您从 Modrinth 下载了 jar 文件，且在崩溃时提示该 jar 文件未经我签名，请在 Discord 上联系我，以便我替换有问题的文件。此外，Curseforge 上的描述通常更为及时。

这是经典模组 Thaumcraft 4 的一个扩展。它不适用于较新的 Thaumcraft 5/6。此扩展仅支持 1.7.10 版本。

本模组采用 AGPL 3.0 许可证，并针对 Minecraft 相关问题附加了额外例外条款。简单来说，这意味着即使您仅在服务器端使用 TC4Tweaks，也必须向用户提供本模组的源代码副本。这主要适用于使用自定义 TC4Tweaks jar 文件的情况，因为我希望您的贡献能够回馈社区。对于正常使用本模组，只需在您的整合包/客户端下载页面附上本模组页面、GitHub 或 Curseforge 页面的链接即可。

使用说明

本模组在客户端和服务器端均为可选，两端可使用不同版本。

（不完整）功能列表

滚动浏览要素列表

本模组的原始功能。允许您使用鼠标滚轮在研究桌中滚动浏览要素列表。无需再频繁点击！当鼠标悬停在研究笔记上时，模组会提示滚动功能已启用。

滚动浏览研究页面

允许您使用鼠标滚轮在书中滚动浏览各个页面（包含描述性文本、配方、奥术构造图示等的页面）。无需再频繁点击！

放大魔导书 GUI

在 .minecraft/config/tc4tweaks.cfg 中修改 browserScale 选项。对于 1920x1080 分辨率且使用标准 GUI 缩放的情况，2.0 较为合适；1.0 则与原版相同。如果您使用其他 GUI 缩放或分辨率，可能需要调整此值。

修复焦点 NPE 问题

如果您：

• 装备了来自某个 TC4 扩展的焦点（例如 MyFocus）
• 从游戏中移除了该扩展
• 恭喜！一旦您拿起这根法杖，游戏将崩溃。

本模组修复了此问题。

性能提升

基本上，这将在大型整合包中缓解打开奥术工作台时的客户端卡顿。同时，也能减轻因玩家使用奥术工作台批量制作 64 个物品而导致的服务器延迟。

限制 GUI 更新频率

从 1.1.0 版本开始，允许您将奥术工作台合成结果的更新频率限制为每 X 游戏刻一次。默认值为 4。如果效果不明显，可以设置更长的间隔。此值可在运行时通过本模组的配置 GUI 修改（Esc | Mod 选项 | 在模组列表中选择 TC4 Tweaks | 配置 | general），无需重启客户端。

这将缓解因法杖充能导致的延迟。从 1.2.0-beta2 版本开始，仅此一项就足以修复此延迟，并基本消除对更激进优化的需求（如下所述）。

其他性能补丁

对 TC4 中一些随机出现的低效代码进行了优化。其中大多数仅影响客户端性能（FPS），但部分补丁对专用服务器也有影响。大多数影响服务器的补丁针对奥术合成延迟。从 1.2.0-beta12 版本开始，新增了一个旨在修复炼金炉延迟的补丁。从 1.4.20 版本开始，将减少因充能节点持续检查是否仍能看到中继器而导致的延迟。通常建议在专用服务器上安装此模组，效果显著。

如果您对具体细节感兴趣，请参阅“技术说明”部分。

更激进的优化

从 1.2.0-beta1 版本开始，引入了一项实验性可选功能，可防止奥术工作台作为普通工作台使用。这解决了大型整合包中的大部分延迟问题。正如您所见，这种优化会带来一些副作用。建议在游戏中尝试以了解其实际效果。

此功能可通过本模组的配置 GUI 在运行时方便地开启或关闭（即无需重启客户端）（Esc | Mod 选项 | 在模组列表中选择 TC4 Tweaks | 配置 | general）。作为预防措施，仅当 checkWorkbenchRecipes 设置为 false（而非 true）时，此功能才会启用。

尽管这听起来像是需要在两端同时启用的更改，但实际上，如果服务器禁用此功能（或未安装此模组）而客户端启用它，效果同样良好。建议在专用服务器上保持此功能关闭，仅在客户端启用。

技术说明

本节仅面向开发者。如果您不理解，请不要惊慌。

注意：本文档不经常更新。请查阅源代码以了解实际情况。

• ScanManager#generateItemHash(Item, int) 不再创建大量字符串，而是直接计算哈希码。此修改与 GT6 的修复冲突，如果检测到 GT6 的加载插件，将不会生效。GT6 的修复将优先。
• ResearchCategories#getResearch(String) 现在使用 HashMap，而不是遍历所有已注册的研究。此 HashMap 将在服务器每次启动时重新计算。如果服务器尚未启动完成，HashMap 查找将被禁用。
• 在客户端侧，向 TileMagicWorkbench#setInventorySlotContents(IInventory) 注入了一个调用钩子，将更新频率限制为每 200 毫秒一次。如果任何更新被跳过，将设置一个标志。随后，一个刻处理器将尝试每 X 刻（可配置值）更新一次，以防遗漏更新。
• FXSonic 的模型改为静态，仅在资源包重载时重新加载。
• 在 ThaumcraftCraftingManager 中，findMatchingArcaneRecipe 和 findMatchingArcaneRecipeAspects 添加了简单的 LRU 缓存，缓存大小可配置（默认为 16）。缓存满时，旧条目将被逐出。
• 在 TC4 映射线程开始时注入 Thread.currentThread().setPriority(1)。如果缓存被命中，优先级将恢复为正常，以尝试缓解锁竞争。
• GuiResearchRecipeVisitor 之前同时使用同步方法和 ConcurrentMap。现已移除同步。
• ThaumcraftCraftingManager 中的 getObjectTags 得到改进。详情请参阅代码。
• GuiResearchBrowser 进行了大量更改。详情请参阅 net.glease.tc4tweak.asm.GuiResearchBrowserVisitor。
• 大多数 TESR 已打补丁，在区块未完全加载时不渲染内容。

如果您在使用此扩展时遇到任何问题，请将问题提交至 GitHub（点击本页面侧边的 Issues 标签）。视频预告暂未提供。