原创 闭源 工具 世界管理 [全中文][更方便地播放声音]BetterSoundPlayer 1.0-SNAPSHOT

[MD] # BetterSoundPlayer - Minecraft 声音播放插件 ## 📖 插件介绍 **BetterSoundPlayer** 是一款专为 Minecraft 服务器管理员设计的便捷声音播放工具，让向玩家播放声音变得简单直观。 ### ✨ 主要特性 - **🎵 汉化声音名称** - 所有声音都使用中文命名，易于理解和记忆 - **🎯 智能目标选择** - 支持多种目标选择器，精确控制播放对象 - **⌨️ 完整 Tab 补全** - 支持命令自动补全，提升使用效率 - **📋 分页声音列表** - 方便浏览所有可用声音 - **🎚️ 可调参数** - 自定义音量和音调，满足不同场景需求 --- ## 📝 使用方法 ### 基础语法 ``` /声音 <目标> <声音种类> [音量] [音调] ``` ### 参数说明 | 参数 | 必需 | 说明 | 示例 | |------|------|------|------| | 目标 | ✅ | 播放声音的目标选择器或玩家名 | `@a`, `Steve` | | 声音种类 | ✅ | 要播放的声音（中文名称） | `升级`, `末影龙低吼` | | 音量 | ❌ | 音量大小 (0.0-2.0) | `1.0`, `1.5` | | 音调 | ❌ | 音调高低 (0.0-2.0) | `1.0`, `0.8` | ### 目标选择器 | 选择器 | 说明 | |--------|------| | `@a` | 向所有在线玩家播放 | | `@p` | 向最近的玩家播放 | | `@r` | 向随机一个玩家播放 | | `@s` | 向自己播放（仅限玩家使用） | | `@e` | 向所有实体播放 | | 玩家名 | 向指定玩家播放 | ### 使用示例 ```bash # 向所有玩家播放升级音效 /声音 @a 升级 # 向特定玩家播放末影龙低吼 /声音 Steve 末影龙低吼 # 播放唱片音乐，音量 1.5，音调 0.8 /声音 @a 唱片cat 1.5 0.8 # 向随机玩家播放雷声 /声音 @r 雷声 2.0 # 查看帮助信息 /声音 # 查看所有可用声音列表 /声音 list # 查看第3页声音列表 /声音 list 3 ``` --- ## 🔐 权限节点 ### 命令权限 | 权限节点 | 默认权限 | 说明 | |----------|----------|------| | `betterSoundPlayer.use` | OP | 使用 `/声音` 命令的基础权限 | ### 权限配置示例 在 `plugins/BetterSoundPlayer/config.yml` 或服务器的权限插件中配置： ```yaml # 给予所有玩家使用权限 betterSoundPlayer.use: true # 仅给予管理员组使用权限 groups: admin: permissions: - betterSoundPlayer.use ``` **推荐配置：** - **管理员/OP**: 自动拥有完整权限 - **普通玩家**: 根据服务器需求决定是否授权 - **限制模式**: 仅允许特定玩家组使用 --- ## 🎵 声音分类 ### 🌍 环境音效 (19种) 用于营造环境氛围的背景声音。 | 中文名称 | 说明 | |----------|------| | 玄武岩三角洲环境音 | 下界玄武岩三角洲的环境背景音 | | 玄武岩三角洲循环音 | 玄武岩三角洲的循环背景音 | | 玄武岩三角洲情绪音 | 玄武岩三角洲的情绪变化音 | | 洞穴环境音 | 洞穴内的环境音效 | | 绯红森林环境音 | 下界绯红森林的环境音 | | 绯红森林循环音 | 绯红森林的循环背景音 | | 绯红森林情绪音 | 绯红森林的情绪变化音 | | 下界荒地环境音 | 下界荒地的环境音 | | 下界荒地循环音 | 下界荒地的循环音 | | 下界荒地情绪音 | 下界荒地的情绪音 | | 灵魂沙峡谷环境音 | 灵魂沙峡谷的环境音 | | 灵魂沙峡谷循环音 | 灵魂沙峡谷的循环音 | | 灵魂沙峡谷情绪音 | 灵魂沙峡谷的情绪音 | | 进入水下 | 进入水中的过渡音效 | | 离开水下 | 离开水时的过渡音效 | | 水下循环音 | 水下的持续环境音 | | 诡异森林环境音 | 下界诡异森林的环境音 | | 诡异森林循环音 | 诡异森林的循环音 | | 诡异森林情绪音 | 诡异森林的情绪音 | ### 🧱 方块音效 (55+种) 各种方块的交互声音。 #### 💎 紫水晶系列 - 紫水晶块破坏/共鸣/掉落/击打/放置/脚步声 - 紫水晶簇破坏/掉落/击打/放置 #### ⚒️ 工具与机械 - 铁砧破坏/摧毁/掉落/击打/落地/放置/脚步声/使用 - 高炉火焰噼啪声 - 酿造台酿造 #### 📦 容器与家具 - 箱子打开/关闭/已锁定 - 桶打开/关闭 - 钟响 - 信标激活/环境音/停用/选择效果 #### 🔔 装饰方块 - 蜡烛破坏/熄灭/掉落/击打/放置/脚步声 - 锁链破坏/掉落/击打/放置/脚步声 - 铜块/铜门/铜格栅/铜活板门 系列 #### 🌿 自然方块 - 竹子破坏/掉落/击打/放置/脚步声 - 杜鹃叶破坏/掉落/击打/放置/脚步声 - 蜘蛛网破坏/掉落/击打/放置/脚步声 - 作物破坏 #### ⚗️ 功能方块 - 堆肥桶清空/填充/填充成功/就绪 - 蜂巢滴落/进入/离开/工作 - 气泡柱气泡破裂/上升环境音 ### 👾 实体音效 (75+种) 游戏内各种生物和实体的声音。 #### 🤖 特殊实体 - **铜灵**: 无物品/有物品环境音、死亡、受伤、物品交互 - **末影龙**: 环境音、死亡、拍翅、低吼、受伤、射击、火球爆炸 - **末影人**: 环境音、死亡、受伤、尖叫、凝视、传送 - **末影螨**: 环境音、死亡、受伤 - **末影之眼**: 死亡、发射 #### 😈 敌对生物 - **烈焰人**: 环境音、燃烧、死亡、受伤、射击 - **苦力怕**: 死亡、受伤、引燃 - **恶魂**: 尖叫、警告 - **守卫者**: 环境音、攻击、死亡 - **唤魔者**: 施法、死亡、受伤、准备攻击/召唤/变形 - **溺尸**: 环境音、死亡、受伤、射击、脚步声、游泳 - **疣猪兽**: 环境音、愤怒、攻击、转化、死亡、受伤、撤退、脚步声 - **尸壳**: 环境音、死亡、受伤、脚步声 - **铁傀儡**: 攻击、受损、死亡、受伤、修复、脚步声 #### 🐾 友好生物 - **蝙蝠**: 环境音、死亡、受伤、循环音、起飞 - **蜜蜂**: 死亡、受伤、循环音、攻击循环音、授粉、蛰刺 - **猫**: 环境音、死亡、进食、嘶嘶声、受伤、呼噜声、喵叫、踱步 - **鸡**: 环境音、死亡、下蛋、受伤、脚步声 - **牛**: 环境音、死亡、受伤、挤牛奶、脚步声 - **海豚**: 环境/水中环境音、攻击、死亡、受伤、跳跃、玩耍、溅水 - **驴**: 环境音、愤怒、箱子、死亡、受伤 - **狐狸**: 环境音、死亡、受伤、睡觉、尖叫 - **山羊**: 环境音、死亡、受伤、进食、长跳、撞击、尖叫系列、脚步声 - **马**: 环境音、愤怒、铠甲装备、呼吸、死亡、进食、奔跑、受伤、跳跃、着陆、脚步声 - **美西螈**: 攻击、死亡、受伤 #### 🐟 水生生物 - **鳕鱼**: 环境音、死亡、扑腾、受伤 - **鱼**: 游泳 #### 🏹 投射物与物品 - **箭矢**: 命中/命中玩家/射击 - **烟花火箭**: 爆炸(普通/大型)、发射、闪烁 - **经验瓶**: 扔出 - **经验球**: 拾取 - **浮标**: 溅水/抛出 - **鸡蛋**: 扔出 ### 🎒 物品音效 (18+种) 玩家使用物品时产生的声音。 #### 🛡️ 装备类 - 装备钻石甲/鞘翅/铁甲/皮革甲/下界合金甲 #### 🪣 工具类 - 倒空桶/装满桶/用桶装岩浆 - 使用打火石/火焰弹 - 锄头耕地 - 斧头相关操作 #### 🎵 特殊物品 - 紫颂果传送 - 弩射击 - 鞘翅飞行 - 使用不死图腾 - 三叉戟投掷/雷击 ### 💿 唱片音乐 (15种) Minecraft 原版唱片音乐。 | 中文名称 | 英文原名 | 时长 | 氛围 | |----------|----------|------|------| | 唱片11 | "11" | 1:11 | 神秘、不安 | | 唱片13 | "13" | 2:58 | 平静、沉思 | | 唱片blocks | "blocks" | 5:45 | 电子、节奏感强 | | 唱片cat | "cat" | 2:57 | 轻快、爵士风 | | 唱片chirp | "chirp" | 3:05 | 欢快、电子 | | 唱片far | "far" | 2:54 | 悠远、空灵 | | 唱片mall | "mall" | 3:17 | 温暖、舒适 | | 唱片mellohi | "mellohi" | 1:36 | 吉他、悠闲 | | 唱片pigstep | "Pigstep" | 2:28 | 迪斯科、动感 | | 唱片stal | "stal" | 2:30 | 爵士、放松 | | 唱片strad | "strad | 1:51 | 舒缓、柔和 | | 唱片wait | "wait" | 3:58 | 悲伤、深沉 | | 唱片ward | "ward" | 4:11 | 深沉、神秘 | ### 🖥️ UI 与天气音效 (4种) 界面交互和环境音效。 | 中文名称 | 说明 | |----------|------| | 按钮点击 | UI按钮按下音效 | | 挑战完成提示 | 进度挑战完成的提示音 | | 下雨 | 雨声环境音 | | 上方下雨 | 头顶上方的雨声 | --- ## 📊 快速参考 ### 🎮 常用场景推荐 #### 🎉 庆典活动 ```bash /声音 @a 升级 # 完成任务奖励 /声音 @a 唱片pigstep # 背景音乐 /声音 @a 按钮 点击 # 互动反馈 ``` #### 👻 恶搞娱乐 ```bash /声音 @r 苦力怕引燃 # 恶作剧 /声音 @a 末影龙低吼 # 制造紧张气氛 /声音 Steve 打嗝 # 个人恶搞 ``` #### 🏆 竞技比赛 ```bash /声音 @a 玩家暴击 # PVP战斗音效 /声音 @a 挑战完成提示 # 获胜提示 /声音 @a 唱片cat # 背景音乐 ``` #### 🌍 角色扮演 ```bash /声音 @a 洞穴环境音 # 地下探险氛围 /声音 @a 雷声 # 天气效果 /声音 @a 末影人传送 # 魔法场景 ``` ### ⌨️ Tab 补全技巧 1. **输入 `/声音` 后按 Tab 键** - 显示: `@a`, `@p`, `@r`, `@s`, `@e`, `list` 2. **输入目标后按 Tab 键** - 显示所有可用声音的中文名称 3. **输入部分声音名后按 Tab 键** - 自动补全匹配的声音名称 - 例如: 输入 `升` → 自动补全为 `升级` 4. **输入音量/音调参数按 Tab 键** - 显示建议值: `0.5`, `1.0`, `1.5`, `2.0` --- ## ❓ 常见问题 ### Q: 如何查看所有可用的声音？ A: 输入 `/声音 list` 可以查看分页的声音列表，每页显示10个声音。 ### Q: 声音播放的范围是多大？ A: 默认情况下，声音会在目标玩家的位置播放，只有该玩家能听到。 ### Q: 可以同时向多个玩家播放不同声音吗？ A: 可以！多次执行命令即可，每次指定不同的目标和声音。 ### Q: 音量和音调的最佳值是多少？ A: - **音量**: 1.0 为正常音量，推荐范围 0.5-2.0 - **音调**: 1.0 为正常音调，<1.0 更低沉，>1.0 更尖锐 ### Q: 普通玩家可以使用这个命令吗？ A: 需要 `betterSoundPlayer.use` 权限，默认仅OP拥有。 --- ## 📞 支持与反馈 - **作者**: MVPCN - **适用版本**: Minecraft 1.21+ - **支持平台**: Paper, Spigot, Bukkit 及其衍生服务端 --- ## 📄 许可证 保留所有权利 本插件仅供学习和个人使用，请勿用于商业用途。 --- *感谢使用 BetterSoundPlayer！让您的服务器更有趣！* 🎵 [/MD]