# Existing Modding Tools for HomuraHime

## Recommended: CinematicUnityExplorer (295 stars)

**Purpose:** In-game UI for exploring, debugging, and modifying Unity games with cinematic tools

**Download:**
```
https://github.com/originalnicodr/CinematicUnityExplorer/releases/latest/download/CinematicUnityExplorer.BepInEx5.Mono.zip
```

**Installation:**
1. Download `CinematicUnityExplorer.BepInEx5.Mono.zip`
2. Extract to: `C:\apps\steam\steamapps\common\Homura Hime\BepInEx\plugins\`
3. Launch game - press **F5** to open

**Features:**
| Feature | Description |
|---------|-------------|
| Object Search | Find audio manager types (FmodVoiceManager, CFVoiceEventUtility, etc.) |
| Inspector | View/edit component values in real-time |
| Hook Manager | Create Harmony patches at runtime (no rebuild needed) |
| C# Console | Execute code live to test audio triggers |
| Mouse Inspect | Click objects to inspect them |
| Freecam | Cinematic camera for screenshots/videos |
| Lights Manager | Add/modify scene lighting |
| Camera Paths | Create cinematic camera sequences |
| Animator Control | Pose characters for screenshots |

---

## Alternative: Yukieiji UnityExplorer (809 stars)

**Vanilla UnityExplorer** - if you don't need cinematic features

**Download:**
```
https://github.com/yukieiji/UnityExplorer/releases/latest/download/UnityExplorer.BepInEx5.Mono.zip
```

---

## Why Keep Our Custom AudioMixerGUI?

Our **AudioMixerGUI** provides audio-specific sliders and quick testing:

| Feature | CinematicUnityExplorer | Our AudioMixerGUI |
|---------|----------------------|-------------------|
| Audio-specific sliders | No | Yes |
| One-click enemy cue testing | Via C# Console | Yes |
| Voice count monitoring | Manual via Inspector | Yes |
| Config persistence | No | Yes (via BepInEx config) |

**Recommendation:** Use **BOTH**
- CinematicUnityExplorer (F5) for debugging, object browsing, screenshots
- Our AudioMixerGUI (F1) for audio parameter tweaking

---

## Quick Start with CinematicUnityExplorer

### Finding Audio Types
1. Press **F5** to open CinematicUnityExplorer
2. Go to **Object Search** tab
3. Search for: `FmodVoiceManager`, `CFVoiceEventUtility`, `VoiceManager`, `SnapshotManager`
4. Click results to inspect

### Creating Runtime Patches
1. Go to **Hook Manager** tab
2. Enter class name (e.g., `CFVoiceEventUtility`)
3. Select method (e.g., `PlayCFVoice`)
4. Click to generate patch code
5. Edit and apply at runtime

### Testing Audio Triggers via C# Console
```
// Example - trigger enemy alert sound
CFVoiceEventUtility.PlayCFVoice("Enemy_Alert");
```

---

## Default Hotkeys

| Key | Action |
|-----|--------|
| **F5** | Toggle CinematicUnityExplorer |
| **F1** | Toggle our AudioMixerGUI |

For CinematicUnityExplorer freecam controls, see their documentation.