Aller au contenu principal

Scripts Standalone

Documentation des scripts autonomes qui ne dépendent pas directement du framework BCC.

Vue d'Ensemble​

Ces scripts fonctionnent de manière indépendante ou avec des dépendances minimales. Ils ajoutent des fonctionnalités spécifiques au serveur.

Hard Jobs​

Description​

Collection complète de jobs/métiers avec systèmes intégrés.

Jobs Disponibles​

⛏️ Mining (Minage)​

Extraction de minerais dans les mines.

Localisation: hard_jobs/Mining/

Fonctionnalités:

  • ✅ Zones de minage configurables
  • ✅ Différents types de minerais
  • ✅ Système de fatigue
  • ✅ Vente aux négociants
  • ✅ Progression de niveau

Minerais Disponibles:

  • Fer (Iron Ore)
  • Or (Gold Ore)
  • Cuivre (Copper Ore)
  • Charbon (Coal)

Configuration:

-- hard_jobs/Mining/server/main.lua
Config.MiningZones = {
    {
        coords = vector3(x, y, z),
        ore_type = "iron",
        spawn_chance = 80
    }
}

Items Requis:

  • Pioche (pickaxe)

🪓 Wood Cutting (Bûcheron)​

Coupe de bois et transformation.

Localisation: hard_jobs/WoodCutting/

Fonctionnalités:

  • ✅ Zones de coupe
  • ✅ Types d'arbres variés
  • ✅ Transport au scierie
  • ✅ Transformation en planches
  • ✅ Vente de bois

Produits:

  • Bois brut (Raw Wood)
  • Planches (Planks)
  • Bois de chauffage (Firewood)

Items Requis:

  • Hache (axe)

👮 Police Job​

Système complet pour forces de l'ordre.

Localisation: hard_jobs/policejob/

Fonctionnalités:

  • ✅ Armurerie police
  • ✅ Système d'arrestation
  • ✅ Fouille de suspects
  • ✅ Cellules de prison
  • ✅ Amendes
  • ✅ Menottes
  • ✅ Dossiers criminels

Commandes Police:

  • Arrêter un joueur
  • Fouiller
  • Menotter/Démenotter
  • Mettre en cellule
  • Donner une amende

Grades:

  • Recrue
  • Officier
  • Sergent
  • Lieutenant
  • Shérif

Configuration:

Config.PoliceStations = {
    {
        name = "Valentine Sheriff",
        coords = vector3(-275.5, 805.1, 118.4),
        blip = true
    }
}

🏥 Medic Job​

Système médical complet.

Localisation: hard_jobs/medicjob/

Fonctionnalités:

  • ✅ Réanimation de joueurs
  • ✅ Soins sur place
  • ✅ Pharmacie
  • ✅ Diagnostics
  • ✅ Ambulance/Transport
  • ✅ Fournitures médicales

Items Médicaux:

  • Trousse de premiers soins
  • Bandages
  • Morphine
  • Stimulants

Actions:

  • Réanimer (revive)
  • Soigner (heal)
  • Diagnostiquer
  • Transporter

Configuration:

Config.Hospitals = {
    {
        name = "Valentine Doctor",
        coords = vector3(-283.4, 809.3, 119.4),
        blip = true
    }
}

🍺 Saloon Job​

Job de barman dans les saloons.

Localisation: hard_jobs/SaloonJob/

Fonctionnalités:

  • ✅ Service de boissons
  • ✅ Préparation de nourriture
  • ✅ Gestion de bar
  • ✅ Pourboires
  • ✅ Événements spéciaux

Menu de Service:

  • Bières variées
  • Whiskies
  • Vins
  • Nourriture

Revenus:

  • Salaire de base
  • Pourboires des clients
  • Bonus selon activité

🚪 Doorlocks​

Système de portes verrouillables.

Localisation: hard_jobs/Doorlocks/

Fonctionnalités:

  • ✅ Portes configurables
  • ✅ Permissions par job
  • ✅ Clés physiques
  • ✅ Lockpicking
  • ✅ Logs d'ouverture

Types de Portes:

  • Portes publiques
  • Portes de job
  • Portes privées
  • Portes haute sécurité

Configuration:

