[QB/QBOX] Feron Multicharacter - Cinematic Character Selection + Premium Slots OPEN SOURCE

Package Description

[PREVIEW]

https://www.youtube.com/watch?v=zNl3_iQY6JM

[DESCRIPTION]

💡 First impressions matter. The character selection screen is the very first thing every player sees on your server — make it unforgettable. Feron Multicharacter replaces the bland default selector with a cinematic forensic-studio scene, animated transmission boot, and a Tebex premium slot system that pays for itself.

Feron Multicharacter is a premium character selection system for FiveM. A 3-point studio lighting rig wraps around the preview ped, animated light streaks scroll behind, periodic photo flashes punctuate the scene, and a "classified transmission" loading overlay plays during data fetches. Up to 5 character slots with a Tebex-driven premium unlock flow. Drop-in for QBCore and Qbox.

[GAMEPLAY]

🎬 Player connects — cinematic "TRANSMITTING" boot overlay plays while the roster loads.

📋 Forensic dossier UI reveals: roster on the left, 3D ped in the center under studio lighting, identity card on the right.

👤 Select a character to see their full dossier (CID, TAG, birthdate, nationality, money, occupation), or click an empty slot to register a new one.

💎 Locked premium slots prompt for a Tebex transaction key — redeem to unlock instantly, no admin involvement.

🎯 Hit DEPLOY CHARACTER and the script smoothly hands off to your spawn flow (qb-apartments / qb-spawn / last-location).

[FEATURES]

🎬 Cinematic Forensic Studio — 3-point lighting rig (warm 3200K key + cool fill + theme-colored rim), pulsing ground ring, glossy floor disc, slowly orbiting accent spot, periodic photo-flash bursts.

📡 Classified Transmission Loading — Full-screen opaque overlay with shimmering title, scanning beam, stage progress, rotating diamond cursor, scrolling hex columns. Different copy per operation (boot, register, delete, activate, deploy).

🌊 Animated Light Streaks — 7 thin neon beams falling behind the ped, theme-colored, configurable count/length/speed.

🎭 Smooth Animation Cycle — Idle poses cycle every 15s with slow crossfade. Switching characters preserves the current pose — no jarring snap.

👤 Smooth Ped Reveal — Newly previewed ped stays invisible until the wardrobe script finishes writing components, then fades in. No naked freemode default flash.

💎 Tebex Premium Slots — Customer buys a slot package on your store, Tebex calls a server command, the resource generates a key, customer redeems it in the UI. Cap-aware, idempotent, no admin work.

🎨 3 Built-in Color Palettes — Crimson (red noir), Cyan (cyber tactical), Gold (luxury dossier). One config block to swap, every CSS variable rebinds.

🏞️ 3 Scene Themes — Crimson / Arctic / Toxic lighting presets with runtime switching via NUI callback.

📷 Streamer Mode — One-click toggle that blurs every PII field (name, CID, TAG, birthdate, phone, money). Persists across sessions via localStorage. Hover-to-reveal on dossier values.

📸 Photo Mode — Free camera controls (rotate, zoom, reset), keyboard shortcuts, full UI hides. Built-in studio framing.

🌍 192-Country Nationality Picker — Full ISO 3166-1 list, alphabetical, searchable dropdown.

🪪 Multi-Identifier Support — license / license2 / discord / steam / xbl / live / fivem. Configurable primary + fallback chain. Switching identifier types preserves legacy slots (read sums across all of player's identifiers).

🛡️ Anti-Death Watchdog — Player ped parked in a safe interior, health/invincibility re-applied each tick. Defeats qb-ambulancejob "respawn in X seconds" loops.

🎯 Auto-Detect Framework — Resource boots regardless of whether qb-core or qbx_core is started. Optional manual override via Config.Framework.

[UI DESIGN]

🎨 Forensic Dossier Theme — Unbounded display font, JetBrains Mono labels, Instrument Sans body. Tactical typography, geometric corner brackets, scan-line overlay, film grain, vignette.

🎭 Vanilla HTML/CSS/JS NUI — No React/Vite dependency. Minified + obfuscated for production.

💡 Configurable Brand — Top-bar name, subtitle, footer signature, all rebrandable via Config.Brand. Make it your server.

📝 Every Visible Text is Editable — Config.UI.strings has 50+ keys for every label, button, badge, modal copy. Translate to your language by editing values, no JS knowledge required.

📍 Per-Mode Loading Copy — Override title / subtitle / eyebrow / rotation messages for each operation (boot, create, delete, redeem, deploy).

🏷️ Stage Markers — Configurable POSE / LIGHT / ANGLE / CAM labels around the ped (4 slots, individually toggleable).

[TECHNICAL]

⚡ Optimized Performance — Scene FX gated by UI state, no per-frame waste, cached pose loops, smart watchdog ticks every 200ms not every frame.

🔒 License-Locked — Package binds to QBCore/Qbox at the framework.lua layer. Buyers can't use this on ESX servers.

🛠️ Multi-MySQL Adapter — oxmysql / mysql-async / ghmattimysql via single Config.Mysql switch.

📦 Production Build Pipeline — Terser minify + javascript-obfuscator + clean-css. Ship the obfuscated build for protection, or rebuild from source any time.

🔁 Migration-Free Slot Tracking — Switching Config.Identifier.primary doesn't orphan existing premium slots — reads sum across every identifier the player has.

🎬 No Naked Default Flash — Preview ped invisible until clothing applies + 220ms settle, then 8-step alpha fade.

🪶 Open Source — Full Lua + UI source readable. Customize freely. The license-lock layer in framework.lua is encrypted.

[CONFIGURATION]

Full config.lua with:

• Brand identity (name, subtitle, footer, logo glyph)

• UI palette (every CSS variable: bg, ink, accent, glass, line)

• Scene props, lights, ground ring, gloss disc, orbit spot, camera flash, streaks

• 3 scene themes (crimson / arctic / toxic) with runtime switching

• Idle animation pools (per-gender) + cycle interval + blend rates

• Premium slot rules (default, max, per-license overrides)

• Tebex integration (link, server command, key pattern)

• Identifier configuration (primary + fallback + requireAny)

• 192 nationalities, builds, blood types

• Validation rules (name length, banned names, DOB range, height range)

• Lifecycle hooks (OnPlayerLoaded, OnCharacterCreated, OnCharacterDeleted, OnPremiumSlotUnlocked)

• DB delete cascade (vehicles, houses, bank, phone — extend with custom tables)

• Spawn flow detection (auto / spawnSelector / apartments / lastLocation)

• UI visibility toggles (live indicator, photo mode, delete button, streamer mode, scanlines, grain, vignette, etc.)

• UI strings (every visible text)

• Loading screen copy (per-mode title / subtitle / rotation messages)

[INSTALLATION]

1. Extract to your resources folder.

2. Run install.sql against your QBCore database (creates feron_multichar_slots, feron_multichar_keys, feron_multichar_audit_log).

3. Add "ensure feron_multicharacter" to server.cfg.

4. Edit config.lua — set Config.Framework, Config.Mysql, Config.MaxCharSlots, Config.Tebex.Link.

5. Configure your Tebex package "Online Command" (see TEBEX_SETUP.md).

6. Restart server. Players see the new selector on their next connection.

[SUPPORT]

💬 Discord: https://discord.gg/p4z492X6xT