Aller au contenu principal

Scripts BCC (Byte-Crafted-Creations)

Documentation des scripts BCC installés sur le serveur.

Vue d'Ensemble​

Les scripts BCC (Byte-Crafted-Creations) sont des scripts communautaires de haute qualité pour VORP. Ils ajoutent des fonctionnalités essentielles au serveur.

BCC Boats​

Description​

Système complet de gestion de bateaux avec inventaire intégré.

Fonctionnalités​

  • ✅ Achat/vente de bateaux via magasins
  • ✅ Système d'inventaire par bateau (configurable)
  • ✅ Canoë portable craftable
  • ✅ Contrôle de vitesse des bateaux à vapeur
  • ✅ Menu en bateau (ancre, retour à distance)
  • ✅ Nommage personnalisé des bateaux
  • ✅ Limite de bateaux par joueur
  • ✅ Magasin à Guarma (si bcc-guarma installé)
  • ✅ Système de paiement (cash ou gold)
  • ✅ Heures d'ouverture des magasins
  • ✅ Blips personnalisables par magasin

Commandes​

CommandeDescriptionUsage
/boatEnterRéentrer dans le bateau si bloquéConsole F8

Configuration​

Fichier: bcc-boats/config.lua

Config = {
    MaxBoats = 3,                    -- Bateaux max par joueur
    BoatInventorySize = 200,         -- Taille inventaire bateau
    DefaultSpeedMult = 1.0,          -- Multiplicateur de vitesse
    SpawnNPCBoats = false,           -- Désactiver bateaux NPC
}

Magasins de Bateaux​

Les magasins sont configurables avec:

  • Position GPS
  • Modèles disponibles
  • Prix (cash/gold)
  • Heures d'ouverture
  • Restrictions de job
  • Couleur du blip

Base de Données​

Table: player_boats

Colonnes:

  • id - ID unique du bateau
  • identifier - Steam ID du propriétaire
  • charid - ID du personnage
  • boatname - Nom du bateau
  • boatmodel - Modèle du bateau
  • boat_inv - Inventaire (JSON)

Dépendances​

  • vorp_core
  • vorp_inventory
  • vorp_menu

BCC Stables​

Description​

Système d'écuries complet pour la gestion des chevaux.

Fonctionnalités​

  • ✅ Achat/vente de chevaux
  • ✅ Système de mort dure (hard death)
  • ✅ Inventaires customisés par vendeur
  • ✅ Système de dressage (groom job)
  • ✅ Soins vétérinaires
  • ✅ Équipement (selles, sacoches, lanternes)
  • ✅ Stats de chevaux (vitesse, accélération)
  • ✅ Nommage personnalisé
  • ✅ Système de faim/soif pour chevaux

Hard Death​

Lorsqu'activé, les chevaux subissent des dégâts permanents à chaque mort. Au-delà d'un seuil, le cheval meurt définitivement.

Configuration​

Fichier: bcc-stables/config.lua

Config = {
    MaxHorses = 5,                   -- Chevaux max par joueur
    HardDeath = true,                -- Activer mort dure
    DeathThreshold = 5,              -- Morts avant mort permanente
    HorseHunger = true,              -- Système de faim
}

Inventaire Cheval​

Chaque cheval a un inventaire contrôlé par vorp_inventory plutôt que le script lui-même.

Taille: Varie selon le type de cheval et équipement.

Job Groom (Dresseur)​

Système de job pour acheter/vendre/dresser des chevaux sauvages.

Navigation

Flèches gauche/droite au clavier pour naviguer dans le menu (pas de clic souris).

Base de Données​

Table: player_horses

Colonnes importantes:

  • identifier - Propriétaire
  • name - Nom du cheval
  • modelname - Modèle
  • health - Santé
  • stamina - Stamina
  • components - Équipement (JSON)
  • death_count - Compteur de morts

Dépendances​

  • vorp_core
  • vorp_inventory
  • feather-menu

BCC Wagons​

Description​

Système de gestion de chariots avec inventaire.

Fonctionnalités​

  • ✅ Achat/vente de chariots
  • ✅ Inventaire par chariot
  • ✅ Système de spawn/despawn
  • ✅ Nommage personnalisé
  • ✅ Limite par joueur
  • ✅ Système de réparation
  • ✅ Hitch (atteler des chevaux)

Types de Chariots​

  • Delivery Wagons - Transport de marchandises
  • Hunting Wagons - Transport d'animaux
  • Stagecoaches - Transport de passagers
  • Supply Wagons - Usage général