Config.Doors = {
    {
        coords = vector3(x, y, z),
        locked = true,
        jobs = {"sheriff", "police"},
        lockpickable = false
    }
}

Usage:

  • Approche de la porte
  • Prompt affiché
  • Interaction si autorisé

📦 Items System​

Système d'items custom pour hard_jobs.

Localisation: hard_jobs/items/

Fonctionnalités:

  • ✅ Items de job spécifiques
  • ✅ Outils avec durabilité
  • ✅ Licenses
  • ✅ Badges
  • ✅ Clés

Items Spéciaux:

  • Badge de police
  • Carte médicale
  • License de minage
  • Clés de bâtiments

Configuration Globale Hard Jobs​

Salaires:

Config.Salaries = {
    miner = 50,
    lumberjack = 45,
    police = 75,
    medic = 70,
    bartender = 40
}

Véhicules de Job:

Config.JobVehicles = {
    police = {"policewagon", "policehorse"},
    medic = {"medicwagon"},
    -- etc
}

Discord Integration​

Badger Discord API​

Localisation: Badger_Discord_API/

Description: API pour intégrer Discord avec le serveur RedM.

Fonctionnalités:

  • ✅ Obtenir rôles Discord
  • ✅ Vérifier présence sur serveur
  • ✅ Whitelist via Discord
  • ✅ Logs Discord
  • ✅ Webhooks

Usage:

-- Obtenir les rôles d'un joueur
exports['Badger_Discord_API']:GetDiscordRoles(source)

-- Vérifier un rôle
exports['Badger_Discord_API']:CheckRole(source, roleId)

Configuration:

Config = {
    GuildId = "123456789",  -- ID du serveur Discord
    BotToken = "votre_token"
}

DiscordAcePerms​

Localisation: DiscordAcePerms/

Description: Gestion des permissions serveur via rôles Discord.

Fonctionnalités:

  • ✅ Permissions automatiques
  • ✅ Mapping rôles Discord -> Groupes serveur
  • ✅ Updates en temps réel
  • ✅ Logs

Configuration:

Config.Roles = {
    ["123456789"] = "group.admin",      -- Rôle Admin
    ["987654321"] = "group.moderator",  -- Rôle Modérateur
    ["456789123"] = "group.vip",        -- Rôle VIP
}

Avantages:

  • Pas besoin de modifier server.cfg
  • Gestion centralisée via Discord
  • Updates automatiques

Prérequis:

  • Badger_Discord_API
  • Bot Discord configuré

Fred HUD​

Description​

Interface HUD complète et customisable.

Localisation: fred_hud/

Fonctionnalités​

  • ✅ Cores visuels (santé, stamina)
  • ✅ Mini-map
  • ✅ Compass
  • ✅ Vitesse du cheval/véhicule
  • ✅ Argent affiché
  • ✅ Job et grade
  • ✅ Faim et soif
  • ✅ Température

Éléments Affichés​

Cores​

  • Santé (rouge)
  • Stamina (jaune)
  • Dead Eye (bleu)

Statuts​

  • Faim
  • Soif
  • Alcoolémie (si ivre)
  • Stress

Informations​

  • Argent cash
  • Or
  • Job actuel
  • Heure du serveur
  • ID du joueur

Configuration​

Fichier: fred_hud/config.lua

Config = {
    ShowCores = true,
    ShowMinimap = true,
    ShowCompass = true,
    ShowMoney = true,
    ShowJob = true,
    ShowStatus = true,
    Position = "bottom-right"
}

Customisation CSS​

Le HUD est entièrement customisable via CSS dans fred_hud/ui/.

Dépendances​

  • vorp_core
  • fred_metabolism

Fists Gold Panning​

Description​

Système d'orpaillage dans les rivières.

Localisation: fists-goldpanning/

Fonctionnalités​

  • ✅ Zones d'orpaillage
  • ✅ Mini-jeu
  • ✅ Récompenses aléatoires
  • ✅ Équipement requis
  • ✅ Système de fatigue

Usage​

  1. Acheter un pan d'orpaillage
  2. Trouver une rivière/zone d'orpaillage
  3. Utiliser le pan
  4. Compléter le mini-jeu
  5. Récolter l'or trouvé

