Documentation produit

Supérette FiveM (LTD Creator)

Un script de création et gestion de supérette LTD pour FiveM avec configuration des articles, gestion du point de vente, interaction joueur et mise en place rapide sur serveur ESX.

Installation

  1. 1. Téléchargez le fichier zip.
  2. 2. Placez le dossier concerné dans votre dossier resources.
  3. 3. Ajoutez ensure ltdbuilder dans votre server.cfg ou resources.cfg.
  4. 4. Insérez le SQL suivant :
    SQL
    CREATE TABLE IF NOT EXISTS `ltdbuilder_shops` (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `name` varchar(60) NOT NULL,
      `interaction_x` double NOT NULL DEFAULT 0,
      `interaction_y` double NOT NULL DEFAULT 0,
      `interaction_z` double NOT NULL DEFAULT 0,
      `interaction_h` double NOT NULL DEFAULT 0,
      `blip_enabled` tinyint(1) NOT NULL DEFAULT 0,
      `blip_name` varchar(60) NOT NULL DEFAULT 'Superette',
      `blip_sprite` int(11) NOT NULL DEFAULT 52,
      `blip_color` int(11) NOT NULL DEFAULT 2,
      `blip_scale` double NOT NULL DEFAULT 0.8,
      `ped_enabled` tinyint(1) NOT NULL DEFAULT 0,
      `ped_model` varchar(60) NOT NULL DEFAULT 'mp_m_shopkeep_01',
      `ped_x` double NOT NULL DEFAULT 0,
      `ped_y` double NOT NULL DEFAULT 0,
      `ped_z` double NOT NULL DEFAULT 0,
      `ped_h` double NOT NULL DEFAULT 0,
      `created_by` varchar(80) NOT NULL DEFAULT 'unknown',
      `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
      `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
    
    CREATE TABLE IF NOT EXISTS `ltdbuilder_shop_items` (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `shop_id` int(11) NOT NULL,
      `item_name` varchar(60) NOT NULL,
      `item_label` varchar(60) NOT NULL,
      `price` int(11) NOT NULL DEFAULT 0,
      PRIMARY KEY (`id`),
      KEY `idx_ltdbuilder_shop_items_shop_id` (`shop_id`),
      CONSTRAINT `fk_ltdbuilder_shop_items_shop` FOREIGN KEY (`shop_id`) REFERENCES `ltdbuilder_shops` (`id`) ON DELETE CASCADE
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
  5. 5. Redémarrez le serveur.

Tutoriel

  1. Tutoriel de présentation et mise en place de la supérette LTD.

Configuration

  1. 1. Ouvrez le fichier config.lua.
  2. 2. Modifiez les options qui s'offrent à vous :
  3. - Ajoutez les licences autorisées dans AllowedLicenses pour donner accès au menu de création de supérette.
  4. - Modifiez MenuTitle et MenuSubtitle pour personnaliser le menu builder.
  5. - Modifiez ShopTitle et ShopSubTitle pour personnaliser le menu d’interaction de la supérette.
  6. - Changez OpenMenuCommand pour définir la commande d’ouverture du builder.
  7. - Ajustez les couleurs générales avec ColorR, ColorG, ColorB et ColorA.
  8. - Réglez l’affichage des markers avec DrawDistance, InteractDistance et Marker.
  9. - Définissez le PNJ par défaut avec DefaultPedModel.
  10. - Définissez le nom par défaut des blips avec DefaultBlipName.
  11. - Configurez les choix de blips disponibles via BlipSprites, BlipColors et BlipScales.
  12. - Ajoutez les produits vendables par défaut dans SellableItems.
  13. - Activez ou désactivez les logs d’achat avec LogPourAchat.
  14. - Configurez les webhooks Discord dans Logs pour les ouvertures du builder, refus d’accès, créations, modifications, suppressions de supérettes et achats réussis ou échoués.

Utilisation

  1. Rendez-vous à la supérette en jeu pour utiliser le commerce que vous configurerez via la commande /builder_ltd.