纹理包

基本信息

属性 值
核心类 org.dynmap.hdmap.TexturePack（hdmap/TexturePack.java）
着色器实现 hdmap/TexturePackHDShader（hdmap/TexturePackHDShader.java）
CTM 变体 hdmap/CTMTexturePack.java（Connect Texture Mod 支持）
仓库内纹理包 src/main/resources/texturepacks/standard/（3115 个文件，包名 standard）
被引用处 shaders.txt 默认着色器指定 texturepack: standard

功能

纹理包定义"方块 → 贴图"的映射，是渲染管线的数据层。仓库内的 standard 包采用资源包式目录结构（assets/<domain>/…），而非 .txt 定义文件：

路径 文件数
assets/minecraft/ 3109
assets/gwmcustom/ 5
terrain.png 1

assets/gwmcustom/ 下的 5 个自定义贴图为：ae2cable.png、air.png、gt5cablepipe.png、tc4bellows.png、tc4pipe.png——分别对应 AE2 电缆、空气、GT5 电缆管道、神秘学四号 bellows 与 pipe，是本 fork 为 GTNH 方块补的贴图。

[!NOTE] 这些 assets/ 属于纹理包内部，不是 mod 自身的资源目录：mod 的 src/main/resources/ 根下没有 assets/（git ls-files 'src/main/resources/assets/*' 为 0 命中）。

方块定义文件

与之分离，方块的贴图/模型映射以 .txt 形式放在 src/main/resources/ 根目录，按分片拆分：

文件 行数 推测用途
texture_0.txt 836 贴图定义（分片 0）
texture_1.txt 1842 贴图定义（分片 1）
models_0.txt 1273 方块模型定义（分片 0）
models_1.txt 1417 方块模型定义（分片 1）
deleted.txt 273 被移除/屏蔽的方块清单

这 5 个文件未被 build.gradle 或 dependencies.gradle 显式引用，其确切加载路径在 src/ 内无法从静态引用关系确定（grep -rn 'texture_0' src/main/java 无命中）。此处按文件名与行数照录，不断言其运行时位置。

反射点

TexturePack 是本 mod 扩展性的核心，含多处字符串反射：

位置 作用
TexturePack.java:2001-2002 Class.forName(parts[0]) + newInstance() → 装配 CustomModSupportLoader
TexturePack.java:2213-2214 反射装配 CustomColorMultiplier
TexturePack.java:2437 反射装配方块模型渲染器

hdmap/colormult/ 下有 3 个颜色乘数实现：TFBandedWoodColorMultiplier、TFMagicLeafColorMultiplier、TFSpecialLeafColorMultiplier（均为 Twilight Forest 木材/树叶的按 biome 着色）。

数值

数值名 值
仓库内纹理包数 1（standard）
standard 包文件数 3115
colormult 类数 3
反射装配点 ≥3 处（:2001、:2213、:2437）
5 个根级 .txt 定义文件合计行数 5641

交互

触发 行为
渲染 TexturePack 按方块 id/meta 查贴图，缺失时回退默认
贴图定义中遇 specialModSupportLoader: 装配对应 ModSupport 加载器
贴图定义中遇 render=<FQCN> 装配对应 ModSupport 渲染器
useOldBiomeColoring 为真 走旧生物群系着色分支（TexturePack.java:2638）

相关条目