🎙️Custom Sounds for Pets (Vocalization)

🎤 Custom Sounds for Pets

Attention: This custom sounds (vocalization) system will not work for certain actions for some animals such as (Lion, Tiger, Capybara, Puma) because the models were made based on dogs to function correctly with our system. Bellow the table from actions not will change the sound.

Actions	Work / Not Work	Detail
Cuddle	⛔ Not work	Keeps making dog sounds
Following	⛔ Not work	Keeps making dog sounds wehn follow/running
Bump	⛔ Not work	Keeps making dog sounds
Bark while running	⛔ Not work	Keeps making dog sounds
Bark K9	✅ Work	After you use Bark K9 interaction with other player
Whine	✅ Work	Sad, hungry, thirsty, and low on health
Growl	✅ Work	Hungry and angry
Agitated	✅ Work	Playing and happy
Idle Sounds (Panting)	⛔ Not work	Keeps making dog sounds

NEW FEATURE! This feature is fully compatible with existing shops. Old shops will maintain their pet placed by default.

📋 Overview

The Custom Sounds system lets you use audio files (.ogg) for pet vocalizations instead of GTA’s native sounds. Cats can meow, lions/tigers can roar, and any pet can use unique sounds. URLs are configured in anims.lua in the Vocalization section of each category (BigDog, SmallDog, Cat, BigCat). Audio is played at the pet’s position via xsound.

Perfect for:

• 🐱 Cats with real meows (instead of no sound or dog sounds)

• 🦁 Big cats (lion, tiger, puma, capybara) with roars/grunts

• 🎶 Any pet with custom and realistc sounds (bark, growl, whine, etc.)

---

✨ Key Features

Feature

🎶 One sound per vocal type

Description

In Vocalization use customSoundBark, customSoundWhine, customSoundGrowl, customSoundAgitated, customSoundSniff, and optionally customSoundBarkSeq. If you set a custom, it takes priority; otherwise the native sound is used (when available).

Feature

❌ xsound optional

Description

If the xsound resource is not installed or not started, the system does not error: it simply does not play the custom sound and uses the native one (or nothing).

Feature

🐈‍⬛ Sound at pet position

Description

Sound is played at the pet’s position in the world (3D) using the xsound API.

Feature

🔧 Optional settings for each pet category.

Description

Inside the file public/config/anims.lua, you will find the VocalizeAnim and Vocalization options for each pet category.

---

🔧 How Configs and Setup Custom Sounds

---

Setup a Custom Sounds

1

Install (or update) dependencies

If you have already installed it, please check if it is on the latest version and ensure it is running before the cdev_lib and cdev_pets resources.

Releases · Xogy/xsoundGitHub

1. Download xsound-1.1-experimental.zip (or the latest stable release)

2. Extract the ZIP. After extracting, the folder will be named xsound-1.1-experimental (or similar).

3. Rename the folder to exactly xsound.

4. Place the xsound folder inside your server’s resources root folder (the same folder that contains cdev_lib, [cdev], [cdev_assets], etc.).

resources/
  xsound/           ← folder renamed to "xsound"
  cdev_lib/
  [cdev_assets]/
  [cdev]/cdev_pets
  ...

2

Start order in server.cfg

xsound must be started before cdev_lib and cdev_pets. Add this at the end of your server.cfg (after your other resources):

# cdev
ensure xsound
ensure cdev_lib
ensure [cdev_assets]
ensure [cdev] -- or cdev_pets 

3

Place sound files in xsound

You can download the sounds from websites such as: Meow Sound and it will be necessary to convert them from .mp3 to .ogg.

1. Open the xsound folder you placed in resources/.

2. Go into html/sounds/.

3. Put your .ogg files in that folder (e.g. meow.ogg, lion_roar.ogg).

Example structure:

resources/xsound/
  html/
    sounds/
      meow.ogg
      lion_roar.ogg
      cat_hiss.ogg

4

Configure URLs in anims.lua

