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 个同级包并列。若不记录,读者按目录普查会以为漏了内容。记录「它是空的」比留白更有信息量 —— 尤其因为它可以被误认为「模型相关功能待补」。

已知问题

  1. 空文件应删除:VanillaModels.java 零字节、零引用,删除对构建与运行无任何影响。Git 已跟踪它(位于 src/main/java 下),但由于内容为空,删除只会产生一条删除记录。
  2. com.gtnewhorizons.angelica.models 包不存在:任何尝试 import com.gtnewhorizons.angelica.models.* 的代码都会编译失败(包不存在时的通配 import 在部分编译器下静默通过,在引用具体类时失败)。
  3. 无 git blame 可查:本轮未执行 git 历史查询,文件被创建的时间与提交无从判定(且本任务不执行任何 git 写操作)。

相关条目

  • API 层 - api/tesr/ 是当前实际承担模型/网格扩展职责的包
  • Iris(内嵌) - Iris 侧有自己的模型处理
  • Sodium(内嵌库) - org.embeddedt.embeddium.impl.model.* 是真正的模型数据结构所在