Script docs · Free
Arm Wrestling
Arm wrestle any player at a table or a barrel, with stamina, bets, a rated ranking and tournaments.

- Version
- v1.0.0
- Frameworks
- ESX · QBCore · Qbox
- Requires
- ox_lib, oxmysql, OneSync
- Source
- Open source
- resmon
- 0.00 ms idle · 0.06 ms in a match
- Updated
- 18 Nov 2026
Arm wrestling for FiveM. Two players meet at a table or a barrel, one challenges the other, and they push against each other with the game’s own arm wrestling animations. Stamina makes it a match of timing instead of a tapping contest, players can bet in-game money, and every ranked match moves a rating that feeds a server ranking. ESX, QBCore and Qbox.
The server runs the match: it counts and rate-limits the pushes, applies stamina, moves the arm, picks the winner, pays the bet and saves the result. A modified client can’t win a match it didn’t play.
Made by XeX. Screenshots and the rest of the XeX scripts are on xexstudio.com.
Features
- Tables anywhere: props that already exist on the map (the arm wrestling table and wooden barrels by default)
through ox_target or qb-target, plus tables you place in the config with a map blip. Without a target resource,
[E]at the placed tables. - Challenge and accept: pick a player standing at the table, name a bet or play a friendly match, and the rival accepts or declines.
- Stamina: every push costs stamina and tired pushes are weaker. A steady rhythm keeps full power; a burst wins ground for a few seconds and leaves you weak. Both stamina bars are on screen, so you can strike when the rival is tired.
- Bets with in-game money: both stakes are taken when the challenge is accepted and the winner takes the pot. Draws and cancelled matches are refunded. Giving up, walking away or disconnecting during a match loses it.
- Rated ranking with divisions: each player has a rating and a division (bronze, silver, gold, diamond), and the number one is the champion. Beating a stronger player gives more points than beating a weaker one, and the result card celebrates a promotion. The ranking shows rating, wins and losses, best win streak and fastest win.
- Monthly seasons and hall of fame: on the first day of each month the top 3 go to the hall of fame and a new season starts. Best streak and fastest win stay as all-time records.
- Ranking on the wall: the season’s top 5 and the last champion painted on a wall next to the table (no props).
- Spectators: players around the table see the match live: both names, the arm, the stamina bars and the pot.
- Tournaments: single elimination at a table for 4, 8 or 16 players, seeded by rating, with byes, an entry fee that makes the pot, live bracket, matches called by the server and walkovers for whoever does not show up. Past winners go to the hall of fame.
- Match HUD and result card: arm position, time left, both stamina bars, pot, and the rating change at the end.
- Hooks and events for skills, battle passes, analytics or permissions, without editing the resource.
- Optimized: no threads while nobody plays and one database write per ranked match. Placed tables only exist while a player is close to them.
- English and Spanish.
Requirements
- ox_lib and oxmysql
- One framework: ESX, QBCore or Qbox
- OneSync (on by default on current servers)
- Optional: ox_target or qb-target (needed to use props that are already on the map)
Install
- Put
xex_armwrestlingin your resources folder. - Add it to
server.cfgafter your framework, ox_lib and oxmysql:ensure xex_armwrestling - Set the language with
setr ox:locale en(ores).
The xex_armwrestling table is created on start. If your database user can’t create tables, run
install/armwrestling.sql.
How it works
- At the table a player picks “Arm wrestle” and chooses one of the players standing next to it.
- Bet. The challenger names an amount (0 for a friendly match). The rival sees it and accepts or declines.
- Both stakes are taken, both players are placed at the table and a countdown runs.
- Push. Tap the push key. The arm moves towards whoever pushes harder; the match ends when it reaches one side, or after 45 seconds in favour of whoever is ahead.
- Result. The winner takes the pot, and a ranked match updates both ratings.
Hold the give-up key for a second to forfeit. During the countdown that cancels the match and refunds the bets; once the match has started it counts as a loss. A player who is downed cancels the match and both get their money back.
Stamina
With the default numbers a player keeps full power at about 5 to 6 pushes per second. Faster than that empties the bar in three to four seconds, and pushes with an empty bar are worth 30 %. Tapping as fast as possible therefore loses against a steady player over a full match; the skill is in when to spend the burst.
Ranking
Ratings start at 1000 and work like chess ratings: the points one player wins are the points the other loses, and the amount depends on the difference between them (16 between equals, up to 32). To keep it honest:
- matches shorter than
Config.Ranking.minDurationseconds are not ranked; - the same two players only get
Config.Ranking.pairLimitranked matches per hour (more can be played, unranked); - a player appears in the ranking after
Config.Ranking.minMatchesmatches.
The HUD shows whether the match is ranked before it starts.
Configure
| File | What it contains |
|---|---|
config.lua |
All settings (table below) |
locales/<locale>.json |
Every text: notifications, menus, HUD and ranking |
bridge/server.lua |
Framework, money, character names, downed check |
bridge/client.lua |
Notifications, target resource, downed check |
| Setting | What it does |
|---|---|
Config.Framework |
auto, or force esx / qb / qbox |
Config.Target |
auto, ox_target, qb-target or none ([E] at placed tables) |
Config.Controls |
Push and give-up keys with the label shown in the HUD |
Config.Models |
Props players can use, whether every one on the map counts, and how players stand at them |
Config.Tables |
Tables placed by the script: position, model, blip and an optional ranking board on a wall |
Config.Match |
Distances, invitation time, countdown, match length, push size, win point and the push rate limit |
Config.Stamina |
On or off, cost per push, recovery per second and power with no stamina |
Config.Bets |
On or off, account and maximum bet |
Config.Ranking |
On or off, size, starting rating, points per match, the rules above, divisions and seasons |
Config.Spectators |
On or off and how close players must be to watch a match |
Config.Tournaments |
On or off, who can host, sizes, sign-up time, entry limit, pot cut, call time and distances |
Config.WallBoard |
Distance at which wall ranking boards are drawn and how often they refresh |
Config.UI |
Brand name and accent color |
Config.Admin |
Ace and name of the reset command |
Config.Hooks |
Functions called by the server (see For developers) |
Props and tables
Config.Models = {
prop_arm_wrestle_01 = { world = true, aligned = true, axis = 0.0, offset = vec3(0.0, 0.0, 0.0) },
prop_wooden_barrel = { world = true, aligned = false, offset = vec3(0.0, 0.0, 0.0) },
}
Config.Tables = {
{ coords = vec4(-1226.8, -1557.87, 3.19, 303.77), model = 'prop_arm_wrestle_01', blip = true },
}
world = truelets players use every prop of that model on the map. Set it tofalseto allow only the tables you place.aligned = trueis for props with two sides: players stand along the prop’s own axis. If they end up across the table instead of along it, setaxis = 90.0.offsetmoves the centre of the scene if the hands don’t meet over the prop (x to the challenger’s right, y towards the rival, z up).
To add any other prop (a bar table, a crate), list its model and adjust offset in game.
Ranking board on a wall
Each table of Config.Tables can show the season’s ranking on a wall nearby. Stand in front of the wall, look at
it and run /armwrestlingboard: the line is printed in F8 and copied to the clipboard. Paste it into the table:
Config.Tables = {
{ coords = vec4(-1226.8, -1557.87, 3.19, 303.77), model = 'prop_arm_wrestle_01', blip = true,
board = { coords = vec4(-1205.10, -1559.80, 6.20, 215.0), width = 1.6 } },
}
Tournaments
- Host: at the table, pick “Tournament” and fill in a name, the size (4, 8 or 16) and the entry fee (0 for a free
one). By default only admins host; set
Config.Tournaments.host = 'everyone'to let any player do it. - Sign-up: players around the table are told, and sign up from the same option, paying the entry. They can leave and get it back until sign-up ends.
- Bracket: when the tournament is full or the sign-up time ends (with at least
minPlayers), players are seeded by rating. The best seeds get byes when the field is not a power of two. - Matches: the server calls each match. Both players have
callSecondsto come to the table; whoever is not there loses by walkover. A draw or a cancelled match is played again. Normal challenges wait while it runs. - Champion: the winner takes the pot (minus
cut) and is saved in the hall of fame.
Everyone can open the live bracket from the table. A player who disconnects during sign-up leaves the tournament and their entry stays in the pot.
Seasons and divisions
Seasons follow the calendar month. When a month ends, the top Config.Ranking.hallSize players of the season are
saved in the hall of fame and every rating, win and loss starts again; the ranking screen has a tab with the last
hallSeasons seasons. Set Config.Ranking.seasons = false for one endless ranking. Divisions are rating
thresholds in Config.Ranking.divisions (name, minimum rating and colour); add, remove or rename them freely.
Admin commands
/armwrestlingreset clears the whole ranking and /armwrestlingboard prints the coords of a wall ranking board.
Both are restricted to group.admin; change it in Config.Admin.ace.
For developers
exports.xex_armwrestling:IsWrestling(source) -- server
exports.xex_armwrestling:GetStats(identifier) -- server: { rating, wins, losses, streak, best_streak, fastest, rank, needed }
| Event (server, local) | Arguments |
|---|---|
xex_armwrestling:matchFinished |
data = { winner, loser, players, reason, duration, bet, ranked } |
xex_armwrestling:tournamentFinished |
data = { id, name, winner, runnerUp, players, pot, prize } |
winner and loser are server ids (nil on a draw), reason is pin, time or forfeit and duration is in
milliseconds.
AddEventHandler('xex_armwrestling:matchFinished', function(data)
-- battle pass progress, logs, analytics...
end)
Config.Hooks does the same from the config, plus a permission check and a strength multiplier:
Config.Hooks = {
canPlay = function(source)
return true -- false = this player can't arm wrestle right now
end,
power = function(source)
return 1.0 -- multiplier of every push, clamped between 0.5 and 1.5 (e.g. a gym skill)
end,
onMatchFinished = function(data) end,
onTournamentFinished = function(data) end, -- same data as the tournamentFinished event
}
Keep server-specific code in your own resource and listen to the event: updates of xex_armwrestling then never overwrite it.
Security
Players only ask to challenge someone, answer a challenge and say how many times they tapped. The server:
- accepts only props listed in
Config.Models, and for models that are not usable everywhere, only at a table ofConfig.Tables; both players must really stand at the table and the table must be free; - takes both stakes before the match starts, or neither, and pays or refunds them exactly once;
- accepts at most
Config.Match.maxPressRatepushes per second from each player, whatever the client sends; - applies stamina and strength itself, moves the arm and decides the winner and the time;
- ends the match if a player leaves, walks away or disconnects, and never ranks matches that were too short or repeated too often between the same two players.
FAQ
Do I need a target resource?
Only to use props that are already on the map. Tables from Config.Tables also work with [E].
Can I turn off the bets or the ranking?
Yes: Config.Bets.enabled = false and Config.Ranking.enabled = false.
Does a stronger character push harder?
Not by default. Return a multiplier from Config.Hooks.power to connect your own skills or gym resource.
The players stand in the wrong place at my table.
Adjust axis and offset of that model in Config.Models.
How do I reset the ranking?
/armwrestlingreset, or empty the xex_armwrestling table. With seasons on, it also starts again every month.
Can people watch?
Yes. Anyone within Config.Spectators.distance of a match sees it live; set enabled = false to turn it off.
License
MIT. Use it, change it and share it; keep the copyright notice. See LICENSE.