---

🎵 WHAT DOES IT DO?

When the mod recognizes an Aspect pickup spawning in the world, it plays a custom MP3 notification on your PC.

No extra hotkeys. No sound editing tools. No need to replace the game's audio files.

Feature	What you get
🔔 Aspect alerts	A sound when a recognized Aspect pickup appears
🎶 Your own MP3s	Use files you choose, not a fixed sound pack
🎲 Shuffle All	Pick randomly from your playable MP3s
🎚️ Volume control	Set notification volume from 1% to 100%
▶️ Play / Stop	Preview your sounds from the settings menu
📂 Folder Path	See exactly where to put your MP3 files
🔄 Refresh	Rescan your MP3 folder without restarting the game
✅ Playable count	See how many MP3s passed the file check

Aspect detection includes supported vanilla Aspect equipment and ZetAspects entries. Other mods that add new Aspects may need extra support.

Screenshot spot: Add a picture of the Select Sound dropdown in RiskOfOptions, showing your MP3 choices and Shuffle All.

---

⚙️ SETTINGS — KEEP IT SIMPLE

Everything lives in one RiskOfOptions settings section.

Setting	What it does
Select Sound	Choose a specific MP3 or Shuffle All
Volume	Set MP3 volume, 1–100% (default: 85%)
Play	Preview the selected sound; Shuffle All chooses a random file
Stop	Stop the current preview
Folder Path	Show the Sounds folder location
Refresh	Rescan the folder and update available choices
MP3 Playable	Show accepted MP3s out of all MP3s found

Example: 5/5 PLAYABLE means all five MP3 files passed the scan.

The dropdown shows Shuffle All plus up to 63 individual MP3 filenames. Shuffle All can still use every playable MP3, even when the folder has more than 63 files.

---

📁 ADD YOUR OWN SOUNDS

1. Open your active mod profile's BepInEx/plugins folder.
2. Go to AspectNotifications_Stand_A_Lone/Sounds.
3. Drop your .mp3 files inside.
4. Open the mod's settings and press Refresh.
5. Pick a sound from Select Sound, or leave it on Shuffle All.
6. Hit Play to test it.

The complete folder path is also shown in the settings menu, so you don't have to guess which profile you're using.

MP3 ONLY. WAV, OGG, and other audio formats are ignored. An MP3 must also pass the Windows audio check to appear as playable.

---

🚀 INSTALLATION

Mod manager (recommended): Install the release through r2modman or Thunderstore Mod Manager when available. Install the listed dependencies, including BepInExPack and RiskOfOptions for the in-game settings menu.

Manual installation:

1. Install BepInEx for Risk of Rain 2 and the required RiskOfOptions dependency.
2. Place the compiled AspectNotifications_Stand_A_Lone.dll in your active BepInEx/plugins folder.
3. Create BepInEx/plugins/AspectNotifications_Stand_A_Lone/Sounds if it does not exist automatically.
4. Add your MP3s and launch the game through your mod manager.
5. Open Settings → Mod Options → AspectNotifications_Stand_A_Lone to choose and preview a sound.

Using the source ZIP? That contains the Visual Studio project, not a ready-to-install compiled mod. Build the project first and install the resulting DLL.

---

👥 MULTIPLAYER — IMPORTANT

The sound plays locally, on the PC running the mod. It is not sent to everyone in the lobby.

• Players who want to hear the notification should install the mod themselves.
• This mod does not provide a sound fallback for players without it.
• Multiplayer behavior across different host/client setups has not been fully verified.

This is an audio notification mod, not a system for changing Aspect drop rates, loot, or other players' inventories.

---

🛡️ KNOWN LIMITATIONS

• Windows audio only: Custom MP3 playback uses the Windows MCI system. Linux, Steam Deck, and other platforms are not confirmed to work.
• Not 3D audio: The alert is heard locally; it does not get louder or quieter based on your distance from the drop.
• MP3 only: WAV and other formats were removed after unreliable playback tests.
• Not every modded Aspect is guaranteed: Detection covers supported Aspect types and ZetAspects mappings, but unusual modded pickup systems may need special handling.
• No automatic audio for other players: Each listener needs their own working installation.
• File validation is not a full playback guarantee: A file can pass the scan but still fail to play on a particular Windows setup.

Tested so far: The mod has loaded in-game, recognized ZetAspects pickups, played MP3s through the Windows backend, and displayed the custom sound dropdown with five MP3 choices. Refresh and preview commands have also appeared in the logs. A full multiplayer test and every possible file format/codec combination have not been checked.

---

🐛 BUG REPORTS & SUGGESTIONS

An Aspect dropped and you heard nothing? Tell us:

• Which Aspect dropped, and whether another mod added it.
• Which MP3 was selected (or whether you used Shuffle All).
• Whether the Play button works.
• What MP3 Playable shows.
• Your relevant mods and BepInEx/LogOutput.log.

A screenshot of the settings menu helps with dropdown or display issues.

---

📜 VERSION HISTORY

The complete development history, including the failed audio experiments and fixes, is in CHANGELOG.md.

The short version? We tried spatial sound. Windows had other plans. MP3 won.

---

🤝 JOIN THE PROJECT

A small contributor-focused Discord is planned, with a limit of 100 active participants for testing, bug reports, compatibility fixes, and ideas.

Invite: Coming soon.

❤️ NO DONATIONS. NO TIPS. NO MONEY.

Want to help? Test it. Break it. Report it. Share an idea. That's plenty.

---