我们很高兴为《我的世界》1.7.10 带来图腾模组的全新版本！

这是一次重大更新，将图腾模组过去十年间新增的众多功能回溯移植到了 1.7.10 版本。本次更新加入了全新的仪式、图腾效果、生物以及其他内容。尤为值得一提的是，进程系统已全面升级，并与新版本《我的世界》中的进程系统保持一致。

当前版本尚属早期开发阶段，仍在持续完善中，可能存在不稳定情况。若您遇到崩溃或其他问题，请务必提交至我们的问题追踪页面（请注明所使用的《我的世界》版本及模组版本）：https://github.com/TeamTotemic/Totemic/issues

祝您游戏愉快，仪式顺利！

• 仪式类别的图腾百科条目现在需要先获得相应的乐器才能解锁。这将减少新手玩家的信息过载，仅显示当前可执行的仪式。
  • 吉格尔舞裙的图腾百科条目现在将与风铃条目同时解锁。
  • 如果更新后出现乐器或仪式条目异常锁定的情况，只需将相关乐器放入物品栏即可解锁。
• 新增服务器配置选项 medicineBagBlacklist，可用于指定不允许在药囊中使用的图腾雕刻。
• 为药囊添加了打开、关闭以及设置雕刻时的音效。
• 修复了仪式HUD中音乐进度条可能溢出的视觉错误。
• 添加了 KubeJS 集成功能（文档待补充）。
  • 使用方式与 1.21.1 版本大致相同，但有一个重要区别：由于 KubeJS 在 1.20.1 中存在限制，无法使用 KubeJS 的 StartupEvents.registry 来注册图腾主义内容。请改用 TotemicEvents.registerMusicInstruments 等专用事件。

API 变更：请参见 1.21.1-0.12.18 版本说明。

• 仪式类别的图腾百科条目现在需要获得相应的乐器后才会解锁。这将减少新手玩家的信息过载，仅显示当前可执行的仪式。

  • 吉格尔舞裙的图腾百科条目现在将与风铃条目同时解锁。
  • 如果更新后出现乐器或仪式条目错误地被锁定的情况，只需将相关乐器放入物品栏即可解锁。

• 新增服务器配置选项 medicineBagBlacklist，可用于指定不允许在药囊中使用的图腾雕刻。

• 为药囊增加了打开、关闭以及设置雕刻时的音效。

• 修复了红雪松树叶无法使用模组剪刀收割的问题（现在任何具有 "shears_dig" 工具能力的工具都可以收割）。

• 修复了仪式HUD中音乐进度条可能出现溢出的视觉错误。

• 扩展了 KubeJS 集成功能（仍为实验性）：

  • 现在可通过 StartupEvents.registry 使用注册键 'totemic:a_instrument'、'totemic:c_totem_carving' 和 'totemic:d_ceremony' 分别创建新的乐器、图腾雕刻和仪式（前缀字母是必要的，以确保正确的注册顺序）。
  • 新增 TotemicEvents.modifyTotemCarvings 事件。
  • 现在可通过 TotemicEvents.ceremonyEffectTick 修改仪式效果的持续时间。

API 变更：

• 对 TotemCarving 及相关类进行了全面重构。PortableTotemCarving 和 MedicineBagEffect 已被移除，并分别合并至 TotemCarving 和 TotemEffect，大幅简化了系统结构。
• 移除了 TotemEffectEvent 和 MedicineBagEffectEvent，改由 TotemCarving 上的 setter 方法进行替代。
• 新增用于修改仪式的 setter 方法。
• 现在可通过 CeremonyEvent.EffectTick 修改仪式效果的持续时间。

• 添加了配置选项 ceremonyStartupTimeMultiplierEasy、...Normal 和 ...Hard，这些选项允许针对每个难度简单调整仪式启动时间
  • 当你加载世界或启动服务器时，这些选项将出现在“<save folder>/serverconfig/totemic-server.toml”中
• (@HanJiang-cn) 更新了简体中文翻译

注意：由于 KubeJS 的 API 存在重大差异，我将在 1.21.1 中集成更稳定之前，暂不添加 1.20.1 的 KubeJS 集成。

