YXIO AnyAudio 为 RPG Maker MV/MZ 添加上下文感知的 UI 音效规则。
YXIO AnyAudio
为每个菜单、操作和事件赋予专属音效。
大家好！我们是 Candlehart Studio（烛鹿工坊）。今天想向大家介绍我们的第一款公开发布的 RPG Maker 插件：YXIO AnyAudio。
YXIO AnyAudio 是一款专为 RPG Maker MV 和 MZ 设计的灵活音效规则管理插件。
它让你摆脱“所有菜单都使用同一套系统音效”的限制，根据当前事件、命令符号（Command Symbol）、场景、窗口、游戏开关、播放概率、冷却时间和规则优先级，为不同操作配置不同的声音。
────────────────
为什么做这个插件？ / Why AnyAudio?
在许多 RPG Maker 项目中，光标、确认、取消、保存、装备等系统音效通常是全局共用的。
对于简单项目来说没有问题，但当你开始制作自定义菜单、氛围化界面或更有辨识度的系统时，这种限制会越来越明显。
使用 YXIO AnyAudio 后，即使是同一个操作，也可以根据当前所在的菜单、窗口或场景播放完全不同的音效。
例如：
• 主菜单使用普通确认音，而装备菜单可以使用更有金属质感的确认音。
• 设置菜单使用轻柔的光标音，而暗黑风格背包界面可以使用更厚重的反馈音。
• 为重复操作加入随机音效变化，减少每次反馈完全相同带来的机械感。
────────────────
核心功能 / Key Features
◆ 上下文感知的音效规则 / Context-Aware Sound Rules
规则可以根据触发事件、菜单指令 Symbol、场景、窗口、游戏开关、播放概率、冷却时间和优先级进行匹配。
同一种操作可以在不同菜单、窗口或场景中使用不同音效。
菜单指令 Symbol 支持逗号列表和 * 通配符。
────────────────
◆ 丰富的系统事件支持 / Extensive Event Support
支持的事件包括：
光标移动 / Cursor
确认 / OK
取消 / Cancel
错误提示 / Buzzer
装备 / Equip
保存 / Save
读取 / Load
战斗开始 / Battle Start
逃跑 / Escape
敌人攻击 / Enemy Attack
敌人受伤 / Enemy Damage
敌人消灭 / Enemy Collapse
角色受伤 / Actor Damage
角色倒下 / Actor Collapse
恢复 / Recovery
未命中 / Miss
闪避 / Evasion
魔法闪避 / Magic Evasion
反射 / Reflection
商店 / Shop
使用物品 / Use Item
使用技能 / Use Skill
每种事件都可以继续通过场景、窗口或菜单指令限制触发范围。
────────────────
◆ 随机音效变化 / Random Sound Variations
每条规则都可以设置一个主 SE 和多个随机候选音效。
音量、音调和声像也可以加入随机浮动。
这非常适合菜单连续操作、碰撞、攻击以及其他高频触发音效。
────────────────
◆ 替换、叠加或静音 / Replace, Layer, or Mute
你可以替换 RPG Maker 原生音效。
也可以保留原生音效，并让自定义 SE 同时播放。
也可以让某类事件完全静音。
单条规则还可以在游戏运行过程中启用或禁用。
────────────────
◆ 灵活的触发条件 / Flexible Conditions
每条规则可以使用：
必须开启的游戏开关 / Required Game Switch
播放概率 / Playback Probability
毫秒级冷却时间 / Millisecond Cooldown
规则优先级 / Rule Priority
初始启用状态 / Initial Enabled State
当多条规则同时符合条件时，会优先检查优先级更高的规则。
────────────────
◆ 游戏运行时控制 / Runtime Control
RPG Maker MZ 提供可视化插件指令。
RPG Maker MV 提供对应的文本插件指令。
在游戏运行过程中，你可以：
启用或禁用整个插件 / Enable or disable YXIO AnyAudio
直接播放指定 SE / Play an SE directly
触发优先级最高的匹配规则 / Trigger the highest-priority matching rule
通过规则 ID 启用或禁用单条规则 / Enable or disable a rule by Rule ID
静音或恢复指定事件类型 / Mute or restore specific event types
停止当前播放的全部 SE / Stop all currently playing SE
同时提供公开脚本 API，方便与自定义系统和其他插件联动。
────────────────
MV 与 MZ 双兼容 / MV & MZ Support
RPG Maker MZ：提供可视化插件指令。
RPG Maker MV：提供对应的文本插件指令。
────────────────
英文 / 中文 / 日本語
YXIO AnyAudio 为英文、简体中文和日语分别提供了独立的插件管理器语言数据。
插件参数名称、说明、选项、插件指令和规则字段会跟随 RPG Maker 编辑器语言自动显示。
运行时调试信息和 API 消息也支持自动语言识别。
────────────────
性能与使用体验 / Performance & Convenience
• 支持预加载已配置音效。
• 支持缓存高频 UI 音效。
• 支持自定义音效全局音量倍率。
• 运行时插件状态可以随游戏存档保存。
• 无需其他前置插件。
────────────────
快速安装 / Quick Setup
- 将 YXIO_AnyAudio.js 放入项目的 js/plugins/ 文件夹。
- 在 RPG Maker 插件管理器中启用插件。
- 创建一条音效规则，并选择触发事件和 SE。
- 根据需要继续添加 Symbol、场景、窗口、开关、概率、冷却或优先级条件。
────────────────
获取插件 / Get YXIO AnyAudio
YXIO AnyAudio 现已在 itch.io 发布：
目前首发期间提供限时优惠。
如果你正在制作自定义菜单、战斗界面、恐怖游戏、氛围型 RPG、CRPG，或者任何需要更精细控制交互音效的项目，希望 AnyAudio 能让这部分开发变得更加轻松。
────────────────
反馈与兼容性报告 / Feedback & Compatibility Reports
这是我们正式公开发布的第一款 RPG Maker 插件，非常欢迎大家提供反馈。
如果遇到问题，请尽量提供 RPG Maker 版本、AnyAudio 版本、相关第三方插件，以及能够获取到的控制台报错信息。
我们也会根据实际项目中的使用反馈继续优化兼容性和使用体验。
────────────────
Developed by 枫间落羽 / Candlehart Studio（烛鹿工坊）
Copyright © 2026 枫间落羽 and Candlehart Studio（烛鹿工坊）.
All rights reserved.