CodeRanch - Coin Toss & Dice Roll

Old Western Coin Toss & Dice Roll Gambling System for RedM

This script provides an immersive gambling system for RedM servers. Players can challenge each other to coin toss or dice roll games with customizable bets. The system features animations, sound effects, and full framework support.

🚀 Features

• Multi-Framework Support: VORP, RSG, QBR and Standalone

• Coin Toss Gambling: Classic heads or tails betting

• Dice Roll Gambling: Customizable dice with 2-20 sides

• Player vs Player: Challenge nearby players to wager matches

• Animated Gameplay: Realistic coin flip and dice roll animations

• Sound Effects: Immersive audio feedback for all actions

• Interactive UI: NUI interface for creating challenges

• Quick Commands: Fast challenge system via commands

• Bet Validation: Automatic validation of bet amounts and player funds

• Auto-Expiry: Challenges expire after timeout period

📋 Requirements

• RedM Server (Beta 1491+)

• Supported Frameworks: VORP, RSG, QBR or Standalone

🛠️ Installation

1

Download Files

Copy the resource folder to your server's resources folder.

# Copy to your server's resources folder
resources/[coderanch]/coderanch-cointoss/

2

Server.cfg Settings

Add your framework dependencies (only add the ones you use) and ensure the coin toss resource.

# Framework dependencies (only add the ones you use)

# If using VORP
ensure vorp_core

# If using RSG
ensure rsg-core

# If using QBR
ensure qbr-core

# Coin Toss Script
ensure coderanch-cointoss

3

Configuration

Edit config.lua file according to your server's needs.

⚙️ Configuration

Framework Settings

Config.Framework = 'auto' -- "auto", "vorp", "rsg", "qbr", "standalone"

Game Settings

Config.MinBet = 1           -- Minimum bet amount
Config.MaxBet = 1000        -- Maximum bet amount (0 = no limit)
Config.MaxDistance = 3.0    -- Maximum distance between players

Coin Toss Settings

Config.CoinToss = {
    Enabled = true,              -- Enable coin toss
    Command = 'cointoss',        -- Command to initiate
    AnimationDuration = 3000,    -- Animation duration (ms)
}

Dice Roll Settings

Config.DiceRoll = {
    Enabled = true,              -- Enable dice roll
    Command = 'diceroll',        -- Command to initiate
    MinSides = 2,                -- Minimum dice sides
    MaxSides = 20,               -- Maximum dice sides
    DefaultSides = 6,            -- Default dice sides
    AnimationDuration = 3000,    -- Animation duration (ms)
    AllowMultiPlayer = true,     -- Allow multi-player
    MaxPlayers = 6,              -- Maximum players
}

UI Settings

Config.UI = {
    Theme = 'western',           -- UI theme
    ShowNotifications = true,    -- Show notifications
    AcceptKey = 0x760A9C6F,      -- G key (accept)
    DeclineKey = 0x8FD015D8,     -- X key (decline)
    ChallengeTimeout = 30000,    -- Timeout (30 seconds)
}

Sound Settings

Config.Sounds = {
    Enabled = true,
    CoinFlip = 'coin-flip.mp3',
    DiceRoll = 'dice.mp3',
    Win = 'win.mp3',
    Lose = 'lost.mp3',
    Volume = 0.3,                -- Volume (0.0 - 1.0)
}

Animation Settings

Config.Animations = {
    Enabled = true,
    CoinProp = 'p_coinpurse02x', -- Coin prop model
    DiceProp = 'p_dice01x',      -- Dice prop model
}

Language Settings

Config.Messages = {
    NotEnoughMoney = 'You don\'t have enough money for this bet!',
    PlayerTooFar = 'That player is too far away!',
    InvalidBet = 'Invalid bet amount! (Min: $%s, Max: $%s)',
    PlayerNotFound = 'Player not found!',
    AlreadyInGame = 'You or the target player is already in a game!',
    -- And more...
}

🎮 Usage

For Players

Coin Toss Game

1

Approach Another Player

Get within 3 meters.

2

Open Challenge Menu

Type /cointoss (opens UI).

3

Set Bet Amount

Enter your desired bet.

4

Choose Heads or Tails

Pick your side.

5

Send Challenge

Player receives a notification.

6

Accept or Decline

Press G to accept, X to decline.

7

Watch the Flip

Animation plays automatically.

8

Winner Takes All

Winner receives both bets.

Quick Challenge:

/cointoss [playerId] [bet] [heads/tails]
Example: /cointoss 5 50 heads

Dice Roll Game

1

Approach Another Player

Get within 3 meters.

2

Open Challenge Menu

Type /diceroll (opens UI).

3

Set Bet Amount

