Installation — ns-multicharacter

1. Put the ns-multicharacter folder in your resources (e.g. resources/[nullsect]/ns-multicharacter).

2. Turn off the framework's own character and spawn menus:

   • Qbox: in qbx_core/config/client.lua set characters.useExternalCharacters = true. Remove ensure qbx_spawn from server.cfg (or add stop qbx_spawn after it). characters.startingApartment still decides whether new characters get the qbx_properties apartment choice.
   • QBCore: stop qb-multicharacter and qb-spawn.

3. Add it to server.cfg after the framework, oxmysql and your clothing resource:

   ensure oxmysql
   ensure qbx_core              # or qb-core
   ensure illenium-appearance   # optional, for the real look of each character
   ensure ns-multicharacter
   

   Copy

4. Optional: Config.Locale = 'tr', Config.Selection.title (your server name), Config.Slots, and your own scenes and spawn points (see CONFIGURATION.md).

5. Admins: add_ace group.admin ns-multicharacter.admin allow (for /charslots, /charsetup, /charspawn).

6. Restart the server. Tables are created on start (Config.Database.autoMigrate). Without auto-migration, import sql/ns-multicharacter.sql.

Verify

• Join: the loading screen closes and your first character stands in a scene. The title shows the name.
• Arrows / ← →: every switch shows the next character in a different pose. There is no scene or pose control.
• /charsetup (admin): open a scene, Preview shows a copy of you posing there; Set camera, Enter, Save.
• /charsetup → Take from game: emote, /animpos, freecam, Y. The preview shows the same frame; Save.
• Create a character with a number in the name: refused. With a valid name: the spawn selector (or apartment choice) opens, then the clothing menu.
• Play: the spawn list shows the last location, your properties and the public points. A police character also sees Mission Row PD.
• /logout: the selection opens again. With one character and one slot it is refused with a message.
• /logout right after shooting another player, while cuffed / dead, in a car, or twice within 5 minutes: refused with a message (admins are not limited).
• Character card: play time and the area of the last position. Create form: a ped poses and changes with the gender.
• /charsetup → a scene → Ambient sound: pick e.g. Wind, Preview: the sound fades in.
• Create form: the birth date and nationality lists have the orange scrollbar; typing tur in nationality leaves only Turkish.
• Console on start: [ns-multicharacter:SV] ready (framework=qbox, ...).

Troubleshooting

• Two menus at once / ox_lib menu appears: useExternalCharacters is still false in qbx_core.
• The old spawn map appears after choosing a spawn: qbx_spawn / qb-spawn is still running.
• Apartment choice opens for existing characters: that is qbx_properties' behaviour when startingApartment = true and the character owns no property.
• Characters show as default peds: no appearance resource found. Set Config.Appearance.provider.
• A scene is empty or the ped floats: check its coordinates in game and fix them with /charsetup (Stand here / Set camera).
• "No supported framework found": start the framework before ns-multicharacter. ESX is not supported.