models/(空壳目录)
基本信息
| 属性 | 值 |
|---|---|
| 目录 | com.gtnewhorizons.angelica.models |
| 文件数 | 1 |
| 文件 | models/VanillaModels.java |
| 文件大小 | 0 字节 |
| 行数 | 0 |
核心事实:这是一个 0 字节的空文件
$ wc -c src/main/java/com/gtnewhorizons/angelica/models/VanillaModels.java
0
实测确认:该文件完全为空 —— 不是「有 package 声明但没有类」,也不是「只有 Javadoc」,而是零字节。连 package com.gtnewhorizons.angelica.models; 这一行都不存在。
因此 com.gtnewhorizons.angelica.models 这个包在编译产物中不存在(Java 编译器不会为空文件生成任何输出)。
全仓引用检查:零引用
对 VanillaModels 做全仓 grep(含 src/main、src/mixin、glsm、sdl-gpu、umbra、tracy-client、lwjgl3-backend 全部源根,以及测试源):
结果为 0 处引用。 没有任何 Java 代码 import 或引用 com.gtnewhorizons.angelica.models.VanillaModels。
判定
这是一个遗留的空目录残留,属于重构/迁移后的死文件。可能的历史来源(本仓库内无证据,仅列可能性):
- 曾计划为 vanilla 方块模型建立注册表,后改由 Celeritas / Sodium 派生的模型管线承担
- 曾用于 MCPatcherForge 的模型扩展,后被
api/tesr/取代 - 曾用于 Iris 的模型 hook,后被 vendored Iris 自己实现
以上均无源码证据,不作为事实记录。
为什么仍要立条目
models/ 是 com.gtnewhorizons.angelica 下的一个一级包,与 api/、render/、dynamiclights/ 等 20 个同级包并列。若不记录,读者按目录普查会以为漏了内容。记录「它是空的」比留白更有信息量 —— 尤其因为它可以被误认为「模型相关功能待补」。
已知问题
- 空文件应删除:
VanillaModels.java零字节、零引用,删除对构建与运行无任何影响。Git 已跟踪它(位于src/main/java下),但由于内容为空,删除只会产生一条删除记录。 com.gtnewhorizons.angelica.models包不存在:任何尝试import com.gtnewhorizons.angelica.models.*的代码都会编译失败(包不存在时的通配 import 在部分编译器下静默通过,在引用具体类时失败)。- 无 git blame 可查:本轮未执行 git 历史查询,文件被创建的时间与提交无从判定(且本任务不执行任何 git 写操作)。
相关条目
- API 层 -
api/tesr/是当前实际承担模型/网格扩展职责的包 - Iris(内嵌) - Iris 侧有自己的模型处理
- Sodium(内嵌库) -
org.embeddedt.embeddium.impl.model.*是真正的模型数据结构所在