Enter your desired bet.

4

Choose Dice Sides

Select 2-20 sided dice.

5

Send Challenge

Player receives a notification.

6

Accept or Decline

Press G to accept, X to decline.

7

Watch the Roll

Dice animation plays.

8

Winner Determined

Highest roll wins (tie returns bets).

Quick Challenge:

/diceroll [playerId] [bet] [sides]
Example: /diceroll 5 50 6

Challenge Acceptance

• Press G to accept the challenge

• Press X to decline the challenge

• Challenge expires after 30 seconds

🔧 Advanced Settings

Customizing Bet Limits

Config.MinBet = 5       -- Minimum bet increased
Config.MaxBet = 0       -- No maximum limit

Adjusting Game Duration

Config.CoinToss.AnimationDuration = 5000  -- 5 seconds
Config.DiceRoll.AnimationDuration = 5000  -- 5 seconds

Disabling Features

Config.CoinToss.Enabled = false   -- Disable coin toss
Config.DiceRoll.Enabled = false   -- Disable dice roll
Config.Sounds.Enabled = false     -- Disable sounds
Config.Animations.Enabled = false -- Disable animations

Customizing Dice Range

Config.DiceRoll.MinSides = 4    -- Minimum 4-sided dice
Config.DiceRoll.MaxSides = 100  -- Maximum 100-sided dice
Config.DiceRoll.DefaultSides = 20 -- Default to 20-sided dice

Changing Key Bindings

Config.UI.AcceptKey = 0x760A9C6F   -- G key (default)
Config.UI.DeclineKey = 0x8FD015D8  -- X key (default)

🐛 Troubleshooting

Framework Not Detected

• Set Config.Framework manually instead of "auto"

• Make sure your framework is properly loaded

• Check framework name in fxmanifest.lua

Money Not Deducting/Adding

• Verify framework compatibility

• Check if player has sufficient funds

• Enable debug mode: Config.Debug = true

Challenges Not Working

• Check players are within range (default 3 meters)

• Verify both players have enough money

• Make sure player isn't already in a game

Animations Not Playing

• Check Config.Animations.Enabled = true

• Verify prop models exist in game

• Test with debug mode enabled

No Sound Effects

• Check Config.Sounds.Enabled = true

• Verify sound files exist in nui/sounds/ folder

• Check volume settings: Config.Sounds.Volume

🔄 Game Flow

Coin Toss Flow

1

Challenge Sent

Player A challenges Player B with bet amount.

2

Notification

Player B receives notification.

3

Acceptance

Player B accepts or declines.

4

Deduct Bets

If accepted, both players' money is deducted.

5

Animation

Coin flip animation plays (3 seconds).

6

Outcome

Coin lands on heads or tails.

7

Payout

Winner receives both bets (bet × 2).

Dice Roll Flow

1

Challenge Sent

Player A challenges Player B with bet and dice sides.

2

Notification

Player B receives notification.

3

Acceptance

Player B accepts or declines.

4

Deduct Bets

If accepted, both players' money is deducted.

5

Roll

Both players roll the dice.

6

Outcome

Higher roll wins; tie returns bets.

7

Payout

Winner receives both bets (bet × 2).

🛡️ Safety Features

• Bet Validation: Automatic validation of bet amounts

• Fund Check: Verifies both players have enough money

• Distance Check: Players must be within range

• Game Lock: Players cannot join multiple games

• Auto-Expiry: Challenges expire after 30 seconds

• Self-Challenge Prevented: Cannot challenge yourself

🎨 Customization

Adding Custom Sounds

Place your custom sounds in nui/sounds/ folder and reference them in config:

Config.Sounds.CoinFlip = 'my-custom-flip.mp3'
Config.Sounds.Win = 'my-custom-win.mp3'

Modifying UI Theme

Edit nui/css/style.css and nui/js/script.js to customize the interface.

Adding New Props

Use GTA V object hash names for custom props:

Config.Animations.CoinProp = 'prop_name_hash'

🔍 Debug Mode

Enable debug mode to see detailed console logs:

Config.Debug = true

Debug command (admin only):

/gamesdebug

📊 Framework Integration

VORP Core

Config.Framework = 'vorp'

RSG Core

Config.Framework = 'rsg'

QBR Core

Config.Framework = 'qbr'

Standalone

Config.Framework = 'standalone'

🔄 Updates

v1.0.0

• Initial release

• Coin toss gameplay

• Dice roll gameplay

• Multi-framework support

• NUI interface

• Sound effects

• Animations

• Debug mode

📄 License

This script is developed by CodeRanch. Commercial use requires permission.

---

Note: This script is developed for RedM Beta version. Incompatibilities may occur in RedM's official release.