STG ScriptsDocumentation
Billiards

Billiards

Free 8-ball, 9-ball and practice pool for FiveM with server side physics, a POV cue camera, live spectators and admin placed tables.

STG Billiards turns every pool table on the map into a playable game. Walk up to a table, pick 8-ball, 9-ball or solo practice and play from a camera right behind the cue ball. Every shot is simulated on the server, so both players and everyone watching see the exact same result. It is free.

Features

8-ball, 9-ball and practice

Solids and stripes with the 8 last, lowest ball first in 9-ball with three fouls in a row losing, or a solo rack to practice on.

Aim and power

Aim with the mouse, fine tune with Shift and hold the left mouse button to charge the 3D power bar next to the cue ball.

Three cameras

A POV camera behind the cue ball, a top view on C and a bird's eye camera that follows every shot.

Live spectators

Everyone near the table sees the balls roll, the players' poses and the cue in their hands.

Walk between shots

The player who is waiting walks freely and steps back to the table with the target when it is their turn.

Any table, anywhere

Every GTA pool table works out of the box. Admins place more tables anywhere with /pooladmin.

Rules

8-ball9-ball
BreakCue ball goes behind the head stringCue ball goes behind the head string
Legal first hitYour group, any ball except the 8 while the table is open, the 8 when your group is clearedThe lowest numbered ball on the table
GroupsYour first pocketed ball after the break picks solids or stripesNo groups
WinPocket the 8 after your groupPocket the 9 on a legal shot
LossPocketing the 8 early or on a foulThree fouls in a row
FoulsScratch, no ball hit, wrong ball first, no ball reaching a railSame
After a foulOpponent gets ball in hand anywhereOpponent gets ball in hand anywhere

The aim guide is chosen per table before the game starts: Full shows the cue ball path, the ghost ball and where both balls go after contact, Basic shows only the cue ball path and Off shows nothing.

Controls

KeyAction
MouseAim
Shift (hold)Fine aim
Left mouse (hold)Charge the shot, release to shoot
CSwitch between the POV camera and the top view
Mouse wheelZoom
BackspaceCancel the charge, or go back to placing the cue ball
GLeave the table

At a glance

PriceFree
Game modes8-ball, 9-ball, practice
TablesEvery GTA pool table plus admin placed tables
Access to /pooladminFramework permission groups, admin, god and superadmin by default
FrameworksESX, QBCore, QBOX through stg_lib
Languages17 included

Credits

Pool animations by Darks Animations (Pool Pack #1), used with credit.

Next steps

Still having trouble?

Open a ticket on our Discord. Our team answers around 15 hours a day.

Get help on Discord

On this page