Skip to content

Dev coolfish#39

Merged
ifishcool merged 5 commits into
mainfrom
dev_coolfish
May 12, 2026
Merged

Dev coolfish#39
ifishcool merged 5 commits into
mainfrom
dev_coolfish

Conversation

@ifishcool
Copy link
Copy Markdown
Contributor

No description provided.

ifishcool added 5 commits May 12, 2026 10:52
- 引入全新的 `audio` 全局对象,提供完整的音频控制功能
- 添加 audio.playSound() 用于播放音效(SoundSource.PLAYERS 分类)
- 添加 audio.playMusic() 用于播放音乐(SoundSource.MUSIC 分类)
- 添加 audio.stopAll() 用于停止所有正在播放的声音和音乐
- 添加 audio.getVolume() 和 audio.setVolume() 用于音量控制
- 支持多种音频分类:master、music、record、weather、block、hostile、neutral、player、ambient、voice
- 将音频相关功能从 `client` 对象迁移至专用的 `audio` 对象
- 更新 README 和 API 文档以反映此次变更
- 将示例代码中的 client.playSound() 引用更新为 audio.playSound()
- 为新音频 API 添加完整的 TypeScript 类型定义

BREAKING CHANGE: client.playSound() 已迁移至 audio.playSound()
- 将 Box3JS 模组元数据替换为 Color Zone 模组配置
- 在 neoforge.mods.toml 中添加 neoforge 和 box3js 依赖
- 设置模组显示名称为 "Color Zone",并添加领土争夺模组描述
- 添加致谢信息、展示 URL、问题追踪 URL 及 logo 文件

BREAKING CHANGE: 模组已从 Box3JS 完全重构为 Color Zone

refactor(api): 使用自定义注册系统替换自定义物品 API

- 移除 world.loadCustomItems() API 及相关功能
- 移除 player.giveCustomItem() 方法
- 引入 registries 全局对象,支持方块、物品和声音的注册
- 添加 JSON 配置文件:blocks.json、items.json、sounds.json 和 creativeTabs.json
- 通过 /box3script compile 实现编译时注册表注册
- 更新文档以反映基于注册表的新方案

BREAKING CHANGE: 移除自定义物品 API,请改用 registries 系统

feat(project): 拆分 TypeScript 配置,支持客户端-服务端架构

- 将 tsconfig.json 拆分为 tsconfig.base.json、tsconfig.server.json 和 tsconfig.client.json,优化项目结构
- 将服务端和客户端源代码分别置于 src/server/ 和 src/client/ 目录下
- 新增 client.js 编译输出,支持客户端脚本
- 更新构建流程,同时处理服务端和客户端打包
- 为各目标环境添加正确的 TypeScript 配置

docs: 更新自定义注册系统文档及 API 变更说明

- 更新 README.md 和 README_en.md,反映自定义注册系统新特性
- 新增 registries.md 文档,说明自定义方块/物品/声音的注册方式
- 更新 API 参考文档,补充 registries 全局对象说明
- 修改教程引用,移除自定义物品相关描述
- 更新 commands.md,说明包含资源的新版 JAR 编译格式
- 文档中说明 registries 仅限服务端使用,客户端脚本无法访问
- 将类型定义整理到独立的 server/ 和 client/ 目录中
  按具体类别分类(服务端:entity/player/world/voxels,
  客户端:audio/input/ui/chat)

- 新增文档章节,包括入门指南、架构概述以及 JS 与 Java 模组开发对比

- 更新 API 文档,采用基于领域的分类方式和全面的 API 参考表

- 精简模板注册表配置,移除过多的示例条目

- 更新 README 文件中的导航链接,指向新的文档结构
更新 README_en.md 中的教程文档链接,为所有教程文件添加 _en 后缀,确保语言特定文件的引用正确。
- 新增常用功能模式(食谱)指南,包含经济系统、传送点、商店、每日奖励、排行榜及 Webhook 等功能模板
- 新增常见问题(FAQ)章节,涵盖脚本加载、构建、运行时、数据库、HTTP、客户端及部署等相关问题
- 新增客户端脚本教程,涵盖键盘输入、屏幕界面、音效/音乐、本地存储、SQLite、HTTP 及 remoteChannel 等内容
- 更新英文文档,确保正确引用带 _en.md 后缀的文件
- 修复教程链接,指向正确语言版本的文件
@ifishcool ifishcool merged commit acc1be5 into main May 12, 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