Battle Buddies - A Pet Battle Script

A script by ahoffman

No reviews yet.
Battle Buddies - A Pet Battle Script main image

Full Description

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.).
  • Enable/Disable blood VFX & animal sounds

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.

Resmon

Idle
resmon - idle

In Wild Zones
resmon - wild zones

During Battle (orbit camera calculations, can be set to static)
resmon - battle

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


Many more features to come, including:

  • Further CPU usage optimizations
  • Treasure hunting pets
  • Job Animals
  • Weather Abilities
  • Pet Accessories, Leashes, Grooming Kits
  • Shinies
    …and much much more!

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


Purchase on Tebex


Supported Frameworks:
QBCore, QBox, ox_core, ESX, and standalone. Client/server bridge files are un-escrowed.
Standalone uses /pet commands instead of third-eye targeting.

Code is accessible Config, Abilities
Subscription-based No
Lines (approximately) ~41,000
Requirements ox_lib
Support Yes

Config Merger
Have you tried Config Merger? Merge your configs easily