自定义方块音效

自定义方块音效

资源包驱动的方块音效覆盖:按方块状态分别设置破坏、下落、击中、放置、踩踏和环境(空闲)音效,可在 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。