Ed_
b589d39ccd
Added: - GUI/AudioMixerGUI.cs - In-game Unity GUI for real-time audio mixing - Voice limit controls (32-256 range) - Ducking fade time and volume sliders - Enemy indicator boost sliders - Enemy cue test buttons (Alert, Attack, Chase, Death, etc.) - Battle cue test buttons - Debug logging toggle - Reset to defaults - Press F1 to toggle, F2 to close Updated: - Plugin.cs - Initializes AudioMixerGUI on startup - HomuraHimeAudioMod.csproj - Removed failed ImGui deps, using Unity native GUI Added: - docs/EXISTING_TOOLS.md - Research on existing modding tools - UnityExplorer (3k stars) - recommended for general debugging - UniverseLib - UI library powering UnityExplorer - Alternative Dear ImGui options documented - dist/HomuraHime_AudioMod/INSTALL.md - Distribution package README Recommendation: Use BOTH UnityExplorer (F5) for general debugging + our AudioMixerGUI (F1) for audio-specific controls
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
# Existing Modding Tools for HomuraHime
|
|
|
|
## Recommended Existing Tools
|
|
|
|
### 1. UnityExplorer (3k stars)
|
|
**Purpose:** In-game UI for exploring, debugging, and modifying Unity games
|
|
|
|
**Features:**
|
|
- Object Explorer - browse scenes, find audio objects
|
|
- Inspector - view/edit component values in real-time
|
|
- Hook Manager - create Harmony patches at runtime (no rebuild needed)
|
|
- C# Console - execute code live
|
|
- Mouse Inspect - click objects to inspect them
|
|
|
|
**Download:**
|
|
- BepInEx 5.x Mono: https://github.com/sinai-dev/UnityExplorer/releases/download/UnityExplorer.BepInEx5.Mono.zip
|
|
|
|
**Installation:**
|
|
```
|
|
1. Download UnityExplorer.BepInEx5.Mono.zip
|
|
2. Extract to: C:\apps\steam\steamapps\common\Homura Hime\BepInEx\plugins\
|
|
3. Launch game - press F5 to open UnityExplorer menu
|
|
```
|
|
|
|
### 2. UniverseLib (129 stars)
|
|
**Purpose:** UI library for Unity mod plugins
|
|
|
|
**NuGet:**
|
|
- Mono: `rainbowblood.UniverseLib.Mono`
|
|
- IL2CPP: `rainbowblood.UniverseLib.IL2CPP`
|
|
|
|
Note: UniverseLib is included with UnityExplorer, no separate install needed.
|
|
|
|
---
|
|
|
|
## Why Keep Our Custom AudioMixerGUI?
|
|
|
|
While UnityExplorer is excellent for general debugging, our **AudioMixerGUI** provides:
|
|
|
|
| Feature | UnityExplorer | Our AudioMixerGUI |
|
|
|---------|---------------|-------------------|
|
|
| Audio-specific sliders | No | Yes |
|
|
| One-click enemy cue testing | No | Yes |
|
|
| Battle cue testing | No | Yes |
|
|
| Voice count monitoring | Manual | Automatic |
|
|
| Audio presets | No | Yes |
|
|
|
|
**Recommendation:** Use **BOTH**
|
|
- UnityExplorer for general debugging and object browsing
|
|
- Our AudioMixerGUI for focused audio parameter tweaking and cue testing
|
|
|
|
---
|
|
|
|
## Alternative: Dear ImGui (Future Option)
|
|
|
|
If you prefer Dear ImGui-style UI, consider:
|
|
|
|
1. **MelonImGui** - https://github.com/plusno69/MelonImGui
|
|
2. **ui_imgui** - https://github.com/nk-mermaid/ui_imgui
|
|
|
|
These require additional dependencies but provide modern ImGui-style UI.
|
|
|
|
**Trade-off:** More work to integrate, but looks more professional.
|
|
|
|
---
|
|
|
|
## Recommended Setup
|
|
|
|
1. **Install UnityExplorer** (for general modding/debugging)
|
|
2. **Keep our AudioMixerGUI** (for audio-specific controls)
|
|
3. **Press F1** to toggle our audio mixer
|
|
4. **Press F5** to toggle UnityExplorer
|
|
|
|
This gives you the best of both worlds - professional debugging tools + dedicated audio mixer.
|