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
- Place
murderface-petsin your resources folder - Add
ensure murderface-petsto your server.cfg (after ox dependencies) - Add pet items to your ox_inventory
items.lua(see item definitions below) - Add ace permission for admin commands:
add_ace group.admin murderface-pets.petshop allow - Restart server — DB tables auto-create on first start
murderface_pets— pet data backupmurderface_stray_trust— stray taming progressmurderface_doghouses— placed doghouse positionsmurderface_breeding— breeding recordsmurderface_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
| Command | Permission | Description |
|---|---|---|
/sit |
Everyone | Pet sits for a few seconds then resumes following |
/come |
Everyone | Pet stops waiting and follows you |
/stay |
Everyone | Pet stays at current position |
/heel |
Everyone | Pet follows closely at your side |
/speak |
Everyone | Pet barks on command |
/lay |
Everyone | Pet lays down |
/paw |
Everyone | Paw shake trick (level-gated) |
/petname |
Everyone | Show current pet's name and level |
/petemote <name> |
Everyone | Play a pet emote |
/petshop |
Admin | Open breed picker, place display dogs |
/petshop remove |
Admin | Remove nearest display dog |
| Key | Action |
|---|---|
] (RBRACKET) |
Open pet companion menu |