Skip to content

[resource] 资源体积治理:全量空间账本、根因分析、现代 MC 压缩方案与分项课题 #383

Open
0 of 7 issues completed

Description

@Tanimodori

本文是 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 KB zTXt),原始元数据 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)

  1. Recipes(1.21.1 3,107 条 / 1.19 MiB;1.20.1 3,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%)。
  2. Lang(2 条 / 0.91 MiB 压缩,原始 6.54 MiB):
    • en_us.json 13,718 键(857 KB → 126 KB):英文 oredict.* 已经由 OriginalMaterialNameRules 在 Java 运行期机械生成,文件内为 0 条;但 block.gt6ce.*(4,291)与 item.gt6ce.*(4,232)仍含不少材质组合键。
    • zh_cn.json 98,009 键(5.72 MiB → 810 KB):因 MaterialPresentation.formName() 优先查语言文件中的 oredict.*,中文端静态存放了 65,482 条预展开 oredict.*(~2.88 MB 原始),并混入 ~15,800 条非本端/1.7.10/附属死键(gt.multitileentity 4,305、gt.multiitem 3,921、gt.stone 2,023、gt.material 1,879、gt.block 1,517、qwertech.* 1,356、written.book 742、bc.* 80、ic2.* 6)。
    • 已有基线:GregTech6-Translation-Groupware(packages/node/project.jsonc)已证明 94.3% 的中文条目仅由 168 个生成器(73 个面向 oredict.*,基础词表 2,507 对)机械规则生成;GT6CE 内也已有 TagNameTranslations + GeneratedTagLanguageMixin 成功验证了 tag.* 的运行期模板动态拼接。
  3. Models 与 Blockstates(源码 19,28420,122 文件 / 17.518.5 MiB → JAR 0.36 MiB):
    • compactModelJson 将绝大部分重复结构压缩到 model-json-aliases.json(0.21 MiB),但运行期仍需在内存恢复 4.41 MiB JSON 字节,且源码树/构建树负担未减;
    • 死文件:PipeWireClientModels.onModifyBakingResult() 已在烘焙期完全接管全部管线与传动轴,但磁盘仍残留 998 个 blockstate + ~998 个 item model + 298+ 个 block model;
    • 未折叠残余:models 254 个(0.14 MiB)+ blockstates 13 个(0.005 MiB)。
  4. StackGroups(465 条 / 0.18 MiB):
    • 给可选模组 Reliable EMI(remi:group)使用的侧边栏折叠文件,ZIP 开销(106,124 B)大于载荷(85,050 B),其中竟包含 45 个 "contents": [] 空无效文件。

二、深层根因:为什么 GT6CE 的资源浪费如此严重?

对照 _reference/GregTech6-Original(1.7.10)与 GT6CE 注册代码,核心病根可归为五点:

  1. 原封照搬 1.7.10 TextureMap 的历史妥协,却叠加现代 JSON 维度:原版 GT6(20,377 文件)因 IIconRegister 要求所有注册槽位必须存在磁盘 .png 而被迫用数千张空白透明图填满 41 × N 笛卡尔积;GT6CE 继承该贴图树并叠加现代 JSON 模型/方块状态/配方/中文预展开 oredict.*,形成多重放大。
  2. 资产生成范围与真实注册范围严重脱节: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 未清。
  3. “同模换色”全量预烘焙而非运行期分层着色/绘制:wooden_buckets(126→1 轮廓)、bottles(167→18 轮廓)、cans(57→7 轮廓)、block/fluids(183→10 轮廓,占 0.97 MiB)、basicmachines(79 台 × 24 张)全在硬盘保存已染好色的独立副本。
  4. 小文件粒度过碎推高 ZIP 目录税:recipes、stack_groups、dir_entries、lang 预展开造成高额结构开销与运行时内存膨胀。
  5. 构建期 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 条目)

六、架构红线与验证约束

  1. 分层边界:外观集定义、继承回退链、前缀合法性、配方/语言模板规则留在 core(无 Minecraft/客户端依赖);SharedInventoryModelPack、动态 BakedModel、ItemColor/BlockColor、NativeImage 动态绘制与 AddPackFindersEvent 放在 minecraft/src/ 共享,严禁 1.20.1 Forge 与 1.21.1 NeoForge 产生视觉分化。
  2. 外部材质包与多语言覆写优先:低优先级内置资源包(Pack.Position.BOTTOM)、运行期 NativeImage 合成与运行期 lang 模板解析,必须保证上层用户资源包显式覆盖依然生效。
  3. 生态与技术红线:
    • 配方瘦身严禁用 CustomRecipe 替代普通合成(破坏 EMI/JEI 与配方书展示);
    • 禁用 paletted_permutations 展开全部 GT 材料(防止 GPU 图集尺寸爆炸);
    • 禁用 NeoForge 独占的 RegisterSpriteSourceTypesEvent(保持双端一致)。
  4. 验证门禁:各阶段交付均需通过 :core:test、check_compact_model_json.py / audit_recipes.py、双端 jar / distributionJar 启动零缺图/零 CRC 错误校验与游戏内实机视觉抽检。

Activity

  1. added
    enhancement建议总类 / Suggestion umbrella
    needs triage等待维护者分类 / Awaiting maintainer triage
    perf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration cost
    on Nov 13, 2026
  2. added
    priority: medium一般的功能性错误 / General functional error
    refactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior change
    and removed
    needs triage等待维护者分类 / Awaiting maintainer triage
    on Nov 13, 2026
  3. added
    rfc提案游戏系统、玩法、架构、规范或路线图 / Proposal for game systems, gameplay, architecture, specs or roadmap
    priority: high崩溃、数据丢失或主要功能不可用 / Crash, data loss or major feature unusable
    scope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, rendering
    scope: buildGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository process
    on Nov 14, 2026
  4. self-assigned this
    on Nov 14, 2026
  5. changed the title [-][resource] 资源体积治理:范围、度量基线与分项课题[/-] [+][resource] 资源体积治理:全量空间账本、根因分析、现代 MC 压缩方案与分项课题[/+] on Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancement建议总类 / Suggestion umbrellaperf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration costpriority: high崩溃、数据丢失或主要功能不可用 / Crash, data loss or major feature unusablerefactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior changerfc提案游戏系统、玩法、架构、规范或路线图 / Proposal for game systems, gameplay, architecture, specs or roadmapscope: buildGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository processscope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, rendering

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions