文档可以在 ReadTheDocs 网站上找到。

所有加载器

• JAVA 21+
• Architectury 13.0.8+

Fabric

• Fabric Loader >= 0.16.9
• Fabric API >= 0.110.0+1.21。

NeoForge

• NeoForge 21.1.84+

AI 使用声明

这一部分有点长，因为这是我第一次写。在后续版本中应该会更短。:)

从 1.21.1-0.4.6 开始，我使用 AI 来辅助模组开发（如果你感兴趣的话，我用的是 Claude Code Pro）。为了提供更多背景信息，我是一名拥有近 40 年行业经验（如果算上高中时期和其他个人项目则是 50 年）的软件工程师，主要从事后端系统开发。我个人认为 AI 在模组开发中有一席之地，但挑战在于如何“正确”运用它的“智慧”和“经验”（注意所有的引号）。此外，不同 AI 模型的工作成果在质量上存在差异，而用户如果缺乏软件经验，就有发布低质量作品的风险。遗憾的是，对于这种情况我无能为力，只能对我的 AI 使用保持透明。（我了解关于 AI 的更广泛讨论/争议。）

如果你对我的 AI 使用经验有建设性的反馈或问题，欢迎在这里评论。

以下是我使用 AI 的细节及其对模组的影响，以便你做出明智的决定。我希望以此展示 AI 除了“帮我生成贴图”或“做一个像那个模组的模组，然后冒充自己的作品发布”之外的应用方式。

概要：

• 代码审查：发现错误、性能问题以及不符合最佳实践的地方
• 重构：重构代码使其可进行单元测试（隔离、模拟）、删除重复代码、清理配置处理
• 测试：编写大量的单元测试
• GUI：使模组的界面与 Minecraft 自身界面的工作方式保持一致
• 模组兼容性：分析模组与其他模组的交互方式并进行改进
• 视觉效果：重做了噪点纹理，添加了粒子渐变模块，并集成了旧版本中基于着色器的极光
• 前瞻规划：规划迁移到 Minecraft 26.2 的路径，使其更容易、更不容易出错

成果：

测试与可维护性

• 添加了 1400 多个单元测试来验证内部逻辑
• 进行重构，用注入取代静态引用
• 发现重复代码并重构以消除冗余
• 删除了死代码，或实际上没有提供任何价值的代码（总是返回 true、没有任何实质贡献的代码等）
• 为需要说明的未注释方法添加了注释

性能

• 脚本引擎性能提升约 40%
  • 修复了区域方块事件扫描器中的性能问题，使其速度提高约 50%
    • 有很多情况下它会进行不必要的双重扫描
  • 发现了 Minecraft 生物群系过渡距离的行为，并调整区域生物群系扫描器以加以利用，将采样数量减少 85%
  • 提升了瀑布和 RC 蒸汽输出器效果系统的性能与资源占用
  • 尽可能减少了声音效果引擎（混响）的计算
    • 基本上，只有在任何关键因素发生变化时才进行计算，比如玩家方块位置、区域内方块状态的改变等。
  • 添加了一个注解处理器来生成事件循环实现，而不是使用肌肉反射（更少的开销，无需分配内存）
    • 这是针对模组内部事件系统，而非 Architectury/Fabric/NeoForge
  • 修复了 GUI 渲染性能问题

可靠性

• 修复了缓存未正确刷新或数据持有超出作用域对象（如实体）引用的边缘情况
• 在重复错误可能刷屏日志的地方添加了节流阀
• 改进了脚本和 json 配置的错误检测与报告
• 模组配置逻辑可以处理手动编辑产生的错误输入，并在配置文件中写入注释
• 提升了 Markdown 解析的健壮性和性能（声音制作组对话框）
• 对依赖注入条目进行验证，以便在启动过程中更早地检测到循环依赖（循环引用）（这是开发辅助功能，而非玩家端的问题）

特性

