Billiards (Pool) brings real pool tables to your FiveM server. A player walks up to a table, presses E and chooses how to play: against a bot that walks round the table and lines up its own shots, against other players with a bet on the table, or alone to practise. The camera drops behind the cue ball, an aim line shows where the first ball will be struck, and a power bar fills while the right mouse button is held — release it and the balls roll with real physics, rebound off the cushions and drop into the pockets.
Four game modes are built in — 8-Ball, 9-Ball, Straight Pool and Practice — each with its own rules, fouls and ball in hand. Everyone near a table watches the same shot: the shooter bent over the rail with the cue, and every ball rolling in time. 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 a pool table.
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, taking a shot, the four modes and their fouls, entry fees and bets, the bot and calibration. | |
Frameworks, money, your own currency, notifications, the prompt, map tables, new table models and languages. | |
Every command, every key at the table and in the creator, and the bridge functions you can change. | |
What each problem means, and what to change to fix it. |
What it does#
Area | Details |
|---|---|
Tables | The two pool tables of GTA V — the classic green and the classic purple — spawned wherever you place them, or the ones already in your maps. Loose map cues, triangles and cue balls lying on them are hidden. |
Physics | Rolling friction, cushion rebounds, ball-to-ball collisions and six pockets, simulated 240 times a second. Real ball props that spin as they roll. |
Shooting | An aim camera behind the cue ball, an aim line with a ghost ball, fine aim, a power bar and an overhead camera while the balls roll. Ball in hand anywhere on the cloth. |
Game modes | 8-Ball for two, 9-Ball and Straight Pool for up to four, and Practice alone — each with its own fouls, ball in hand and way to win. |
Player vs Bot | Easy, Normal and Hard, played by a ped that walks to the shot, leans over the table and strikes. It looks for a pot on every shot and plays safe when there is none. |
Player vs Player | Open a table and let others join from an invitation, or break straight away. An optional bet goes into a pot and the winner takes it all. |
Creator | Place, rename, move, price and delete tables in game. Each table can charge an entry fee in cash or from the bank and offer its own list of modes. Teleport to any table from the list. |
Spectators | Everyone within 60 m sees the shooter's stance, the cue strike and every ball roll, including players who arrive halfway through a game. |
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 and bets can be paid in a VIP coin, casino chips or anything else you keep, by defining three small functions in the config. See Integrations.