EBT / Bons d'alimentation

Système EBT / Carte de paiement d'aide alimentaire – Carte de paiement d'aide sociale réaliste pour QBCore Serveurs

Il s'agit d'un système d'aide gouvernementale qui ajoute des cartes EBT (Electronic Benefits Transfer) à votre serveur FiveM – essentiellement des bons alimentaires sous forme numérique. Les joueurs postulent auprès d'un NPC des services gouvernementaux, sont approuvés pour des prestations en fonction de montants configurables et reçoivent une carte qu'ils peuvent utiliser dans les magasins au lieu d'argent liquide. Il est conçu pour les serveurs de rôle qui souhaitent simuler des systèmes socio-économiques réalistes au-delà de “tout le monde est riche ou tout le monde est fauché”.”

Ce qui est inclus

Vous obtenez un système d'application de prestations sociales complet avec un NPC de services gouvernementaux, des montants de prestations configurables, des délais de refroidissement d'approbation et des articles de cartes EBT qui s'intègrent à vos magasins existants. Le script fonctionne avec plusieurs systèmes d'inventaire (qb-inventory, ox_inventory, ps-inventory) et systèmes de ciblage (qb-target, ox_target), donc il s'intègre dans votre configuration existante sans vous forcer à changer de frameworks. Il y a également une journalisation facultative par webhook Discord pour que vous puissiez suivre qui fait des demandes de prestations et combien ils reçoivent.

Comment fonctionne le processus de demande

Les joueurs se rendent chez un NPC de services gouvernementaux (emplacement et modèle de ped entièrement configurables) et interagissent via le système de ciblage pour demander les prestations EBT. Ils précisent le montant pour lequel ils font la demande – vous définissez les montants minimum et maximum dans la configuration (par défaut $50-$4000). Une fois approuvée, ils reçoivent une carte EBT qui fonctionne comme un moyen de paiement séparé dans les magasins. Le système suit les dates de demande dans votre base de données SQL, donc le minuteur de délai d'attente continue de fonctionner même si les joueurs se déconnectent. Le délai d'attente par défaut est de 1 semaine (10,080 minutes), mais vous pouvez l'ajuster selon ce qui convient à l'économie de votre serveur.

Caractéristiques principales

• Montants de prestations configurables – Définir les montants minimum et maximum de la demande ($50-$4000 par défaut)
• Système de délai persistant – Suivi dans une base de données SQL, continue même lorsque les joueurs sont hors ligne
• Méthode de paiement séparée – Les cartes EBT fonctionnent comme une option de paiement distincte dans les magasins compatibles
• Support multi-inventaire – Fonctionne avec qb-inventory, ox_inventory ou ps-inventory
• Support multi-cibles – Compatible avec les systèmes qb-target ou ox_target
• Journalisation des webhooks Discord – Suivi optionnel des demandes et des approbations
• PNP personnalisable – Changer le modèle de pédestre, l'emplacement et les paramètres de balise

Parfait pour

• Serveurs Roleplay qui simulent des luttes économiques réalistes et des systèmes de bien-être
• Serveurs avec des gouvernements détaillés emploi roleplay (services sociaux)
• Communautés qui souhaitent une variété de paiements au-delà de “tout le monde utilise de l'argent liquide”
• Serveurs avec systèmes de magasins d'alimentation/épiceries où EBT a un sens thématique
• Créer un rôle de jeu de disparité économique sans rendre les personnages à faible revenu injouables
• Serveurs qui mettent l'accent sur les services sociaux et les systèmes de soutien communautaire

Détails techniques

• Cadre: QBCore (qb-core requis)
• Systèmes d'inventaire : qb-inventory, ox_inventory ou ps-inventory
• Systèmes cibles : qb-target ou ox_target
• Base de données: Intégration SQL pour le suivi des temps de recharge et de l'historique des demandes
• Webhook: Journalisation optionnelle Discord pour la surveillance par l'administrateur
• Refroidir: Par défaut 1 semaine (10 080 minutes), entièrement configurable

Installation

1. Assurez-vous de faire fonctionner QBCore avec vos systèmes d'inventaire et de cible préférés
2. Importez le fichier SQL pour créer les tables de base de données nécessaires.
3. Configurer le système d'inventaire (“qb-inventory”, “ox_inventory” ou “ps-inventory”)
4. Configurez le système cible (“qb-target” ou “ox_target”)
5. Définir les montants minimum/maximum de demande dans config.lua
6. Configurer la durée de recharge (par défaut 1 semaine = 10 080 minutes)
7. Définir l'emplacement, le modèle et les préférences de blip du NPC de services gouvernementaux
8. (Optionnel) Ajouter l'URL du webhook Discord pour la journalisation de l'application
9. Ajouter assurer ebt-food-stamp dans server.cfg et redémarrez

Points saillants de la configuration

Le fichier de configuration est complet et bien documenté. Vous pouvez basculer entre les systèmes d'inventaire et de cible avec de simples modifications de chaîne – aucune édition de code requise. Le délai est défini en minutes, ce qui le rend facile à ajuster (1 jour = 1 440 minutes, 1 semaine = 10 080 minutes, etc.). Les montants d'application max et min vous permettent d'équilibrer votre économie – serrez-les pour une assistance sociale contrôlée ou relâchez-les pour des avantages plus généreux. La configuration du PNP inclut le modèle de pédestre, les coordonnées exactes avec l'orientation, et un repère de carte optionnel pour que les joueurs puissent trouver facilement les services gouvernementaux.

Intégration des paiements

