PlayMoreSounds - 玩家事件音效

PlayMoreSounds 是一款功能全面的插件，允许你为游戏中的各种场合配置音效。其主要目标是在玩家触发特定事件（动作）时播放音效，从而极大地增强服务器的沉浸感和互动体验。

💡重要须知

PlayMoreSounds 需要 EpicPluginLib 才能运行！

• 对于 Minecraft 1.17 或更新版本，请下载最新版插件。
• 对于 低于 1.17 的 Minecraft 版本，请使用 4.1.2 版本。

🎮支持的声音事件

PlayMoreSounds 包含大量可配置音效的事件，部分事件还支持为特定情况设置不同的音效。插件只会注册你启用的事件，因此即使你只想为一个事件配置音效，也完全无需担心性能问题！

以下是支持的事件列表

• 玩家被服务器封禁
• 切换手持物品（支持特定物品！）
• 等级变化
• 切换世界
• 聊天（支持特定聊天关键词！）
• 合成物品
• 丢弃物品
• 编辑书
• 实体受到攻击（支持特定实体使用特定物品攻击！）
• 实体跳跃（需要 Paper 服务端）
• 首次加入服务器
• 从熔炉取出物品
• 游戏模式切换（支持切换至特定模式！）
• 点击物品栏（支持点击特定物品！）
• 关闭物品栏
• 加入服务器
• 玩家被踢出服务器
• 离开服务器
• 上床睡觉 / 离开床
• 进入或离开特定生物群系（支持循环音效！）
• 玩家死亡（支持特定死亡类型！）
• 玩家跳跃（需要 Paper 服务端）
• 玩家击杀或被击杀
• 玩家挥动手臂（支持挥动特定物品！）
• 创建传送门
• 进入或离开区域（支持循环音效！）
• 重生
• 执行命令（支持特定命令！）
• 开始飞行 / 停止飞行
• 交换主副手物品
• 通过命令传送
• 切换潜行状态
• 醒来
• 开始下雨 / 雨停
• 世界特定时间

如何配置音效

所有音效均在 sounds.yml 文件中进行配置。下面是一个配置示例和简要说明：

# 示例：为“传送”事件配置音效
Teleport:
  # 当事件被其他插件取消时，是否阻止音效播放。这有助于与其他插件兼容。
  Cancellable: true
  # 启用或禁用此事件的音效。设为 false 时，该事件将被注销，以节省性能。
  Enabled: true
  # 音效列表。可以配置多个，每个需有唯一名称（如‘1’，‘2’）。
  Sounds:
    '1':
      # 音效类别
      Category: MASTER
      # 播放前的延迟（刻），0 为无延迟
      Delay: 0
      # 音效选项（均为可选）
      Options:
        # 即使玩家使用“/pms toggle”关闭了音效，此音效仍会播放
        Ignores Disabled: false
        # 只有拥有此权限的玩家触发事件时才会播放音效（非玩家事件则忽略）
        Permission Required: 'playmoresounds.reproduce.teleport'
        # 只有拥有此权限的玩家才能听到此音效
        Permission To Listen: 'playmoresounds.listen.teleport'
        # 音效可被听到的范围（方块）。0=仅触发者，-1=全服在线玩家，-2=事件所在世界所有人
        Radius: 15.2
        # 相对于触发者位置的偏移（根据玩家面向方向计算）。启用此选项会消耗较多内存。
        Relative Location:
          FRONT_BACK: 1.3   # 前后偏移
          RIGHT_LEFT: -0.01 # 左右偏移
          UP_DOWN: 0.13     # 上下偏移
      # 音高（大于2的值无差异）
      Pitch: 1.0
      # 音效类型或自定义音效名称。自定义音效需在资源包的 sounds.json 中定义。
      Sound: ENTITY_ENDERMAN_TELEPORT
      # 音量。Minecraft 中音量1约等于15格距离。区域音效可能需要设置较大值以保证整个区域音量一致。
      Volume: 0.9

若要禁用某个事件的音效，你可以直接删除其配置节，或将 Enabled 设为 false。

🔧区域系统

PlayMoreSounds 拥有自己的区域系统。每位玩家都可以创建自己的区域，并为其添加进入、离开和循环播放的音效。

选择区域

你可以通过命令或区域工具来选择区域。

使用区域工具：

• 输入命令 /pms region wand 获取区域选择工具（木棍）。
• 左键点击选择位置 1，右键点击选择位置 2，以框定一个矩形区域。

使用命令：

• 在游戏中，使用 /pms region set p1 或 /pms region set p2 将你当前位置设为选择点。
• 在控制台，使用 /pms region set p1|p2 <world> <x> <y> <z> 来指定坐标。

创建与管理区域

• 使用命令 /pms region create [名称] [描述] 来创建区域。
• 目前，为区域添加音效的唯一方法是直接编辑 Sounds 文件夹内的 regions.yml 文件。该文件内有详细教程。未来计划推出 GUI 以便更轻松地管理区域音效。

