版本 6.1.1:
修复
- 修复了
C2SSelfMessagingComponent#sendC2SMessage错误地将组件 ID 添加到自定义数据缓冲器的问题 - 移除了对
com.demonwav.mcdev:annotations的依赖 - 这应该会消除开发环境中的一些错误
完整更新日志请参阅此处
版本 6.0.0:
已更新至 1.20.5/1.20.6
本次更新引入了多项破坏性变更——迁移指南可在 Ladysnake 官网 查看。
新增内容
- 新增
C2SSelfMessagingComponent,一个新的实验性工具接口,用于简化玩家组件上的客户端到服务器消息传递 - 新增
WorldComponentRegistry#registerFor方法,支持针对特定维度的世界组件 - 记分板和队伍组件现在支持客户端 tick
变更
- 所有包名从
dev.onyxstudios迁移至org.ladysnake - 更新了文档和许可证以反映包名变更
RespawnCopyStrategy现在也会在生物转化时生效cardinal-components-level模块现已弃用,因为它与cardinal-components-scoreboard模块功能重复- 建议模组开发者迁移到记分板组件,它们同样用于全局数据存储,且 API 与其他模块更加一致
- 组件注册现在发生在模组初始化阶段。这应该能修复一些与类加载相关的问题,并使加载错误更容易诊断。
- 内部 ASM 生成系统已部分重写(感谢 lukebemish!)
- 所有序列化方法现在都接受一个额外的注册表查询参数
- 警告:由于上述变更,如果模组调用
LevelProperties.readProperties而非LevelStorage.parseSaveProperties,等级存储组件可能无法正确反序列化
修复
- 缺失的组件(通常由移除模组导致)将不再触发大量警告
- 每种缺失组件类型记录的警告数量可配置
移除内容
- 移除了物品组件。
cardinal-components-item模块现在包含一个ItemComponentMigrationRegistry,用于帮助你迁移到原版组件。 - 移除了
PlayerCopyCallback——如果你之前在使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM cardinal-components-block中已弃用的util包已被移除
完整更新日志请见此处
版本 6.0.0:
已更新至 1.20.5/1.20.6
本次更新引入了多项重大更改——迁移指南可在 Ladysnake 官网查看。
候选发布版 1
修复
- 修复了重生复制策略未在玩家实体上正确注册的问题
预发布版 3
修复
- 缺失的组件(通常由模组被移除导致)不再会触发一大堆警告
- 每种缺失组件类型记录的警告数量可配置
预发布版 2
修复
- 该库不再要求在开发工作区中使用 Loom 1.7-alpha
预发布版 1
更改
- 组件注册现在在模组初始化阶段进行。这应能修复一些与类加载相关的问题,并使加载错误更易于诊断。
- 内部 ASM 生成系统已被部分重写(感谢 lukebemish!)
Beta 3
修复
- 修复了与为 beta 1 编译的模组之间最基础的二进制不兼容问题
Beta 2
更改
- 所有序列化方法现在都接受一个额外的注册表查找参数
- 警告:由于上述更改,如果模组调用
LevelProperties.readProperties而不是LevelStorage.parseSaveProperties,等级组件可能无法正确反序列化
移除
cardinal-components-block中已弃用的util包已被移除
Beta 1
新增
- 新增
C2SSelfMessagingComponent,一个新的实验性工具接口,用于简化玩家组件上的客户端到服务端通信 - 新增
WorldComponentRegistry#registerFor方法,支持维度专属的世界组件 - 计分板和队伍组件现在支持客户端刻(tick)
更改
- 所有包已从
dev.onyxstudios迁移至org.ladysnake - 更新了文档和许可证以反映包结构的变更
RespawnCopyStrategy现在也适用于生物转换cardinal-components-level现已被弃用,因为它与cardinal-components-scoreboard模组功能重复- 建议模组迁移到计分板组件,其用途与全局数据存储相同,且 API 与其他模块更加一致
移除
- 移除了物品组件。
cardinal-components-item模块现在包含一个ItemComponentMigrationRegistry,用于帮助你迁移到原版组件。 - 移除了
PlayerCopyCallback——如果你正在使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM
完整更新日志请见此处
6.0.0-pre2
on 2026 Nov 046.0.0 版本:
已更新至 1.20.5/1.20.6
本次更新引入了多个破坏性变更 - 迁移指南可在 Ladysnake 官网 查看。
预发布版 2
修复
- 该库在开发环境中不再需要使用 Loom 1.7-alpha
预发布版 1
变更
- 组件注册现在在模组初始化期间进行。这应能修复一些与类加载相关的问题,并使加载错误更易于诊断。
- 内部 ASM 生成系统已部分重写(感谢 lukebemish !)
Beta 3
修复
- 修复了与基于 beta 1 编译的模组之间最基本的二进制不兼容问题
Beta 2
变更
- 所有序列化方法现在都接受一个额外的注册表查询参数
- 警告:由于上述变更,如果模组调用
LevelProperties.readProperties而非LevelStorage.parseSaveProperties,维度组件可能无法正确反序列化
移除
cardinal-components-block中已弃用的util包已被移除
Beta 1
新增
- 新增
C2SSelfMessagingComponent,一个新的实验性工具接口,用于简化玩家组件上的客户端到服务端通信 - 新增
WorldComponentRegistry#registerFor方法,支持针对特定维度的世界组件 - 计分板和队伍组件现在支持客户端刻(tick)处理
变更
- 所有包名已从
dev.onyxstudios迁移至org.ladysnake - 更新了文档和许可证以反映包名变更
RespawnCopyStrategy现在也适用于生物转化cardinal-components-level现已弃用,因为它与cardinal-components-scoreboard模块功能重复- 建议模组迁移至计分板组件,其用途与全局数据存储相同,且 API 与其他模块更加一致
移除
- 移除了物品组件。
cardinal-components-item模块现在包含一个ItemComponentMigrationRegistry,用于帮助你迁移至原版组件。 - 移除了
PlayerCopyCallback- 如果你曾使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM
完整更新日志请参见此处
6.0.0-pre1
on 2026 Nov 04版本 6.0.0:
已更新至 1.20.5/1.20.6
本次更新包含多个破坏性更改 - 迁移指南可在 Ladysnake 官网查看。
预发布版 1
更改
- 组件注册现在发生在模组初始化阶段。这应该能修复一些与类加载相关的问题,并让加载错误更容易诊断。
- 内部 ASM 生成系统已被部分重写(感谢 lukebemish!)
Beta 3
修复
- 修复了与针对 beta 1 编译的模组之间最基础的二进制不兼容问题
Beta 2
更改
- 所有序列化方法现在都需要一个额外的注册表查询参数
- 警告:由于上述更改,如果模组调用
LevelProperties.readProperties而不是LevelStorage.parseSaveProperties,等级组件可能无法被正确反序列化
移除
cardinal-components-block中已弃用的util包已被移除
Beta 1
新增
- 新增
C2SSelfMessagingComponent,一个新的实验性工具接口,用于简化玩家组件上的客户端到服务端通信 - 新增
WorldComponentRegistry#registerFor方法,允许注册维度专属的世界组件 - 记分板和队伍组件现在支持客户端 tick
更改
- 所有包已从
dev.onyxstudios迁移至org.ladysnake - 更新了文档和许可协议以反映包路径的变化
RespawnCopyStrategy现在也适用于生物转化cardinal-components-level现已弃用,因为它与cardinal-components-scoreboard模块功能重复- 建议模组迁移到记分板组件,它同样用于全局数据存储,且 API 与其他模块更加一致
移除
- 移除了物品组件。
cardinal-components-item模块现包含一个ItemComponentMigrationRegistry,用于帮助你迁移到原版组件。 - 移除了
PlayerCopyCallback- 如果你曾使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM
完整更新日志请见此处
6.0.0-beta.3
on 2026 Nov 04版本 6.0.0:
已更新至 1.20.5
本次更新引入了多项重大破坏性变更 —— 迁移指南可在 Ladysnake 官网查看。
Beta 3
修复
- 修复了与针对 beta 1 编译的模组之间最基本的二进制不兼容问题
Beta 2
变更
- 所有序列化方法现在都需要一个额外的注册表查找参数
- 警告:由于上述变更,如果模组调用
LevelProperties.readProperties而非LevelStorage.parseSaveProperties,等级组件可能无法被正确反序列化
移除
- 已移除
cardinal-components-block中已弃用的util包
Beta 1
新增
- 新增
C2SSelfMessagingComponent,一个用于简化玩家组件上客户端到服务器通信的全新实验性工具接口 - 新增
WorldComponentRegistry#registerFor方法,支持特定维度的世界组件 - 记分板和队伍组件现在支持客户端 tick
变更
- 所有包已从
dev.onyxstudios迁移至org.ladysnake - 更新了文档和许可证以反映包路径变更
RespawnCopyStrategy现在也适用于生物转换cardinal-components-level现已弃用,因为它与cardinal-components-scoreboard模块功能重复- 建议模组迁移至记分板组件,其用途与全局数据存储相同,且 API 与其他模块更加一致
移除
- 移除了物品组件。
cardinal-components-item模块现在包含一个ItemComponentMigrationRegistry,用于帮助你迁移到原版组件。 - 移除了
PlayerCopyCallback—— 如果你正在使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM
完整更新日志请见此处
6.0.0-beta.2
on 2026 Nov 046.0.0 版本:
已更新至 1.20.5
本次更新包含多项重大变更 - 迁移指南可在 Ladysnake 官网 查看。
Beta 2
变更
- 所有序列化方法现在都需要一个额外的注册表查找参数
- 警告:由于上述变更,如果模组调用
LevelProperties.readProperties而非LevelStorage.parseSaveProperties,等级组件可能无法正确反序列化
移除
cardinal-components-block中已弃用的util包已被移除
Beta 1
新增
- 新增
C2SSelfMessagingComponent,一个全新的实验性工具接口,用于简化玩家组件上的客户端到服务端通信 - 新增
WorldComponentRegistry#registerFor方法,支持维度专属的世界组件 - 记分板和队伍组件现在支持客户端刻更新
变更
- 所有包已从
dev.onyxstudios迁移至org.ladysnake - 文档和许可证已更新以反映包的变更
RespawnCopyStrategy现在也适用于生物转化cardinal-components-level现已弃用,因为它与cardinal-components-scoreboard模块功能重复- 建议模组迁移至记分板组件,其用途与全局数据存储相同,且 API 与其他模块更加一致
移除
- 移除了物品组件。
cardinal-components-item模块现在包含一个ItemComponentMigrationRegistry,用于帮助你迁移到原版组件。 - 移除了
PlayerCopyCallback- 如果你正在使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM
完整更新日志请见此处
6.0.0-beta.1
on 2026 Nov 04版本 6.0.0:
已更新至 1.20.5
本次更新引入了多项破坏性更改 - 迁移指南可在 Ladysnake 官网查看。
新增内容
- 新增
C2SSelfMessagingComponent,一个新的实验性工具接口,用于简化玩家组件上的客户端到服务端通信 - 新增
WorldComponentRegistry#registerFor方法,支持维度专属的世界组件 - 记分板和队伍组件现在支持客户端 tick
更改
- 所有包名从
dev.onyxstudios迁移至org.ladysnake - 更新了文档和许可证以反映包名变更
RespawnCopyStrategy现在也会在生物转化时生效cardinal-components-level模块现已弃用,因为它与cardinal-components-scoreboard模块功能重复- 鼓励模组开发者迁移到记分板组件,其用途同样是全局数据存储,且 API 与其他模块更加一致
移除内容
- 移除了物品组件。
cardinal-components-item模块现在包含一个ItemComponentMigrationRegistry,用于帮助你迁移到原版组件。 - 移除了
PlayerCopyCallback- 如果你之前在使用它,可以改用 Fabric API 中的ServerPlayerEvents.COPY_FROM
完整更新日志请见此处
版本 5.2.2:
修复了区块组件在反序列化过程中丢失的问题(感谢 Stuff-Stuffs!)
完整更新日志请见[此处](https://github.com//Cardinal Components Api/blob/5.2.2/changelog.md "Changelog")



