Installation
📋 Requirements
| Resource | |
|---|---|
| oxmysql | Required |
RSG: rsg-core and rsg-appearance | rsg-spawn is optional |
VORP: vorp_core | That's all. This resource replaces vorp_character |
The framework is detected automatically (Config.Framework = 'auto'). You can force it with 'rsg' or 'vorp'.
🚀 Installing
- Drop the
kartik-multicharacterfolder into your resources. - Do the step for your framework:
- Start it after oxmysql and your framework in
server.cfg:
ensure oxmysql
ensure rsg-core # or vorp_core
ensure rsg-appearance # RSG only
ensure kartik-multicharacter- Restart your server and join. You land on character select.
If the console prints "No framework found", your framework is starting after kartik-multicharacter. Move its ensure line above.
💾 Database
Nothing to import. These tables are created on the first start:
| Table | What it holds |
|---|---|
kartik_multicharacter_slots | Extra slots per player (admin grants and Tebex) |
kartik_multicharacter_tebex | Tebex purchases, redeems and chargebacks |
kartik_multicharacter_scenes | Scenes built in the in-game scene creator |
Characters themselves stay in your framework's own tables.
👑 Admin access
The admin panel (/charadmin) and the select screen preview (/charpreview) need the ace set in Config.Admin.ace, which is command by default. txAdmin and server admins already have it.
To give it to a group instead:
add_ace group.admin kartik.multicharacter allowand set Config.Admin.ace = 'kartik.multicharacter'.
🔑 Optional: server.cfg
Only needed if you use these features:
set kmc_discord_token "your bot token" # Discord role slots
set sv_tebexSecret "your tebex secret" # Tebex slotsSee Discord Roles and Tebex.
✅ First steps
- Join and create a character: registry, intro, creator, spawn picker and arrival.
- Open
shared/config.luaand set your title, subtitle and logo inConfig.UI, and your theme ('frontier'or'paper'). - Pick your scene in
Config.Scene, or leave it on'random'. - Type
/charadminand try the scene creator. See Scene Creator. - Set your slot rules in
Config.Slots. See Character Slots.
🧩 Logo
Put your image in the images/ folder and set Config.UI.logo = 'logo.png', or use a full url. Leave it empty for the built-in emblem. A square transparent PNG around 256x256 works best.