> For the complete documentation index, see [llms.txt](https://nanoscripts.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://nanoscripts.gitbook.io/docs/scripts/nn_multichar.md).

# nn\_multichar

Create characters. Build your scene. Manage access.

A character selection scene that feels like part of your server.

Players choose their character from a living scene, create their identity, and continue into your appearance editor. Build the stage in game: place actors, frame cameras, choose animations, and manage free and Platinum positions from one studio.

![Multicharacter selection](https://nanoscript-gifs.s3.ap-southeast-2.amazonaws.com/multichar/multichar-selection.gif)

{% hint style="info" %}
**At a glance:** resource `nn_multichar` · ESX / QBCore / QBox · admin command `/scenecreator` · up to 6 character positions · documentation for resource version **1.3.3**.
{% endhint %}

#### What's inside

| Feature             | What you can do                                                         |
| ------------------- | ----------------------------------------------------------------------- |
| Scene selection     | Show saved characters in animated scenes with individual camera views.  |
| Identity creator    | Collect first name, last name, birthday, nationality, and gender.       |
| Scene Creator       | Build scenes through six guided steps with live in-game placement.      |
| Management          | Choose the active scene, set free/VIP capacity, and customize branding. |
| VIP Access          | Grant or revoke account-based Platinum positions.                       |
| Three presets       | Start with Michael's Death, Vinewood Residence, or The Lockup.          |
| Appearance handoff  | Continue into the configured clothing stack after identity creation.    |
| Persistent settings | Keep scene edits, branding, and VIP grants in MySQL.                    |

#### What you need

| Requirement         | Notes                                                                                                                                                                                                               |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FiveM with OneSync  | Used for private selection instances and networked preview peds.                                                                                                                                                    |
| One framework       | `es_extended`, `qb-core`, or `qbx_core`.                                                                                                                                                                            |
| `oxmysql`           | Connected to your framework database.                                                                                                                                                                               |
| `community_bridge`  | Include the PlaceableObject module for mouse-based actor placement.                                                                                                                                                 |
| Appearance resource | ESX uses `skinchanger` + `esx_skin`; the QB/QBox path has a direct `illenium-appearance` integration and a bridge fallback. See [frameworks & appearance](/docs/scripts/nn_multichar/frameworks-and-appearance.md). |

#### Start here

1. [Install the resource](/docs/scripts/nn_multichar/installation.md).
2. [Check your framework and appearance setup](/docs/scripts/nn_multichar/frameworks-and-appearance.md).
3. [Build your selection scene](/docs/scripts/nn_multichar/scene-creator.md).
4. [Set up free and VIP slots](/docs/scripts/nn_multichar/slots-and-vip.md).
5. [Adjust configuration and languages](/docs/scripts/nn_multichar/configuration.md).

#### Editions

**Escrow — product 7737575:** protected Lua logic after Cfx.re Asset Escrow processing; `config.lua` and `locales/*.lua` remain editable.

**Open source — product 7737600:** every Lua file is editable, including `server/lib.lua`. The UI source is included for customization.

Need help? Join [NANO Scripts Discord](https://discord.gg/nanoscripts).