Skip to content

Dev coolfish#43

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

Dev coolfish#43
ifishcool merged 4 commits into
mainfrom
dev_coolfish

Conversation

@ifishcool
Copy link
Copy Markdown
Contributor

No description provided.

ifishcool added 4 commits May 18, 2026 13:13
将中英文文档中的客户端数据库路径从 `box3/client-db/<project>.db` 更新为 `config/box3/client-db/<project>.db`

feat(database): 将客户端数据库移至 config 目录

将客户端数据库文件从 `<gameDir>/box3/client-db/` 移至 `<gameDir>/config/box3/client-db/`,以优化组织结构并与其他配置文件保持一致

docs(storage): 更新文档中的客户端存储路径

将中英文文档中的客户端存储路径从 `box3/client-storage/<project>/` 更新为 `config/box3/client-storage/<project>/`

refactor(storage): 将客户端存储移至 config 目录

将客户端存储文件从 `<gameDir>/box3/client-storage/` 移至 `<gameDir>/config/box3/client-storage/`,与新的数据库位置保持一致

style(database): 改进文档中的表格格式

调整数据库 API 文档中的表格列宽和对齐方式,优化表格格式,提升可读性

style(storage): 修复对比章节中的表格格式

修复数据库与存储对比章节中的表格格式问题,优化视觉呈现效果
- 将静态文件列表替换为基于资源的动态枚举
- 添加从 JAR 和目录两种来源复制模板的支持
- 使用 JarFile 和 Files.walk 实现递归文件遍历
- 为资源解析添加适当的错误处理

refactor(registries): 更新方块定义,增加渲染类型支持

- 为 BlockDef 记录添加 renderType 属性,支持 cutout/translucent 类型方块
- 在模板中添加具有相应属性的新示例方块
- 将 chocolate item 重命名为 chocolate_bar 以保持一致性

chore(template): 更新示例内容,支持占位符替换

- 将旧示例方块替换为新的 star_lamp、rainbow_cube 等
- 更新语言文件,使用 PROJECT_NAME 占位符
- 修改工具验证逻辑,检查递归枚举实现情况
- 添加针对 NeoForge 命名规范的 modId 验证(正则:^[a-z][a-z0-9_]{1,63}$)
- 在 create 和 compile 命令中验证项目名称
- 当 modId 无效时显示详细的错误信息
- 在常见问题(FAQ)和入门指南中添加 modId 命名规范说明
- 实现客户端渲染类型注册,支持 cutout/translucent 类型的方块
- 为具有透明纹理的自定义方块生成正确的渲染层调用
- 移除模板模型中硬编码的 render_type,以便正确注册渲染类型

这些变更确保项目遵循 NeoForge 的 modId 标准,并正确处理灯饰和彩虹方块等透明材质的方块渲染。

修复了因渲染层处理不当导致自定义方块显示为黑色或偏暗的问题。
- 新增 modId 命名规范警告章节,正则表达式为 ^[a-z][a-z0-9_]{1,63}$
- 包含验证要求:首字符必须小写字母,仅允许小写字母/数字/下划线
- 明确长度限制为 2-64 个字符,并说明禁止使用的特殊字符
- 添加有效与无效 modId 格式的示例
- 为 package.json 中的 modId 字段增加编译时验证警告
@ifishcool ifishcool merged commit 358dd2a into main May 18, 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