✨插件扩展（Addons）

PlayMoreSounds 支持扩展插件（Addons），这些扩展可以为你想要的任何插件添加兼容性。

如何安装扩展

• 在游戏中输入命令 /pms addons。
• 打开的 GUI 中点击“Install Addons”。
• 插件将从 PlayMoreSounds' GitHub 下载最新的扩展列表。
• 下载完成后，会弹出另一个库存界面，让你选择要安装的扩展。
• 安装完成后点击“Done”关闭界面。
• 安装的扩展将在服务器下次重启后加载。

可用扩展列表

目前共有 13 个官方扩展

• AuthMe Hook: 为 AuthMe 插件的登录和注册事件添加音效。
• ChatReaction Hook: 为 ChatReaction 插件的反应失败、开始和获胜事件添加音效。
• CMI Hook: 为 CMI 插件的 AFK 和隐身切换事件添加音效。
• Custom Discs: 添加可作为唱片在音乐盒中使用的自定义物品，以播放自定义音效。
• Essentials Hook: 为 Essentials 插件的 AFK、上帝模式和隐身切换事件添加音效。
• EssentialsChat Hook: 允许为在 EssentialsChat 的本地、喊叫和问答频道中发言配置音效。
• Nature Sound Replacer: 替换或阻止服务器中默认的 Minecraft 环境音效播放。
• NBS Song Player: 使用 NoteBlockAPI 播放 .nbs 格式的歌曲。
• Sound Commands: 在播放音效时执行命令。
• Sound Factors: 如果玩家不在指定的高度或时间范围内，则阻止音效播放。
• SuperVanish Hook: 为 SuperVanish 插件的隐身事件添加音效。
• VentureChat Hook: 允许为在特定 VentureChat 频道中发言配置音效。
• WorldGuard Regions: 允许为 WorldGuard 区域设置进入、离开和循环音效。

你可以在 PlayMoreSounds' forums 找到更多关于扩展的教程。

⭐安装步骤

• 下载 PlayMoreSounds 和 EpicPluginLib。
• 将两个 .jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• （可选）安装兼容性扩展。
• （可选）编辑 sounds.yml 配置默认音效，或编辑 Sounds 文件夹内的文件配置特定音效。
• （可选）为玩家添加权限。

❓权限节点

基础权限

• playmoresounds.player - 默认授予玩家切换音效的命令权限。
• playmoresounds.bypass.invisibility - 允许玩家在拥有隐身效果时隐藏其半径音效。

命令权限

以下为主要的命令权限节点（列表已简化归类）

• 通用与帮助： playmoresounds.help, playmoresounds.help.command, playmoresounds.update, playmoresounds.update.joinmessage
• 音效播放与控制： playmoresounds.play, playmoresounds.play.others, playmoresounds.stopsound, playmoresounds.stopsound.others, playmoresounds.list, playmoresounds.list.gui
• 音效开关： playmoresounds.toggle, playmoresounds.toggle.others, playmoresounds.toggle.check, playmoresounds.toggle.check.others
• 编辑器： playmoresounds.editor, playmoresounds.editor.save
• 自定义唱片： playmoresounds.disc.give, playmoresounds.disc.give.others, playmoresounds.disc.use
• 区域系统： playmoresounds.region（及其众多子权限，如 .create, .wand, .remove, .rename, .sound.enter, .teleport 等，支持管理自己或他人的区域）。
• 确认操作： playmoresounds.confirm

🔧命令列表

• /playmoresounds addons [list|uninstall] - 打开用于安装或卸载扩展的 GUI。
• /playmoresounds check [目标] - 检查目标玩家的音效是否启用。
• /playmoresounds confirm [id|list] - 确认某项待处理的操作（如删除区域）。
• /playmoresounds editor - 打开 GUI，显示 PlayMoreSounds 数据文件夹中的文件，可用于播放或添加音效。
• /playmoresounds help [命令] - 显示指定命令的描述。
• /playmoresounds list [页码] [--gui] - 以文本或 GUI 形式列出当前版本可用的音效。
• /playmoresounds play <音效|路径> [目标] [音量] [音高] - 向目标播放指定的音效或配置中的音效。
• /playmoresounds region <create|info|list|remove|rename|set|sound|teleport|wand> - 所有区域相关命令。
• /playmoresounds stopsound [目标] [音效] - 停止目标玩家当前播放的音效。
• /playmoresounds toggle [目标] [on|off] - 切换目标玩家的音效开关状态。
• /playmoresounds update [download [--force]] - 检查或下载 PlayMoreSounds 更新。

✨统计信息（Metrics）

PlayMoreSounds 使用 bStats 收集匿名统计信息，这些数据有助于开发者决定如何改进插件。如果你不希望发送统计信息，可以在 bStats 的配置文件中禁用。你可以通过点击插件页面上的相关图片查看所收集数据的完整列表。