Character Slotes

Configure how players receive additional character slots through Discord roles, Tebex purchases, or custom licenses.

📊 Slot Calculation

A player's total slots are calculated as:

Total Slots = Default + Database + Discord + Custom License

Source	Description
Default	Config.DefaultCharacterSlots value
Database	Slots stored in 0r_multicharacterv3 table
Discord	Bonus slots from Discord roles
Custom License	Bonus slots from specific license IDs

---

🔢 Default Slots

Set the base slot count for all players:

Config.DefaultCharacterSlots = 1  -- Everyone starts with 1 slot

---

🎮 Discord Role Slots

Grant bonus slots based on Discord roles:

Config.CharacterSlots = {
    Discord = {
        status = false,  -- Enable Discord slot system
        roles = {
            {
                id = 1234567890123456,  -- Discord Role ID
                slot = 1,               -- Bonus slots
            },
            {
                id = 9876543210987654,  -- VIP Role
                slot = 3,               -- +3 bonus slots
            },
        }
    },
    -- ...
}

Setup Requirements

1. Install a Discord bot/integration that provides role checking

2. Configure your Discord guild ID

3. Add role IDs and corresponding slot bonuses

How to Get Role IDs

1. Enable Developer Mode in Discord (Settings → Advanced)

2. Right-click the role → Copy ID

Players receive slots from their highest applicable role, not cumulative.

---

💳 Tebex Integration

Sell character slots through your Tebex store:

Config.CharacterSlots = {
    Tebex = {
        status = false,  -- Enable Tebex integration
        packages = {
            {
                id = 1,      -- Tebex package ID
                slot = 1,    -- Slots to grant
            },
            {
                id = 2,      -- Premium package
                slot = 5,    -- +5 slots
            },
        }
    },
    -- ...
}

Tebex Setup

1. Create a package in your Tebex store

2. Note the package ID

3. Add it to the packages list

4. Configure Tebex API in server/tebex.lua

How Players Redeem

1. Player purchases package on Tebex

2. Tebex provides a redemption code

3. Player enters code in the character selection UI

4. Slots are added to their account

---

🔑 Custom License Slots

Grant slots to specific license identifiers (useful for staff/VIPs):

Config.CharacterSlots = {
    Custom = {
        status = false,  -- Enable custom license system
        licenses = {
            {
                id = 'license:abc123def456',  -- Full license identifier
                slot = 5,                      -- Bonus slots
            },
            {
                id = 'license:xyz789ghi012',  -- Another player
                slot = 10,                     -- Staff gets 10 extra
            },
        }
    },
}

How to Get License IDs

In-game, run:

print(GetPlayerIdentifierByType(source, 'license'))

Or check your database players table.

---

🎟️ Redeemable Codes

Create one-time use codes that grant slots:

Adding Codes via Database

INSERT INTO 0r_multicharacterv3_code (code, slot) VALUES 
('WELCOME2024', 1),
('VIPBONUS', 3),
('STREAMER5', 5);

Adding Codes via Command

Create a command in server/commands.lua:

lib.addCommand('addslotcode', {
    help = 'Add a slot redemption code',
    params = {
        { name = 'code', help = 'The code', type = 'string' },
        { name = 'slots', help = 'Number of slots', type = 'number' },
    },
    restricted = 'group.admin',
}, function(source, args)
    MySQL.insert('INSERT INTO 0r_multicharacterv3_code (code, slot) VALUES (?, ?)', {
        args.code, args.slots
    })
    print('Code created: ' .. args.code .. ' (' .. args.slots .. ' slots)')
end)

---

📋 Complete Configuration Example

Config.DefaultCharacterSlots = 2

Config.CharacterSlots = {
    -- Tebex Store Integration
    Tebex = {
        status = true,
        packages = {
            { id = 12345, slot = 1 },  -- Basic slot package
            { id = 12346, slot = 3 },  -- Premium package
            { id = 12347, slot = 5 },  -- Ultimate package
        }
    },
    
    -- Discord Role Rewards
    Discord = {
        status = true,
        roles = {
            { id = 1111111111111111, slot = 1 },  -- Supporter
            { id = 2222222222222222, slot = 2 },  -- VIP
            { id = 3333333333333333, slot = 5 },  -- MVP
            { id = 4444444444444444, slot = 10 }, -- Staff
        }
    },
    
    -- Manual License Assignments
    Custom = {
        status = true,
        licenses = {
            { id = 'license:owner123', slot = 99 },  -- Server owner
        }
    }
}

---

⚡ Admin Commands

Add slots directly to players via commands:

-- In server/commands.lua
lib.addCommand('addslots', {
    help = 'Add slots to a player',
    params = {
        { name = 'id', help = 'Player ID', type = 'playerId' },
        { name = 'amount', help = 'Slots to add', type = 'number' },
    },
    restricted = 'group.admin',
}, function(source, args)
    local identifier = GetPlayerIdentifierByType(args.id, 'license2')
    MySQL.update('UPDATE 0r_multicharacterv3 SET character_slot = character_slot + ? WHERE identifier = ?', {
        args.amount, identifier
    })
end)

---

❓ FAQ

Q: Do Discord slots stack with Tebex slots? A: Yes! All sources are additive.

Q: What happens if a player has multiple Discord roles? A: They receive slots from the role with the highest slot value.

Q: Can slots be removed? A: Yes, modify the database directly or create a remove command.