# Multicharacter

{% embed url="<https://www.youtube.com/watch?v=lF6w679nI2w>" %}

{% embed url="<https://www.arius-scripts.com/category/scripts/product/6723397>" %}

ARS Multicharacter is a fully-featured, production-ready multi-character system built with a modern React NUI. It supports ESX, QBCore, and QBX Core — with automatic framework detection — and comes with an admin panel, spawn selector, relog system, and full localization support.

## **✨ Features:**

* **Multi-Framework Support** – Works with **ESX**, **QBCore**, and **QBX Core** — auto-detected, no manual config needed.
* **Modern React NUI** – Clean, polished character selection UI with multiple **colour themes** switchable from the admin panel.
* **Character Slots & Codes** – Configurable base slots per player. Admins can generate **one-time redeem codes** to grant extra slots.
* **Spawn Selector** – Players choose a spawn location with **custom points and preview images**. Configurable to show always or only on new characters.
* **Relog System** – Players switch characters via a command. Supports **screenshot capture** uploaded to Discord webhook or FiveManage.
* **Admin Panel** – Full in-game panel to manage **slot codes**, disable/delete characters, override slot counts, change UI theme, and search players.
* **Appearance System Support** – Compatible with **fivem-appearance**, **illenium-appearance**, **bl\_appearance**, **tgiann-clothing**, **rcore\_clothing**, and **esx\_skin**.
* **Starter Items** – Configurable items automatically given to **newly created characters**.
* **Localization** – Fully translated in **EN, ES, FR, IT, PT-BR** with easy support for custom languages.
* **Auto Database Setup** – No SQL imports needed. **Tables are created automatically** on first server start.
* **Editable Hooks** – Safe customization via `editable.lua` for **character load, setup, and delete** events without touching core files.

## **📋 Requirements:**

* **oxmysql** – Required for all **database queries**.
* **ox\_lib** – Required for **callbacks, promises, and utilities**.
* **Framework** – At least one of **es\_extended**, **qb-core**, or **qbx\_core**.
* **screenshot-basic** – Optional, only needed if **relog screenshots** are enabled.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.arius-scripts.com/site/documentation/resources/multicharacter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
