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.4 KiB

Raw Blame History

HomuraHime Audio Mod - Installation Guide

Quick Install

Prerequisites

HomuraHime on Steam
BepInEx 5.x

Steps

Backup Original Files (optional but recommended)

Copy HomuraHime_Data\StreamingAssets\FMOD\Desktop\*.bank to backup folder

Install BepInEx (if not already installed)
- Download BepInEx 5.x from: https://github.com/BepInEx/BepInEx/releases
- Extract to game folder: C:\apps\steam\steamapps\common\Homura Hime\
- Launch game once, then close

Copy Mod Files

Copy BepInEx\plugins\HomuraHimeAudioMod.dll
To:   C:\apps\steam\steamapps\common\Homura Hime\BepInEx\plugins\

Launch Game

Start HomuraHime via Steam
Check BepInEx\LogOutput.log for: "HomuraHime Audio Mod initialized successfully"

Mod Components

Required (BepInEx Plugin)

BepInEx/plugins/HomuraHimeAudioMod.dll - Main mod DLL

Optional (FMOD Banks)

FMOD_banks/Desktop/*.bank - Modified audio banks (if included)

Documentation

docs/ - Full documentation
README.md - This file

Configuration

After first launch, configure in:

C:\apps\steam\steamapps\common\Homura Hime\BepInEx\config\com.homurahime.audiomod.cfg

Recommended Settings

For Low-End Systems:

[VoiceManager]
MaxVoiceCount = 64

[Ducking]
DuckFadeTime = 0.1

For High-End Systems:

[VoiceManager]
MaxVoiceCount = 256

[EnemyAudio]
EnemyIndicatorBoost = 1.5
AlertSoundBoost = 1.6
AttackSoundBoost = 1.4

Troubleshooting

Mod Not Loading

Check BepInEx\LogOutput.log
Ensure DLL is in BepInEx\plugins\ (not a subfolder)
Verify .NET Framework 4.8 is installed

Audio Glitches Persist

Reduce MaxVoiceCount to 64
Increase DuckFadeTime to 0.1
Disable FMOD banks modification if using

Game Crashes

Disable mod temporarily
Test with default settings
Check for conflicting mods

Uninstall

Delete BepInEx\plugins\HomuraHimeAudioMod.dll
Restore original FMOD banks from backup (if modified)
Delete config: BepInEx\config\com.homurahime.audiomod.cfg

Version History

v1.0.0

Initial release
Voice limit fix (configurable 64-256)
Audio ducking improvements
Enemy audio indicator boost

Credits

Mod by: [Your Name]
Framework: BepInEx
Audio Engine: FMOD Studio

2.4 KiB Raw Blame History