Lorsque les joueurs font leurs courses dans les magasins, ils voient deux options de paiement : Espèces et Carte EBT. Le système s'intègre à vos scripts de magasin existants qui prennent en charge plusieurs méthodes de paiement. Cela crée des scénarios réalistes où les joueurs doivent décider quoi acheter avec des fonds EBT limités par rapport à l'argent liquide. Vous pouvez également restreindre certains articles au paiement en espèces si vous souhaitez simuler les restrictions réelles des systèmes EBT (comme dans les systèmes EBT réels aux États-Unis où vous ne pouvez pas acheter d'alcool ou de plats chauds).

Ce qui le distingue

La plupart des scripts d'économie FiveM ne suivent que “l'argent” comme un seul nombre. Cela ajoute un deuxième type de paiement spécifiquement pour les prestations sociales, ce qui crée un rôle économique plus nuancé. Le système de temporisation de refroidissement persistant signifie que les joueurs ne peuvent pas spammer les demandes en se déconnectant et en se reconnectant – le minuteur s'exécute dans votre base de données indépendamment. Le support multi-inventaire et multi-cible est également rare ; la plupart des scripts vous verrouillent dans un système, mais celui-ci fonctionne avec toutes les options populaires. Et le journalisation par webhook Discord donne aux administrateurs une visibilité sur l'utilisation du système sans nécessiter de vérifications manuelles de la base de données.

Applications de jeu de rôle

Cela ouvre des possibilités de rôle de pauvreté et de services sociaux réalistes qui sont généralement impossibles dans FiveM. Les personnages peuvent être des “travailleurs pauvres” – employés mais en difficulté financière – sans être complètement ruinés et incapables de participer. Les joueurs de métiers gouvernementaux (travailleurs sociaux, responsables de cas) peuvent avoir des tâches réelles liées aux services de bien-être. Cela crée également des dynamiques intéressantes dans le rôle de caissier dans les magasins d'alimentation ou les marchés, où les caissiers traitent différents types de paiement. Le système de délai de refroidissement empêche les abus tout en permettant aux joueurs d'accéder aux prestations lorsqu'ils en ont vraiment besoin pour l'histoire de leur personnage.

Équilibrage économique

Les montants minimums/maximums configurables et la durée de recharge vous donnent un contrôle total sur l'impact économique. Si vous définissez une période de recharge d'une semaine avec des avantages maximum de $50-$200, il s'agit d'un petit filet de sécurité qui ne submergera pas votre économie. Si vous définissez des périodes de recharge plus courtes avec des montants plus élevés, cela devient plus accessible mais nécessite une surveillance pour éviter les abus. Le système suit tout en SQL, donc vous pouvez interroger l'historique des demandes pour voir si des ajustements sont nécessaires. Commencez de manière conservatrice et ajustez en fonction de la réponse de l'économie de votre serveur.

Fichier de configuration

Config = {}

Config.Inventory = "qb-inventory" -- "ox_inventory" / "qb-inventory" / "ps-inventory"
Config.Target = "qb-target" -- "ox_target" / "qb-target"

-- Default 1 week
Config.CooldownTillNextEBT = 10080 -- (Minutes) This is Stored in the SQL so if the players logs off this timer will keep going. This is how long until the player can get approved for another EBT card.

-- Max & Min EBT Balance that a player can apply for.
Config.MaxApply = 4000
Config.MinApply = 50

Config.Webhook = false
Config.Webhook = "PLACE_YOUR_WEBHOOK_HERE" --  For Discord Logs

Config.GovernmentPed = "csb_tomcasino" --  Ped Name
Config.GovernmentPedCoords = vector4(-544.8433, -204.5809, 37.2151, 211.2208) -- Ped Coords
Config.Blip = true -- Display Blip on Ped

Strings = {
    SelectPayCash = "Cash",
    SelectPayEBT = "EBT Card",
    PaymentType = "Payment Type",
    PaymentTypeDesc = "Please select either Cash or EBT",
    GovServicesTitle = "Government Services",
    GoveServicesPedTargetLabel = "Government Services",
    ContextTitle = "Apply For A EBT Card",
    ContextDesc = "Put an Application",

-- Rest of the strings --

Système économique FiveM associé

• Banque brutale (ESX/QB)
• Marché de vente avancé
• Codem – Banque
• Statistiques et réalisations

Fichier de configuration

Config = {}

Config.Inventory = "qb-inventory" -- "ox_inventory" / "qb-inventory" / "ps-inventory"
Config.Target = "qb-target" -- "ox_target" / "qb-target"

-- Default 1 week
Config.CooldownTillNextEBT = 10080 -- (Minutes) This is Stored in the SQL so if the players logs off this timer will keep going. This is how long until the player can get approved for another EBT card. 

-- Max & Min EBT Balance that a player can apply for.
Config.MaxApply = 4000
Config.MinApply = 50

Config.Webhook = false
Config.Webhook = "PLACE_YOUR_WEBHOOK_HERE" --  For Discord Logs

Config.GovernmentPed = "csb_tomcasino" --  Ped Name
Config.GovernmentPedCoords = vector4(-544.8433, -204.5809, 37.2151, 211.2208) -- Ped Coords
Config.Blip = true -- Display Blip on Ped

Strings = {
    SelectPayCash = "Cash",
    SelectPayEBT = "EBT Card",
    PaymentType = "Payment Type",
    PaymentTypeDesc = "Please select either Cash or EBT",
    GovServicesTitle = "Government Services",
    GoveServicesPedTargetLabel = "Government Services",
    ContextTitle = "Apply For A EBT Card",
    ContextDesc = "Put an Application",

-- Rest of the strings --