Custom Weapon Sounds - user-grinch/ModelExtras GitHub Wiki

🔫 Overview

The Custom Weapon Sound Loader enhances the audio experience in GTA San Andreas by allowing custom weapon sounds. 🔥 It loads sounds from the ModelExtras/audio/weapon directory and supports newly added weapons seamlessly. 🎵🔉

These weapon types aren't supported at the moment,

  1. Minigun
  2. Chainsaw
  3. Fire Extinguisher
  4. Flame Thrower
  5. Rocket Launcher

📂 Setup

1️⃣ Directory Structure

📁 Navigate to ModelExtras/audio/weapon in your GTA SA directory.
📌 Create a subdirectory for each weapon you wish to customize.
🔹 The subdirectory must contain a .earshot file with the weapon's name in WEAPON.DAT or in the .txt file (if added via modloader without replacing).

2️⃣ Supported Audio Formats

.ogg and .wav are the supported formats. Audio must be in mono channel to work.

3️⃣ Sound Files

Each weapon folder should contain these files:
🎯 shoot.oggSound played when the weapon fires
🔄 reload.wavSound played when reloading
⚔️ swing.oggSound played when swung (if applicable)
💥 hit.wavSound played on impact (if applicable)
🚀 projectile.oggSound for projectiles (if applicable)

📌 Examples

🟢 Custom Sound for a New Weapon (e.g., "sniper_rifle2")

1️⃣ Navigate to ModelExtras/audio/weapon
2️⃣ Create a folder named OPSniperRifle
3️⃣ Add the sound files inside:

📁 ModelExtras/audio/weapon/OPSniperRifle // Folder name can be anything
   ├── shoot.ogg
   ├── reload.wav
   ├── swing.ogg
   ├── hit.wav
   ├── sniper_rifle2.earshot // This must match the weapons name

🔵 Custom Sound for a Vanilla Weapon (e.g., "AK47")

1️⃣ Navigate to ModelExtras/audio/weapon
2️⃣ Create a folder named LegendaryAK
3️⃣ Add the sound files inside:

📁 ModelExtras/audio/weapon/LegendaryAK // Folder name can be anything
   ├── shoot.ogg
   ├── reload.wav
   ├── swing.ogg
   ├── hit.wav
   ├── hit.wav
   ├── ak47.earshot  // This must match the weapons name

Note: The name of the .earshot file must match the weapon name inside weapon.dat file

Now your weapons will have custom sounds, making the game more immersive! 🔊💥🔥

⚠️ **GitHub.com Fallback** ⚠️