BGM 字段

BGM 字段

BGM Fields允许你放置领域方块,创建服务器权威的“BGM区域”(领域)。

装饰

BGM Fields (Forge 1.20.1)

🎥 观看 BGM Fields 演示:
https://www.youtube.com/shorts/meaJewowPdg

BGM Fields 允许你放置 Realm Blocks(领域方块),它们会创建由服务器权威控制的“BGM 区域”(领域)。当玩家处于某个领域内时,该领域可以:

  • 切换 BGM(单曲或播放列表)
  • 应用“Vision”(视觉)效果(雾效 / 叠加层 / 仅天空染色 / 粒子 / 彩色降水)
  • 可选地渲染一圈发光边界环(从内部和外部均可见)

本模组不会通过网络传输 .ogg 音频文件。音乐通过 Sound Event ID(声音事件 ID) 引用;你需要通过客户端资源包(按玩家)或服务器推送资源包提供实际音频。


多人游戏:请在服务器和所有客户端上都安装本模组。


快速开始

  1. 合成并放置一个 Realm Block。

alt text

  1. 右键点击 Realm Block 以打开设置界面。

  1. 设置:
  • 半径(最大 300)
  • Y 范围(可选;你可以限制领域的垂直范围)
  • 领域颜色(用于视觉效果)
  • BGM 设置(单曲或播放列表)
  • 每个领域的 BGM 音量(0–100,默认 80)

只有所有者才能编辑领域。OP(权限等级 2)也可以编辑。


领域放置规则

  • 如果其他玩家的领域与新领域重叠,则放置会被拒绝。
  • 即使是同一所有者,部分重叠也会被拒绝。
  • 完全嵌套是允许的(一个领域完全位于另一个领域内部)。

BGM:曲目工作原理

曲目是一个 Sound Event ID(namespace:path)。示例:

  • 原版音乐:minecraft:music.overworld
  • 本模组生成的用户 BGM:bgmfieldmod:bgm.my_song

BGM 模式:

  • Single(单曲):播放一个声音事件。
  • Playlist(播放列表):多个条目;每个条目包含:
    • track(声音事件 ID)
    • loop(true/false)

添加你自己的音乐(客户端,按玩家)

BGM Fields 会自动创建一个名为以下名称的文件夹资源包:

  • BGMFields_UserBGM

将你的 .ogg 文件放在以下路径下:

resourcepacks/BGMFields_UserBGM/assets/bgmfieldmod/sounds/bgm/

然后重新加载资源(游戏内“Reload”按钮或 F3+T)。

你不需要自己编写 sounds.json;BGM Fields 会自动生成它。

声音 ID 映射:

  • my_song.ogg → bgmfieldmod:bgm.my_song
  • dungeon/boss.ogg → bgmfieldmod:bgm.dungeon.boss

注意:

  • 文件名会被清理为有效的资源路径(空格、大写字母等会被转换)。
  • 该资源包仍然需要在 Minecraft 的资源包菜单中启用(这是原版行为)。此外还有一个可选的客户端配置,可以尝试自动启用它。

向所有人提供音乐(服务器资源包推送)

BGM Fields 可以要求客户端在加入时应用服务器资源包。

两种模式:

  • external-url:将 serverResourcePack.url 设置为指向 .zip 资源包的公开 URL。
  • internal-http:将 serverResourcePack.url 留空;服务器通过内置 HTTP 服务器托管该 .zip。

配置键(位于 Forge 通用配置中):

  • serverResourcePack.enabled
  • serverResourcePack.required
  • serverResourcePack.publicHost
  • serverResourcePack.url
  • serverResourcePack.port
  • serverResourcePack.packFile
  • serverResourcePack.sha1
  • serverResourcePack.prompt

Zip 要求:

  • pack.mcmeta 和 assets/ 必须位于 zip 根目录(压缩父文件夹通常会导致此问题)。

Vision(视觉效果)

每个领域都有一个“Vision”视觉模块(服务器权威设置,会同步到附近客户端)。你可以控制:

  • 主开关
  • 强度(0–100)
  • 渐入/渐出(淡入/淡出)
  • 雾效
  • 叠加层
  • 天空染色(仅天空)
    • 渐变是可选的
    • 可以跟随领域颜色或使用独立的 RGB
  • 粒子
  • 彩色降水(通过自定义粒子实现雨/雪)
  • 边界可视化(发光环)

领域 Vision 按键绑定(所有者实用工具)

有一个客户端按键绑定:

  • V = 切换“Realm Vision”开/关

这用于所有者在领域被伪装时显示真正的 Realm Block:

  • 所有者 + Realm Vision 开启 + 潜行(Shift)→ 显示真正的方块

命令(OP)

  • /bgmfields_rp start
  • /bgmfields_rp stop
  • /bgmfields_rp send
  • /bgmfields_rp reload

注意事项 / 提示

  • 如果你的粒子设置为“Minimal(最少)”,某些 Vision 粒子/降水可能难以看清。
  • 边界环被设计为从领域内部和外部都可见(对于大半径很有用)。