BGM Fields (Forge 1.20.1)
? 观看 BGM Fields 演示视频:
BGM Fields 允许你放置领域方块,从而创建服务器权威的“BGM 区域”(领域)。当玩家处于领域内时,该领域可以:
- 切换背景音乐(单曲或播放列表)
- 应用“视觉”特效(雾效 / 叠加层 / 仅天空着色 / 粒子 / 彩色降水)
- 可选渲染发光边界环(从领域内外均可见)
本模组不会通过网络发送 .ogg 音频文件。音乐通过音效事件 ID 引用;你需要通过客户端资源包(针对每位玩家)或服务器推送的资源包提供实际的音频文件。
多人游戏:请在服务器和所有客户端上安装此模组。
入门指南
- 制作并放置一个领域方块。

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

- 设置:
- 半径(最大 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 会自动创建一个名为以下内容的文件夹资源包:
将你的 .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 值
- 粒子
- 彩色降水(通过自定义粒子实现的雨/雪)
- 边界可视化(发光环)
领域视觉快捷键(所有者实用功能)
有一个客户端快捷键:
这供所有者在领域伪装时揭示真实的领域方块使用:
- 所有者 + 开启领域视觉 + 潜行 (Shift) → 显示真实方块
命令 (OP)
/bgmfields_rp start
/bgmfields_rp stop
/bgmfields_rp send
/bgmfields_rp reload
备注 / 提示
- 如果你的粒子设置是“最小”,某些视觉粒子/降水可能难以看清。
- 边界环的设计旨在从领域内外均可见(对于大半径非常有用)。
BGM Fields (Forge 1.20.1)
? **Watch the BGM Fields demo:**
BGM Fields lets you place Realm Blocks that create server-authoritative “BGM zones” (Realms). When a player is inside a Realm, the Realm can:
- Switch BGM (single track or playlist)
- Apply “Vision” visuals (fog / overlay / sky-only tint / particles / colored precipitation)
- Optionally render a glowing boundary ring (visible from inside and outside)
This mod does not send .ogg audio files over the network. Music is referenced by Sound Event IDs; you provide the actual audio via a client resource pack (per-player) or a server-pushed resource pack.
Multiplayer: install the mod on both the server and all clients.
Getting Started
- Craft and place a Realm Block.

- Right-click the Realm Block to open the settings screen.

- Set:
- Radius (max 300)
- Y-range (optional; you can limit the realm vertically)
- Realm color (used by visuals)
- BGM settings (track or playlist)
- Per-realm BGM volume (0–100, default 80)
Only the owner can edit the Realm. OPs (permission level 2) can also edit.
Realm Placement Rules
- If another player’s Realm overlaps the new one, placement is denied.
- Even for the same owner, partial overlap is denied.
- Full nesting is allowed (one Realm completely inside the other).
BGM: How Tracks Work
A track is a Sound Event ID (namespace:path). Examples:
- Vanilla music:
minecraft:music.overworld
- User BGM generated by this mod:
bgmfieldmod:bgm.my_song
BGM Modes:
- Single: play one Sound Event.
- Playlist: multiple entries; each entry has:
track (Sound Event ID)
loop (true/false)
Add Your Own Music (Client-side, per player)
BGM Fields auto-creates a folder resource pack called:
Put your .ogg files under:
resourcepacks/BGMFields_UserBGM/assets/bgmfieldmod/sounds/bgm/
Then reload resources (in-game “Reload” button or F3+T).
You do not need to write sounds.json yourself; BGM Fields generates it automatically.
Sound ID mapping:
my_song.ogg → bgmfieldmod:bgm.my_song
dungeon/boss.ogg → bgmfieldmod:bgm.dungeon.boss
Notes:
- Filenames are sanitized to valid resource paths (spaces, uppercase, etc. are converted).
- The resource pack still needs to be enabled in Minecraft’s Resource Packs menu (that is vanilla behavior). There is also an optional client config that can attempt to auto-enable it.
Provide Music to Everyone (Server Resource Pack Push)
BGM Fields can ask clients to apply a server resource pack on join.
Two modes:
- external-url: set
serverResourcePack.url to a public URL to a .zip resource pack.
- internal-http: leave
serverResourcePack.url empty; the server hosts the .zip via a built-in HTTP server.
Config keys (in the Forge common config):
serverResourcePack.enabled
serverResourcePack.required
serverResourcePack.publicHost
serverResourcePack.url
serverResourcePack.port
serverResourcePack.packFile
serverResourcePack.sha1
serverResourcePack.prompt
Zip requirements:
pack.mcmeta and assets/ must be at the zip root (zipping the parent folder often breaks this).
Vision (Visual Effects)
Each Realm has a “Vision” visual module (server-authoritative settings synced to nearby clients). You can control:
- Master enable
- Strength (0–100)
- Ramp up/down (fade in/out)
- Fog
- Overlay
- Sky Tint (sky-only)
- Gradient is optional
- Can follow the realm color or use an independent RGB
- Particles
- Colored precipitation (rain/snow via custom particles)
- Boundary visualization (glowing ring)
Realm Vision Keybind (Owner Utility)
There is a client keybind:
V = toggle “Realm Vision” ON/OFF
This is used for owners to reveal the real Realm Block when the Realm is disguised:
- Owner + Realm Vision ON + Sneak (Shift) → show the real block
Commands (OP)
/bgmfields_rp start
/bgmfields_rp stop
/bgmfields_rp send
/bgmfields_rp reload
Notes / Tips
- If your particle setting is “Minimal”, some Vision particles/precipitation may be hard to see.
- The boundary ring is designed to be visible both from inside and outside the Realm (useful for large radii).
评论 0
登录后参与评分
还没有评论,来抢沙发吧