DODI Eight Ball Pool for RedM

VIDEO: https://youtu.be/mVxsuiC5CVY

A realistic 8-ball pool game script for RedM, featuring two locations: Saint Denis and Rhodes. Challenge other players in a classic 1v1 game of 8-ball pool.

Attention: RedM artifacts must be version 14862 or newer. If you use an older version, the system may not work correctly.
Always download the latest artifacts to ensure compatibility and avoid bugs.

Features

All balls are custom props for RedM, made by me: Dodiban Scripts, colored balls, (white) ball, cue stick, and the table.  

The models are exclusive and optimized for this script, ensuring authentic visuals and good performance.  

**Included 17 custom props:**

- p_ball_fullwhite (cue/white ball)

- p_ball_one_yellow (1 yellow)

- p_ball_two_blue (2 blue)

- p_ball_three_red (3 red)

- p_ball_four_purple (4 purple)

- p_ball_five_orange (5 orange)

- p_ball_six_green (6 green)

- p_ball_seven_brown (7 brown)

- p_ball_eight_black (8 black)

- p_ball_nine_yellow (9 yellow striped)

- p_ball_ten_blue (10 blue striped)

- p_ball_oneone_red (11 red striped)

- p_ball_onetwo_purple (12 purple striped)

- p_ball_onethree_orange (13 orange striped)

- p_ball_onefour_green (14 green striped)

- p_ball_onefive_brown (15 brown striped)

- pool_dodi (custom pool table)

- cuestick (wood cue stick)

**Features:**

- Realistic pool physics and ball movement

- Competitive 1v1 multiplayer

- Score tracking system

- Group system (Solids/Stripes)

- Realistic cue stick animations

- Dynamic ball pocketing system

- Auto-respawn for cue ball

- Anti-cheat measures

- Cooldown system between shots

- Intuitive controls

**Two pool table locations:**

  - Saint Denis Saloon

  - Rhodes Saloon

**(2 TABLES ONLY - YOU CAN CHANGE LOCATIONS)**

## Controls

- `G` - Join game/Start aiming

- `SPACE` - Take shot

- `←→` - Rotate aim

- `↑↓` - Adjust shot power

- `Q` - Leave game

## Game Rules

- Standard 8-ball pool rules

- Two players required to start a game

- First ball pocketed determines player groups (Solids/Stripes)

- Black ball (8) must be pocketed last

- Pocketing the 8-ball before clearing your group results in loss

- Automatic turn switching

- Score tracking UI during the game

## Installation

1. Copy the `resources/dodi_eightball` folder to your server's resources directory

2. Add `ensure dodi_eightball` and `ensure dodi_8ballprops` to your `server.cfg`

3. Restart your server

## Dependencies

There is no dependency is Standalone!

## Configuration

The script includes a `config.lua` file where you can adjust:

- Table positions and rotations **(2 TABLES ONLY - YOU CAN CHANGE LOCATIONS)**

- Ball heights and positions

- Pocket positions and sizes

- UI text and notifications

- Game mechanics settings

## Technical Features

- Server-side synchronization with Global.StateBag

- Client-side physics synchronization Server-side

- Anti-glitch protection

- Out-of-bounds detection

- Automatic ball repositioning

- Score tracking UI persistence during the game

> **Notice:** Depending on the host's internet connection, you may experience desync or lag during gameplay. This is a limitation of networking in RedM and is not caused by the script itself.

## FAQ

**How many tables can I place?**  

Currently, the script supports up to 2 tables. You can change their positions in `config.lua`.

**Do I need a database?**  

No, the script is fully standalone and does not require a database.

**Does the script work on public servers?**  

Yes, it works on any RedM server.

**What if the balls bug out or disappear or something strange?**  

The script has anti-glitch protection, but if it happens, move away from the tables more than 20 meters that they disappear and reset the game pool.

**Is there support for more than two players?**  

No, only two players per table.

## Support

For support, bug reports, or feature requests, please open an issue on our GitHub repository.

## Credits

Created by Dodiban Scripts

For RedM Framework

## License

This resource is protected under copyright law. Unauthorized distribution or modification is prohibited.