To find out which anims category is being used, you can open the file pets.lua located at cdev_pets > public > config > pets.lua and search for Animations = DogAnims.

1. Open cdev_pets/public/config/anims.lua.

2. Find the pet category you want to customize: BigDog, SmallDog, Cat, or BigCat (each has a Vocalization block).

3. Inside Vocalization, add (or uncomment) the custom sound keys. The URL must point to the file inside xsound:

   • Format: nui://xsound/html/sounds/FILENAME.ogg

Example for Cat (meow):

Vocalization = {
    animalType = 3,
    bark = nil,
    bark_seq = nil,
    whine = nil,
    growl = nil,
    agitated = nil,
    sniff = nil,
    -- Custom sounds (xsound)
    customSoundBark     = "nui://xsound/html/sounds/meow.ogg",
    customSoundBarkSeq  = "nui://xsound/html/sounds/meow2.ogg",
    customSoundWhine    = "nui://xsound/html/sounds/cat_whine.ogg",
    customSoundGrowl    = nil,
    customSoundAgitated = "nui://xsound/html/sounds/cat_hiss.ogg",
    customSoundSniff    = nil,
    vocalizeLabelKey = "pet_meow",
},

Example for BigCat (lion, tiger, puma, etc.):

Vocalization = {
    animalType = 3,
    bark = nil,
    bark_seq = nil,
    whine = nil,
    growl = nil,
    agitated = nil,
    sniff = nil,
    customSoundBark     = "nui://xsound/html/sounds/lion_roar.ogg",
    customSoundBarkSeq  = "nui://xsound/html/sounds/lion_roar2.ogg",
    customSoundWhine    = "nui://xsound/html/sounds/lion_whine.ogg",
    customSoundGrowl    = "nui://xsound/html/sounds/lion_growl.ogg",
    customSoundAgitated = "nui://xsound/html/sounds/lion_snarl.ogg",
    customSoundSniff    = nil,
    vocalizeLabelKey = "pet_vocalize",
},

If you set a custom for a type (e.g. customSoundBark), that sound is used when the pet “barks” (or the corresponding action).

If you leave it nil, the system uses the native sound (when the category has one) or plays nothing.

---

🔊 Vocal Radius Sound Play

You can modify the distance at which players will hear the custom sounds. By default, it is set to a 40-meter radius, which is recommended. However, if you want to change it, simply open the file config.lua located at cdev_pets > public > config > config.lua (line 32).

-- Max distance (meters) for players to hear custom vocal (Meow/Bark, happiness, mood, etc.) when synced; only players within this radius receive the sound
VocalSyncRadius = 40.0,

❓ Frequently Asked Questions

Q: How can I play these sounds?

A: The sounds are triggered automatically based on the pet’s actions. The Bark and Sniff systems are only enabled when the pet is of type K9. If the pet is a K9, you can use the target or drawtext interaction to trigger the sound.

Q: What happens if I don’t install xsound?

A: Nothing breaks. The system checks if the xsound resource is started. If it isn’t, custom sounds are skipped and only native sounds are used (or none for cat/BigCat when they have no natives).

Q: Can I use only custom sounds and leave natives as nil?

A: Yes. For Cat and BigCat, natives are already nil. Just set the customSound* keys you want; when a custom exists, it has priority.

Q: What audio format should I use?

A: Use .ogg files in the xsound/html/sounds/ folder. The URL in the config should end in .ogg.

Q: Does the target label (Bark / Meow / Vocalize) change by category?

A: Yes. Each category has vocalizeLabelKey in Vocalization (pet_bark, pet_meow, pet_vocalize). The text shown in the target comes from the translation keys in data/languages (e.g. pet_meow = "Meow", pet_vocalize = "Vocalize").

Q: Do I need to restart the server after adding sounds?

A: After adding new .ogg files to xsound/html/sounds/ or changing anims.lua or Install xsound you need full server restart ensures xsound loads the files correctly.