音频播放专业版

音频播放专业版

这个模组是原版 /playsound 命令的增强版本,增加了距离衰减和循环播放等功能。

优化

核心功能: 中国用户可以前往:https://www.mcmod.cn/author/37861.html

可与此模组配合使用。https://modrinth.com/mod/summer_xtjl_f5_camera_control/versions

🎵 直接从资源包读取音频文件

🗺️ 支持区域音频播放(根据玩家位置动态调整音量)

👥 多人游戏兼容(为每位玩家独立计算音频)

🔧 丰富的命令系统

🌐 完整的多语言支持(英语和中文)

📁 音频文件位置

将 WAV 格式的音频文件放入资源包的以下目录: assets/summer_xtjl_audio/audio/

文件要求:

仅支持 .wav 格式文件

建议使用英文或数字命名文件

支持所有标准 WAV 音频参数

普通音频播放命令

普通音频播放:/playsound_pro play

参数说明:

Category:声音类别(控制游戏内哪个音量设置会影响音量)

unlimited - 不受游戏内音量设置影响(始终为最大音量)

master - 受主音量影响

music - 受音乐音量影响

record - 受唱片机/音符盒音量影响

weather - 受天气音量影响

block - 受方块音量影响

hostile - 受敌对生物音量影响

neutral - 受中立生物音量影响

player - 受玩家音量影响

ambient - 受环境音量影响

voice - 受语音音量影响

Loop:true(循环播放)或 false(播放一次)

Filename:音频文件名(可省略 .wav 扩展名)

示例:/playsound_pro play master false test

区域音频播放命令

区域音频播放:/playsound_pro play x= y= z= dx= dy= dz= center cx= cy= cz= cdx= cdy= cdz= mv=

[距离声音核心区域越远,音量越小。在 x y z dx dy dz 定义的范围之外,听不到任何声音。]

Category:声音类别(控制游戏内哪个音量设置会影响音量)

unlimited - 不受游戏内音量设置影响(始终为最大音量)

master - 受主音量影响

music - 受音乐音量影响

record - 受唱片机/音符盒音量影响

weather - 受天气音量影响

block - 受方块音量影响

hostile - 受敌对生物音量影响

neutral - 受中立生物音量影响

player - 受玩家音量影响

ambient - 受环境音量影响

voice - 受语音音量影响

Loop:true(循环播放)或 false(播放一次)

Filename:音频文件名(可省略 .wav 扩展名)

x=、y=、z=:区域的起始坐标

dx=、dy=、dz=:区域尺寸(可以为负数,但不能为 0)

center cx=、cy=、cz=:声音核心区域的起始坐标 [在声音核心区域内,音量始终为 100%]

cdx=、cdy=、cdz=:声音核心区域的尺寸

mv=:最小音量百分比(0-100),默认为 0

区域音频特性:

仅当玩家位于检测区域内时才会播放音频

音量根据玩家位置动态变化:

在声音核心区域内:100% 音量

在检测区域内但在核心区域外:音量随距离逐渐减小 在检测区域外:无声音

mv 参数设置最小音量,确保远处的玩家仍能听到微弱的声音 [在检测区域范围内]

区域音频逻辑