• 瀑布白雾和奶泡、萤火虫的发光与照明，以及极光的回归（详见新功能）

新功能

• 添加了 /dsversion 命令，可以从我的 GitHub 查询版本状态并在本地聊天中报告。回复中将包含可点击的链接，方便你前往各种信息来源。无论登录时的聊天报告是否禁用，该命令都有效。（一些整合包作者会禁用客户端登录时的聊天报告。）
• 在声音选项对话框中添加了“声音制作组”按钮。点击后将显示模组中声音的制作与来源信息。（这些信息也隐藏在声音配置菜单中悬停于声音上时的工具提示中。）
• 人形生物获得踩踏草丛效果和踩踏稻草效果（骷髅、僵尸、劫持者等）。很抱歉没有做苦力怕。
• 清理了模组配置处理
  • 写出配置文件时为字段添加注释。用户注释将不会被保留。
  • 添加了在加载配置时将现有设置迁移到新字段的机制
• 极光回归了。配置中有一组选项可以启用/禁用、调整频率以及最大光带数量。
  • 新版本的渲染计算量约为原来的 1/10（不再是一台电脑暖炉）
  • 站在寒冷/冰雪/针叶林生物群系时会显示在北方天空中
  • 有一个新的极光配置部分，可以在其中启用/禁用以及修改其他属性
  • 如果安装了鸢尾花或眼球，将自动禁用。
• 瀑布白雾（取代了相对较新的 CASCADE 层叠效果）和水体奶泡。
  • 白雾 - 在瀑布落水处底部旋转（下落的水撞击表面）
  • 奶泡 - 当水从方块上流下或水撞击表面时生成。奶泡会随水流方向流动并最终消散。
  • 选项位于配置的瀑布选项部分。（之前的设置（如有）将被迁移。）
  • 如果安装了鸢尾花或眼球，着色器混合将自动禁用。
• 刷新了萤火虫效果，使其行为更像萤火虫；在它们周围添加了微微照亮周围区域的光晕。
  • 选项位于萤火虫选项部分。（之前的设置（如有）将被迁移。）
  • 如果安装了鸢尾花或眼球，着色器照明将自动禁用。
• 扩展了动态环绕的调试 HUD。如果绑定了按键，按下它可以在普通 HUD、玩家生物群系信息和世界中的效果系统放置位置之间切换。

更改

• 独立声音配置菜单中的搜索框将接受正则表达式进行过滤
• 将默认混响射线距离从 256 减少到 128
  • 现有配置仍将是 256（因为新的上限是 256），所以如果你愿意可以自行调低
  • 数学模型和测试表明，超过 110 只会对声音产生微小的改善
• 确保所有动态环绕的脚步声都是单声道，并移除了即时单声道转换支持
• 移除了瀑布 CASCADE 层叠效果，因为它已被白雾和奶泡取代
• 将 26.2 中的迷雾计算器更改向后移植到 1.21.1
  • 生物群系迷雾应该更柔和
  • 世界迷雾被纳入考虑
• 玩家资源包中的配置无论其命名空间如何都会被读取，因此资源包可以自带声音及其播放配置（例如 dsurround_ex 下的 Dynamic Surroundings Extended）

修复

• 更换世界时（如切换维度）某些缓存未正确刷新
• 缓存持有直接引用超出应有时间的边缘情况（如实体）
• 与来自外部来源的配置数据的验证和处理相关的情况（更好的错误报告等）
• 玩家在水下时声音效果被正确地抑制
• 混响计算中的一些数学运算存在损耗，导致声音有点闷（约 8 - 20%，取决于环境）
  • 我自己听不出直接的区别，但似乎聆听体验有所改善
• 水下的呼吸效果回归了（会吐出气泡）
  • 如果呼吸效果被禁用，此功能也将被禁用。
• 修复了加入远程服务器时未检测到标签同步且动态环绕标签缓存未清除的问题