YF-Fleeca : documentation

Présentation

• Les 6 agences Fleeca de la carte, sans MLO à installer.
• 5 approches : intimidation, piratage, crochetage, explosifs, perceuse thermique.
• Mini-jeux du jeu (piratage Hacking_PC, cadran de coffre, perceuse), aucune barre de progression.
• Guichetier, otages paniqués, caméras à détruire, porte du coffre animée.
• Bonus aléatoire : un coffret à percer, une clé USB à livrer à un contact.
• ESX, QBCore, Qbox ou sans framework, détecté tout seul.
• Dispatch police branchable sur votre script, alerte intégrée sinon.
• Français et anglais inclus, sous-titres anglais pour les voix.

Prérequis

Aucune base de données n'est nécessaire : rien n'est enregistré en SQL.

OneSync doit être activé : le serveur vérifie la position des joueurs à chaque étape.

Installation

Six étapes, dans cet ordre.

1. Déposer la ressource

   Récupérez YF-Fleeca sur le portail Cfx.re (voir Récupérer ses achats). Copiez le dossier YF-Fleeca dans vos ressources, sans le renommer : la version protégée est liée à ce nom. Ajoutez-le à votre server.cfg, après ses dépendances et votre framework.

   server.cfgCopier

   ensure ox_lib
   ensure ox_inventory
   ensure ox_target
   # ensure es_extended / qb-core / qbx_core
   ensure YF-Fleeca

2. Déclarer les objets

   Ajoutez le bloc de la section Objets à la fin de ox_inventory/data/items.lua, avant la dernière accolade.

3. Copier les images

   Copiez les 11 images yf_*.png du dossier install/images dans ox_inventory/web/images.

4. Donner les permissions

   Les commandes staff passent par une permission ACE. En mode sans framework, la police aussi.

   server.cfgCopier

   add_ace group.admin yf-fleeca.admin allow
   # sans framework seulement :
   add_ace group.police yf-fleeca.police allow

5. Régler le config

   Ouvrez shared/config.lua : langue, métiers de police, nombre de policiers requis, vendeur de plans, lieux du contact. Branchez votre dispatch dans server/dispatch_custom.lua. Détail dans Configuration.

6. Redémarrer le serveur

   Un redémarrage complet est nécessaire la première fois, pour charger les nouveaux objets. La console affiche le framework détecté : [yf-fleeca] framework : esx.

Objets

11 objets : les cinq plans d'attaque, les outils remis au lancement, et la clé USB du bonus.

-- YF-Fleeca

['yf_plan_teller'] = {
    label = "Plan d'attaque [Intimidation]",
    weight = 50,
    stack = true,
    close = true,
    description = "Plan d'un braquage Fleeca par intimidation du guichetier. Consommé au lancement.",
},

['yf_plan_laptop'] = {
    label = "Plan d'attaque [Piratage]",
    weight = 50,
    stack = true,
    close = true,
    description = "Plan d'un braquage Fleeca par piratage du coffre. Remis au lancement contre l'ordinateur de piratage.",
},

['yf_plan_safecrack'] = {
    label = "Plan d'attaque [Crochetage]",
    weight = 50,
    stack = true,
    close = true,
    description = "Plan d'un braquage Fleeca par crochetage du coffre. Remis au lancement contre le kit de crochetage.",
},

['yf_plan_bomb'] = {
    label = "Plan d'attaque [Explosifs]",
    weight = 50,
    stack = true,
    close = true,
    description = "Plan d'un braquage Fleeca aux explosifs. Remis au lancement contre les charges.",
},

['yf_plan_thermaldrill'] = {
    label = "Plan d'attaque [Perceuse]",
    weight = 50,
    stack = true,
    close = true,
    description = "Plan d'un braquage Fleeca à la perceuse thermique. Remis au lancement contre la perceuse.",
},

['yf_fleeca_laptop'] = {
    label = "Ordinateur de piratage",
    weight = 2500,
    stack = false,
    close = true,
    description = "Sert à pirater la porte du coffre d'une Fleeca.",
},

['yf_fleeca_crackkit'] = {
    label = "Kit de crochetage de coffre",
    weight = 1000,
    stack = false,
    close = true,
    description = "Sert à crocheter la porte du coffre d'une Fleeca.",
},

['yf_fleeca_charge'] = {
    label = "Charge explosive",
    weight = 1000,
    stack = true,
    close = true,
    description = "Se pose sur la porte du coffre d'une Fleeca.",
},

['yf_fleeca_drill'] = {
    label = "Perceuse thermique",
    weight = 6000,
    stack = false,
    close = true,
    description = "Se monte sur la porte du coffre d'une Fleeca.",
},

['yf_fleeca_boxdrill'] = {
    label = "Perceuse à coffrets",
    weight = 3000,
    stack = false,
    close = true,
    description = "Perce les coffrets du mur de coffres d'une Fleeca.",
},

['yf_fleeca_usb'] = {
    label = "Clé USB compromettante",
    weight = 50,
    stack = true,
    close = true,
    description = "Clé USB sortie d'un coffret de la Fleeca. Un contact paie cher pour la récupérer.",
},

Déroulé d'un braquage

Valeurs par défaut du config.

L'alarme part 30 s après le lancement. Une agence braquée se recharge en 60 min ; un seul braquage Fleeca à la fois en ville.

Le chef

Celui qui lance le braquage en est le chef : il consomme son plan, reçoit les outils, ramasse l'argent de la table et perce le coffret bonus. Toute l'équipe voit les objectifs. Si le chef se déconnecte, un autre membre prend sa place.

