跳到正文

Too Many Tinker

为匠魂提供客户端渲染优化

收藏

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

太多匠魂

太多匠魂是适用于匠魂的客户端渲染优化模组,支持 Minecraft 1.12.2(Cleanroom),专为包含大量匠魂材料和附属模组的大型整合包(例如 GreedyCraft2)设计。

在保留原版匠魂工具、部件和附属模组模型的外观及功能约定的同时,本模组将资源加载期间对所有材料纹理和部件模型的预生成及主图集拼接,改为按需生成、二维纹理分页和有界 LRU 缓存,大幅降低主图集压力、内存/显存占用和重新加载时的卡顿。

在 GreedyCraft2 整合包中(818 种匠魂材料),预烘焙的匠魂材料纹理占用内存从最高2 GB降至< 0.05 MB,显著降低整合包的整体内存需求,同时不影响游戏内工具的渲染性能。


要求

  • Minecraft 版本:1.12.2
  • 模组加载器:Cleanroom Loader(必需;不支持标准 Forge)
  • Java 版本:仅支持 Java 25

附属模组兼容性

通过标准匠魂 API 注册材料和部件的模组(例如 MoreTcon),可直接由 Too Many Tinkers 的渲染管线处理。

使用自定义渲染管线的模组可通过条件式 Mixins 按需支持:

  • Construct’s Armory:为动态合成的护甲纹理提供有界缓存(16 MiB / 256 个条目),并复用ResourceLocation槽位,避免渲染穿戴中的护甲时路径缓存和纹理无限增长。
  • Tinkers’ Things 2:查找 Scout 护甲纹理时保留精确匹配条件,确保基础层染色和遮罩管线正常工作。
  • Tinkers’ Evolution:对直接从主图集采样的材料(例如 CosmicMaterialRenderInfo)保留原生主图集注册和 UV,并将委托模型缓存清理接入生命周期事件。
  • Had Enough Items / JEI:自动检测包含 TMT 管理纹理的物品模型,并回退到标准物品渲染,以绕过 HEI 批处理渲染器的限制。

核心优化机制

  • 按需生成纹理与二维纹理分页(NativeMaterialTextures)
    • 拦截CustomTextureCreator,不再将每个部件与材料组合的精灵图预先构建到主图集中,而是在渲染或模型烘焙需要时才生成纹理。
    • 动态将生成的精灵图打包到1024 × 1024二维纹理页中,并按像素内容哈希去重(PixelContentKey)。
    • 限制内存和显存预算:GPU 纹理页64 MiB、预备纹理缓存16 MiB、动画帧缓冲区32 MiB;达到上限时淘汰最近最少使用的条目,并在需要时重新上传。
  • 保留主图集约定(NativeAtlasMaterial)
    • 需要直接从主图集采样的特殊材料(例如 Cosmic 材料)仍会注册到原版主TextureMap,确保光影效果正常渲染。
  • 按需烘焙部件模型(TmtLazyMaterialModel)
    • 保留BakedMaterialModel约定,同时将按材料逐一预先烘焙改为延迟单材料烘焙,并由有界WeightedLruCache缓存支持(最多 4,096 个条目 / 估算权重 16 MiB)。
  • 工作台物品放置缓存(TableItemModels)
    • 为 TableItem中放置在匠魂工作台上的条目缓存经过空间变换的烘焙模型(最多 256 个条目 / 4 MiB),避免每帧执行 TRSRBakedModel矩阵变换。
  • 资源与世界生命周期清理(RenderLifecycle)
    • 资源重载(TextureStitchEvent.Pre)或客户端世界卸载(WorldEvent.Unload)时,自动清除模型缓存并释放 TMT 所持有的 GPU 纹理。

诊断命令

Too Many Tinkers 提供客户端 /tmt 命令(权限等级 0),用于检查缓存状态并排查渲染或性能问题:

命令 说明
/tmt stats 将材质纹理、模型、四边形、遮罩、工作台物品和盔甲缓存的实时统计信息输出到聊天栏和日志。
/tmt dump 将诊断快照导出为 JSON 文件至 <gameDir>/tmt-diagnostics/<timestamp>.json,其中包含堆内存信息、缓存统计、资源包、材料与工具/部件注册表、已启用模组以及手持物品详情。
/tmt profile start 开始记录客户端 RenderTick帧间隔样本(最多保留最近 18,000 帧)。
/tmt profile stop 停止性能分析,并自动生成包含帧间隔统计信息的 JSON 诊断报告。

常见问题

Too Many Tinker 支持哪些 Minecraft 版本?

Too Many Tinker 支持 Minecraft Java 版 1.12.2,可用的加载器:Forge。下载时注意选择和你游戏版本一致的文件。

Too Many Tinker 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Forge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

Shiver211 的其他作品

查看全部 →