Configuration​

Fichier: bcc-wagons/config.lua

Config = {
    MaxWagons = 2,                   -- Chariots max par joueur
    WagonInventory = 500,            -- Taille inventaire
    RepairCost = 50,                 -- Coût réparation
}

Inventaire Chariot​

Capacité de stockage élevée, idéal pour le transport de marchandises.

Base de Données​

Table: player_wagons

Colonnes:

  • identifier - Propriétaire
  • charid - ID personnage
  • name - Nom du chariot
  • model - Modèle
  • wagon_inv - Inventaire (JSON)

Dépendances​

  • vorp_core
  • vorp_inventory
  • vorp_menu

BCC Saloons​

Description​

Système de gestion de saloons/bars avec menu de boissons et nourriture.

Fonctionnalités​

  • ✅ Menu de boissons/nourriture
  • ✅ Système de paiement
  • ✅ Job de barman
  • ✅ Zones de saloon configurables
  • ✅ Effets d'alcool
  • ✅ Musique/ambiance

Items de Saloon​

  • Bières
  • Whisky
  • Vin
  • Nourriture variée

Configuration​

Fichier: bcc-saloons/shared/config.lua

Config.Saloons = {
    {
        name = "Valentine Saloon",
        coords = vector3(-313.5, 805.5, 118.0),
        items = {
            { item = "beer", price = 5, label = "Bière" },
            { item = "whisky", price = 10, label = "Whisky" }
        }
    }
}

Dépendances​

  • vorp_core
  • vorp_inventory
  • feather-menu

BCC Portals​

Description​

Système de téléportation pour accès rapide entre lieux.

Fonctionnalités​

  • ✅ Portails bidirectionnels
  • ✅ Configuration facile
  • ✅ Restrictions par job
  • ✅ Cooldown configurable
  • ✅ Effets visuels

Types de Portails​

  • Entrées de bâtiments - Intérieur - Extérieur
  • Raccourcis - Entre villes
  • Zones spéciales - Accès restreint

Configuration​

Fichier: bcc-portals/config.lua

Config.Portals = {
    {
        name = "Valentine Sheriff",
        entrance = vector3(-275.5, 805.1, 118.4),
        exit = vector3(-275.0, 810.0, 118.4),
        job = "sheriff",  -- Optionnel
        blip = true
    }
}

Usage Joueur​

  1. Approche du portail
  2. Prompt affiché à l'écran
  3. Appuie sur la touche indiquée
  4. Téléportation instantanée

Dépendances​

  • vorp_core

BCC Water​

Description​

Système de gestion de l'eau et hydratation.

Fonctionnalités​

  • ✅ Sources d'eau dans le monde
  • ✅ Gourdes remplissables
  • ✅ Qualité d'eau variable
  • ✅ Système de purification
  • ✅ Intégration avec métabolisme

Sources d'Eau​

  • Rivières et lacs - Eau gratuite (qualité moyenne)
  • Puits - Eau propre
  • Pompes à eau - Eau de qualité
  • Barils - Eau stockée

Gourdes​

Différentes capacités:

  • Petite gourde - 5 utilisations
  • Gourde moyenne - 10 utilisations
  • Grande gourde - 15 utilisations

Configuration​

Fichier: bcc-water/config.lua

Config = {
    WaterSources = {
        { type = "pump", coords = vector3(...) },
        { type = "well", coords = vector3(...) }
    },
    ThirstPerDrink = 20,
    CanteenRefillTime = 3  -- secondes
}

Dépendances​

  • vorp_core
  • fred_metabolism

BCC Camp​

Description​

Système de camps temporaires déployables.

Fonctionnalités​

  • ✅ Tentes déployables
  • ✅ Feu de camp
  • ✅ Repos/craft
  • ✅ Stockage temporaire
  • ✅ Zones de spawn sécurisées

Items de Camp​

  • Tente - Abri temporaire
  • Feu de camp - Cuisiner, se réchauffer
  • Sac de couchage - Repos rapide

Configuration​

Fichier: bcc-camp/config.lua

Config = {
    MaxCamps = 1,                    -- Camps max par joueur
    CampDuration = 3600,             -- Durée en secondes
    AllowCrafting = true
}

Dépendances​

  • vorp_core
  • vorp_inventory

DVR Crafting​

Description​

Système de craft avancé avec stations de travail.

