1
0

docs: 更新文章内容

This commit is contained in:
2025-10-13 10:20:34 +08:00
parent 6e549d6b49
commit afea227c37
108 changed files with 1439 additions and 921 deletions

View File

@@ -1,5 +1,5 @@
---
title: 「Minecraft」自定义声音资源包
title: "「Minecraft」自定义声音资源包"
date: 2025-03-16T17:43:19Z
lastmod: 2025-03-16T17:46:51Z
tags: [Minecraft,教程,资源包]
@@ -92,11 +92,11 @@ tags: [Minecraft,教程,资源包]
- custom.sound.a、custom.sound.b、custom.sound.ab可根据需要修改
- 通常按照类别以点 `.` 分隔
- 对应 `playsound` 命令中的 `声音`
- 对应 `playsound` 命令中的 `声音`
#### replace
- 可选,默认为 `false`
- 可选,默认为 `false`
- 设定为 true`sounds` 项中定义的音效列表会替换优先级较低的资源包的相同命名空间中与该声音事件名相同的声音。
- 设定为 false则补充到已有的音效列表中而不是替换。
@@ -108,51 +108,51 @@ tags: [Minecraft,教程,资源包]
#### sounds
- 该声音事件使用的音频文件列表
- 当该声音事件被触发时,若列表中存在多个项目(类似 `custom.sound.ab` 中的 `sounds` 项),游戏会从此列表定义的音频文件中随机选取一个播放。
- 当该声音事件被触发时,若列表中存在多个项目(类似 `custom.sound.ab` 中的 `sounds` 项),游戏会从此列表定义的音频文件中随机选取一个播放。
#### name
- 从资源包 `assets/<命名空间>/sounds/` 文件夹到此音频文件的相对路径(不带扩展名)
- 可填写另一个已存在的声音事件名(受 `type` 项影响)
- 音频文件格式必须为 `OGG`
- 若音频文件路径为 `assets/minecraft/sounds/custom/sound/a.ogg`,则为 `custom/sound/a`
- 若音频文件路径为 `assets/custom/sounds/sound_a.ogg`,则为 `example:sound_a`
- 音频文件格式必须为 `OGG`
- 若音频文件路径为 `assets/minecraft/sounds/custom/sound/a.ogg`,则为 `custom/sound/a`
- 若音频文件路径为 `assets/custom/sounds/sound_a.ogg`,则为 `example:sound_a`
#### volume
- 可选,默认为 `1.0`
- 可选,默认为 `1.0`
- 此声音播放时的音量
- 值为 0.0 到 1.0 的小数
- 如非必要,可仅在 `playsound` 命令中设定。
#### pitch
- 可选,默认为 `1.0`
- 可选,默认为 `1.0`
- 此声音播放时的音调
- 如非必要,可仅在 `playsound` 命令中设定。
#### weight
- 可选,默认为 `1`
- 可选,默认为 `1`
- 此声音事件触发时此声音被播放的概率(权重)。
- 一般用于 `sounds` 项中存在多个项目时。
#### stream
- 可选,默认为 `false`
- 可选,默认为 `false`
- 设置为 true此声音会以流式播放。
- 当声音时长较长时,最好设为 true 以避免卡顿。
- 所有的 `music``record` 类型的音效除了音符盒都使用流式播放它们的时长都达到1分多钟
- 所有的 `music``record` 类型的音效除了音符盒都使用流式播放它们的时长都达到1分多钟
#### preload
- 可选,默认为 `false`
- 可选,默认为 `false`
- 设置为 true则该音频文件会在加载资源包时被加载而不是在播放音效时再被加载。
#### type
- 可选,默认为 `sound`
- 可填写 `sound``event`
- 可选,默认为 `sound`
- 可填写 `sound``event`
- sound表明 `name` 项中定义的是文件名
- event表明 `name` 项中定义的是声音事件名
@@ -172,42 +172,42 @@ playsound <声音> <来源> <玩家> [x] [y] [z] [音量] [音调] [最小音量
- 指定要播放的声音
-`sounds.json` 中定义的一个声音事件
- 若命名空间不为默认的 `minecraft`,则需要在前方包含命名空间(例如:`example:`)。
- 例如:`custom.sound.a``example:sound.a`
- 若命名空间不为默认的 `minecraft`,则需要在前方包含命名空间(例如:`example:`)。
- 例如:`custom.sound.a``example:sound.a`
- 来源‌‌
- 设定播放的声音所属的类型,对应游戏选项中的 `音乐和声音` 的分类。
- 可填写:`master, music, record, weather, block, hostile, neutral, player, ambient, voice`
- 一般为 `master`
- 可填写:`master, music, record, weather, block, hostile, neutral, player, ambient, voice`
- 一般为 `master`
- 玩家
- 设定播放声音的目标(仅设定的目标可听到该声音)
- 填写 `玩家ID``目标选择器`
- 例如:`Frost_ZX``@a[x=0,y=80,z=0,r=16]`
- 填写 `玩家ID``目标选择器`
- 例如:`Frost_ZX``@a[x=0,y=80,z=0,r=16]`
- x y z
- 发出声音的位置
- 可用波浪号 `~` 来指定一个相对于命令执行者(玩家、命令方块)的位置
- 例如:`0 85 0``~5 ~ ~-5`
- 例如:`0 85 0``~5 ~ ~-5`
- 音量
- 设定声音能被听见的距离
- 最小值为 `0.0`
- 设定小于 `1.0` 的值,声音的音量较低,可听到该声音的范围(中心坐标为 `x y z` 的球状)会较小。
- 设定大于 `1.0` 的值,声音的音量不会增大(保持 `1.0`),但可听到该声音的范围(`16`)会与音量相乘。
- 音量设定为 `1.0` 时,可听到该声音的范围为:中心坐标为 `x y z`,半径为 `16` 方块的球状范围。
- 声音总会基于目标与球体中心(`x y z`)的距离逐渐衰减至无声(即使对方在 `目标` 范围内,也有可能听不到该声音)。
- 最小值为 `0.0`
- 设定小于 `1.0` 的值,声音的音量较低,可听到该声音的范围(中心坐标为 `x y z` 的球状)会较小。
- 设定大于 `1.0` 的值,声音的音量不会增大(保持 `1.0`),但可听到该声音的范围(`16`)会与音量相乘。
- 音量设定为 `1.0` 时,可听到该声音的范围为:中心坐标为 `x y z`,半径为 `16` 方块的球状范围。
- 声音总会基于目标与球体中心(`x y z`)的距离逐渐衰减至无声(即使对方在 `目标` 范围内,也有可能听不到该声音)。
- 音调
- 设定声音播放时的音调。
- 数值在 `0.0``2.0` 之间(含 `0.0``2.0`
- 小于 `0.5` 的值与 `0.5` 等价(效果相同)
- 数值在 `0.0``2.0` 之间(含 `0.0``2.0`
- 小于 `0.5` 的值与 `0.5` 等价(效果相同)
- 小于 `1.0` 的值会降低音调,增加持续时间。
- 大于 `1.0` 的值会提升音调,减小持续时间。
- 最小音量
- 设定在可听到该声音的范围外的目标能听到该声音的音量
- 数值在 `0.0``1.0` 之间(含 `0.0``1.0`
- 数值在 `0.0``1.0` 之间(含 `0.0``1.0`
#### playsound 命令示例