Oxide Multichar
Multi-framework character selection, creation, and appearance system for FiveM servers using o-link.
Overview
oxide-multichar is a cinematic character selection and creation screen that replaces the plain multi-character menu your framework ships with. Players see their characters standing in a fully rendered 3D scene — an apartment, a garage, a pier — hover to read an info card, click to select, then pick where to spawn from a sky-high view of the map. New characters are built in a step-by-step wizard with an optional full in-screen appearance editor.
oxide-multichar is framework-agnostic through o-link and runs on QBCore, ESX, Qbox, and Oxide without code changes. On ESX it announces itself as esx_multicharacter (via provides) so the stock multi-character folder can be deleted entirely while ESX stays in multi-character mode.
Technical
| Dependency | Required | Purpose |
|---|---|---|
ox_lib | Yes | Locale, callbacks, shared utilities |
o-link | Yes | Framework abstraction for characters, money, job, clothing, and housing |
illenium-appearance | Recommended | Clothing backend that describes the full look (face, hair, tattoos) so selection-screen previews match the player's build; qb-clothing / esx_skin work with generic-face previews |
Storage: None of its own. No SQL import — characters stay in your framework's existing tables. Scene choice and accent color are remembered per player between sessions.
Frontend: Vue 3 + Vite NUI for the selection overlay, info cards, creation wizard, appearance editor, and spawn picker.
Features
- 3D scene selection: Characters stand in a real rendered location instead of rows in a list; players hover and click to choose. Each player sits in their own private copy of the scene, so concurrent joiners never see each other's characters.
- Info card on hover: A floating card shows the character's name, cash, bank, and job.
- Multiple scenes: Four built-in backdrops (Apartment, Garage, Pier, Sinner Street), selectable in-screen and remembered between sessions. Display modes: keep the player's last scene, pick a random one, or always use the default (
Config.Scenes.mode). - Step-by-step creation wizard: First name, last name, date of birth, and gender with built-in validation, configurable name-length and age limits.
- In-screen appearance editor: Optional editor for face, hair, makeup, eyes, clothing, accessories, and tattoos on supported clothing resources, so players design their full look before they ever spawn (
Config.CustomCreator). - Sky-view spawn picker: The camera flies over the map and players click a glowing marker to choose where to spawn (
Config.SpawnSelector). Players can also return to their last logged-off location, and any property the character owns appears as a spawn option automatically. - Free starter apartment: New characters can be granted a free apartment on supported housing systems (
Config.StarterApartment). - Extra character slots: Grant additional slots to VIPs, donators, or staff by permission or player ID on top of the base count (
Config.MaxCharacters,Config.SlotGrants). - Creation control: Pause or whitelist character creation entirely (
Config.AllowCreation,Config.CreationAce), and block duplicate names on the same account or reserve specific words (Config.NameRules). - Character deletion control: Allow or hide deletion with server-side enforcement, and toggle the delete confirmation prompt (
Config.AllowDelete,Config.RequireDeleteConfirmation). - Announcements: Show server news, restart notices, and rule updates directly on the selection screen (
Config.Announcements). - Accent color: Players recolor the menu to their taste; the choice is saved on their machine.
/logoutcommand: Return to character selection at any time (Config.Logout).