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

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 `qs-interface` and `qs-textui` support.
Languages	41 complete translations, from Arabic to Chinese, for both the notifications and the interface.

Where to start#

What it does#