
自定义方块音效
资源包驱动的方块音效覆盖:按方块状态分别设置破坏、下落、击中、放置、踩踏和环境(空闲)音效,可在 blockmap.json 中配置音量、音高、概率和条件。
自定义方块音效
让资源包重新定义方块音效——无需编码,无需数据包,只需一个 JSON 文件。
Custom Block Sounds 是一个轻量级的客户端 Fabric 模组,允许资源包作者覆盖任何方块的交互音效——甚至单个方块状态——并为从未拥有环境音效的方块添加环境(闲置)音效。
特性
- 按方块或按方块状态覆盖破坏 / 下落 / 击打 / 放置 / 行走音效
- 为任何方块添加闲置(环境)音效——支持概率、冷却、昼夜、天气、开阔天空、上方空气和聚集条件
- 使用原版音效或同一资源包中自带的自定义音效
- 每个音效可单独控制音量和音调
- 其他玩家和生物的脚步、方块放置和下落音效也会被替换——服务器发送的音效会按其位置对应的方块进行匹配
- 多个资源包自然合并——列表中位置更高的资源包优先
- 无效条目不会导致游戏崩溃——它们会被跳过,并在日志中给出清晰的警告
在 Minecraft 1.21 - 1.21.11 上使用一个 jar,在 Minecraft 26.2 - 26.3 上使用另一个 jar(即 +26 文件)。需要 Fabric API。完全客户端侧——可安全加入任何服务器。
设置你的资源包
在你的资源包中创建一个文件:
assets/customblocksounds/config/blockmap.json
每一行是一条规则:键是一个方块(可选带方块状态属性),值是参数列表。允许重复键——每种音效类型写一行。
{
"minecraft:brown_mushroom_block[down=false,east=false,north=false,south=false,up=false,west=true]": "sound=minecraft:block.sand.break,type=break,volume=1.0,pitch=0.8",
"minecraft:brown_mushroom_block[down=false,east=false,north=false,south=false,up=false,west=true]": "sound=minecraft:block.sand.step,type=step",
"minecraft:stone": "sound=mypack:custom_stone_step,type=step"
}
[...]中的方块状态属性是可选的,且可以是部分的——规则会匹配所有具有所列值的状态。更具体的规则(属性更多)优先。sound=接受任何原版音效事件(例如minecraft:block.sand.break——完整列表见原版sounds.json),或你自己资源包的assets/<namespace>/sounds.json中声明的音效(照常 在sounds.json中声明,并将.ogg放在其旁边)。
提示: 编辑 blockmap.json 后按 F3+T——配置会重新加载,无需重启游戏。
参数
| 参数 | 描述 |
|---|---|
type |
要替换的音效:break、fall、hit、place、step(别名 walk)、idle(别名 ambient) |
sound |
音效事件 id;对于非闲置类型可选(省略则保留原版音效,仅更改音量/音调) |
volume |
0-16,默认 1.0 |
pitch |
0-16,默认 1.0 |
闲置(环境)音效
type=idle 为方块提供循环环境音,类似于原版 1.21.5+ 中的沙漠沙子。额外参数:
| 参数 | 描述 | 默认值 |
|---|---|---|
idle_chance |
扫描器命中该方块时播放的概率,0-1 | 0.002 |
idle_cooldown |
该规则两次播放之间的最短秒数 | 0 |
idle_pitch_min / idle_pitch_max |
随机音调范围 | 0.9-1.1 |
idle_category |
使用的音量滑块:blocks、ambient、weather、players、music... |
blocks |
idle_air_above |
true = 仅当上方方块为空气时 |
关闭 |
idle_sky |
true = 仅在开阔天空下 |
关闭 |
idle_cluster |
仅当附近有 N 个相同方块时(水平 ±8,垂直 ±2) | 关闭 |
idle_time |
day 或 night |
任意 |
idle_weather |
rain 或 clear |
任意 |
示例——类似沙子的沙漠环境音:
"minecraft:brown_mushroom_block[down=true,east=true,north=true,south=true,up=true,west=false]": "sound=minecraft:block.sand.idle,type=idle,idle_chance=1.0,idle_cooldown=5,idle_air_above=true,idle_sky=true,idle_cluster=3,idle_time=day,idle_weather=clear"
全局闲置扫描器设置
每个资源包一个保留键(启用的最高优先级资源包生效):
"customblocksounds:ambient": "idle_samples=64,idle_radius=24,idle_max_per_second=4"
| 参数 | 描述 | 默认值 | 最大值 |
|---|---|---|---|
idle_samples |
每 tick 在玩家周围检查的位置数 | 6 | 700 |
idle_radius |
水平扫描半径(垂直 = 一半) | 16 | 32 |
idle_max_per_second |
每秒闲置音效的全局上限 | 无限制 | 1000 |
使用默认设置时,单个方块很少被找到——这是类似原版沙漠的密度,针对方块区域进行了调优。对于清晰可闻的单个方块,请提高
idle_chance和idle_samples。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。