Air Hockey puts real air hockey tables on your FiveM server. A player walks up to a table, presses E and picks an opponent: the bot, or anybody standing nearby. The camera drops behind their end of the table, the mouse takes the paddle, and the puck flies across a near-frictionless surface, rebounding off the rails until somebody puts it in the goal. First to ten goals wins — or whoever leads when the three-minute clock runs out.
The puck runs on real physics — it takes the momentum of the paddle that hits it, rebounds with almost no loss and never slips through a paddle, however hard the shot — and both players see the same match, kept in sync around sixty times a second. Everyone nearby watches the puck fly and both players lean over the table. Tables are placed in game with the creator and saved to the database, written into the config, or picked up automatically from any map that already has GTA V's air hockey table. There is nothing to stream and nothing extra to download.
Where to start#
Page | What it covers |
|---|---|
Requirements, download, load order, the database, and the permission for the table creator. | |
Placing tables, starting a game, paddle control and puck physics, the bot, duels, entry fees, spectators and calibration. | |
Frameworks, money, your own currency, permissions, notifications, map tables and languages. | |
Every command, every key at the table, while playing and while placing a table, and what other scripts can read. | |
What each problem and each message means, and what to change to fix it. |
What it does#
Area | Details |
|---|---|
Puck physics | A puck that glides almost without friction, rebounds off rails and paddles, takes the paddle's momentum on every hit and never crawls to a stop. A top speed and sub-stepped collisions keep the hardest shot from passing through a paddle. |
Paddle control | The mouse drives the paddle directly, seen from a camera behind your end of the table. Each player keeps to their own half, as in the real game. |
Rules | First to 10 goals, or the leader when the 3-minute clock runs out — a draw if level. Both are set in the config, and the clock can be turned off. |
Player vs Bot | A bot at the far end that reads the puck, predicts bank shots off the side rails and attacks loose pucks in its half, with speed, positioning and accuracy you can tune. |
Player vs Player | Challenge anybody within 15 m from a list. They accept on their own screen and are taken to the far end of the table; both pay the table's entry fee and play the same synchronised match. |
Creator | Set tables down with a live preview wherever you aim, name them, give them an entry fee in cash or from the bank, and edit, delete or teleport to them from one list. |
Spectators | Everyone near a table sees the puck, the paddles and both players leaning over the table — the bot included — even if they arrive halfway through a match. |
No streaming | GTA V's own air hockey table, paddles and puck. Arcades and MLOs that already have an air hockey table become playable on their own. |
Frameworks | ESX, QBCore and Qbox detected on their own, or standalone. Optional |
Languages | 41 complete translations, from Arabic to Chinese, for both the notifications and the interface. |
Running your own economy? Entry fees can be paid in casino chips, a VIP coin or anything else you keep, by defining two small functions in the config. See Integrations.



