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

# ak47\_multicharacter

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

### 🔥 Key Features

Designed to improve roleplay immersion right from the first connection:

#### 🎬 Cinematic Camera & Ped Lineups

* **Dynamic Lineups:** Interactive 3D ped lineups with customizable scenarios (e.g., `WORLD_HUMAN_SMOKING_POT`) and specific animations for each character slot.
* **Seamless Transitions:** Smooth, buttery dive-bomb camera transitions from the sky down to the final player spawn coordinates.
* **Live Previews:** Custom appearance support for `illenium-appearance`, `qb-clothing`, and `esx_skin` to preview your exact character model and outfits.

#### 🎨 Modern React Interface

* **Beautiful UI:** Sleek, responsive React-based interface displaying detailed character stats (cash, bank, job, rank) alongside auto-generated mugshots.
* **Advanced Creation:** Comprehensive character creation menu with strict validations for First/Last Name, Nationality, Gender, Birthdate, and Height parameters.

#### 🔓 Progression & Integration

* **Discord Slot Unlocking:** Reward your community by linking specific Discord roles to unlock extra character slots automatically upon connecting.
* **Extensive Spawns:** Categorized, keyboard-navigable spawn selection supporting normal locations, `qb-apartments`, `qb-houses`, `ak47_housing`, and `snipe-motel`.

#### 🛠️ Technical Excellence

* **Multi-Framework:** Seamlessly works out-of-the-box with ESX & QBCore adapting database queries dynamically.
* **Admin Utilities:** Built-in server commands like `/logout`, `/closeNUI`, and `/deletechar` for easy administration and cross-table character wiping.
* **Environment Sync:** Automatically pauses time and weather sync (fully compatible with `cd_easytime` and `qb-weathersync`) during the selection phase to maintain atmosphere.

***

### 💻 Framework:

* ESX, QBCore

***

### ⚙️ Dependencies:

* Your chosen framework (ESX/QB)
* Optional: `illenium-appearance`, `qb-clothing`, or `esx_skin` for ped rendering.

***

### ⚙️ How To Install:

* Download ak47\_multicharacter from your cfx portal.
* Add the script in your resources folder.
* Start the script in your server.cfg below framework files.
* Configure your Discord Bot Token and Guild ID in `config-server.lua` if using role-based slots.
* Restart the server.

***

### 🔗 Links & Support:

* **📖 Documentation:** <https://docs.menanak47.com/multi-framework/ak47\\_multicharacter>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/7545540>
* **💬 Discord Support:** <https://discord.gg/MenanAk47>

***

### 📝 Note:

* We don't support custom framework. Make sure you are using official framework update.
* Renaming the script is not allowed. It may break the functionalities.
* Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading.