ns-multicharacter

Character selection and spawn selector for Qbox and QBCore. Every character poses in its own cinematic scene, and the player chooses where to spawn while the camera flies over each place.

Türkçe: README.tr.md

Features

• Scenes and poses: 10 scenes (casino terrace, penthouse, rooftops, pier, Mount Chiliad and more) with their own time of day and weather, plus 12 poses (animations and scenarios with props). Every switch shows the next character in a different pose. Players cannot change scenes, poses or camera angles.
• Cinematic UI: letterbox bars, the character's name as a Playfair Display title card, big arrows around the character (also ← → / A D) with the neighbour's name, and a slot strip. The camera glides in after every switch.
• In-game editor (/charsetup): admins set where the character stands (walk there, press E), the camera (free camera with FOV and aim height), time, weather and the poses allowed in each scene, order and switch scenes, and add animation or scenario poses with a live preview on a copy of themselves. Saved in the database. Take from game: pose with any emote, fine-tune with ns-animpos, frame it with a freecam and press Y; the scene keeps that exact shot.
• Create and delete: first and last name, date of birth, gender and nationality (searchable), all checked by the server. A stand-in ped of the chosen gender poses in the scene while you fill in the form.
• Character card: money, job, birth date, play time and the area where the character was last seen.
• Fair logout: /logout is refused right after a fight, while dead, cuffed or in a vehicle, and within a cooldown (admins are not limited).
• Ambient sound: each scene can have wind, city, sea, rain, night or indoor sound, or your own loop. Deleting asks for the full name and is admin-only by default (configurable).
• Slots: a default count, per-license counts, ACE groups (ns-multicharacter.slots.5) and extra slots given with /charslots. Locked slots can show your store address.
• Spawn selector: last location, owned properties (qbx_properties), public spawn points and job or gang points (police and EMS examples). An aerial camera flies to each one.
• New characters: go to the starting apartment flow (qbx_properties / qb-apartments) when it is enabled. Otherwise they use the spawn selector, then the clothing menu opens.
• Private: players wait in their own routing bucket, and preview peds are local, so nobody else sees them.
• Spawn tool: /charspawn copies a ready spawn point entry from your position.
• Secure: the client only sends ids. Ownership, slots, validation and spawn coordinates are decided by the server.

Requirements

• Qbox (qbx_core) or QBCore (qb-core). ESX is not supported.
• oxmysql
• Optional: illenium-appearance / fivem-appearance / qb-clothing to show each character's real look, qbx_properties for property spawns.

Quick start

See INSTALLATION.md. In short: turn off the framework's own character menu and spawn menu, then ensure ns-multicharacter. Options are in CONFIGURATION.md.