Background information

internal command and general information about how the script works.

Framework Integration

Compatibility Layer

The server/compatibility.lua file provides a unified interface across frameworks:

Wrapper Functions:

• user.getName() - Get character full name

• user.getFirstname() - Get first name only

• user.getMoney() - Get cash amount

• user.addMoney(amount) - Add money

• user.removeMoney(amount) - Remove money

• user.getItemAmount(name) - Get item count

• user.removeItem(name, amount) - Remove items

Implementation Pattern:

if Config.Framework == "custom" then
    local Framework = {}
    TriggerEvent("getFrameworkCore", function(core)                                                         -- <- ADAPT THE EVENT OR REWRITE TO GET YOUR FRAMEWORKS CORE FUNCTIONS
        Framework = core
    end)

    AddEventHandler("d_roulette:custom:getCharacterFromId", function(source, cb)
        local _source = source
        local char = Framework.GetPlayer(_source)                                                           -- <- ADAPT THE FUNCTION ON THE RIGHT OF "=" TO RETURN CHARACTER OBJECT
        if char then
            local user = {}
            -- wrapper functions to return and set data from custom framework
            user.getName        = function() return char.data.firstname.." "..char.data.lastname end        -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO RETURN FULL NAME
            user.getFirstname   = function() return char.data.firstname end                                 -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO RETURN FIRSTNAME 
            user.getMoney       = function() return char.func.getMoney(currency) end                        -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO RETURN PLAYER MONEY 
            user.removeMoney    = function(amount) char.func.removeMoney(currency, amount) end              -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO REMOVE PLAYER MONEY 
            user.addMoney       = function(amount) char.func.addMoney(currency, amount) end                 -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO ADD PLAYER MONEY
            user.getItemAmount  = function(name) return char.inventory.func.getItemCount(name) end          -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO GET PLAYER INVENTORY ITEM AMOUNT
            user.removeItem     = function(name, amount) char.inventory.func.removeItem(name, amount) end   -- <- ADAPT THE FUNCTIONS ON THE RIGHT OF "=" TO REMOVE ITEM FROM PLAYER INVENTORY
            cb(user)
        else
            cb(nil)
        end
    end)
end

Adding New Framework Support

To add support for a new framework:

1. Set framework identifier to Config.Framework = "custom"

2. Configure wrapper events names for notifications in config.lua:

Wrapper.objectiveEvent = "myFrameWork:Objective"
Wrapper.TipEvent       = "myFrameWork:Tip"
Wrapper.HudOverride    = "myFrameWork:OverrideHUD"

1. Implement server wrapper in server/compatibility.lua:

elseif Config.Framework == "custom" then
    local NewFramework = exports['myframework']:GetCore()

    AddEventHandler("d_roulette:custom:getCharacterFromId", function(source, cb)
        local Player = NewFramework.GetPlayer(source)
        if Player then
            local User = {}
            User.getName = function() return Player.name end
            User.getMoney = function() return Player.cash end
            User.removeMoney = function(amt) Player.RemoveCash(amt) end
            User.addMoney = function(amt) Player.AddCash(amt) end
            User.getItemAmount = function(item) return Player.GetItemCount(item) end
            User.removeItem = function(item, amt) Player.RemoveItem(item, amt) end
            cb(User)
        else
            cb(nil)
        end
    end)

---

Console Commands

The roulette command can be used for debugging and administration directly from the server console. Only usable server-side.

Toggle Debug Logging: Enables or disables detailed debug prints in the console.

roulette debug

View Active Tables: Shows a list of all currently active roulette tables, their state, and the players at each table.

roulette tables

Reset/Delete a Table: Forcibly stops, resets and deletes a specific game table.

roulette delete <tableId>

---

External Events

The script provides events you can use in external scripts, for example, to disable inventory or other UI functions while a player is at a table.

Client-Side Events

These events are triggered on the client.

Player Joins a Table: Fires when the local player sits down at a roulette table.

-- client-side
AddEventHandler("d_roulette:PlayerJoinTable", function(tableId)
    print("Player joined roulette table: "..tableId)
    -- Do your stuff here | for example, disable a metabolism system
end)

Player Leaves a Table: Fires when the local player gets up from a roulette table.

-- client-side
AddEventHandler("d_roulette:PlayerLeaveTable", function()
    print("Player left the roulette table")
    -- Do your stuff here | for example, re-enable a metabolism system
end)

Server-Side Events

These events are triggered on the server and provide detailed information about game outcomes.

Player Wins a Round: Fires every time a player has one or more winning bets in a round.

AddEventHandler("d_roulette:handleChipWin", function(tableId, playerId, winChips, looseChips, pricePerChip, winNumber, winBets, looseBets)
    print("Table:", tableId, "Player:", playerId)
    if winChips > 0 then print("Win " .. winChips .. " chips which have a total value of " .. (winChips * pricePerChip) .. "$") end
    if looseChips > 0 then print("Loose " .. looseChips .. " chips which have a total value of " .. (looseChips * pricePerChip) .. "$") end
    print("Roulette Number:", winNumber)
    if winChips > 0 then
        print("Winning Bets: ( winChips = placedChips + (placedChips * Odd) )")
        for _,v in pairs(winBets) do
            print("Bettype:", v[1])
            print("Odd multiplicator:", v[2])
            print("Placed chip amount:", v[3])
            print("---")
        end
    end
    if looseChips > 0 then
        print("Loose Bets:")
        for _,v in pairs(looseBets) do
            print("Bettype:", v[1])
            print("Odd multiplicator:", v[2])
            print("Placed chip amount:", v[3])
            print("---")
        end
    end
end)

Player Loses All Bets: Fires only when a player loses all chips they placed in a round (i.e., has no winning bets).

AddEventHandler("d_roulette:handleChipLoose", function(tableId, playerId, chipCount, pricePerChip, winNumber, bets)
    print("Table:", tableId, "Player:", playerId)
    print("Loose " .. chipCount .. " chips which have a total value of " .. (chipCount * pricePerChip) .. "$")
    print("Roulette Number:", winNumber)
    for _,v in pairs(bets) do
        print("Bettype:", v[1])
        print("Odd multiplicator:", v[2])
        print("Placed chip amount:", v[3])
        print("---")
    end
end)