PRO Carrom Board Game System v1.0

[PRO] Multi-Table Carrom Board Game System​

Physics-Simulated, Animated AI Bots, & Proximity-Synced Spectator View (Commercial-Grade)​

Core Product Features​

1. Precision Local Physics Solver (Relatively-Mapped Physics)​

• Relative Calculations: All disk-on-disk collisions, rail bounces, friction damping, and pocketing checks are calculated in the local coordinate space of the active board.
• Infinite Placement & Rotation: Tables can be cloned, rotated at any angle, or placed anywhere in the workspace without affecting the simulation.
• Sub-Stepped Physics Loop: Runs 8 sub-steps per physics tick to prevent coins from tunneling through rails or overlapping at high velocities.

2. Adaptive R15 Animated AI Bot Rigs​

• Realistic Seated Animation: Bots use standard R15 rigs loaded with a custom looping sitting animation
• Auto-Join & Dynamic Cleanup: Bots spawn dynamically to fill empty slots and are automatically destroyed when a real player takes the seat, or when the game lobby resets.
• Mid-Game Bot Takeover: If a player disconnects or leaves mid-match, an AI Bot instantly takes over their seat and turns to ensure game continuity.

3. Proximity-Synced Spectator & Overhead Camera​

• Spectator Proximity Sync: Spectators walking around the game will automatically see their screen HUD and scores update in real-time to display the status of the closest active table.
• Overhead Camera Lock: Seated players have their camera locked to an overhead projection, aligned relative to their respective seat orientation (P1-P4).

4. Dynamic 3D Neon Trajectory Guides (Aim Assist)​

• Real-time Trajectories: A glowing neon yellow path shows the striker's projection and its precise impact point on target coins.
• Reflection Visualizers: Neon orange and green lines display the rebound paths of both the striker and the target coin after collision.

5. High-Fidelity Spatial 3D Audio & VFX​

• Velocity-Scaled Sound: Positioned impact sounds (wood clacks, rail thuds, pocket drops) scale their playback volume dynamically based on the impact velocity.
• Roblox Safety Compliant: Uses 100% public, verified Creator Store audio assets to avoid permission errors.
• Wood Dust & Sparks: High-speed collisions trigger realistic wood dust and golden spark particle bursts.

6. Hardened System Modularity & Stability​

• Anti-Asynchronous Lock: Features status guards that prevent the lobby state from freezing if a player leaves the table exactly while the striker is in motion. The server resets cleanly and immediately clears physics objects.
• CPU Throttle Optimization: The server shuts down the physics update thread completely when all coins on a table come to a halt.

System Architecture & File Structure​

1. Workspace.CarromSystem: Holds the physical board models (e.g. CarromTable, CarromTable2), seating, overhead light rigs (BoardLamp), and the folder for active coin parts.
2. CarromConfig (ModuleScript inside each table): Defines rules (minimum player count), geometry dimensions (coin/striker radii), coefficients of bounce/friction, and maximum speed.
3. ServerScriptService.CarromServer (Script): Serves as the central network router. Scans workspace tables, instantiates managers, and directs incoming requests.
4. ServerScriptService.CarromTableInstance (ModuleScript): The core OOP table manager. Handles turn rotations, bots, scores, physics step calculations, and cleanups.
5. StarterPlayerScripts.CarromClient (LocalScript): Controls local aiming input (mouse drag, touch swipe, spacebar charge), camera interpolation, and localized visual effects.
6. StarterPlayerScripts.CarromUI (ModuleScript): Controls UI transition tweens, mobile button visibilities, and Turn HUD updates.
7. StarterGui.CarromHud (ScreenGui): The responsive dark glassmorphic user interface containing the lobby menus, scoreboard, mobile controls, and turn alerts.
8. ReplicatedStorage.CarromRemotes: The network events bridging client input and server state broadcasts.

Configuration Module (CarromConfig)​

local CarromConfig = {
MinPlayersToStart = 2, -- Minimum players (players + bots) required to start
StopSpeed = 0.12, -- Speed threshold below which coins are marked as stopped

BoardHalfSize = 7.74, -- Half of the board width (studs)
CoinRadius = 0.26, -- Radius of the carrom coins
CoinHeight = 0.12, -- Height/thickness of the carrom coins
StrikerRadius = 0.38, -- Radius of the player's striker
StrikerHeight = 0.14, -- Height/thickness of the player's striker
PocketRadius = 0.42, -- Collision radius of the four corner pockets

Friction = 0.994, -- Friction multiplier applied per frame (damping)
RailBounce = 0.985, -- Elasticity of the board's wooden rails (0 to 1)
CoinBounce = 0.97, -- Elasticity of coin-on-coin collisions (0 to 1)
MaxSpeed = 48, -- Maximum velocity magnitude of the striker shot
}

Click to expand...

Easy Installation & Setup Guide​

1. Copy Assets to Services:
   • Drop the CarromSystem folder into Workspace.
   • Move CarromServer and CarromTableInstance to ServerScriptService.
   • Move CarromClient and CarromUI to StarterPlayer.StarterPlayerScripts.
   • Move CarromHud to StarterGui.
   • Place the CarromRemotes folder in ReplicatedStorage.
2. Adding More Tables:
   • Duplicate Workspace.CarromSystem.CarromTable to CarromTable2, CarromTable3, etc.
   • Shift the new model's position (e.g., offset by 28 studs along the X-axis) to prevent overlaps.
   • Duplicate BoardLamp and position it directly above the center of the new board at Y = 22.
3. Playtest & Enjoy:
   • Start a 2-player local test server in Roblox Studio.
   • Sit at different tables to play independent matches, or stand near any table to spectate active games instantly.