[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12,"_13":14},"actionData","errors","root",{"_216":217,"_218":-7,"_219":220,"_25":221},"c/Community",{"_80":199,"_25":200},"p/packageListing",{"_80":81,"_82":83,"_84":-7,"_85":86,"_69":-7,"_87":20,"_88":22,"_89":24,"_25":90},"wikiLayout",{"_15":68,"_19":20,"_21":22,"_23":24,"_40":-7,"_69":-7,"_25":70},"p/tabs/Wiki/WikiFirstPage",{"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26},"wiki",{"_37":48,"_35":49,"_40":50,"_42":51,"_44":52,"_53":54},"firstPage",{"_37":38,"_35":39,"_40":41,"_42":43,"_44":45,"_46":47},"communityId","necropolis","namespaceId","ZekesApprentice","packageId","Abraxis_Audio","seo",{"_27":28},"descriptors",[29,30],{"_35":36},{"_31":32,"_33":34},"name","description","content","Wiki page for ZekesApprentice-Abraxis_Audio","title","General Guide - Replacing Sounds - ZekesApprentice-Abraxis_Audio | Thunderstore","id","4400","General Guide - Replacing Sounds","slug","4400-general-guide-replacing-sounds","datetime_created","2025-11-25T14:15:31.075796Z","datetime_updated","2025-11-25T14:15:31.075813Z","markdown_content","# BepInEx Plugin Guide: Custom Audio within Abraxis Audio using CustomWwiseAPI\n\nThis guide shows you how to create BepInEx 5 plugins for Necropolis that add custom sounds, replace existing sounds, and replace environment-specific music using the CustomWwiseAPI system.\n\n## Table of Contents\n1. [Prerequisites](#prerequisites)\n2. [Project Setup](#project-setup)\n3. [Basic Plugin Structure](#basic-plugin-structure)\n4. [Playing Custom Sounds](#playing-custom-sounds)\n5. [Replacing Existing Sounds](#replacing-existing-sounds)\n6. [Replacing Music (Environment-Aware)](#replacing-music-environment-aware)\n7. [Advanced: 3D Positioned Sounds](#advanced-3d-positioned-sounds)\n8. [Distribution and Installation](#distribution-and-installation)\n9. [Troubleshooting](#troubleshooting)\n\n---\n\n## Prerequisites\n\n### Required Software:\n- **Visual Studio 2019 or later** (Community Edition works)\n- **BepInEx 5** installed in Necropolis\n- **Wwise 2015.1.9** (for creating soundbanks - see Wwise guide)\n- **.NET Framework 3.5**\n\n### Required Knowledge:\n- Basic C# programming\n- Understanding of Unity GameObject system\n- Familiarity with BepInEx plugin structure\n- If you are replacing sounds, you'll need to know [Sound Event Names in Necropolis](#sound-event-names-in-necropolis)\n\n### Required Files/Dependencies:\nYou'll need these DLL references in your project:\n- `Assembly-CSharp.dll` (from Necropolis game folder: `Necropolis_Data/Managed/`)\n- `UnityEngine.dll` (from Necropolis game folder: `Necropolis_Data/Managed/`)\n- `BepInEx.dll` (from BepInEx installation: `BepInEx/core/`)\n- `0Harmony.dll` (from BepInEx installation: `BepInEx/core/`)\n- `AbraxisAudio.dll` (from CustomWwiseSoundbanks mod)\n\n### Required Mods:\n- **CustomWwiseSoundbanks** plugin (provides the API)\n\n\n### Sound Event Names in Necropolis\nYou need to know the exact event name from the game. Two methods:\n\n**Method 1: Check Wwise_IDs.h**\n1. Go to `Necropolis\\Necropolis_Data\\StreamingAssets\\Audio\\GeneratedSoundBanks`\n2. In that folder, there is a file called Wwise_IDs.h, open it in a text editor\n3. This file will give you every single sound event in the game\n\nLook in the game's Wwise_IDs.h file for event names:\n```cpp\nstatic const AkUniqueID BRUTE_PLAY_FOOT_STONE_01 = 123456789U;\n```\n\n**Method 2: Enable Debug Logging**\n1. Run the game with BepInEx console open\n2. Enable verbose logging in CustomWwiseSoundbanks config\n3. Play the game and watch console for event names being posted\n\nYou may need to experiment to find out what sounds are from where!\n\n---\n\n## Project Setup\n\n### Step 1: Create New C# Class Library Project\n\n1. Open Visual Studio\n2. Create New Project → **Class Library (.NET Framework)**\n3. Name: `YourModName`\n4. Framework: **.NET Framework 3.5**\n5. Click Create\n\n### Step 2: Add References\n\n1. Right-click **References** in Solution Explorer\n2. Click **Add Reference** → **Browse**\n3. Add all required DLLs listed in prerequisites\n\n### Step 3: Configure Build Output\n\n1. Right-click your project → **Properties**\n2. Go to **Build** tab\n3. **Output path:** Set to your BepInEx plugins folder for easy testing\n - Example: `C:\\Games\\Necropolis\\BepInEx\\plugins\\YourModName\\`\n4. **Target framework:** .NET Framework 3.5\n\n### Step 4: Add Your Soundbank File\n\n1. In your project folder, create a folder structure:\n ```\n YourModName/\n YourModName.csproj\n YourPlugin.cs\n soundbanks/\n YourModName.bnk ← Your Wwise soundbank\n ```\n\n2. In Visual Studio:\n - Right-click project → **Add → Existing Item**\n - Browse to your `.bnk` file\n - Add it to project\n - Right-click the `.bnk` file → **Properties**\n - **Build Action:** Content\n - **Copy to Output Directory:** Copy if newer\n\n---\n\n## Basic Plugin Structure\n\n### Minimal Plugin Template\n\nCreate a new file `YourPlugin.cs`:\n\n```csharp\nusing BepInEx;\nusing BepInEx.Logging;\nusing CustomWwiseAPI;\n\nnamespace YourModName\n{\n [BepInPlugin(GUID, NAME, VERSION)]\n [BepInDependency(\"com.customwwise.soundbanks\")] // Require CustomWwiseSoundbanks\n public class YourPlugin : BaseUnityPlugin\n {\n // Plugin metadata\n public const string GUID = \"com.yourname.yourmod\";\n public const string NAME = \"Your Mod Name\";\n public const string VERSION = \"1.0.0\";\n \n // Logger for debugging\n private static ManualLogSource logger;\n \n void Awake()\n {\n logger = Logger;\n logger.LogInfo($\"{NAME} v{VERSION} is loading...\");\n \n // Your initialization code here\n InitializeAudio();\n \n logger.LogInfo($\"{NAME} loaded successfully!\");\n }\n \n private void InitializeAudio()\n {\n // Audio setup code goes here\n }\n }\n}\n```\n\n### Key Components:\n\n- **`[BepInPlugin]`**: Marks this as a BepInEx plugin with unique GUID\n- **`[BepInDependency]`**: Ensures CustomWwiseSoundbanks loads first\n- **`Awake()`**: Called when plugin loads - do initialization here\n- **`logger`**: For debug logging (visible in BepInEx console)\n\n---\n\n## Playing Custom Sounds\n#### Be sure you've gone through the \"Setting Up Your Sounds & Music in Wwise 2015.1\" Guide First\n\n### Method 1: Simple Sound Playback\n\n\nPlay a sound from your custom soundbank:\n\n```csharp\nusing CustomWwiseAPI;\nusing UnityEngine;\n\nvoid PlayCustomSound()\n{\n // Get the player GameObject\n GameObject player = GameObject.FindGameObjectWithTag(\"Player\");\n \n if (player != null)\n {\n // Play event on player\n CustomAudioManager.PlayCustomEvent(\"Play_MyMod_Footstep\", player);\n logger.LogInfo(\"Played custom footstep sound!\");\n }\n else\n {\n logger.LogWarning(\"Could not find player GameObject!\");\n }\n}\n```\n\n### Method 2: Play on Specific Position (3D Sound)\n\nFor sounds that should come from a specific location:\n\n```csharp\nvoid PlaySoundAtPosition(Vector3 worldPosition)\n{\n // Create temporary GameObject at position\n GameObject soundSource = new GameObject(\"CustomSoundSource\");\n soundSource.transform.position = worldPosition;\n \n // Play sound\n CustomAudioManager.PlayEvent(\"Play_MyMod_ExplosionSound\", soundSource);\n \n // Clean up after sound duration (adjust time as needed)\n Destroy(soundSource, 3.0f);\n}\n```\n\n### Fun Example: Play with Delay\n\nHeres an example of something you could do when playing custom sounds:\n\n```csharp\nvoid PlayDelayedSound(string eventName, GameObject source, float delay)\n{\n StartCoroutine(PlaySoundAfterDelay(eventName, source, delay));\n}\n\nIEnumerator PlaySoundAfterDelay(string eventName, GameObject source, float delay)\n{\n yield return new WaitForSeconds(delay);\n CustomAudioManager.PlayEvent(eventName, source);\n}\n```\nThis is just one of many things though, think outside the box, the possibilities are endless!\n\n\n### Best Practices:\n\n✅ Always check if GameObject exists before playing sound\n✅ Use descriptive event names with your mod prefix (avoid conflicts)\n✅ Log errors for debugging\n✅ Clean up temporary GameObjects used as sound sources\n\n---\n\n## Replacing Existing Sounds\n\nReplace game sounds with your custom audio using event name mapping.\n\n### How Sound Replacement Works:\n\nThe CustomWwiseSoundbanks plugin uses Harmony to intercept `PostEvent` calls. When the game tries to play an event, the system checks if you've registered a replacement. If found, your custom event plays instead.\n\n### Finding Event Names to Replace\nPlease check out [Sound Event Names In Necropolis](#sound-event-names-in-necropolis)\n\n### Basic Replacement Setup\n\n```csharp\nusing CustomWwiseAPI;\n\nvoid InitializeAudio()\n{\n // Replace a specific footstep sound\n CustomAudioManager.RegisterEventReplacement(\n \"BRUTE_PLAY_FOOT_STONE_01\", // Original game event\n \"Play_MyMod_Footstep\" // Your custom event\n );\n \n logger.LogInfo(\"Registered footstep replacement\");\n}\n```\n\n### Multiple Replacements Example\n\n```csharp\nvoid InitializeAudio()\n{\n // Replace multiple footstep variations\n string[] footstepEvents = new string[]\n {\n \"BRUTE_PLAY_FOOT_STONE_01\",\n \"BRUTE_PLAY_FOOT_STONE_02\",\n \"BRUTE_PLAY_FOOT_STONE_03\",\n \"BRUTE_PLAY_FOOT_WOOD_01\"\n };\n \n foreach (string eventName in footstepEvents)\n {\n CustomAudioManager.RegisterEventReplacement(\n eventName, \n \"Play_MyMod_Footstep\" // Same custom sound for all\n );\n logger.LogInfo($\"Replaced: {eventName}\");\n }\n}\n```\n\n### Conditional Replacement\n\nOnly replace sounds under certain conditions:\n\n```csharp\nusing HarmonyLib;\n\n[HarmonyPatch(typeof(AudioBankManager), \"PostEvent\", typeof(string), typeof(GameObject))]\nclass AudioReplacementPatch\n{\n static bool Prefix(string eventName, GameObject sourceObject)\n {\n // Only replace if player is wearing specific item\n if (eventName.Contains(\"FOOTSTEP\") && PlayerHasCustomSkin())\n {\n CustomAudioManager.PlayCustomEvent(\"Play_MyMod_MetalFootstep\", sourceObject);\n return false; // Skip original event\n }\n \n return true; // Allow original event\n }\n \n static bool PlayerHasCustomSkin()\n {\n // Your logic here\n return true;\n }\n}\n```\n\n### Important Notes:\n\n⚠️ **Event names are case-sensitive!**\n⚠️ **Your custom event must exist in your soundbank**\n⚠️ **Registering the same replacement twice will overwrite the first**\n\n---\n\n## Replacing Music (Environment-Aware)\n\nNecropolis uses an environment-based music system. Different areas trigger different music based on `AudioState_EnvironmentSet` values.\n\n### Understanding Environment Music System\n\nThe game sets environment states like:\n- `Forest` - Forest areas\n- `Foundry` - Foundry areas \n- `Temple` - Temple areas\n- `Hellscape` - Hell areas\n- `Ice_Cave` - Just the ice caves, not the ice areas\n- `Palace` - Either an old/unused or very specific area that Im not aware of\n- `Swamp` - Swamp areas\n- `Thunder` - Also not sure on this one yet.\n- `Schism` - Most of the default areas of the game.\n- `No_Set` - UNSURE\n- `Report_Window` - UNSURE\n\n\nMusic events are triggered based on combat state:\n- **Explore mode:** Background exploration music\n- **Combat mode:** Intense combat music\n\n### Available Music Switch Values\n\nFrom the `Music_Switch`:\n- `Title` - Title screen\n- `Explore` - Exploration mode\n- `Combat` - Combat mode\n- `Credits` - End credits\n\n### Basic Music Replacement\n\n```csharp\nusing CustomWwiseAPI;\n\nvoid InitializeAudio()\n{\n // Replace exploration music for Black Forest environment\n CustomAudioManager.RegisterEnvironmentMusic(\n \"Forest\", // Environment name\n \"Explore\", // Music switch value\n \"Play_MyMod_ForestExploreMusic\" // Your custom event\n );\n \n // Replace combat music for same environment\n CustomAudioManager.RegisterEnvironmentMusic(\n \"Forest\",\n \"Combat\",\n \"Play_MyMod_ForestCombatMusic\"\n );\n \n logger.LogInfo(\"Registered custom Black Forest music\");\n}\n```\n\n### Complete Environment Music Setup\n\nReplace music for all states in an environment:\n\n```csharp\nvoid InitializeAudio()\n{\n string environment = \"Foundry\";\n \n // Map all music states for this environment\n var musicMap = new Dictionary()\n {\n { \"Explore\", \"Play_MyMod_FoundryExplore\" },\n { \"Combat\", \"Play_MyMod_FoundryCombat\" }\n };\n \n foreach (var kvp in musicMap)\n {\n CustomAudioManager.RegisterEnvironmentMusic(\n environment,\n kvp.Key,\n kvp.Value\n );\n logger.LogInfo($\"Registered {environment} - {kvp.Key} music\");\n }\n}\n```\n\n### Dynamic Music Example\n\nChange music based on player health:\n\n```csharp\nusing UnityEngine;\n\nvoid Update()\n{\n if (Input.GetKeyDown(KeyCode.M)) // Toggle music (for testing)\n {\n CheckPlayerHealthAndAdjustMusic();\n }\n}\n\nvoid CheckPlayerHealthAndAdjustMusic()\n{\n // Get player's current health (simplified example)\n float healthPercent = GetPlayerHealthPercent();\n \n string currentEnvironment = GetCurrentEnvironment();\n \n if (healthPercent < 0.25f)\n {\n // Play intense music when health is low\n CustomAudioManager.RegisterEnvironmentMusic(\n currentEnvironment,\n \"Explore\",\n \"Play_MyMod_DangerMusic\"\n );\n logger.LogInfo(\"Switched to danger music!\");\n }\n else\n {\n // Normal music\n CustomAudioManager.RegisterEnvironmentMusic(\n currentEnvironment,\n \"Explore\",\n \"Play_MyMod_NormalMusic\"\n );\n }\n}\n\nfloat GetPlayerHealthPercent()\n{\n // Your implementation here\n return 1.0f;\n}\n\nstring GetCurrentEnvironment()\n{\n // Your implementation here\n return \"Forest\";\n}\n```\n\n### Music Replacement Notes:\n\n✅ Music events should be set up in a Music Switch Container in Wwise\n✅ Use stereo audio files for music\n✅ Consider music loop points and transitions in Wwise\n✅ Test in different environments to ensure proper replacement\n⚠️ Music changes happen when the environment state changes, not instantly\n\n---\n\n## Advanced: 3D Positioned Sounds\n\n### Playing 3D Sound at World Position\n\nFor sounds that should come from a specific location with distance falloff:\n\n```csharp\nvoid PlayExplosionAt(Vector3 position)\n{\n GameObject soundEmitter = new GameObject(\"ExplosionSound\");\n soundEmitter.transform.position = position;\n \n // Play 3D positioned event (must be configured in Wwise!)\n CustomAudioManager.PlayEvent(\"Play_MyMod_Explosion\", soundEmitter);\n \n // Destroy after sound duration\n Destroy(soundEmitter, 5.0f);\n}\n```\n\n### Attaching Sound to Moving Object\n\nFor sounds that follow a moving object (like a projectile):\n\n```csharp\nvoid AttachSoundToProjectile(GameObject projectile)\n{\n // Play looping sound\n CustomAudioManager.PlayEvent(\"Play_MyMod_ProjectileLoop\", projectile);\n \n // Stop sound when projectile is destroyed\n StartCoroutine(StopSoundOnDestroy(projectile));\n}\n\nIEnumerator StopSoundOnDestroy(GameObject obj)\n{\n // Wait until object is destroyed\n while (obj != null)\n {\n yield return null;\n }\n \n // Stop the sound (if you created a Stop event)\n CustomAudioManager.PlayCustomEvent(\"Stop_MyMod_ProjectileLoop\", obj);\n}\n```\n\n### 3D Sound Requirements:\n\n⚠️ Your Wwise event must be configured for 3D positioning\n⚠️ Audio source should be mono (not stereo)\n⚠️ Attenuation profile must be set up in Wwise (see Wwise guide)\n⚠️ GameObject position must be valid in world space\n\n---\n\n## Distribution and Installation\n\n### File Structure for Distribution\n\nYour mod should be distributed with this structure:\n\n```\nYourModName_v1.0.zip\n├── BepInEx/\n│ └── plugins/\n│ └── YourModName/\n│ ├── YourModName.dll ← Your compiled plugin\n│ └── soundbanks/\n│ └── YourModName.bnk ← Your Wwise soundbank\n```\n\n### Why This Structure?\n\nThe CustomWwiseSoundbanks plugin **recursively scans** the BepInEx plugins folder for `.bnk` files. By placing your soundbank in your plugin's folder, it will be automatically discovered and loaded.\n\n### Installation Instructions for Users\n\nCreate a `README.txt` for users:\n\n```\nYourModName Installation Instructions:\n\n1. Install BepInEx 5 if not already installed\n2. Install CustomWwiseSoundbanks plugin (dependency)\n3. Extract this ZIP file to your Necropolis game folder\n4. File structure should look like:\n Necropolis/\n BepInEx/\n plugins/\n YourModName/\n YourModName.dll\n soundbanks/\n YourModName.bnk\n\n5. Run the game!\n\nThe soundbank will be automatically loaded when the game starts.\nCheck BepInEx/LogOutput.log for any errors.\n```\n\n### Build Process Automation\n\nAdd to your `.csproj` file to automate copying files:\n\n```xml\n\n \n \n \n \n\n```\n\n---\n\n## Troubleshooting\n\n### Sound Not Playing\n\n**Check 1: Is the soundbank loaded?**\n- Look in BepInEx console/log for: `\"Loaded custom soundbank: YourModName.bnk\"`\n- If not found, check file path and structure\n\n**Check 2: Is the event name correct?**\n```csharp\n// Add debug logging\nCustomAudioManager.PlayEvent(\"Play_MyMod_Sound\", gameObject);\nlogger.LogInfo(\"Attempted to play: Play_MyMod_Sound\");\n```\n\n**Check 3: Does the event exist in your soundbank?**\n- Open your `.bnk.txt` file (generated with soundbank)\n- Search for your event name\n- Verify exact spelling and capitalization\n\n**Check 4: Is the GameObject valid?**\n```csharp\nif (gameObject == null)\n{\n logger.LogError(\"GameObject is null! Cannot play sound.\");\n return;\n}\n```\n\n### Sound Replacement Not Working\n\n**Issue:** Game sound still plays instead of custom sound\n\n**Fix 1:** Verify event name exactly matches\n```csharp\n// Wrong - case mismatch\nCustomAudioManager.RegisterEventReplacement(\"brute_play_foot\", \"Play_Custom\");\n\n// Correct\nCustomAudioManager.RegisterEventReplacement(\"BRUTE_PLAY_FOOT_STONE_01\", \"Play_Custom\");\n```\n\n**Fix 2:** Check registration happens in `Awake()`\n```csharp\nvoid Awake()\n{\n InitializeAudio(); // Make sure this is called!\n}\n```\n\n**Fix 3:** Verify your custom event exists\n- Check Wwise project\n- Regenerate soundbank\n- Check `.bnk.txt` for event list\n\n### 3D Sound Not Attenuating\n\n**Issue:** Sound doesn't get quieter with distance\n\n**Fix:** Check Wwise project\n- Sound must have Positioning enabled\n- Sound must have Attenuation assigned\n- Attenuation must have distance curve defined\n- See Wwise Audio Creation Guide for complete setup\n\n### Plugin Not Loading\n\n**Issue:** Plugin doesn't appear in BepInEx log\n\n**Check 1:** Dependencies installed\n- CustomWwiseSoundbanks plugin must be present\n- Check `BepInEx/plugins/` folder\n\n**Check 2:** Plugin metadata correct\n```csharp\n[BepInPlugin(GUID, NAME, VERSION)]\n[BepInDependency(\"com.customwwise.soundbanks\")] // Required!\n```\n\n**Check 3:** .NET Framework version\n- Project must target .NET Framework 4.6 or higher\n- Check project properties → Application → Target framework\n\n**Check 4:** Check log file\n- Open `BepInEx/LogOutput.log`\n- Search for your plugin name\n- Look for error messages or load failures\n\n### Common Error Messages\n\n**Error:** `\"Could not load soundbank: YourMod.bnk\"`\n- **Cause:** Soundbank file not found in expected location\n- **Fix:** Verify `.bnk` file is in `plugins/YourModName/soundbanks/` folder\n\n**Error:** `\"Event 'Play_Custom_Sound' not found in loaded banks\"`\n- **Cause:** Event doesn't exist or soundbank not loaded\n- **Fix:** Check event exists in Wwise project and soundbank generated correctly\n\n**Error:** `\"Dependency plugin 'com.customwwise.soundbanks' not found\"`\n- **Cause:** CustomWwiseSoundbanks plugin not installed\n- **Fix:** Install dependency plugin first\n\n---\n\n## Complete Example: Custom Weapon Sound Mod\n\nHere's a complete, working example that replaces sword swing sounds:\n\n```csharp\nusing BepInEx;\nusing BepInEx.Logging;\nusing CustomWwiseAPI;\nusing UnityEngine;\nusing System.Collections.Generic;\n\nnamespace CustomSwordSounds\n{\n [BepInPlugin(GUID, NAME, VERSION)]\n [BepInDependency(\"com.customwwise.soundbanks\")]\n public class CustomSwordSoundsMod : BaseUnityPlugin\n {\n public const string GUID = \"com.example.customswordsounds\";\n public const string NAME = \"Custom Sword Sounds\";\n public const string VERSION = \"1.0.0\";\n \n private static ManualLogSource logger;\n \n void Awake()\n {\n logger = Logger;\n logger.LogInfo($\"{NAME} v{VERSION} is loading...\");\n \n InitializeAudio();\n \n logger.LogInfo($\"{NAME} loaded successfully!\");\n }\n \n private void InitializeAudio()\n {\n // Replace all sword swing sounds with custom sounds\n List swordSwingSounds = new List()\n {\n \"BRUTE_ATTACK_GREATSWORD_HEAVY_ATTACK01\",\n \"BRUTE_ATTACK_GREATSWORD_HEAVY_ATTACK02\",\n \"BRUTE_ATTACK_GREATSWORD_HEAVY_ATTACK03\",\n \"BRUTE_ATTACK_SHORTSWORD_LIGHT_ATTACK01\",\n \"BRUTE_ATTACK_SHORTSWORD_LIGHT_ATTACK02\"\n };\n \n foreach (string soundEvent in swordSwingSounds)\n {\n CustomAudioManager.RegisterEventReplacement(\n soundEvent,\n \"Play_CustomSword_Swing\" // Your custom event from Wwise\n );\n logger.LogInfo($\"Replaced sword sound: {soundEvent}\");\n }\n \n // Replace weapon impact sounds\n CustomAudioManager.RegisterEventReplacement(\n \"WEAPON_PLAY_SWORD_ONHIT\",\n \"Play_CustomSword_Impact\"\n );\n \n logger.LogInfo(\"Sword sound replacements registered!\");\n }\n }\n}\n```\n\n**Required Wwise Setup:**\n1. Create events `Play_CustomSword_Swing` and `Play_CustomSword_Impact`\n2. Import your custom audio files\n3. Generate soundbank named `CustomSwordSounds.bnk`\n4. Place in `plugins/CustomSwordSounds/soundbanks/CustomSwordSounds.bnk`\n\n---\n\n## Best Practices Summary\n\n✅ **Always log important operations** for debugging\n✅ **Use unique event names** with your mod prefix to avoid conflicts\n✅ **Test thoroughly** in different game scenarios\n✅ **Check null references** before accessing GameObjects\n✅ **Follow the file structure** for automatic soundbank loading\n✅ **Document your mod** with clear installation instructions\n✅ **Version your releases** and track changes\n✅ **List dependencies** clearly (CustomWwiseSoundbanks required!)\n\n---\n\n## Next Steps\n\n1. **Create your Wwise project** following the Wwise Audio Creation Guide\n2. **Generate your soundbanks** with unique event names\n3. **Write your plugin** using the examples above\n4. **Test in-game** and iterate\n5. **Package for distribution** following the structure above\n6. **Share with the community!**\n\n\n**Happy modding! 🎮🎵**","2360","ZekesApprentice/Abraxis_Audio Wiki","2360-zekesapprenticeabraxis_audio-wiki","2025-11-25T14:15:31.069638Z","2025-11-25T14:16:28.010859Z","pages",[55,56,57],{"_37":38,"_35":39,"_40":41,"_42":43,"_44":45},{"_37":63,"_35":64,"_40":65,"_42":66,"_44":67},{"_37":58,"_35":59,"_40":60,"_42":61,"_44":62},"4402","Setup of Sounds & Music in Wwise 2015.1.9","4402-setup-of-sounds-music-in-wwise-201519","2025-11-25T14:16:28.008910Z","2025-11-25T14:16:28.008934Z","4401","Music Replacement Guide","4401-music-replacement-guide","2025-11-25T14:16:04.121875Z","2025-11-25T14:16:04.121913Z",{"_37":48,"_35":49,"_40":50,"_42":51,"_44":52,"_53":76},"permissions",{"_27":71},[72,73],{"_35":75},{"_31":32,"_33":74},"Wiki for ZekesApprentice-Abraxis_Audio","ZekesApprentice-Abraxis_Audio Wiki | Thunderstore",[77,78,79],{"_37":38,"_35":39,"_40":41,"_42":43,"_44":45},{"_37":63,"_35":64,"_40":65,"_42":66,"_44":67},{"_37":58,"_35":59,"_40":60,"_42":61,"_44":62},"community",{"_31":143,"_119":20,"_183":-5,"_32":184,"_185":-5,"_186":187,"_42":188,"_189":190,"_191":192,"_126":-5,"_193":194,"_195":196,"_197":198},"listing",{"_122":123,"_87":20,"_32":111,"_124":125,"_126":109,"_127":128,"_129":128,"_130":128,"_31":24,"_131":22,"_132":133,"_134":135,"_136":137,"_138":139,"_140":141,"_142":143,"_144":145,"_146":147,"_148":149,"_150":151,"_152":128,"_85":153,"_154":155,"_156":157,"_158":159},"listingStatus","team",{"_119":120,"_31":22,"_121":-5},"community_identifier","namespace_id","package_id",{"_27":91},[92,93,94,95,96,97,98,99,100,101],{"_35":118},{"_31":32,"_33":111},{"_102":116,"_33":117},{"_102":114,"_33":115},{"_102":112,"_33":113},{"_102":110,"_33":111},{"_102":108,"_33":109},{"_102":107,"_33":106},{"_102":105,"_33":106},{"_102":103,"_33":104},"property","og:site_name","Thunderstore","og:image:height","256","og:image:width","og:image","https://gcdn.thunderstore.io/live/repository/icons/ZekesApprentice-Abraxis_Audio-1.0.1.png","og:description","A custom sound and music framework/API for Necropolis (using Wwise magic!)","og:title","Abraxis Audio by ZekesApprentice","og:url","https://thunderstore.io/c/necropolis/p/ZekesApprentice/Abraxis_Audio/wiki","og:type","website","Abraxis Audio by ZekesApprentice | Necropolis | Thunderstore","identifier",63037,"donation_link","categories",[171,172,173],"download_count",180,"icon_url","is_deprecated",false,"is_nsfw","is_pinned","namespace","rating_count",0,"size",70717,"latest_version_number","1.0.1","install_url","ror2mm://v1/install/thunderstore.io/ZekesApprentice/Abraxis_Audio/1.0.1/","download_url","https://thunderstore.io/package/download/ZekesApprentice/Abraxis_Audio/1.0.1/","community_name","Necropolis","dependant_count",3,"dependencies",[162],"dependency_count",1,"full_version_name","ZekesApprentice-Abraxis_Audio-1.0.1","has_changelog",{"_31":22,"_160":161},"website_url","https://github.com/Cut2TheChase/AbraxisAudio","package_created","2025-11-25T14:01:49.584059Z","version_created","2025-11-25T14:08:39.313357Z","members",[],{"_87":20,"_32":163,"_126":164,"_165":166,"_31":167,"_131":168,"_169":170},"BepInEx modloader. Preconfigured and ready to use.","https://gcdn.thunderstore.io/live/repository/icons/BepInEx-BepInExPack_Necropolis-5.4.2304.png","is_active",true,"BepInExPack_Necropolis","BepInEx","version_number","5.4.2304",{"_31":180,"_40":181,"_37":182},{"_31":177,"_40":178,"_37":179},{"_31":174,"_40":175,"_37":176},"Audio","audio","1744","Tools","tools","1741","Mods","mods","1739","short_description","Thunderstore is a mod database and API for downloading mods","wiki_url","discord_url","https://discord.gg/2233yFQ","2025-11-18T16:00:15.386746Z","hero_image_url","https://gcdn.thunderstore.io/assets/necropolis/necropolis-bg-1920x620.webp","cover_image_url","https://gcdn.thunderstore.io/assets/necropolis/necropolis-cover-360x480.webp","community_icon_url","https://gcdn.thunderstore.io/assets/necropolis/necropolis-icon-192x192.webp","total_download_count",2894,"total_package_count",18,{"_31":143,"_119":20,"_183":-5,"_32":184,"_185":-5,"_186":187,"_42":188,"_189":190,"_191":192,"_126":-5,"_193":194,"_195":196,"_197":198},{"_27":201},[202,203,204,205,206,207,208,209,210,211],{"_35":214},{"_31":32,"_33":215},{"_102":116,"_33":117},{"_102":114,"_33":115},{"_102":112,"_33":214},{"_102":110,"_33":213},{"_102":108,"_33":194},{"_102":107,"_33":212},{"_102":105,"_33":212},{"_102":103,"_33":104},"88","Thunderstore is a mod database and API for downloading Necropolis mods","The Necropolis Mod Database","Mods for Necropolis","publicEnvVariables",{"_240":238,"_241":238,"_242":238,"_243":244,"_245":246,"_247":238,"_248":249,"_250":251,"_252":253},"currentUser","config",{"_237":238,"_239":-7},{"_27":222},[223,224,225,226,227,228],{"_35":104},{"_31":32,"_33":236},{"_31":235,"_33":234},{"_31":233,"_33":234},{"_231":232},{"_31":229,"_33":230},"viewport","width=device-width, initial-scale=1","charSet","utf-8","theme-color","#29295b","msapplication-TileColor","An ecosystem for sharing mods for games!","apiHost","https://thunderstore.io","sessionId","VITE_SITE_URL","VITE_BETA_SITE_URL","VITE_API_URL","VITE_COOKIE_DOMAIN",".thunderstore.io","VITE_AUTH_BASE_URL","https://auth.thunderstore.io","VITE_AUTH_RETURN_URL","VITE_CLIENT_SENTRY_DSN","https://0dde07a3b02487bf768e90666ab8a83f@o578525.ingest.us.sentry.io/4509966833352704","VITE_RYBBIT_SITE_ID","00e7a81e15fc","VITE_RYBBIT_ANALYTICS_HOST","https://rybbit.thunderstore.io/api"]

Details

Categories

General Guide - Replacing Sounds