Fonctionnalités​

  • ✅ Recettes configurables
  • ✅ Stations de craft
  • ✅ Niveaux de compétence
  • ✅ Items custom
  • ✅ Temps de craft
  • ✅ Mini-jeux optionnels

Stations de Craft​

  • Workbench - Craft général
  • Forge - Armes et outils
  • Alchemy Table - Potions et médecine
  • Cooking Fire - Nourriture

Recettes​

Format de recette:

{
    name = "lockpick",
    label = "Crochet",
    station = "workbench",
    time = 10,  -- secondes
    level = 1,
    ingredients = {
        { item = "iron", amount = 2 },
        { item = "wood", amount = 1 }
    }
}

Configuration​

Fichier: dvr_crafting/config.lua

Dépendances​

  • vorp_core
  • vorp_inventory
  • bcc-minigames (optionnel)

DVR Phone​

Description​

Système de téléphone roleplay pour communication entre joueurs.

Fonctionnalités​

  • ✅ Appels vocaux
  • ✅ SMS/Messages
  • ✅ Contacts
  • ✅ Historique d'appels
  • ✅ Sonneries personnalisées
  • ✅ Numéros uniques

Usage​

  1. Item phone dans l'inventaire
  2. Utiliser l'item pour ouvrir le menu
  3. Composer un numéro ou sélectionner contact
  4. Appeler ou envoyer un message

Configuration​

Fichier: dvr_phone/config.lua

Config = {
    PhoneItem = "phone",
    CallRange = 0,  -- 0 = illimité
    MessageCost = 1,  -- Coût par SMS
    CallCost = 2      -- Coût par minute
}

Base de Données​

Tables:

  • phone_contacts - Liste de contacts
  • phone_messages - Historique SMS
  • phone_calls - Historique appels

Dépendances​

  • vorp_core
  • vorp_inventory

DVR Saloon Job​

Description​

Job de barman avec système de service.

Fonctionnalités​

  • ✅ Menu de service
  • ✅ Préparation de boissons
  • ✅ Système de paiement
  • ✅ Pourboires
  • ✅ Inventaire de bar

Tâches du Barman​

  1. Prendre les commandes
  2. Préparer les boissons
  3. Servir les clients
  4. Encaisser les paiements

Configuration​

Fichier: dvr_saloonjob/config.lua

Config = {
    JobName = "bartender",
    Salary = 50,  -- Par service
    Items = {
        { item = "beer", price = 5 },
        { item = "whisky", price = 10 }
    }
}

Dépendances​

  • vorp_core
  • vorp_inventory
  • bcc-saloons

KD Fix Wagon​

Description​

Script simple pour réparer les chariots endommagés.

Fonctionnalités​

  • ✅ Réparation instantanée
  • ✅ Coût configurable
  • ✅ Cooldown entre réparations

Usage​

  1. Monte dans un chariot endommagé
  2. Utilise le menu
  3. Paie le coût de réparation
  4. Chariot réparé

Configuration​

Fichier: kd_fixwagon/fxmanifest.lua

Coût et cooldown configurables via le code.

Dépendances​

  • vorp_core

Installation des Scripts BCC​

Prérequis​

  1. VORP Core installé
  2. oxmysql configuré
  3. Base de données créée

Étapes d'Installation​

  1. Télécharger le script

  2. Placer dans resources/

    resources/[bcc]/nom_script/

  3. Importer SQL

    -- Exécuter le fichier .sql fourni

  4. Ajouter au server.cfg

    ensure nom_script

  5. Configurer

    • Éditer config.lua
    • Ajuster selon besoins

  6. Redémarrer le serveur

Ordre de Chargement​

Dans server.cfg, respecte cet ordre:

# Dependencies
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_menu
ensure bcc-utils
ensure feather-menu

# BCC Scripts
ensure bcc-boats
ensure bcc-stables
ensure bcc-wagons
ensure bcc-saloons
ensure bcc-portals
ensure bcc-water
ensure bcc-camp

# DVR Scripts
ensure dvr_crafting
ensure dvr_phone
ensure dvr_saloonjob

# Autres
ensure kd_fixwagon

Support et Updates​

GitHub Officiel​

Discord BCC​

Documentation BCC​

Chaque script a son propre README.md avec instructions détaillées.

Notes Importantes​

Compatibilité

Assure-toi que tous les scripts BCC sont à jour et compatibles entre eux.

Customisation

Les scripts BCC sont open-source, tu peux les modifier selon tes besoins.

Sauvegarde

Toujours faire une sauvegarde de la base de données avant une mise à jour.