shared/config.lua. Cette page explique chaque réglage.
[!NOTE] Vous cherchez les options Framework, Garage ou Clés ?
ts-persistence est totalement indépendant : tous les ponts (QBCore, ESX, qs-vehiclekeys, qb-garages, etc.) sont gérés uniquement parts-lib. Paramétrez-les dansts-lib/shared/config.lua.
Paramètres du pont
boolean
défaut:"false"
Si
true, le script synchronise la déformation visuelle des véhicules via le plugin VehicleDeformation. Plus d’infos ici.Paramètres globaux
boolean
défaut:"true"
Si activé, une remorque attachée à un véhicule est aussi sauvegardée et restaurée au spawn du véhicule principal.
boolean
défaut:"false"
Si activé, tous les véhicules deviennent permanents : ils ne sont plus supprimés après un redémarrage ou un restart du script.
Paramètres client
boolean
défaut:"false"
Active ou désactive les logs de debug client dans la console F8.
function
Fonction pour lire le niveau de carburant. Par défaut : native
GetVehicleFuelLevel.function
Fonction pour appliquer le niveau de carburant. Les scripts custom (ex. LegacyFuel) peuvent s’intégrer ici.
number
défaut:"200"
Distance (unités de jeu) à laquelle un véhicule persistant commence à apparaître quand un joueur s’approche, s’il n’était pas déjà spawné.
number
défaut:"100"
Temps max (ms) pendant lequel le client attend que l’entité véhicule existe après le déclenchement du spawn serveur. Ne modifiez pas sans savoir pourquoi.
number
défaut:"100"
Temps max (ms) pour obtenir le contrôle réseau du véhicule spawné avant abandon. Ne modifiez pas sans savoir pourquoi.
number
défaut:"1"
Nombre de tentatives pour réappliquer les propriétés (mods, couleurs) si une incohérence est détectée après spawn. Défaut : 1. Ne modifiez pas sans savoir pourquoi.
function
Gère le verrouillage local des portes. Reçoit l’état de verrou GTA brut (1 = déverrouillé, 2 = verrouillé, etc.). Voir FiveM Natives.
function
Fonction retournant
true ou false. Si true, aucun véhicule ne spawn pour ce joueur (cinématiques, certains états).Paramètres serveur
boolean
Active ou désactive les logs de debug serveur dans la console.
function
Fonction serveur pour déterminer le type de véhicule au spawn (ex.
automobile, boat, heli). Par défaut : pont framework TS.Bridge.GetVehicleType(model).function
Vérifie si une plaque (et
netId optionnel) correspond à un véhicule possédé. Sert à décider si le véhicule est temporaire ou permanent.boolean
défaut:"true"
Active ou désactive l’auto-sauvegarde. Si activé, les véhicules sont enregistrés en BDD à intervalles réguliers.
number
défaut:"5"
Intervalle (en minutes) entre les sauvegardes automatiques. S’applique seulement si
Config.Server.autoSaveActive est true.boolean
défaut:"true"
Active ou désactive la suppression basée sur l’âge du véhicule.
number
défaut:"2"
Âge (en minutes) au-delà duquel les véhicules temporaires sont supprimés. Ex.
120 = 2 heures. false pour désactiver. S’applique si Config.Server.timeToDeleteActive est true.number
défaut:"false"
Âge (en minutes) pour supprimer les véhicules permanents.
false pour ne jamais supprimer les permanents. Si timeToDeleteActive est activé.number
défaut:"5"
Intervalle (minutes) entre les vérifications de suppression. Si
timeToDeleteActive est activé.boolean
défaut:"true"
Si
true, les véhicules spawnés par la persistance sont marqués « dehors » pour un comportement cohérent en jeu.boolean
défaut:"true"
Si
true, tous les véhicules persistés sont envoyés aux clients connectés au démarrage de la ressource pour alimenter tout de suite la grille côté client.function
Callback serveur déclenché juste après la création d’un véhicule. Utile pour le modifier après spawn.
function
Verrouillage côté serveur et synchro avec les scripts de clés (ex.
qb-vehiclekeys). Met à jour le state bag isLocked.function
Callback pour afficher des notifications. Reçoit la source du joueur, un message et un type optionnel (ex.
success, error).