🎰Roulette

Custom roulette script for RedM RP Servers by DArkSouL.

Welcome to the d_roulette documentation! This RedM script brings an authentic, multiplayer roulette experience to Red Dead Redemption 2 roleplay servers. Players can gather around elegantly placed roulette tables across iconic locations in the game world, place bets using a wide variety of betting options, and watch the wheel spin in real-time with realistic physics.

Whether you're running a saloon in Valentine or a high-stakes gambling hall in Saint Denis, d_roulette provides a fully-featured, immersive gambling system that integrates seamlessly with major RedM frameworks.

---

Features

Gameplay Features

• Multiplayer Support: Up to 3 players can play simultaneously at each table with unique chip colors

• 14 Bet Types: Full American Roulette implementation including straight-up, split, street, corner, line, dozen, column, red/black, odd/even, and more

• Realistic Wheel Physics: Authentic ball trajectory with deceleration and pocket landing animations

• Interactive Betting System: Navigate 161 bet positions with arrow keys, visual markers, and live odds display

• Color Selection: Each player chooses a unique chip color for easy bet identification

• Action Timer: Configurable time limits to prevent AFK players from blocking tables

• Surrender Option: Players can leave mid-game with chip refunds (before spin only)

Technical Features

• Multi-Location Support: 5 pre-configured table locations (Valentine, Blackwater, Saint Denis, Tumbleweed, Armadillo)

• Dynamic Object Spawning: Tables, NPCs, chips, and wheels spawn automatically with LOD optimization

• Framework Agnostic: Built-in support for 8+ major frameworks (VORP, RedEM, RSG, QBR, QR, Gum)

• Economy Integration: Configurable chip prices, betting limits, and optional item-based buy-ins

• NUI Interface: Clean, immersive heads-up display showing game state and player information

• Discord Webhooks: Comprehensive logging for table creation, bets placed, game results, and more

• External Events: Triggers for win and loss outcomes, sending chip amounts, player IDs, and table data to external scripts

• Full Localization: Multi-language support (English, German, Russian) with easy expansion

• Custom Table Support: Use custom roulette table models with configurable offsets

• Console Commands: Admin tools for debugging, table management, and diagnostics

Configuration Features

• Per-Table Settings: Each location can have unique odds, chip prices, limits, and spawning options

• Flexible Odds System: Adjust payouts for each bet type independently to control house edge

• Chip Limit System: Optional maximum chip count per player to balance gameplay

• Key Binding System: Configurable controls using RedM native control hashes

• Webhook Granularity: Enable/disable specific webhook events for cleaner logging

---

Requirements

Server Requirements

• RedM Server: Latest recommended build

• Framework: One of the following:

  • VORP Core

  • RedEM:RP

  • RSGCore

  • QBR-Core

  • Gum Framework

  • (or standalone mode with custom integration)

Dependencies

• Framework Core: Must be started before d_roulette

• Inventory System: Framework-dependent (for optional item buy-ins)

• Discord Webhook (optional): For logging and monitoring

---

Installation

Step 1: Download & Extract

1. Download the d_roulette resource from your provider

2. Extract the folder to your server's resources directory

3. Important: Do NOT rename the resource folder (escrow protection requires original name)

Step 2: Configuration

1. Open config.lua in a text editor

2. Set your framework:

   Config.Framework = "vorp2"  -- Change to your framework

3. Set your language:

   Config.UsedLang = "en"  -- Options: en, de, ru

4. Configure table locations (see Configuration for details)

5. (Optional) Set up Discord webhooks for logging

Wen your`re using RSG-Framework, you have to add the ox_lib as shared resource into the fxmanifest.lua. Otherwise the notifications wont work

shared_scripts {
    '@ox_lib/init.lua',
}

Step 3: Server.cfg

Add the following to your server.cfg:

ensure d_roulette

Load Order Considerations:

• Ensure your framework core starts BEFORE d_roulette

• Example for VORP:

  ensure vorp_core
  ensure vorp_inventory
  ensure tm_modals
  ensure d_roulette

Step 4: Custom Table Assets (Optional)

If you want to use the custom roulette table model:

1. Navigate to d_roulette/custom_roulette_table/

2. Copy this folder to your resources directory

3. Add to server.cfg:

   ensure custom_roulette_table

4. In config.lua, change table model:

   tblObject = "c_roulettetable01x"

5. Restart Server

---

Compatibility

Framework Support Matrix

Framework	Version Tested	Status	Notes
VORP Core	Latest	✅ Fully Supported	Primary development framework
RedEM:RP	Latest	✅ Fully Supported	Tested with core v1.x
RSGCore	Latest	✅ Fully Supported	Includes notification system
QBR-Core	Latest	✅ Fully Supported	QBCore RedM port
QR-Core	Latest	✅ Fully Supported	Alternative QBCore port
Gum Framework	Latest	✅ Fully Supported	Custom notification handling

Game Version

• Red Dead Redemption 2: Build 1436.28 and later

• RedM: Latest artifact (recommended build 6683+)

---

Support

For technical support, bug reports, or feature requests, please join our Discord server:

Discord: https://discord.gg/JTYwrfeJK7

All support is handled exclusively through our Discord community.

---

Thank you for choosing d_roulette! Enjoy bringing authentic gambling experiences to your RedM server.