Multicharacter
Characters and Slots
config/characters.lua - character slots, security cooldowns, and the /relog command.
Slots
Config.DefaultSlots = 1Config.MaxSlots = 8Config.CanDelete = trueConfig.SlotOverrides = {}Config.SlotsByDiscordRole = {}| Option | Description |
|---|---|
DefaultSlots | Slot count every player starts with. |
MaxSlots | Hard limit no override can exceed. |
CanDelete | Whether players can delete their own characters. |
SlotOverrides | Extra slots for a specific identifier. |
SlotsByDiscordRole | Extra slots for a Discord role. Needs Config.Discord.checkRoles = true and a bot. |
How the limit is calculated
- If an admin set slots with
setslots, that number replaces everything else. - Otherwise:
DefaultSlotsplusSlotOverridesand Discord role slots. - The result is always capped at
MaxSlots.
Example
Config.DefaultSlots = 2Config.SlotOverrides = { ['license:1234567890abcdef1234567890abcdef12345678'] = 5,}Config.SlotsByDiscordRole = { ['111111111111111111'] = 1, ['222222222222222222'] = 3,}Security
Config.Security = { createCooldown = 8, deleteCooldown = 5, selectCooldown = 1.5, createLimit = { count = 5, perMinutes = 60 }, violations = { kick = true, reason = '', },}| Option | Description |
|---|---|
createCooldown | Seconds between character creations. |
deleteCooldown | Seconds between character deletions. |
selectCooldown | Seconds between character selections. |
createLimit | At most count new characters per perMinutes minutes per player. |
violations.kick | Kicks players who send many rejected requests. false only logs a warning. |
violations.reason | Kick reason shown to the player. Empty uses the translation. |
See Security for details.
Relog
Config.Relog = { enabled = true, command = 'relog', cooldown = 30,}| Option | Description |
|---|---|
enabled | Lets players return to character select without disconnecting. |
command | Command name without the slash. |
cooldown | Seconds between uses. |
On /relog, the character is saved and logged out of the framework. The inventory closes and the player returns to the private world and character select.