Personnalisation

Points d’apparition

Chaque entrée de Config.Spawn.Locations devient un choix dans le panneau, sous « Dernière position » :

Config.Spawn.Locations = {
    {
        id = 'apartment',
        label = 'Appartement',
        description = 'Alta Street',
        icon = 'building-2',
        coords = vector4(-269.41, -955.31, 31.22, 205.0)
    },
    {
        id = 'sandy',
        label = 'Sandy Shores',
        description = 'Motel',
        icon = 'hotel',
        coords = vector4(1142.33, 2664.11, 38.16, 90.0)
    }
}

coords contient la position et l’orientation. id doit être unique, last est réservé à la dernière position. Les nouveaux personnages apparaissent toujours sur Config.Spawn.NewCharacter.

Icônes

Pour les points d’apparition et les offres de la boutique, utilisez l’un de ces noms :

house, hotel, building-2, plane-takeoff, map-pin, landmark, crown, sparkles, shopping-cart, banknote, user, user-plus, lock, flag, calendar, clock, history, ruler, music, video, image, message-circle, volume-2, play, pencil, settings, check.

Un nom mal écrit affiche un point d’exclamation.

Décor et caméra

Pendant la sélection, le personnage est placé sur Config.Scene.Coords (le toit du Maze Bank par défaut). Pour changer de décor :

1. Placez-vous à l’endroit voulu, tourné vers l’endroit où doit se trouver la caméra.
2. Reportez votre position et votre orientation dans Config.Scene.Coords.
3. Ajustez CameraDistance, CameraHeight, CameraShift et CameraFov.
4. Choisissez la météo et l’heure avec Weather, Hour et Minute.

Fond, musique et nom du serveur

Les fonds proposés dans Paramètres sont dans Config.UI.Backgrounds. Un fond est un dégradé CSS ou une image :

Config.UI.Backgrounds = {
    { id = 'violet', value = 'radial-gradient(120% 90% at 50% 0%, #4a3868 0%, #2b2139 45%, #141317 100%)' },
    { id = 'ville', value = 'https://cdn.mon-serveur.fr/fonds/ville.jpg' }
}
Config.UI.Defaults.Background = 'ville'

• Config.UI.SceneOpacity règle la transparence du fond par-dessus la scène 3D.
• Config.UI.MusicUrl doit pointer vers un fichier audio (.mp3, .ogg), pas vers une page YouTube.
• Config.UI.Watermark affiche le nom de votre serveur en bas à droite, Config.Links.Discord ajoute un bouton Discord.

Les joueurs changent ces réglages dans Paramètres. Leurs choix sont enregistrés sur leur PC.

Textes

Tous les textes sont dans locales/fr.lua et locales/en.lua. Modifiez la valeur à droite et gardez les %s :

title = 'Choisissez votre citoyen',
new_character_hint = 'Commencez une nouvelle vie à Los Santos',

Pour une autre langue, copiez locales/en.lua en locales/de.lua, remplacez Locales.en par Locales.de, traduisez puis mettez Config.Locale = 'de'.

Météo et HUD pendant la sélection

config/client.lua contient des hooks appelés à l’ouverture et à la fermeture de la sélection. Par défaut, ils mettent en pause qb-weathersync et cd_easytime pour que la météo de la scène ne soit pas remplacée :

function ClientHooks.OnSelectionOpen()
    TriggerEvent('qb-weathersync:client:DisableSync')
    TriggerEvent('cd_easytime:PauseSync', true)
end

function ClientHooks.OnSelectionClose()
    TriggerEvent('qb-weathersync:client:EnableSync')
    TriggerEvent('cd_easytime:PauseSync', false)
end

Avec un autre script météo, remplacez ces lignes par ses propres événements. Vous pouvez aussi y masquer votre HUD. Testez vos ajouts : une erreur dans ces fonctions bloque la sélection.

Logs Discord

ServerConfig.Logs = {
    Webhook = 'https://discord.com/api/webhooks/…',
    Name = 'Mon serveur · Personnages'
}

Un message est envoyé à chaque création, chargement et suppression de personnage, avec le joueur, sa licence et le personnage concerné.