API 参考 / registry 包:注册表与资源标识
registry 包:注册表与资源标识
registry 包定义了模组贡献内容的唯一通道:一张插入有序、启动期可写、之后永久冻结的注册表(Registry),以及它使用的两种不可变身份类型——带命名空间的资源标识 ResourceLocation 与「资源标识 + 值类型」的注册键 RegistryKey。全部注册表统一收拢在 ModRegistries 中,模组在 onPreInit 内经 ctx.registries() 一次性写入。冻结后再写会抛 RegistryFrozenException,这是刻意的严格模型。
本分类覆盖 com.seecmd.mod.api.registry 的全部五个类型,以及 collect 包中的收集品定义 CollectibleDefinition。阅读顺序建议:先看 ResourceLocation 的格式约束,再看 RegistryKey,最后看 Registry 的写入/读取契约。