Skip to content

Dev coolfish#34

Merged
ifishcool merged 4 commits into
mainfrom
dev_coolfish
May 7, 2026
Merged

Dev coolfish#34
ifishcool merged 4 commits into
mainfrom
dev_coolfish

Conversation

@ifishcool
Copy link
Copy Markdown
Contributor

No description provided.

ifishcool added 4 commits May 7, 2026 13:27
- 新增 world.createEntity() 和 world.searchBox() 到实体创建方法说明
- 明确 entity.player 仅对玩家实体非空,其他情况为 null
- 将"基础属性"重命名为"基础身份标识"
- 添加 entity.id 的 UUID 格式示例,并阐明 entity.player 的关联关系
- 优化 LiveVec3 在位置和速度属性上的说明,增加强调
- 添加详细的包围盒描述,包含各轴向拆解
- 明确 onGround 用于判断实体是否站在方块表面
- 更新 hp/maxHp 对 LivingEntity 的处理说明
- 新增物理属性:destroyed、collides、fixed、gravity、friction、mass、restitution,并附示例
- 增强外观属性描述
- 改进标签系统文档,标明 tags() 的返回值类型
- 添加详细的装备槽位对照表
- 更新生命周期方法说明,补充回调细节
- 添加自定义属性持久化存储说明
BREAKING CHANGE: entity.remove() 方法已被移除,因其功能与 entity.destroy() 重复。
该方法可直接移除实体而不触发回调,但该功能使用不一致且易造成混淆。
用户应改用 entity.destroy(),该方法能正确处理 onDestroy 回调。

以下文件已同步更新以反映此变更:
- 实体方法 API 文档
- 英文 API 文档
- BOX3 API 对照表
- Java 源代码实现
- 新增 player.giveCustomItem() 方法,可通过 world.loadCustomItems() 加载的自定义物品配置发放物品,使用 DataComponents 组件系统
- 实现 world.loadCustomItems() 方法,用于从资源包中的 items.json 加载自定义物品定义
- 新增 player.grantAdvancement() 与 player.revokeAdvancement() 方法
- 新增 world.grantAdvancement() 方法,可向玩家授予进度
- 新增 world.placeStructure() 方法,用于放置数据包中的结构
- 新增配方管理方法:listRecipes()、removeRecipe()、clearRecipes()
- 为所有新增 API 方法添加完整文档
- 更新 TypeScript 声明文件以支持新功能
- 修改聊天系统,支持通过返回值取消消息
- 为玩家对象添加 position、velocity、bounds 与 onGround 属性
- 在中英文 README 文件中新增完整教程章节,提供从入门到高级系统的逐步指南
- 包含教程文档链接,涵盖基础概念、玩家/物品、事件/实体、高级系统及实战示例
- 更新主 README,引用新的教程文档
- 新增详细的 Box3JS 脚本引擎章节,包含快速入门指南、命令速查表、沙箱系统说明及 API 概览
@ifishcool ifishcool merged commit 1d84f55 into main May 7, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant