REALISTIC POOL
PROPS & SCRIPT
VIDEO PREVIEW
The most complete pool system for FiveM. Real physics, real rules, real competition.
REAL PHYSICS, NOT ANIMATIONS:
- Every shot is a real simulation: ball to ball hits at the true contact point, cushion rebounds, rolling friction and pockets.
- The server simulates and judges every shot. Every client plays back the exact same shot, so all players at the table see the same thing, every time.
- The balls visibly roll and spin across the cloth as they travel.
- Works on GTA's own pool tables and on custom table models of any size.
CUE BALL SPIN:
- Press F while aiming to zoom in on the cue ball, then move the tip with W/A/S/D.
- Draw: hit low and the cue ball comes back after a full hit.
- Follow: hit high and it rolls on through.
- Stun: hit just below centre and it stops dead.
- English: hit left or right to change the angle it comes off a cushion.
- Draw wears off over distance, just like a real table.
- The cue in the game moves to where you aim, a red marker shows the contact point, and the aim guide bends to show where the cue ball will go.
JUMP SHOTS:
- Raise the butt of the cue and the cue ball leaves the cloth, flying over balls in its way.
- Hit harder to jump higher. Overdo it and the ball can fly off the table (a foul), and it can even knock over a player standing nearby.
AIM GUIDE:
- Shows the cue ball's path, a ghost ball where it meets the first ball, the object ball's path and where the cue ball goes after the hit.
- Turns green when your ball is heading for a pocket, red when the cue ball is about to scratch.
- Fills in your called ball and pocket for you when it sees a pot.
- Players can hide it, and a match leader can turn it off for everyone.
CURVE SHOTS:
- Put side spin on the cue ball and raise the cue: the cue ball curves around a ball in its way, towards the side you hit. More side spin and a higher cue curve more.
- The bend is the same at any power. In other games the aim guide draws it; Curve Shot Pool has no aim guide, so every curve is down to skill.
EIGHT GAME MODES:
- 8-Ball: solids and stripes, clear your group and sink the 8.
- 9-Ball: hit the lowest ball first, sink the 9 to win. Push out after the break.
- Straight Pool: call every ball, first to the target score. Full 14.1 re-racks.
- Bank Pool: only banked balls count.
- Kick Shot Pool: the cue ball must hit a cushion before the called ball.
- Jump Shots Pool: only jumped balls count.
- Curve Shot Pool: no rack. Every shot gets a new random layout with a target ball and a blocker in the way. Curve around the blocker and sink the target for a point, taking turns, first to 5, 10, 15, 20 or 25. Every layout is checked by the server to be makeable.
- Shot Glass Pool: jump the cue ball over a line of balls and smash a pyramid of shot glasses. Every glass that falls is a point. The cue ball starts in the kitchen, the wall stands near the foot rail and the line moves to a random distance every shot. The wall size (3, 6, 10 or 21 glasses) is picked in the menu.
MATCHES AND THE REFEREE:
- 1v1 or 2v2. Teammates take turns, and the scoreboard shows who is up next.
- Single racks, races (best of 3, 5...) or points to a target.
- Two rule presets: Casual and Official (WPA). Called shots, push outs, three fouls in a row and WPA break rules.
- The server referee calls every foul: scratches, wrong ball first, no rail after contact, missed calls, balls off the table. Ball in hand is given on the
whole table or behind the head string, as the rules say.
- Safeties, push outs and every decision the rules allow (take the table or hand it back).
- Invite nearby players from the menu. They accept on screen.
- Walk away or leave the server mid-match and you forfeit.
- A live scoreboard with player photos, groups, balls left, fouls and what the rules need next.
- A live feed shows who pocketed which ball to everyone nearby.
PLAY THE COMPUTER:
- A bot opponent with four levels: Easy, Medium, Hard and Pro.
- It uses the same physics as you. It looks at real shots, plays position for its next shot on the harder levels, and plays safe when nothing is on.
- An NPC stands in for it at the table, walks up to the cue ball and takes its shot.
WAGERS:
- The match leader sets a buy-in. Every player pays when the match starts, and the winners split the pot.
- Optional house cut, and an optional fee to start a match.
- Crash-safe: open stakes are saved, so a crash or restart refunds every player automatically.
- A match ended without a result refunds everyone.
LEADERBOARD:
- A leaderboard page in the guidebook: the top players by wins, win rate, balls pocketed or earnings.
- Filter by game mode.
- Your own record and rank, best win streak, the most played games and the latest results.
- Matches against the bot do not count by default, so nobody can farm the easy level.
TABLES AND CUES:
- Place pool tables anywhere from an inventory item, and pick them up again. Placed tables are
saved and come back after a restart.
- Add any pool table model: stand at it, run /pooltable, line it up and paste one line in the config.
- Wall cue racks to grab a cue, or carry your own cue item.
- Several cue models, each with its own item, grip and animations.
- Custom carry and aiming animations (included).
GUIDEBOOK:
- A full illustrated guidebook opened at any table: getting started, controls, every game mode with diagrams, fouls, matches, wagers, a pool glossary and the leaderboard.
BUILT FOR SERVERS:
- Works with Qbox, QBCore and ESX, with ox_inventory, qs-inventory, qb-inventory or the ESX inventory, or standalone. Detected automatically.
- Everything framework specific lives in one bridge folder. Adding another framework only takes filling in a few functions.
- Every text players see is in one language file, ready to translate.
- Every key can be changed.
- Secure: players only send their aim and calls. The server simulates, judges and pays out, and every input is checked and rate limited.
- Light on performance: nothing runs when nobody is near a table.