SpellReplace - Custom Voice Commands for YAPYAP

SpellReplace is a BepInEx plugin for the game YAPYAP that lets you customize the voice commands (trigger words) for every spell in the game.
You can replace the default English incantations with your own words – in any language supported by the game's speech recognition, including Chinese (Mandarin).

✨ Features

• Fully automatic spell detection – scans all SpellData objects loaded by the game.
• Per-spell configuration – each spell gets its own entry in the config file.
• Chinese name hints – common Chinese translations are shown in comments to help you understand what each spell does.
• Live replacement – modifies the voiceCommandKey field at runtime; no game files are altered.
• Compatible with any language model – works with the built‑in Vosk models (English, Chinese, etc.).

📥 Installation

1. Install BepInEx 5 (if not already present) – follow the official guide for YAPYAP.
2. Download the latest SpellReplace.dll from the Releases page.
3. Place the .dll into the BepInEx/plugins/SpellReplace/ folder inside your game directory.
   • If the SpellReplace folder doesn't exist, create it yourself.
4. Launch the game once – the plugin will automatically generate a configuration file.

⚙️ Configuration

After the first run, you'll find the config file at:
BepInEx/config/com.hyy.spellreplace.cfg

It looks like this:

[Spells]

## Custom voice command for 'IGNIS-BALLS'. Leave empty to use default. (中文名: 火球术)
IGNIS-BALLS = 

## Custom voice command for 'BLINK'. Leave empty to use default. (中文名: 闪现)
BLINK = 

• Each line corresponds to one spell (the part before = is the internal spell name, do not change it).
• Fill in the right‑hand side with the voice command you want to use.
  Examples: 火球术, piu, fire, 给我来一发火球
• Leave it empty to keep the original command.

💡 Tip: The voice recognition uses the language model you have selected in the game settings. For Chinese, choose "Chinese (Simplified)" in the game's audio options.

🚀 Usage

1. Edit the config file with your preferred commands.
2. Save the file and restart the game (or re‑enter a level).
3. Pick up a wand that uses that spell, speak your custom phrase, and watch the magic happen!

📝 Notes

• The plugin only affects the voice command keyword; all other spell properties (damage, cooldown, visuals) remain unchanged.
• If you don't see a spell in the config, it probably wasn't loaded when the plugin scanned. Give it a few seconds after entering the main menu – the plugin retries automatically every 3 seconds until it finds all spells.
• Providing Chinese name prompts is for ease of use only.

🛠️ Building from Source

1. Clone this repository.
2. Open SpellReplace.csproj in your editor and adjust the <GameDir> path to point to your YAPYAP installation.
3. Build with dotnet build or Visual Studio.
4. The compiled .dll will be in bin/Release/net48/.

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

🙏 Acknowledgements

• Inspired by community tools like bufftool and the amazing work of YAPYAP modders.
• Thanks to all testers who helped verify Chinese voice command support.

Have fun customizing your wizardly vocabulary! 🧙‍♂️✨