> For the complete documentation index, see [llms.txt](https://kartik-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kartik-scripts.gitbook.io/docs/redm/kartik-multicharacter.md).

# Multicharacter

Western multicharacter for RedM with living select scenes, a built-in creator and an in-game scene creator

<figure><img src="https://749229180-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5PW43WAkb8lL7jo4A2R%2Fuploads%2Fgit-blob-ccdb3ab49413f0269b6eef3a29eb23e021279ffa%2Fthumbnail.png?alt=media" alt="Kartik Multicharacter"><figcaption></figcaption></figure>

**kartik-multicharacter** is a complete character system for RedM. Characters wait for you in a living scene with props, horses, idle animations, music and ambience. New characters fill in a registry document, watch a short cinematic, build their looks in the built-in creator and pick where they arrive on the Rockstar map.

Works on **RSG** and **VORP**. On VORP it replaces `vorp_character` completely, and scripts made for it keep working.

{% hint style="success" %}
**Build your own select scenes in game.** The scene creator places spots, props, horses and cameras with a free camera. No file editing, and saved scenes survive updates.
{% endhint %}

***

## 🌟 What it does

* 🎭 **Character select in a living scene**: props, horses, idle animations, reactions, music and ambience. The selected character turns to look at the camera.
* 🏜️ **Six scenes included**: Van Horn camp, Armadillo saloon, Cotorra Springs, Donner Falls, The Heartlands and Bayou Nwa. Use one, a list, or a random one on every login.
* 🎨 **Two themes**: **Frontier** (dark panels, torn edges, paper grain) and **Paper** (newspaper, telegram and registry props). Use your own logo or the built-in emblem.
* 📜 **Certificate of Registry**: first and last name, date of birth, origin, nickname and backstory, with name rules and a banned names list.
* 🎬 **Cinematic intro** for new characters and an **arrival title card** on every spawn.
* 🪞 **Built-in character creator** for RSG and VORP: heritage, body, face, hair and eyes, marks, makeup and a full wardrobe. Looks are saved in the framework's own format, so its barbers and clothing shops keep working.
* 🗺️ **Spawn picker on the RDR2 map**, with "Where I left off" and locks for dead and jailed characters.
* 🎟️ **Character slots** from a default, ace permissions, Discord roles, the VORP character limit, admin grants and Tebex purchases.
* 🛒 **Tebex**: purchases unlock slots automatically, chargebacks take them back, and players can redeem their `tbx-` id on a locked slot.
* 💬 **Discord roles**: map roles to slot counts.
* 🪦 **Retire characters**, with the name typed to confirm.
* 🚪 **Logout** back to character select, with a cooldown, a stand-still timer and blocks for dead, cuffed, jailed or mounted players.
* 🗂️ **Admin panel** (the Registry Office): players online, slots, characters, Tebex history, scenes and previews.
* 🛠️ **In-game scene creator**: free camera, character spots with scenarios, props, horses and cameras. Test, save to the database, or export as Lua.
* 🌍 **Six languages**: English, German, French, Spanish, Brazilian Portuguese and Polish. Every line, in Lua and the UI, comes from a locale file.

***

## 🗺️ Where to go next

{% hint style="info" %}
New here? Read [Installation](/docs/redm/kartik-multicharacter/installation.md), then the guide for your framework: [RSG](/docs/redm/kartik-multicharacter/installation/rsg.md) or [VORP](/docs/redm/kartik-multicharacter/installation/vorp.md).
{% endhint %}

* 🖼️ [Preview](/docs/redm/kartik-multicharacter/preview.md): screenshots.
* ⚙️ [Installation](/docs/redm/kartik-multicharacter/installation.md): get it running.
* ✨ [Features](/docs/redm/kartik-multicharacter/features.md): every feature explained.
* 💬 [Commands](/docs/redm/kartik-multicharacter/commands.md): every command.
* 🔧 [Configuration](/docs/redm/kartik-multicharacter/configuration.md): `shared/config.lua` explained.
* 🔌 [Exports & Hooks](/docs/redm/kartik-multicharacter/exports.md): for developers connecting other scripts.
* ❓ [FAQ](/docs/redm/kartik-multicharacter/faq.md): common questions and fixes.