Repository navigation
Description
本文是 GregTech 6 Community Edition 资源与包体体积治理的总览与 RFC 入口。
基线核对基于只读工作树
GregTech6CE-ReadOnly(origin/master@851c92179)的源码资源树、GregTech6CE双端1.0.7成品 JAR(gt6ce-neoforge-1.21.1-1.0.7.jar、gt6ce-1.20.1-forge-1.0.7.jar),并对照了_reference/GregTech6-Original、_reference/GregTech-Modern、_reference/Minecraft-{1.20.1-Forge,1.21.1-NeoForge}与GregTech6-Translation-Groupware。基线说明:
1.0.7成品 JAR 构建于硬币系统移除的增量缓存清理之前,JAR 内仍残留 187 个(1.21.1)/ 186 个(1.20.1)coin条目(含 94 张 PNG 与 112 份模型/方块状态,0.12 MiB),而851c92179源码树已移除硬币资源。下文分别以双口精确核对并已标明差异。
一、空间消耗的完整整体构成
1.1 成品 JAR 100% 完整账本(含真实 ZIP 结构开销)
直接解析 JAR 的 Local File Header(LFH,30 B + 文件名 + extra)、Central Directory Header(CD,46 B + 文件名 + extra + comment)与 EOCD(22 B),得到 差额为 0 B 的双端完整组成:
| 维度 | 1.21.1 NeoForge (1.0.7.jar) |
1.20.1 Forge (1.0.7.jar) |
|---|---|---|
| JAR 总字节 | 23,962,317 B (22.8522 MiB) | 23,910,609 B (22.8029 MiB) |
| 总条目数(文件 + 目录) | 27,990(26,288 + 1,702) | 28,061(26,366 + 1,695) |
| 未压缩总字节 | 43,561,499 B(41.54 MiB) | 43,498,322 B(41.48 MiB) |
压缩载荷(compress_size) |
17,672,139 B(16.85 MiB) | 17,598,589 B(16.78 MiB) |
| ZIP 结构总开销 | 6,290,178 B(5.9988 MiB,占 26.25%) | 6,312,020 B(6.0196 MiB,占 26.40%) |
关键发现:ZIP 结构开销本身就高达 6.00 MiB(整包的 1/4 强)!每多一个路径长约 60–80 B 的小文件,即使内容被压到几十字节,也要固定缴纳 ~200–240 B 的 LFH+CD 目录税。
按 1.21.1-neoforge JAR 全量目录树拆解(1.20.1 差异仅在配方数多 44 个、未折叠模型多 35 个及字节码微差):
| 资产/代码类别 | 条目数 | 原始未压缩 | 压缩载荷 | ZIP 结构开销 | JAR 实际占用 | 占比 | 归属 |
|---|---|---|---|---|---|---|---|
assets/gt6ce/textures(含 484 .mcmeta) |
18,095 | 7.44 MiB | 7.01 MiB | 4.05 MiB | 11.06 MiB | 48.38% | #384 / #396 / #397 / #401 |
classes/gregtech(Java 字节码) |
3,904 | 19.59 MiB | 7.83 MiB | 0.75 MiB | 8.59 MiB | 37.57% | 代码体量,不属资源治理 |
data/gt6ce/recipe(s) |
3,107 | 1.19 MiB | 0.58 MiB | 0.62 MiB | 1.19 MiB | 5.22% | #398 配方去 JSON 化 |
assets/gt6ce/lang(2 文件) |
2 | 6.54 MiB | 0.91 MiB | <0.01 MiB | 0.91 MiB | 4.00% | #399 Lang 模板化与死键清理 |
dir_entries(空目录条目) |
1,702 | 0 B | <0.01 MiB | 0.35 MiB | 0.35 MiB | 1.54% | #401 打包与 PNG 瘦身 |
META-INF/gt6ce/model-json-aliases.json |
1 | 4.41 MiB | 0.21 MiB | <0.01 MiB | 0.21 MiB | 0.92% | #400 模型/Blockstate 全虚拟化 |
assets/gt6ce/stack_groups |
465 | 0.26 MiB | 0.08 MiB | 0.10 MiB | 0.18 MiB | 0.80% | #400 模型/Blockstate/杂项 |
assets/gt6ce/models(未被 aliases 折叠) |
254 | 1.52 MiB | 0.09 MiB | 0.05 MiB | 0.14 MiB | 0.63% | #400 模型 / #396 机器 |
assets/gt6ce/gui(JSON) |
110 | 0.13 MiB | 0.02 MiB | 0.02 MiB | 0.04 MiB | 0.19% | 暂不立项(体量极小) |
data/gt6ce/other + tags + loot_table + data/other |
314 | 0.34 MiB | 0.05 MiB | 0.06 MiB | 0.11 MiB | 0.48% | 暂不立项 |
META-INF/other + sounds + blockstates(13) + 散件 |
24 | 0.13 MiB | 0.05 MiB | 0.01 MiB | 0.06 MiB | 0.27% | blockstates 归入模型子课题 |
| 合计(100% 对账差额 = 0 B) | 27,990 | 41.54 MiB | 16.85 MiB | 6.00 MiB | 22.85 MiB | 100.00% | 资源相关合计占整包 62.43%(14.27 MiB) |
1.2 源码资源树构成与 compactModelJson 掩盖的构建期膨胀
JAR 内只有 254 个模型与 13 个 blockstate,是因为 gradle/compact-model-json.gradle 在打发行包时将 19,129 个重复结构文件(15,136 models + 3,993 blockstates,源码 LF 高达 17,103,806 B = 16.31 MiB)折叠进了 META-INF/gt6ce/model-json-aliases.json(0.21 MiB)。但在源码仓库与开发期构建中,这批文件依然全量存在:
源码资源根 (851c92179) |
文件数 | 磁盘占用 | 关键构成 |
|---|---|---|---|
core/src/main/resources |
35,282 | 21.85 MiB | textures 18,001(17,517 PNG + 484 .mcmeta)、models 10,784、recipes 3,151、blockstates 2,498、stack_groups 464、lang 2 |
minecraft/src/main/resources |
6,003 | 12.41 MiB | models 4,496(11.17 MiB)、blockstates 1,506(1.24 MiB) |
1.20.1-forge/src/main/resources |
916 | 1.06 MiB | models 791、blockstates 47、tags/loot_tables |
1.21.1-neoforge/src/main/resources |
145 | 0.13 MiB | loot_table 84、tags 13、data |
| 源码资源总计 | 42,346 | 35.46 MiB | processResources 需复制 3.5–4.1 万个小文件,Windows 下全量复制与 IDE 索引耗时高昂 |
1.3 各贴图子目录的精细消耗与“重复/空图/同构换色”审计
对 1.21.1-neoforge JAR 内 18,095 个贴图条目(17,611 PNG + 484 .mcmeta) 进行逐像素解码与哈希分组,贴图总占用 11,593,447 B(11.06 MiB = 载荷 7.01 MiB + ZIP 开销 4.05 MiB):
- 字节级完全重复(SHA-1 相同):全局仅 4,259 个唯一 SHA-1,其余 13,352 张(75.82%) 为冗余副本,浪费
7,144,824 B(6.81 MiB); - 全透明空图(Alpha 全 0):共 5,236 张(29.73%),占用
1,932,859 B(1.84 MiB); - 调色板同构换色(仅颜色不同、轮廓/相对明暗相同):全部 17,611 张 PNG 仅对应 3,063 个调色板同构模板(1,336 个唯一 Alpha 掩码),14,548 张(82.61%) 落在重复或换色模板上;
- PNG 非必要元数据与重压空间:17,309 个
pHYs、17,140 个tIME、17,142 个bKGD、228 个iCCP、193 个iTXt、120 个zTXt(neutron.png单张含 7.1 KBzTXt),原始元数据 1,929,109 B(1.84 MiB),另有 10 张 PNG 的iCCP块 CRC 校验损坏。若做离线 Pillow 重编不仅会污染 Git 历史,JAR 也仅省0.73 MiB;而改用构建期纯 Chunk 过滤(原样透传IHDR/PLTE/tRNS/IDAT/IEND字节并缓存至build/),可在零 Git 膨胀前提下在 JAR 净省1,492,697 B(1.42 MiB)。
各子目录细目(按 JAR 实际占用排序):
| 子目录 | PNG / mcmeta | JAR 合计 | 唯一 SHA1 | 冗余数 (占用) | 全透明空图 | 唯一 Alpha | 唯一调色板同构 | 主要问题 |
|---|---|---|---|---|---|---|---|---|
item/material_icons |
8,200 / 0 | 3.67 MiB | 441 | 7,759 (3.41 MiB) | 3,177 | 291 | 333 | 41×100×2 全展开、6 套零引用、无继承树、硬声明空 overlay |
block/machines |
3,833 / 163 | 2.51 MiB | 1,019 | 2,814 (1.68 MiB) | 685 | 299 | 739 | basicmachines 79 台×24 图硬拷贝、壳体与空面重复 |
block/material_icons |
2,624 / 52 | 1.39 MiB | 79 | 2,545 (1.31 MiB) | 1,341 | 28 | 68 | 41×32×2 全展开(19/32 前缀非方块形态)、99.1% overlay 空 |
block/fluids |
183 / 169 | 0.97 MiB | 138 | 45 (0.23 MiB) | 0 | 10 | 61 | 160 张 16×512 长条动画图仅 10 个形状模板,大多仅换色 |
gui/machines + components + chests + _root |
286 / 0 | 0.49 MiB | 283 | 3 (<0.01 MiB) | 2 | 150 | 265 | gui/machines(88) 与 chests(18) 为 256×256,含 283 KB 元数据 |
block/iconsets |
392 / 11 | 0.29 MiB | 391 | 1 (<0.01 MiB) | 1 | 83 | 270 | 分散大量 16×16 小图(含 102 KB 元数据),ZIP 税占比 28% |
block/overlays |
75 / 0 | 0.25 MiB | 53 | 22 (0.06 MiB) | 0 | 52 | 53 | 72 张 64×64、2 张 128×128、1 张 256×256 + 22 重复 + 损坏 CRC |
block/stones |
304 / 2 | 0.24 MiB | 288 | 16 (0.01 MiB) | 0 | 2 | 213 | 岩石变体较多且不可纯单色 tint,适合 unstitch 合图 |
item/food |
264 / 5 | 0.19 MiB | 262 | 2 (<0.01 MiB) | 0 | 83 | 182 | 手绘图标分散(约 13 张未引用),含 100 KB 元数据 |
item/technological |
302 / 0 | 0.18 MiB | 292 | 10 (<0.01 MiB) | 0 | 72 | 194 | 分散小图(约 27 张未引用) |
item/randomtools |
145 / 0 | 0.13 MiB | 144 | 1 (<0.01 MiB) | 0 | 62 | 134 | 含 111 KB 非必要 PNG 元数据(重压立省 48 KB) |
item/triggers |
80 / 0 | 0.10 MiB | 80 | 0 | 0 | 68 | 72 | 小图标合集 |
item/iconsets |
188 / 0 | 0.09 MiB | 151 | 37 (0.01 MiB) | 23 | 93 | 120 | 含 23 空图与 37 重复 |
item/bottles |
167 / 0 | 0.09 MiB | 161 | 6 (<0.01 MiB) | 0 | 18 | 94 | 约 29 张未引用;仅 18 个瓶型轮廓,大量为液体换色 |
item/wooden_buckets |
126 / 0 | 0.09 MiB | 110 | 16 (0.01 MiB) | 0 | 1 | 50 | 9 箍 × 14 液 = 126 张全共享 1 个 Alpha 掩码,纯换色硬拷贝 |
item/bumblebee |
83 / 80 | 0.07 MiB | 74 | 9 (<0.01 MiB) | 0 | 43 | 66 | 带 .mcmeta 的蜂类物品 |
item/cans |
57 / 0 | 0.05 MiB | 51 | 6 (<0.01 MiB) | 0 | 7 | 22 | 仅 7 种罐型轮廓,含 50 KB 元数据 |
其余(sandwiches/books/certificate/nature/dungeon/data_switch/armor 等) |
299 / 4 | 0.22 MiB | 248 | 51 (0.03 MiB) | 7 | 46 | 142 | data_switch 12 张仅 2 个 SHA1;books 含 53 KB 元数据 |
1.4 次要资源问题精细消耗(Recipes / Lang / Models / Blockstates / StackGroups)
- Recipes(1.21.1
3,107条 /1.19 MiB;1.20.13,151条 /1.22 MiB):- 中位大小仅 367 B(1.20.1 为 386 B),ZIP 结构开销(645,884 B)已经超过配方压缩载荷本身(604,706 B)。
- 96.7% 为模板机械展开:3,107 个配方仅对应 277 个 JSON 结构模板(176 个重复模板命中 3,006 个文件),且附带大量冗余
"_comment"与"_autocrafting_source"字段。 - 源目录大户:
wire_working/(1,272,40.4%)、clay_molds/(422,13.4%)、books/(290,9.2%)、smeltery_survival/(131)、food/(86)、components/(84)、catalog_repairs/(82)、extruder_shapes/(78)、decorative_panels/(75)——仅前 4 类模板化目录就占 2,062 个(65.4%)。
- Lang(
2条 /0.91 MiB压缩,原始6.54 MiB):en_us.json13,718 键(857 KB → 126 KB):英文oredict.*已经由OriginalMaterialNameRules在 Java 运行期机械生成,文件内为 0 条;但block.gt6ce.*(4,291)与item.gt6ce.*(4,232)仍含不少材质组合键。zh_cn.json98,009 键(5.72 MiB → 810 KB):因MaterialPresentation.formName()优先查语言文件中的oredict.*,中文端静态存放了 65,482 条预展开oredict.*(~2.88 MB 原始),并混入 ~15,800 条非本端/1.7.10/附属死键(gt.multitileentity4,305、gt.multiitem3,921、gt.stone2,023、gt.material1,879、gt.block1,517、qwertech.*1,356、written.book742、bc.*80、ic2.*6)。- 已有基线:
GregTech6-Translation-Groupware(packages/node/project.jsonc)已证明 94.3% 的中文条目仅由 168 个生成器(73 个面向oredict.*,基础词表 2,507 对)机械规则生成;GT6CE 内也已有TagNameTranslations+GeneratedTagLanguageMixin成功验证了tag.*的运行期模板动态拼接。
- Models 与 Blockstates(源码
19,28420,122文件 /17.518.5 MiB→ JAR0.36 MiB):compactModelJson将绝大部分重复结构压缩到model-json-aliases.json(0.21 MiB),但运行期仍需在内存恢复4.41 MiBJSON 字节,且源码树/构建树负担未减;- 死文件:
PipeWireClientModels.onModifyBakingResult()已在烘焙期完全接管全部管线与传动轴,但磁盘仍残留 998 个 blockstate + ~998 个 item model + 298+ 个 block model; - 未折叠残余:
models254 个(0.14 MiB)+blockstates13 个(0.005 MiB)。
- StackGroups(
465条 /0.18 MiB):- 给可选模组 Reliable EMI(
remi:group)使用的侧边栏折叠文件,ZIP 开销(106,124 B)大于载荷(85,050 B),其中竟包含 45 个"contents": []空无效文件。
- 给可选模组 Reliable EMI(
二、深层根因:为什么 GT6CE 的资源浪费如此严重?
对照 _reference/GregTech6-Original(1.7.10)与 GT6CE 注册代码,核心病根可归为五点:
- 原封照搬 1.7.10
TextureMap的历史妥协,却叠加现代 JSON 维度:原版 GT6(20,377 文件)因IIconRegister要求所有注册槽位必须存在磁盘.png而被迫用数千张空白透明图填满41 × N笛卡尔积;GT6CE 继承该贴图树并叠加现代 JSON 模型/方块状态/配方/中文预展开oredict.*,形成多重放大。 - 资产生成范围与真实注册范围严重脱节:
41套MaterialTextureSet中6套零引用(1,584 文件);物品侧实际仅投影2,246 / 4,018(55.9%),方块侧实际仅投影254组合却铺了41×32×2(膨胀 5.17×);MaterialIconDefinitions与BlockMaterialIcons无条件硬写layer0 + layer1,制造 4,518 张空图;PipeWireClientModels管线死文件与 45 个空stack_groups未清。 - “同模换色”全量预烘焙而非运行期分层着色/绘制:
wooden_buckets(126→1 轮廓)、bottles(167→18 轮廓)、cans(57→7 轮廓)、block/fluids(183→10 轮廓,占 0.97 MiB)、basicmachines(79 台 × 24 张)全在硬盘保存已染好色的独立副本。 - 小文件粒度过碎推高 ZIP 目录税:
recipes、stack_groups、dir_entries、lang预展开造成高额结构开销与运行时内存膨胀。 - 构建期 PNG 未剥离块元数据:
pHYs/tIME/bKGD/iCCP/iTXt/zTXt占 1.84 MiB 原始体积并引入 10 个 CRC 坏块。
三、原版 MC 与现代模组压缩技术调研(Domain Knowledge)
| 机制 / 方案 | 原版 MC (1.20.1 / 1.21.1) 原生支持 | GregTech-Modern / 生态实战 |
对 GT6CE 双平台(1.20.1 Forge + 1.21.1 NeoForge)适用性评估 |
|---|---|---|---|
| 1. 继承回退树 + 按需声明层 | item/generated 读 layer0..4,遇缺失层即止;不写 layer1 就不需空图;ItemColor/BlockColor 运行期染色 |
GTM MaterialIconSet 沿 parentIconset 回退,全模组材料图仅 582 张(整模组仅 3,832 PNG + 694 JSON) |
100% 通用,最高优先。改按存在层输出 JSON 即可立删 4,500+ 张 void.png,配合回退链消减 3,000+ 同图。 |
| 2. 机器“壳体 + Overlay”正交拆分 + 动态 BakedModel | composite 与自定义 IDynamicBakedModel 按 state/面按需拼装 quad |
GTM GTMachineModels + WorkableOverlays:壳体共用并支持着色,仅留差异面与自发光,全模组机器仅 495 PNG + 348 外壳 |
100% 通用。扩展 MachineBlockClientModels 复用 MaterialBlockBakedModel 体系即可消灭 basicmachines ~80% PNG 与 1,700+ 大 JSON。 |
3. minecraft:unstitch 图集切片(Spritesheet) |
assets/minecraft/atlases/blocks.json 原生支持 unstitch,NativeImage.copyRect 运行时切回原 sprite ID |
— | 100% 双平台原生支持。适合将 Phase 1–2 收敛后最终保留下来的静态 16×16 手绘图标合并为少量 512×512 大图,消减 PNG 帧头与 ZIP 目录税,不破坏外部材质包覆盖。 |
4. minecraft:paletted_permutations 调色板置换 |
图集加载期按 palette_key -> permutations 生成衍生 sprite |
— | 仅适合“少数模板 × 少数色板”,禁止用于几百种材料展开(会撑爆 GPU TextureAtlas)。 |
5. PackResources + NativeImage 运行期动态绘制 |
NeoForge 1.21.1 有 RegisterSpriteSourceTypesEvent,但 Forge 1.20.1 SpriteSources.TYPES 为 private;两平台均支持 NativeImage.mappedCopy/asByteArray(无需渲染线程) |
— | 禁用 RegisterSpriteSourceTypesEvent(无法统一双端)。能用“多层模型 + ItemColor”解决的(如木桶、大部分流体)优先多层着色;不便多层着色的渐变换色图(部分瓶罐等)用双平台统一的低优先级 PackResources + NativeImage 动态合成。 |
| 6. 动态资源包 / 数据包与语言模板化 | AddPackFindersEvent 注入内存 PackResources;ClientLanguage Mixin(GT6CE 已有 GeneratedTagLanguageMixin) |
GTM GTDynamicResourcePack + GTDynamicDataPack 内存生成全部材料/矿石模型与配方 |
100% 通用。配方迁入 RecipePublishing(禁用 CustomRecipe 避免丢失 EMI/JEI 展示);lang 结合 GregTech6-Translation-Groupware 规则集与 TagNameTranslations 架构运行期模板生成 oredict.*。 |
| 7. 打包选项与 PNG 无损压榨 | FilePackResources 按路径查找、listResources 跳过目录条目 |
— | Jar 开启 includeEmptyDirs = false(需双端加载验证)立省 0.35 MiB;构建期增量缓存纯 PNG Chunk 过滤(零 Git 膨胀)立省 1.42 MiB,Phase 4 再对留存少量 PNG 做离线收口压榨。 |
四、建议实施步骤与阶段依赖(Roadmap)
本治理计划按工程依赖划分为 4 个阶段(Phase 1 → Phase 4)。其中部分跨越多个阶段的子课题内部也已按 Phase 切分 Step,确保前置条件清晰、可并行最大化、且不发生“先合图后删图”或“先改写再删除污染 Git 历史”的返工:
Phase 1(止血、底包瘦身与死资产清理 — 零渲染风险,最先启动)
├─ #401 · Step 1 Jar 去空目录条目 + 本地增量缓存构建期 PNG Chunk 过滤(零 Git 膨胀)+ 增量门禁
├─ [#384 · Step 1] 删 6 零引用 set + 不可达 (set,prefix) + 取消无条件 layer1 消除 4,518 空图
└─ #400 · Step 1 删 PipeWireClientModels 覆盖的 ~2,300 死 JSON + 45 个空 stack_groups
│
▼
Phase 2(结构正交收敛与数据/语言/配方虚拟化 — 各线可高度并行)
├─ [#384 · Step 2] MaterialTextureSet 继承回退树 + models/*/material 虚拟化(依赖 #384·Step 1)
├─ #396 机器壳体着色 + 差异面 Overlay 正交拆解 + 动态 BakedModel(依赖 Phase 1 基线)
├─ #398 3,151/3,107 静态配方 JSON 迁入 RecipePublishing(完全独立并行)
└─ #399 · Step 1~2 zh_cn.json 死键清理 + oredict.* 运行期模板化(独立并行,对齐 Translation-Groupware)
│
▼
Phase 3(同模换色动态化与静态精灵合图 — 必须等 Phase 2 定稿留存贴图后推进)
├─ #397 · Step 1 木桶/瓶罐/流体多层动态染色 & PackResources+NativeImage 动态绘制(依赖 #384·Step 1)
└─ #397 · Step 2 对 Phase 1~3.1 最终留存的 16×16 静态图集做 minecraft:unstitch 合图(依赖 #384·Step 2 + A + B·Step 1)
│
▼
Phase 4(全仓 JSON 虚拟化收口、留存 PNG 终局压榨与基线锁定)
├─ #400 · Step 2 剩余平铺模型/blockstate 收口进 SharedInventoryModelPack + 评估淘汰 compactModelJson(依赖 #384 + A + B)
├─ #399 · Step 3 评估 block/item.gt6ce.<mat>_* 机械语言键模板化(可选)
└─ #401 · Step 2 对最终留存少量 PNG 做一次性离线终局压榨/坏块清理 + 锁定 CI 最终基线门禁
预计全套 Phase 1–4 落地后,资源相关占用可从 14.27 MiB 压缩至 ~3–4 MiB,JAR 总条目从 ~28,000 降至 ~5,000–7,000,源码静态资源文件从 42,346 降至 ~3,000–5,000。
五、子 Issue 列表(已关联子课题)
| 序号 | 子课题 | 所属 Phase | 前置依赖 | 建议标签 | 核心目标与预计 JAR 收益 |
|---|---|---|---|---|---|
| #384(已有,建议更新) | 材质图标与材料模型收敛 | Phase 1 (Step 1) Phase 2 (Step 2) |
Step 1 无前置;Step 2 依赖 Step 1 | enhancement, priority: high, perf, refactor, scope: ui, scope: material |
删 6 零引用 set、不可达 (set,prefix) 与 4,518 空图;建 MaterialTextureSet 回退树与材料模型虚拟化(~4.3–4.6 MiB / -9,500+ 条目) |
| #396 | 机器贴图与机器模型/方块状态正交重构 | Phase 2 | Phase 1 基线(与 #384 Step 2 并行) | enhancement, priority: high, perf, refactor, scope: ui, scope: machine |
basicmachines 等正交拆分“可着色壳体 + 差异面 Overlay”;动态 BakedModel 淘汰 1,724 大 JSON;清机器死图(~1.5–1.8 MiB / -2,800+ 条目) |
| #397 | 同模板换色资产动态绘制与 unstitch 合图 |
Phase 3 (Step 1~2) | Step 1 依赖 #384 Step 1;Step 2 依赖 #384 Step 2 + A + Step 1 | enhancement, priority: medium, perf, refactor, scope: ui |
木桶(126→3)/瓶罐/16×512 流体改多层染色或 NativeImage 动态绘制;留存 16×16 静态图标做 minecraft:unstitch 合图(~1.2–1.6 MiB / -2,000+ 条目) |
| #398 | 静态配方 JSON 迁入 RecipePublishing 与代码规则化 |
Phase 2 | 无(独立并行) | enhancement, priority: medium, perf, refactor, scope: recipe |
wire_working(1,272)/clay_molds(422)/books(290)/extruder_shapes(78) 等迁入 RecipePublishing,保持 EMI/JEI 与 /reload 兼容(~1.1 MiB / -3,000+ 条目) |
| #399 | 语言文件(lang)模板化动态生成与历史死键清理 |
Phase 2 (Step 1~2) Phase 4 (Step 3 可选) |
无(独立并行) | enhancement, priority: medium, perf, refactor, translation, scope: ui |
清 zh_cn.json ~15,800 条 1.7.10/附属死键;对齐 GregTech6-Translation-Groupware 与 TagNameTranslations 模板生成 65,482 条 oredict.*(~0.6–0.7 MiB / 内存大降) |
| #400 | 模型/Blockstate 死文件清理、全虚拟化与 stack_groups 瘦身 |
Phase 1 (Step 1) Phase 4 (Step 2) |
Step 1 无前置;Step 2 依赖 #384 + A + B | enhancement, priority: medium, perf, refactor, scope: ui, scope: build |
Phase 1 删 ~2,300 管线死 JSON 与 45 空 stack_groups;Phase 4 全虚拟化平铺模型/blockstate 并评估淘汰 compactModelJson(JAR ~0.2 MiB / 源码减 ~18 MiB、~19,000 文件) |
| #401 | 构建打包与 PNG 底层无损瘦身及 CI 门禁 | Phase 1 (Step 1) Phase 4 (Step 2) |
Step 1 无前置(最先启动);Step 2 依赖全线收口 | enhancement, priority: medium, perf, scope: build, scope: ui |
Phase 1 去 1,702 空目录条目 + 本地增量缓存构建期 PNG Chunk 过滤(零 Git 膨胀)+ 增量门禁;Phase 4 留存 PNG 终局压榨与基线锁定(~1.77 MiB / -1,702 条目) |
六、架构红线与验证约束
- 分层边界:外观集定义、继承回退链、前缀合法性、配方/语言模板规则留在
core(无 Minecraft/客户端依赖);SharedInventoryModelPack、动态BakedModel、ItemColor/BlockColor、NativeImage动态绘制与AddPackFindersEvent放在minecraft/src/共享,严禁 1.20.1 Forge 与 1.21.1 NeoForge 产生视觉分化。 - 外部材质包与多语言覆写优先:低优先级内置资源包(
Pack.Position.BOTTOM)、运行期NativeImage合成与运行期lang模板解析,必须保证上层用户资源包显式覆盖依然生效。 - 生态与技术红线:
- 配方瘦身严禁用
CustomRecipe替代普通合成(破坏 EMI/JEI 与配方书展示); - 禁用
paletted_permutations展开全部 GT 材料(防止 GPU 图集尺寸爆炸); - 禁用 NeoForge 独占的
RegisterSpriteSourceTypesEvent(保持双端一致)。
- 配方瘦身严禁用
- 验证门禁:各阶段交付均需通过
:core:test、check_compact_model_json.py/audit_recipes.py、双端jar/distributionJar启动零缺图/零 CRC 错误校验与游戏内实机视觉抽检。
Activity
unstitch图集压缩(木桶/瓶罐/流体/零散图标) #397RecipePublishing与代码规则化 #398lang)模板化动态生成与历史死键清理(覆盖oredict.*等机械条目) #399stack_groups瘦身 #400[-][resource] 资源体积治理:范围、度量基线与分项课题[/-][+][resource] 资源体积治理:全量空间账本、根因分析、现代 MC 压缩方案与分项课题[/+]fix(client): restore conditional overlay rendering on anvil workpieces
build(resources): wire verifyPngFilter into check and refine CI and docs