Récompenses​

  • Pépites d'or (Gold Nuggets)
  • Or brut (Raw Gold)
  • Pierres précieuses (rare)

Configuration​

Fichier: fists-goldpanning/config.lua

Config.GoldPanningZones = {
    {
        coords = vector3(x, y, z),
        radius = 50.0,
        reward_min = 1,
        reward_max = 5
    }
}

Mini-jeu​

Type: Timing/Précision Difficulté: Configurable

Dépendances​

  • vorp_core
  • vorp_inventory

Crosshair Remove​

Description​

Script simple qui enlève le réticule de visée par défaut.

Localisation: crosshair_remove/

Fonctionnalités​

  • ✅ Désactive le crosshair natif
  • ✅ Améliore l'immersion
  • ✅ Léger et performant

Configuration​

Aucune - Plug and play.

Toggle​

Peut être activé/désactivé via commande si configuré.

Zeus RedM Aim Log​

Description​

Système de logs pour détecter les tricheurs (aimbot).

Localisation: zeus-redm-aim-log/

Fonctionnalités​

  • ✅ Détection de patterns suspects
  • ✅ Logs dans console
  • ✅ Webhooks Discord
  • ✅ Alertes staff
  • ✅ Statistiques de tir

Métriques Surveillées​

  • Précision anormale
  • Temps de réaction
  • Snap-to-target
  • Patterns de visée

Configuration​

Fichier: Configuration dans le script

Config = {
    EnableLogging = true,
    DiscordWebhook = "votre_webhook",
    SuspicionThreshold = 85  -- % de précision suspect
}

Logs Discord​

Envoie automatiquement des alertes si joueur suspect détecté.

Dépendances​

  • vorp_core

Installation des Scripts Standalone​

Étapes Générales​

  1. Télécharger/Extraire le script

  2. Placer dans resources/

    resources/[standalone]/nom_script/

  3. Importer SQL (si applicable)

    -- Exécuter les fichiers .sql fournis

  4. Configurer

    • Éditer config.lua
    • Ajuster permissions
    • Configurer Discord (si applicable)

  5. Ajouter au server.cfg

    ensure nom_script

  6. Redémarrer le serveur

Ordre de Chargement​

Dans server.cfg:

# Discord Integration
ensure Badger_Discord_API
ensure DiscordAcePerms

# UI
ensure fred_hud
ensure crosshair_remove

# Jobs
ensure hard_jobs

# Activities
ensure fists-goldpanning

# Security
ensure zeus-redm-aim-log

Configuration Hard Jobs​

server.cfg Permissions​

# Mining
add_ace group.miner hard_jobs.mining allow

# Lumberjack
add_ace group.lumberjack hard_jobs.woodcutting allow

# Police
add_ace group.police hard_jobs.police allow
add_ace group.police hard_jobs.arrest allow
add_ace group.police hard_jobs.jail allow

# Medic
add_ace group.medic hard_jobs.medic allow
add_ace group.medic hard_jobs.revive allow

Dépannage​

Hard Jobs ne fonctionne pas​

  1. Vérifie que vorp_core est démarré
  2. Vérifie les tables SQL
  3. Confirme les permissions dans server.cfg

Discord API erreur​

  1. Vérifie le bot token
  2. Confirme le guild ID
  3. Vérifie les permissions du bot

HUD ne s'affiche pas​

  1. Clear cache NUI (F5 dans menu)
  2. Vérifie fred_metabolism est démarré
  3. Regarde console F8 pour erreurs

Notes de Performance​

Hard Jobs​

Très optimisé, impact minimal sur performance.

Fred HUD​

Léger, utilise peu de ressources.

Discord APIs​

Requêtes asynchrones, pas d'impact notable.

Support et Documentation​

Hard Jobs​

Voir README dans chaque sous-dossier de job.

Fred HUD​

[Documentation en ligne si disponible]

Discord APIs​

Notes Importantes​

Customisation

Tous ces scripts sont hautement customisables selon tes besoins.

Jobs

Hard Jobs nécessite une configuration appropriée des salaires et zones pour équilibrer l'économie.

Discord

Pour utiliser les features Discord, assure-toi d'avoir un bot Discord configuré correctement.