Introduction

VScript Doc est un système complet de gestion de documents pour FiveM. Il permet aux joueurs de rédiger, signer, verrouiller, copier et même importer des documents depuis Google Docs directement en jeu.

Note : Cette ressource est compatible avec les frameworks QBCore, Qbox, et ESX, ainsi que les inventaires OX Inventory et Core Inventory.

Installation

Suivez ces étapes pour installer la ressource sur votre serveur :

  1. Téléchargez la ressource et placez-la dans votre dossier resources.
  2. Ajoutez ensure vscript_doc à votre fichier server.cfg.
  3. Configurez les items dans votre système d'inventaire (voir Configuration des Items).
  4. Redémarrez votre serveur.

Configuration

Le fichier de configuration se trouve dans config.lua. Vous pouvez ajuster les paramètres suivants :

Config = {}

-- Framework : 'QBCore', 'Qbox', ou 'ESX'
Config.Framework = 'ESX'

-- Langue (fr, en, es, de, it, pt, ru, pl, nl, tr, sv)
Config.Lang = 'fr'

-- Items utilisés par le script
Config.Items = {
    document_vierge = "document_vierge"
}

-- Inventaire : 'ox', 'core', 'qb-inventory', 'esx_inventory'
Config.Inventory = "ox"

-- Mode Debug (affiche les logs dans la console serveur)
Config.Debug = false

Configuration des Items

Vous devez ajouter l'item document_vierge à votre base de données ou à la configuration de votre inventaire. Choisissez la méthode qui correspond à votre système.

1. SQL (Standard ESX / QBCore)

Exécutez cette requête SQL si vous utilisiez la table items standard.

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('document_vierge', 'Document Vierge', 1, 0, 1);

2. OX Inventory

Ajoutez ce bloc à ox_inventory/data/items.lua.

Important : L'item doit avoir stack = false pour que les métadonnées (contenu du document) soient sauvegardées correctement par document. Sinon tous vos documents partageront le même contenu ! 
['document_vierge'] = {
    label = 'Document Vierge',
    weight = 100,
    stack = false,  -- IMPORTANT: doit être false !
    close = true,
    description = 'Un document vierge à remplir'
},

3. Core Inventory

Ajoutez ce bloc à la configuration de Core Inventory (généralement items.lua).

['document_vierge'] = {
    label = 'Document Vierge',
    weight = 1,
    stack = false,  -- Recommandé pour les métadonnées uniques
    description = 'Un document vierge à remplir'
},

4. Image de l'Item

Nous avons fourni une image pour l'item cohérente avec le style d'OX Inventory.

  • Chemin : vscript_doc/html/img/document_vierge.png
  • Copiez ce fichier dans le dossier d'images de votre inventaire (ex: ox_inventory/web/images/).

Traduction (Locales)

Le script est fourni avec des traductions pré-configurées pour 11 langues.

Pour changer la langue, modifiez simplement la variable Config.Lang dans config.lua. 

Config.Lang = 'fr' -- Options: fr, en, es, de, it, pt, ru, pl, nl, tr, sv

Vous pouvez également ajouter ou modifier des traductions dans le fichier locales.lua.