CC:HQ扬声器Sable Compat

CC:HQ扬声器Sable Compat

修复了放置在Sable子关卡内的CC: HQ扬声器的位置音频问题。

技术

CC:HQ Speakers Sable Compatibility

让 CC:HQ Speakers 的音频跟随正在移动的 Sable 子层级。

CC:HQ Speakers Sable Compatibility 是一个 NeoForge 附加模组，适用于 CC:HQ Speakers 和 Sable。它修复了放置在 Sable 子层级内部（例如移动的载具和装置）的扬声器的定位音频问题。

功能

如果没有此附加模组，位于 Sable 子层级内部的 CC:HQ Speaker 会使用该子层级的局部坐标。此时，靠近可见装置的玩家可能会处于服务器音频接收半径之外，或者在客户端听到来自错误位置的声音。

此附加模组使扬声器改为使用其投影后的世界坐标。音频会被传递给移动子层级周围的玩家，并随着子层级的移动而跟随。

它还将支持的 CC:HQ Speaker 音量上限从 3 提高到 16。接收半径会随所选的音量而变化：音量 1 达到 16 格，音量 16 最多达到 256 格。

此附加模组不添加方块、物品、配方或命令。它不会改变 CC:HQ Speakers 在 Sable 子层级之外的工作方式。

兼容性

安装

  1. 为 Minecraft 1.21.1 安装 NeoForge。
  2. 将匹配的 CC:HQ Speakers JAR、Sable JAR 以及此附加模组的 JAR 放入实例或服务器的 mods 文件夹中。
  3. 正常启动游戏。无需任何配置。

开发

该项目使用 Java 21。若要进行本地客户端运行，请将匹配的 Sable JAR 放入 libs/ 并运行：

.\gradlew.bat build
.\gradlew.bat runClient

发布的 JAR 会写入 build/libs/。libs/ 中的 HQ Speaker JAR 仅用于编译和测试此兼容性附加模组；它不会被打包到输出中。

许可证与致谢

CC:HQ Speakers Sable Compatibility 根据 MIT License 分发。

CC:HQ Speakers 和 Sable 是由各自作者拥有的独立项目。此附加模组是独立的，不隶属于任一项目，也未获得其认可。

AI 披露

AI 工具协助了此项目的研究、实现和文档编写。