Kivo Boxing
Kivo Boxing is a boxing arena for FiveM. Players sign up at a bouncer NPC, get matched with an opponent, and fight in rounds inside a ring. Anyone standing in the spectator area sees a live scoreboard.
What it does
Section titled “What it does”- A bouncer NPC that players interact with (through your target system) to sign up for a fight.
- Automatic matchmaking: the first player waits for a challenger, the second player starts the match.
- Round based matches with a configurable number of rounds, extra rounds, and round length.
- Knockouts: a fighter who is knocked out loses the round.
- Forfeit when a fighter stays outside the ring for too long.
- Boxing gloves, screen fades, round banners, a countdown and sounds.
- A scoreboard that fighters and spectators see during the match.
- A debug mode that lets one player fight an AI opponent for testing.
The script uses one arena. Only one match can run at a time.
Requirements
Section titled “Requirements”| Requirement | Needed | Notes |
|---|---|---|
| A supported framework | Yes | ESX (es_extended), QBCore (qb-core) or QBX (qbx_core). |
| PolyZone | Yes | Defines the ring and spectator areas. The resource folder must be named PolyZone. |
ox_target or qb-target |
Yes | Lets players interact with the bouncer. If both run, ox_target is used. |
ox_lib |
No | If it is running, notifications use its notification style. Otherwise they appear as chat messages. |
| A boxing ring in the world | Yes | The script does not create a ring. It expects one at the configured coordinates (map or MLO). |
No database, SQL file or inventory items are needed.
Game build: the manifest uses fx_version 'cerulean', game 'gta5' and Lua 5.4.
Start order
Section titled “Start order”Start these before kivo-boxing:
- PolyZone (the manifest lists it as a dependency, so a missing PolyZone stops the script from starting)
- Your framework (
es_extended,qb-coreorqbx_core) - Your target resource (
ox_targetorqb-target)
The script checks which framework and target are running when it starts. If either one starts later, the bouncer will not be interactive. See Installation.
Betting and rewards
Section titled “Betting and rewards”Config.lua has no betting, entry fee or reward options. Winners get a victory banner, a sound and a notification. There is no money or item payout in this version.
Documentation
Section titled “Documentation”- Installation: folders,
server.cfg, first test. - Configuration: every option in
Config.lua. - Ring and zone setup: moving the arena, drawing zones, placing fighters and the NPC.
- Matches and scoreboard: what players see from sign-up to the final bell.
- Examples and troubleshooting: ready-made configs, common mistakes and fixes.
Integration
Section titled “Integration”This version has no documented exports or events for other scripts. The integration points are the options in Config.lua and the supported framework and target resources. See the integration points section.
Back to the scripts index.