L'échec

Le braquage échoue si plus aucun membre n'est en état d'agir à moins de 35 m de l'entrée pendant 15 s, avant que la table soit vidée. Il est aussi clos d'office au bout de 30 min. Une carte discrète en haut de l'écran annonce la réussite ou l'échec, sans gêner la conduite.

Les approches

Le plan d'attaque décide comment s'ouvre le coffre. Si le chef porte plusieurs plans, il choisit au lancement.

Bonus et contact

Une fois sur quatre, un renseignement signale un coffret sensible dans le mur de coffres. Le chef reçoit une perceuse à coffrets au lancement.

• Percer le coffret : clic gauche maintenu pour le moteur, souris vers le haut pour pousser.
• Le coffret contient une clé USB compromettante, marquée au nom du chef : lui seul peut la livrer.
• Un contact apparaît sur un lieu tiré au sort parmi ceux du config. L'équipe reçoit l'itinéraire GPS dès le perçage.
• Le contact paie 5 000 $ par clé, en liquide, avec une courte cinématique de remise.

Le contact n'existe que pendant un braquage avec bonus, ou tant qu'une clé n'a pas été livrée. Il reste au même endroit jusque-là, puis le prochain tirage évite le même lieu.

Configuration

shared/config.lua est le seul fichier de réglages à modifier, commenté en français et en anglais. Une valeur invalide est signalée en console au démarrage et remplacée par sa valeur par défaut.

Fichier livré

Le fichier complet avec ses valeurs par défaut. Recopiez-le pour revenir à la configuration d'origine.

Config = {}

Config.locale = 'fr'

Config.framework = 'auto'

Config.money = { item = 'money' }

Config.admin = { ace = 'yf-fleeca.admin' }

Config.police = {
    jobs = { 'police', 'sheriff' },

    ace = 'yf-fleeca.police',

    minOnDuty = 4,
}

Config.planVendor = {
    coords = vec4(-358.2050, 16.1889, 46.3549, 258.7397),

    price = 3200,
}

Config.loot = {
    min = 8000,
    max = 12000,
}

Config.bonus = {
    chance = 25,
}

Config.contact = {
    locations = {
        vec4(1085.0905, -2287.8787, 30.2286, 262.7219),
        vec4(143.0727, -3075.3372, 5.8963, 180.3207),
        vec4(-564.8896, -2322.7942, 13.9146, 318.2265),
        vec4(176.4104, -686.3036, 33.1230, 158.1722),
        vec4(-372.4448, -92.6789, 45.6637, 254.9622),
        vec4(-1024.3159, 828.6182, 172.3921, 4.4594),
        vec4(2340.9258, 3140.4905, 48.2087, 261.8160),
        vec4(1536.9336, 3589.5247, 38.7665, 123.9719),
        vec4(-510.1786, 4366.8784, 67.6254, 170.0338),
        vec4(1979.6206, 5176.8965, 47.6391, 219.5273),
        vec4(1711.2861, 6432.3477, 32.7621, 332.8784),
        vec4(2.6436, 6279.2295, 31.3743, 217.8062),
    },

    reward = { min = 5000, max = 5000 },
}

Police et dispatch

Qui compte comme policier dépend du framework :

Brancher votre dispatch

server/dispatch_custom.lua n'est pas chiffré. La fonction CustomDispatch(alert) est appelée à chaque alarme : envoyez l'alerte avec votre script et rendez true. Si elle rend false, ou si votre code plante, l'alerte intégrée prend le relais : notification et blip clignotant aux policiers en service.

La fonction tourne côté serveur, 30 s après le lancement du braquage. Utilisez l'export serveur de votre script de dispatch.

Fichier livré

Il contient un exemple prêt à l'emploi pour lb-tablet, utilisé seulement si lb-tablet est démarré. Ajoutez votre dispatch sur le même modèle, avant le return false final.

function CustomDispatch(alert)
    if GetResourceState('lb-tablet') == 'started' then
        for _, job in ipairs(alert.jobs) do
            exports['lb-tablet']:AddDispatch({
                priority = 'high',
                code = alert.code,
                title = alert.title,
                description = alert.message,
                location = { label = alert.bank, coords = vec2(alert.coords.x, alert.coords.y) },
                time = alert.duration,
                job = job,
                blip = {
                    sprite = alert.blip.sprite,
                    size = alert.blip.scale,
                    color = alert.blip.color,
                    shortRange = true,
                    label = alert.title,
                    flashes = true,
                },
            })
        end
        return true
    end

    return false
end

Modèle pour un autre script, à adapter à son export :

if GetResourceState('mon-dispatch') == 'started' then
    exports['mon-dispatch']:SendAlert({
        title = alert.title,
        message = alert.message,
        coords = alert.coords,
        jobs = alert.jobs,
    })
    return true
end

Commandes staff

Disponibles en console serveur et en jeu pour les joueurs ayant la permission yf-fleeca.admin.

Langues

Tous les textes affichés aux joueurs sont dans locales/, lisible et modifiable. Pour ajouter une langue :

• copiez locales/en.lua en locales/de.lua ;
• remplacez Locales['en'] par Locales['de'] et traduisez les phrases ;
• gardez les %s et %d dans le même ordre ;
• mettez Config.locale = 'de'.

Le vendeur de plans parle en français : dans les autres langues, ses répliques s'affichent en sous-titres. Les noms des objets, eux, se traduisent dans items.lua.

Dépannage