Celeritas mixin 分组(40 个)
概览
| 属性 | 值 |
|---|---|
| 源文件位置 | src/mixin/java/com/gtnewhorizons/angelica/mixins/early/celeritas/ |
| 文件数 | 40 |
| 顶层文件 | 0(全部在子包内) |
| Phase | EARLY |
| 主题 | Celeritas —— Angelica 内置的 1.7.10 地形渲染重写 |
Celeritas 没有自己的 @Mod 注解,不是独立 modid;它是 Angelica 渲染管线的内部组成部分。
目录构成
| 子包 | 文件数 | 主题 |
|---|---|---|
terrain |
17 | 地形分块网格构建(最大子包) |
features |
7 | 特性:含 culling 1、mipmaps 3、textures 3 |
light |
6 | 光照引擎 |
biome_blending |
5 | 群系颜色混合 |
frustum |
3 | 视锥剔除 |
debug |
1 | 调试 |
threading |
1 | 线程化(对应 AngelicaConfig.enableThreadedChunkBuilding 与 chunkBuilderThreadCount) |
| 合计 | 40 |
注册名去重后按两段包名归并也是同样的分布:celeritas.terrain 17、celeritas.features 7、celeritas.light 6、celeritas.biome_blending 5、celeritas.frustum 3、celeritas.debug 1、celeritas.threading 1。两套口径一致,可以互相印证。
独立注册名(无子包前缀)
3 个注册名是裸类名,不写包前缀:
celeritas.debug.MixinXxx
celeritas.threading.MixinXxx
其余均带子包前缀。
混合地形缓冲(MBI)
biome_blending 的 5 个 mixin 实现 1.7.10 上不存在的「按群系混合颜色」能力 —— 原版 1.7.10 地形着色是按单一生物群系取色,Modern Minecraft 1.13+ 的 MBI 才引入。Angelica 在 1.7.10 上用 mixin 补出了这一特性。
对应的配置入口是 GpuCullingMode(CPU_ONLY / COMPUTE)与 AngelicaConfig.applyGpuCullingMode(),见 AngelicaModulesConfig。
线程化
threading 子包只有 1 个 mixin,但对应的功能有两条独立配置:
| 配置 | 默认 | 含义 |
|---|---|---|
enableThreadedChunkBuilding |
true |
多线程分块构建(RequiresWorldRestart) |
chunkBuilderThreadCount |
0 |
线程数;0 = 自动探测,-1 = 单线程回退(RangeInt(-1, 16)) |
运行时由 ClientProxy.java:156 的 CeleritasSetup.ensureInitialized() 启动。
调试钩子
CeleritasDebugScreenHandler(rendering.celeritas.CeleritasDebugScreenHandler)在 ClientProxy.java:167 被注册到 EVENT_BUS。SystemProperties 里有一条专门给 Celeritas 的 key(celeritas.enableGLDebug,注释写明「Set by us, read by celeritas」),但值的写入方在本仓内未找到。
相关条目
- Angelica mixin 分组 - 122 个
- Mixin 注册表 - 53 组枚举
- CeleritasBlockTransformer - ASM 侧的方块渲染变换
- SystemProperties -
celeritas.*系统属性 - AngelicaModulesConfig - 线程化与 GPU 剔除开关