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

# Multicharacter

## Getting Started

### Description

**Phnx Multicharacter** is a full character selection and creation system for FiveM servers (GTA V Roleplay). It allows players to:

* Select from multiple character slots
* Create new characters with a custom identity
* Choose a spawn location
* Manage character slots (expand via licenses, Discord roles, or codes)
* Customize visual settings (weather, time, camera, effects, particles)

### Prerequisites

Before installing this script, make sure you have:

* A working **FiveM server**
* **MySQL / MariaDB** installed and accessible
* **Node.js** (v18 or higher) and **npm** installed (only needed if you rebuild the UI)
* **Lua 5.4** enabled on your FiveM server

### Tech Stack

| Layer         | Stack                                                                              |
| ------------- | ---------------------------------------------------------------------------------- |
| Backend       | Lua 5.4, MySQL (oxmysql), ox\_lib                                                  |
| Frontend      | React 19, TypeScript, Vite 7, TailwindCSS 4, Framer Motion, Zustand, FontAwesome 7 |
| Communication | FiveM NUI (Chromium Embedded Framework)                                            |

### Supported Frameworks

| Framework         | Auto-detected |
| ----------------- | ------------- |
| ES Extended (ESX) | Yes           |
| QB-Core           | Yes           |
| QBX Core          | Yes           |

The script automatically detects the installed framework — no manual configuration needed (`Config.Framework = 'auto'`).

***

Next: **Compatibility** →