Battle Buddies adds a full battle-pet system to your FiveM server: catch pets in the wild, build a team, level up (1–25), and fight NPC trainers or other players. Designed to fit naturally into existing servers as a complementary minigame, players can battle casually, or deep-dive with team building and collecting.

What’s Included

• 19 pet species from the base game
• 25 NPC trainers placed around the world
• 27 wild zones, each with their own species pools
• 1 pet vendor selling bandages, cages, and starter pets
• 62 abilities balanced for PvE and PvP
• 29 auras (multi-turn buffs/debuffs) applied via pet abilities
• Extensive Lua exports for integrations (start battles, manage pets, reward trainers, etc).

The Pet Journal

Collect, view, and manage your pets inside a journal UI.

• Max 3 pets per team (1 active pet + 2 reserves)
• Swap ability loadouts per pet (3 active abilities equipped at once)
• Heal wounded or dead pets in the journal with pet bandages

Compatible With Any Ped

If it’s a Ped model, it can be used in battle. Automatically supports Popcorn RP animals including:

• Robot Dog, Armadillo, Chow Chow, Cockroach, Dalmatian, Doberman, German Shepherd, Tarantula
• Otter
• Raccoon
• Alligator
• Capybara
• English Bulldog
• Hippo
• Arctic Fox
• Husky Puppy
• Malinois Puppy
• Pygmy Hippo
  and more coming soon!

PvP Duels

Battle other players in 1v1 duels. PvP is optional and can be toggled on/off at any time in the pet journal (or disable entirely within the config.lua).

Wild Pet Capturing

Buy cages from the pet vendor and capture wild pets once they’re below 35% HP.
Capture odds increase after each failed attempt.

Captured pets show up instantly in the journal. You can also cage a pet into an inventory item (keeps its stats) for trading.

Optimized + Server-Validated

Wild pets, trainers, and shops stream in near players and despawn after leaving the area. It’s built to be lightweight. If no one is in a wild zone, the wild pets are unloaded.

Battle actions are server-validated to prevent invalid moves or client-side cheating.

Highly Configurable + Expandable

Customizing the resource to fit your own needs is always great. With the extensive config, you can tweak it to play exactly how you want it to.
In addition, a plethora of exports are available. Add new abilities, species, trainers, zones, and shops, all explained extensively in the docs.

Docs / exports:  View on GitBook

Supported Frameworks

QBCore, QBox, ox_core, ESX, and standalone
Standalone uses commands instead of third-eye targeting.

Requires ox_lib as a dependency.