长期以来，一直有人请求能够调整乐器、仪式和其他内容的能力，现在我们终于通过添加与 KubeJS 的集成来实现这一点。这仍然是实验性的，非常感谢反馈和建议。

目前，Totemic 提供了启动事件TotemicEvents.modifyMusicInstruments和modifyCeremonies，以及几个用于挂钩仪式的服务器和客户端事件，例如ceremonyEffectTick。

目前还没有文档，但现在您可以查看测试脚本，以了解如何使用这些事件。

由于我计划首先对代码进行重大更改以解决一些问题，因此目前尚不支持更改图腾效果。

进一步的更改：

• 添加了配置选项ceremonyStartupTimeMultiplierEasy、...Normal和...Hard，这些选项允许在没有 Kube 的情况下简单地调整每个难度的仪式启动时间
• 这些选项将在您加载世界或启动服务器时出现在"totemic-server.toml"中
• （@HanJiang-cn）更新了简体中文翻译

• 图腾基座现在在仪式期间将根据启动仪式所需的音乐发出比较器信号。
• （注意：Forge 在 1.20.1 中不提供配置 GUI）

API 更改：

• 为仪式和图腾效果添加了几个事件。计划通过 KubeJS 集成公开这些事件。

• 图腾基座现在将在仪式期间根据启动仪式所需的音乐发出比较器信号。
• 除了 customTotemWoodTypes 之外的配置选项现在可以在配置 GUI 中编辑。

API 更改：

• 为仪式和图腾效果添加了几个事件。计划通过 KubeJS 集成公开这些事件。

此更新包含一些添加项，通过数据包在与其他模组的交互方面允许更多自定义。这对于模组包和其他模组的开发者可能特别有用。

• 添加了新的实体类型标签：
  • buffalo_dance_targets 和 eagle_dance_targets：这些生物将分别通过相应的仪式转换为水牛和白头海雕。
  • hymn_of_maturity_blacklist：这些动物将被排除在成熟之歌的婴儿生长加速之外。
• （注意：1.20.1 中不支持数据映射，因此这里不提供史蒂夫摇篮曲的自定义。）
• 修复了使用功能标志时的一些潜在崩溃。
• 添加了一些圣诞氛围。如果你大约 9 年前在的话，你可能会认出这个！
  很难相信图腾现在已经超过 10 年了（尽管 1.7.10 之前的版本在很大程度上似乎丢失了）。

此更新包含了一些添加项，通过数据包在与其他模组的交互方面允许更多的自定义。这对于模组包和其他模组的开发者可能特别有用。

• 添加了新的实体类型标签：
  • buffalo_dance_targets 和 eagle_dance_targets：这些生物将分别通过相应的仪式转换为水牛和白头海雕。
  • hymn_of_maturity_blacklist：这些动物将被排除在成熟之歌的婴儿生长加速之外。
• 添加了数据映射 cleansing_ceremony_conversions：控制哪些生物将通过史蒂夫的摇篮曲仪式转换为哪些生物。
• 修复了在使用功能标志时的一些潜在崩溃。
• 添加了一些圣诞氛围。如果你大约 9 年前在附近，你可能会认出这个！（很难相信图腾现在已经超过 10 年了（尽管 1.7.10 之前的版本在很大程度上似乎已经丢失了）。）

• 添加了块标签 totemic:zaphkiel_waltz_growable，允许自定义哪些块受 Zaphkiel Waltz 仪式影响，就像在 1.21 中一样
  • 请注意，只有接收随机滴答声的块才会实际受到 Zaphkiel Waltz 的影响
• 在尝试在和平难度下启动 Danse Macabre 仪式时添加了错误消息
• 幕后的一些代码清理

无

• 修复了在基岩附近或建筑高度限制处执行 Zaphkiel Waltz 或 Hymn of Maturity 仪式时发生的反复崩溃，例如在超平坦世界中。

(注意：1.18.2 版本除了关键错误修复外，不计划接收更多更新。)

API 更改：

• 修复了 CeremonyAPI.forEachBlockIn 在给定的 BoundingBox 超出建筑高度限制时导致异常（导致上述崩溃）