A natural companion pet system for FiveM (QBox/QBX framework). Pets act like real pets — they follow you, defend you, react to their environment, and interact with other pets, all without constant menu management.

• Auto-idle: Pet sits when you stop, wanders and sniffs around, plays random anims, then cycles back
• Speed-matching follow: Pets walk when you walk, jog when you jog, sprint when you sprint
• Sprint ahead: Dog runs out in front when you sprint, falls back behind when you slow down
• Move rate override: Physically faster movement (1.0x idle to 1.8x catch-up) via SetPedMoveRateOverride
• Auto-defend: Pet attacks anyone who hurts you — no toggle needed, scales by level
• Gunshot reactions: Small pets cower, large pets bark and go alert
• Ambient vocalizations: Random barks, whines, and mood changes while following
• Stranger alert: Barks at NPCs who get too close
• Sprint excitement: Barks happily when you start running
• Water reactions: Excited bark entering water, shake off leaving

• Up to 2 active pets simultaneously
• Lateral spacing — pets walk side by side, not stacked
• Sibling interactions — your own pets sniff and bark at each other during idle
• Independent follow offsets (left/right of player)

8 large dogs, 3 small dogs, 2 cats, 3 wild/exotic, 2 small animals, 2 primates, plus 10 addon breeds (requires addon ped streaming resource). Police K9 available for law enforcement jobs.

• 10 XP sources: passive, hunting, petting, tricks, feeding, watering, K9 search, healing, guarding, tracking, defending
• Level-gated unlocks: hunting (3), guard mode (5), speed tiers (10/25), specializations (20)
• 5 level titles: Puppy, Trained, Veteran, Elite, Legendary
• Milestone celebrations at levels 10, 25, 50

• Guardian: 1.5x guard radius, +50 combat ability
• Tracker: Detect and highlight nearby peds within 50m
• Companion: 2x stress relief, 2x regen, 1.25x XP

• Guard mode: Pet guards a position and attacks intruders
• Aggro/defense: Auto-attacks threats to owner (always-on for dogs/wild)
• Hunting: Hunt and Hunt & Grab with corpse carry
• K9 search: Person and vehicle search for illegal items (police jobs)

• 3 color variants (Black, Yellow, Green)
• Physical leash prop attached between player hand and pet neck
• Script-side distance enforcement
• Network synced — other players see the leash
• Auto-detaches on despawn, death, vehicle enter

• Pick up small/medium pets with carry animation
• Auto-drops on vehicle enter, combat, logout

happy, angry, sad, bark, sit, sleep, dance, paw, lay, fetch (throws a ball!)

• Wild animals at config-driven spawn points
• Trust-building through feeding (persisted in DB)
• Rare coat variants on tamed strays

• Placeable doghouse prop with rest bonus aura
• Same-model, opposite-gender, level 10+ breeding
• 24h cooldown per parent, offspring metadata pre-generated

• Admin places display dogs at kennel locations in-game
• Players walk up and buy via ox_target
• DB-persisted, proximity-spawned display dogs
• Works standalone — no dependency on external shop resources

• Pets swim instead of drowning (SetPedDiesInWater + config flag 65)

• Auto-board when owner enters vehicle
• Auto-exit to left side with ground detection when owner exits
• Skip invisible vehicles (skateboard BMX fix)
• Dead pets don't board

• qbx_core (QBox framework)
• ox_lib
• ox_target
• ox_inventory
• oxmysql

• Addon ped streaming resource for extra breeds (Doberman, Cane Corso, English Bulldog, Sphynx Cat, etc.)
• Police K9 ped streaming resource for the Police K9 breed

1. Place murderface-pets in your resources folder
2. Add ensure murderface-pets to your server.cfg (after ox dependencies)
3. Add pet items to your ox_inventory items.lua (see item definitions below)
4. Add ace permission for admin commands:

   add_ace group.admin murderface-pets.petshop allow
   

5. Restart server — DB tables auto-create on first start

• murderface_pets — pet data backup
• murderface_stray_trust — stray taming progress
• murderface_doghouses — placed doghouse positions
• murderface_breeding — breeding records
• murderface_petshop_displays — admin-placed shop display dogs

All settings are in config.lua:

• Pet definitions, prices, and traits
• XP rates and progression gates
• Guard, aggro, and combat settings
• Ambient behavior tuning (vocalize chance, idle thresholds, reactions)
• Movement rate multipliers
• Leash settings
• Pet carry settings
• K9 illegal items list
• Stray spawn points
• Breeding rules
• Notification system (ox_lib or rtx_notify)

Pets respond naturally to what you're doing — no commands needed:

• Owner sits down — pet walks over and lays at your feet
• Owner eats/drinks — dog whines and begs for food
• Owner goes AFK (2 min) — pet sleeps nearby, barks when you return
• Owner dies — pet sits by your body and whines

MIT