BGM Fields

模组

· 作者 oj1755

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

0 本站下载 0 关注 更新于 9 个月前

最新 1.4.0 · 1.20.6 · Forge

一键开服(送7天)

BGM Fields (Forge 1.20.1)

? 观看 BGM Fields 演示视频:

BGM Fields 允许你放置领域方块,从而创建服务器权威的“BGM 区域”(领域)。当玩家处于领域内时,该领域可以:

  • 切换背景音乐(单曲或播放列表)
  • 应用“视觉”特效(雾效 / 叠加层 / 仅天空着色 / 粒子 / 彩色降水)
  • 可选渲染发光边界环(从领域内外均可见)

本模组不会通过网络发送 .ogg 音频文件。音乐通过音效事件 ID 引用;你需要通过客户端资源包(针对每位玩家)或服务器推送的资源包提供实际的音频文件。


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


入门指南

  1. 制作并放置一个领域方块。

alt text

  1. 右键点击领域方块以打开设置界面。

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

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


领域放置规则

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

BGM:曲目工作原理

曲目是一个音效事件 ID (namespace:path)。示例如下:

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

BGM 模式:

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

添加你自己的音乐(客户端侧,针对每位玩家)

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

  • BGMFields_UserBGM

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

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

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

你无需手动编写 sounds.json;BGM Fields 会自动生成它。

Sound 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)

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

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

领域视觉快捷键(所有者实用功能)

有一个客户端快捷键:

  • V = 切换“领域视觉”开/关

这供所有者在领域伪装时揭示真实的领域方块使用:

  • 所有者 + 开启领域视觉 + 潜行 (Shift) → 显示真实方块

命令 (OP)

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

备注 / 提示

  • 如果你的粒子设置是“最小”,某些视觉粒子/降水可能难以看清。
  • 边界环的设计旨在从领域内外均可见(对于大半径非常有用)。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源