Files

Ed_ b589d39ccd Phase 6 + GUI: Distribution and in-game audio mixer

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

2026-03-22 13:49:59 -04:00

2.3 KiB

Raw Blame History

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:

MelonImGui - https://github.com/plusno69/MelonImGui
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

Install UnityExplorer (for general modding/debugging)
Keep our AudioMixerGUI (for audio-specific controls)
Press F1 to toggle our audio mixer
Press F5 to toggle UnityExplorer

This gives you the best of both worlds - professional debugging tools + dedicated audio mixer.

2.3 KiB Raw Blame History