Sosomods House Robbery — Braquage de Résidences & Coop
Système complet de braquage de maisons en coop réparti sur 3 paliers de difficulté. Bruit dynamique, lasers de sécurité, coffres-forts, piratage d'alarme, sac de braquage obligatoire, progression persistée en base de données et compatibilité multi-dispatch. Anti-cheat côté serveur sur toutes les actions sensibles.
Fonctionnalités configurables
Système de paliers (Low / Mid / High Tier)
10 maisons réparties sur 3 paliers de difficulté. Chaque palier définit librement ses propres coordonnées d'intérieur/sortie, son IPL, son NPC endormi (modèle, chance, anim, arme), ses meubles fouillables, ses props transportables, ses coffres-forts et son boitier d'alarme. Créez vos propres maisons en copiant simplement une entrée.
Bruit dynamique & appel police automatique
Jauge de bruit qui augmente en courant, sprintant, tirant ou volant un objet, et qui redescend naturellement. Trois seuils configurables déclenchent des chances croissantes de signalement à la police. Vitesse de hausse/baisse et position de la barre à l'écran entièrement paramétrables.
Coffres-forts & minigame de crochetage
Chaque coffre demande un item configurable (crochet) et un temps d'ouverture propre. Le butin est une table pondérée (chance, min/max) avec prop attaché au joueur pendant l'animation d'ouverture. Crochet consommé ou non selon Config.Lockpick.remove.
Lasers de sécurité invisibles
Activables/désactivables globalement ou palier par palier, avec une chance d'apparition propre à chaque maison. Invisibles à l'œil nu, révélés uniquement avec l'item laser_scan achetable en boutique. Déclenche une alarme sonore positionnelle (xsound) si traversé.
Piratage d'alarme & sac de braquage obligatoire
Le boitier d'alarme se désactive via un item dédié avec un temps de hack propre à chaque maison. Le vol des objets peut être conditionné au port d'un sac de braquage (Config.NeedBag, drawable/texture configurables) — vérifié côté serveur, aucun contournement possible.
Compatibilité multi-dispatch
Un seul paramètre à changer dans Config.Dispatch.script pour basculer entre qs-dispatch, cd_dispatch, origen_police et rcore_dispatch. Jobs et effectif minimum de police requis (Config.MinPolice) ajustables.
Boutique d'outils & recel (fence)
Boutique d'achat des outils (scanner laser, laptop de hack, crochet, sac de braquage) avec prix et quantités min/max configurables. Boutique de recel séparée pour revendre le butin, avec vente individuelle ou totale (EnabledSellAll) sur une trentaine d'objets au prix ajustable.
Progression persistée par palier
Le nombre de braquages réussis par joueur sauvegardé en base via oxmysql. Le passage au palier supérieur (Mid puis High) est débloqué après un nombre de réussites configurable (midRequired / highRequired).
Mission de contact & véhicule de fuite
PNJ de contact pour lancer la mission, avec restriction horaire optionnelle. Véhicule de fuite généré sur plusieurs points de spawn configurables, despawn automatique si laissé vide pour éviter l'encombrement du serveur.
Couches d'abstraction Target & UI
Pont interne (TargetBridge) permettant de basculer entre ox_target et soso_interact sans toucher au reste du script. Notifications, barres de progression et TextUI basculés indépendamment entre ox_lib et ESX natif.
Anti-cheat & sécurité serveur
Validation de la position du joueur côté serveur sur un rayon configurable autour de chaque maison. Réaction aux tentatives de triche paramétrable (kick, ban ou simple log) et option d'argent sale pour le butin en espèces.
Réinitialisation automatique & horaires de vol
Les maisons dévalisées se réinitialisent automatiquement après un délai configurable pour éviter les maisons vides en permanence. Restriction horaire optionnelle (Night Rob) pour limiter le braquage à une plage de nuit configurable.
Journalisation Discord
Webhook Discord activable pour journaliser les braquages, parfait pour le suivi du staff sans toucher au code.
Paliers disponibles
Low Tier — 5 maisons — Entrée de gamme, butin et risques réduits, idéal pour débuter
Mid Tier — 3 maisons — Débloqué après un nombre de réussites configurable en Low Tier, butin supérieur
High Tier — 2 maisons — Réservé aux joueurs expérimentés, coffres et props les plus rentables, lasers systématiques
Configuration détaillée
Config.Target / Config.Inventory
Système de cible — "ox_target" ou "soso_interact" · inventaire basé sur ox_inventory
Config.NotificationType / Config.Progress / Config.TextUI
Habillage UI — "ox_lib" ou "esx" selon l'élément, indépendamment
Config.PoliceJobs / Config.MinPolice
Jobs considérés comme police (défaut : police, sheriff) et effectif minimum en ligne pour autoriser un braquage (0 = désactivé)
Config.Dispatch
enabled + script — qs-dispatch · cd_dispatch · origen_police · rcore_dispatch
Config.Logs
enabled + URL de webhook Discord pour journaliser les braquages
Config.DropPlayer / Config.AnticheatBan / Config.DirtyMoney
Sanctions anti-triche (kick / ban) en cas de détection côté serveur, et option pour marquer l'argent volé comme "argent sale"
Config.MissionDuration / Config.AlarmSoundRadius / Config.HouseAntiCheatRadius
Durée maximale d'une mission, rayon audible de l'alarme (xsound) et rayon de validation anti-cheat autour de la maison
Config.ShopInteractDistance
Distance maximale côté serveur pour valider un achat/vente en boutique — protection anti-cheat (défaut : 6.0)
Config.ResetHousesAfterTime / Config.ResetTime
Réinitialisation automatique du butin d'une maison après un délai en minutes (défaut : 20)
Config.NightRob
enabled + plage horaire (from / to) pour restreindre le braquage à la nuit
Config.Lockpick / Config.NeedBag
Item de crochetage et consommation, plus l'obligation (ou non) de porter un sac de braquage pour pouvoir voler (drawable/texture configurables)
Config.Noise
Valeur max, vitesse de baisse, hausses (course, sprint, tir, vol) et trois seuils déclenchant des chances d'appel police croissantes, plus position de la barre à l'écran
Config.Lasers
Activation globale des lasers de sécurité — chaque palier définit ensuite ses propres positions et chances d'apparition
Config.Tier
Table principale par palier — intérieur, NPC, meubles fouillables, props transportables, coffres-forts, objets statiques, boitier d'alarme et lasers. C'est ici que se construit chaque maison.
Config.TargetBlip / Config.HousesToRob
Apparence du blip GPS des maisons (icône, couleur, taille, label) et liste des 10 instances de maisons avec leurs coordonnées et leur palier associé
Config.Shop / Config.SellShop
Boutique d'achat des outils (prix, quantités min/max) et boutique de recel (vente individuelle ou totale, prix par objet)
Config.Progression
midRequired / highRequired — nombre de braquages réussis nécessaires pour débloquer le palier supérieur
Config.StartMission
PNJ de contact, restriction horaire optionnelle, et véhicule de fuite (modèle + points de spawn multiples) activable ou non
Config.Debug
true = logs détaillés console serveur + client — à activer uniquement en développement, jamais en production
Dépendances
Informations

