Installation
Cinq minutes : un fichier SQL, une ligne dans config.lua, une ligne dans server.cfg.
Avant de commencer
Section intitulée « Avant de commencer »| Vous avez besoin | Pourquoi |
|---|---|
| lb-phone | L’application s’y installe |
| oxmysql | Les annonces, likes et gains sont stockés dans votre base SQL |
| ESX, QBCore ou QBox | Inventaire, argent et identité des joueurs |
1. Mettez le dossier en place
Section intitulée « 1. Mettez le dossier en place »Déposez mic_pawnshop dans vos ressources, par exemple dans resources/[mic]/mic_pawnshop.
2. La base de données
Section intitulée « 2. La base de données »Importez pawnshop.sql depuis le dossier de la ressource une seule fois, via HeidiSQL, phpMyAdmin ou l’outil de votre choix. Il crée trois tables :
| Table | Ce qu’elle contient |
|---|---|
pawn_offers | Chaque annonce : item, quantité, prix, type de prix, vendeur, dates et métadonnées |
pawn_earnings | Les gains en attente d’encaissement pour chaque vendeur |
liked_offers | Qui a liké quelle annonce |
La ressource ne crée pas ces tables d’elle-même.
Vérification : les trois tables sont bien présentes dans la base de données utilisée par votre serveur.
3. Démarrez-le après ses dépendances
Section intitulée « 3. Démarrez-le après ses dépendances »Dans server.cfg, ajoutez la ligne ensure mic_pawnshop en dessous de oxmysql, de votre framework et de lb-phone.
L’application attend lb-phone et se réenregistre d’elle-même si lb-phone redémarre, donc l’ordre vis-à-vis du téléphone est souple ; en revanche, le framework et oxmysql doivent impérativement être démarrés en premier.
4. Indiquez votre framework et votre inventaire
Section intitulée « 4. Indiquez votre framework et votre inventaire »Ouvrez config.lua :
| Option | ESX | QBCore | QBox |
|---|---|---|---|
Config.Framework | "esx" | "qb" | "qb" |
Config.InventoryImagePath | "ox_inventory/web/images/" | "qb-inventory/html/images/" | "ox_inventory/web/images/" |
Le framework n’est pas auto-détecté et doit être écrit en minuscules. Sur QBox, utilisez "qb" : QBox gère les ressources QBCore via sa compatibilité. Le chemin d’image sert uniquement à afficher les illustrations dans l’application — n’importe quel inventaire fonctionne, du moment que le chemin pointe vers le dossier contenant ses images d’items.
5. Items
Section intitulée « 5. Items »Il n’y a aucun item à créer. L’application vend ce que les joueurs possèdent déjà. Tout item dont vous souhaitez interdire le commerce doit être inscrit dans Config.BlackList (voir Personnalisation).
6. Premier test
Section intitulée « 6. Premier test »- Ouvrez lb-phone. Pawn Shop se trouve déjà sur l’écran d’accueil — l’application est préinstallée par défaut.
- Créez une annonce : sélectionnez un item de votre inventaire, définissez une quantité et un prix, puis choisissez Unit (À l’unité) ou Total (En lot).
- Avec un second personnage, ouvrez l’application et achetez-le.
Vérification : l’item quitte l’inventaire du vendeur dès la publication de l’annonce, apparaît dans celui de l’acheteur après l’achat, et le vendeur voit l’argent crédité sous Pending en haut de l’application, prêt à être transféré.
Avant d’ouvrir votre serveur
Section intitulée « Avant d’ouvrir votre serveur »- Décidez de la provenance de l’argent.
Config.Bank = trueutilise les comptes bancaires. Payer en items nécessite que l’argent soit un item d’inventaire — lisez d’abord la page Personnalisation. - Configurez
Config.Expireen connaissance de cause. Une annonce qui expire est supprimée avec ses items ; ils ne sont pas restitués au vendeur. - Remplissez
Config.BlackListavec tous les items qui ne doivent pas être échangés : la liste fournie ne contient queburgeretweapon_appistolà titre d’exemples. - Déplacez le pawn shop à l’endroit désiré si vous activez
Config.RequireLocation.