Changelog — ns-multicharacter

1.0.0 — 2026-11-12

• First full release. Tested on Qbox and QBCore. No code changes since 0.7.0.

0.7.0

• /logout limits (Config.Logout.combat, cooldownSeconds), never applied to admins:
  • no logout for 60 s after shooting or hitting a player or being hit by one (seen by the server from weaponDamageEvent, a hit on a car with a player inside counts; NPCs do not), the message shows the seconds left;
  • no logout while dead / down, cuffed (framework metadata, ns-police) or sitting in a vehicle;
  • one logout per 5 minutes per player (Rockstar license, kept over reconnects).
• New character form: a stand-in ped of the chosen gender poses in the scene while the form is open, and switches when the gender changes (Config.Create.preview, any ped model, false = empty scene). Only the player sees it.
• Character card: play time ("42 h") and the area of the last position ("Vinewood Hills"). Play time is counted on the server from spawn to logout / disconnect and written every 5 minutes (Config.Features.Playtime, LastPlace).
• Ambient sound per scene, chosen in /charsetup (Atmosphere → Ambient sound): wind, city, sea, rain, night crickets, indoor room tone. Made in the page, no audio files; own loops can be added in nui/sounds/ (Config.Ambience.files). Volume in Config.Ambience.volume; it fades between scenes and stops at spawn.
• A character no longer stands in the same place every time: Config.Selection.sceneMode is now 'random' by default, and random skips both the scene shown just before and the scene that character had last time (remembered on the player's PC, so also after a relog). 'cycle' keeps the old fixed order.
• Database schema v4: ns_multicharacter_playtime, sound column on scenes (automatic with autoMigrate).

0.6.0

• /logout for players (Config.Logout): answered by this resource on the client, so it replaces qbx_core's admin-only /logout. The server checks that the character has spawned. A player with one character and one slot cannot log out (nothing to switch to, blockSingleCharacter). access = 'admin' keeps it admin-only; command = false leaves the framework's own command.
• New character form: day / month / year and nationality open the resource's own themed lists instead of the game's plain drop-downs, with an accent-coloured scrollbar. The lists open upwards when there is no room below.
• Nationality is a search field: type and the list shows only the matching entries (case and accents are ignored, turk finds Turkish). Enter / click picks, unmatched text goes back to the last pick.
• The spawn list uses the same themed scrollbar.

0.5.0

• GTA V character switch on spawn: the camera flies up into the clouds, the character loads up there (clothes included) and the camera comes down onto it at the spawn point. Config.Spawn.switch (on by default). Property and starting apartment spawns keep the plain teleport. If the switch does not start, the old teleport runs.
• Logout (/logout) does the reverse: the camera flies up from the character into the clouds, then the screen goes black and the selection opens. Controls are locked during the flight. Same setting (Config.Spawn.switch).

0.4.0

• Opening animation when the selection opens: logo, title, line and subtitle on black while the first scene loads; any key or click skips it (the key does not also switch characters). Config.Branding.intro: on / off, title, subtitle, duration, only on join or after every logout.
• Small logo + "NULLSECT DEVELOPMENT" in the bottom right of the letterbox bar (Config.Branding.credit), logo file in Config.Branding.logo.
• ns-hud is hidden while the selection, the spawn selector or /charsetup is open (Config.Selection.hideHud).
• The arrows no longer show the neighbouring character's name.

0.3.2

• Deleting characters is admin-only by default: Config.Features.Delete = 'admin' (true = everyone, false = nobody). Players get no delete button; the server refuses and flags a delete request from them.
• The previous / next arrows moved to the bottom right, around the slot strip, on the line of the Play button.
• Fix: the scene clock jumped to the server time and back every few seconds (Renewed-Weathersync / qb-weathersync pushing the server time). The weather sync is paused while a scene shows its own time and weather and resumed after spawn / when the studio closes.

0.3.1

• Fix: scenes whose FOV was a whole number (e.g. the freecam default 50) zoomed in extremely on the selection screen while the studio preview looked right. Scene numbers loaded from the database are now always floats.

0.3.0

• /charsetup Take from game: play an emote (any menu), place yourself with /animpos, aim with freecam (ns-hud or any other), press Y. The scene gets exactly that camera (position, rotation, FOV), your exact spot and facing, and the pose you play: a library pose is found by its animation, a scully_emotemenu emote that is not in the library is added as a new pose. ns-animpos, freecam and the emote are closed after the shot.
• Scenes taken this way keep the camera angle (no aiming at the ped) and place the character exactly (frozen at once, no ground snap), so sitting / leaning poses stay where they were set.
• The studio preview hides your own character while a scene camera shows (you often stand on the spot).
• Config.Studio.captureKey (default Y). Database schema v3 (cam_fixed, cam_rx/ry/rz, exact), migrated automatically.

0.2.0

• New look: character names and titles in Playfair Display (Barlow for text).
• Character switching with big arrows around the character (with the neighbour's name), ← → / A D keys and a slot strip. The cast list on the right is gone.
• Every switch shows the next character in a different pose (and, with sceneMode = 'cycle', the next scene).
• Players can no longer change scene, pose or camera; photo mode and saved per-character choices were removed (Config.Features.SceneChoice / PoseChoice / PhotoMode, Config.Photo, Config.Selection.sceneOrder → sceneMode).
• /charsetup admin editor: scenes (stand here, free camera with FOV and aim height, time, weather, ground snap, allowed poses, order, on / off) and poses (animation or scenario, gender), live preview on a copy of yourself. Stored in the database (schema v2); the config scenes / poses seed it once. /charscene was replaced by it.

0.1.0

First version (not tested in game yet).

• Character selection: each character poses in a cinematic scene (10 scenes, 12 poses), camera glides in, scene time and weather, letterbox title-card UI. Scene and pose can be changed per character and are saved.
• Photo mode: orbit, zoom, height, six filters.
• Create (first / last name, date of birth, gender, nationality; server validated, blocked words) and delete (type the full name) characters.
• Slots: default, per license, ACE (ns-multicharacter.slots.<n>), extra slots with /charslots, locked slots with an optional store hint.
• Spawn selector with an aerial camera: last location, owned qbx_properties, public points, job / gang points. New characters go to the starting apartment flow when it is enabled, otherwise to the selector, then clothing.
• Private routing bucket while choosing.
• Dev tools: /charscene (capture a scene with a free camera), /charspawn (capture a spawn point).
• Qbox and QBCore. English and Turkish.