EBT / Vale-Alimentação

Sistema EBT / Vale-Alimentação – Cartão de Pagamento de Bem-Estar Realista para QBCore Servidores

Este é um sistema de assistência governamental que adiciona cartões EBT (Transferência Eletrônica de Benefícios) ao seu servidor FiveM – basicamente cupons de alimentação em forma digital. Os jogadores se candidatam através de um NPC de serviços governamentais, são aprovados para benefícios com base em quantias configuráveis e recebem um cartão que podem usar em lojas em vez de dinheiro. É projetado para servidores de roleplay que desejam simular sistemas socioeconômicos realistas além de apenas “todos são ricos ou todos são pobres”.”

O que está incluído

Você recebe um sistema completo de aplicação de assistência social com um NPC de serviços governamentais, quantias de benefícios configuráveis, tempos de resfriamento de aprovação e itens de cartão EBT que se integram às suas lojas existentes. O script funciona com vários sistemas de inventário (qb-inventory, ox_inventory, ps-inventory) e sistemas de alvo (qb-target, ox_target), então ele se encaixa no seu setup existente sem forçá-lo a mudar de frameworks. Também há registro opcional de webhook Discord para que você possa rastrear quem está se candidatando a benefícios e quanto estão recebendo.

Como Funciona o Processo de Aplicação

Os jogadores vão até um NPC de serviços governamentais (localização e modelo de ped totalmente configuráveis) e interagem via sistema de alvo para solicitar benefícios EBT. Eles especificam quanto estão solicitando — você define os valores mínimo e máximo no config (padrão $50-$4000). Uma vez aprovados, recebem um cartão EBT que funciona como um método de pagamento separado em lojas. O sistema rastreia as datas de solicitação no seu banco de dados SQL, então o temporizador de resfriamento continua funcionando mesmo se os jogadores saírem do jogo. O resfriamento padrão é de 1 semana (10.080 minutos), mas você pode ajustar isso para o que fizer sentido para a economia do seu servidor.

Principais características

• Valores de Benefício Configuráveis – Defina os valores mínimo e máximo para os pedidos de aplicação (padrão $50-$4000)
• Sistema de Resfriamento Persistente – Rastreado em banco de dados SQL, continua mesmo quando os jogadores estão offline
• Método de Pagamento Separado – Cartões EBT funcionam como opção de pagamento distinta em lojas compatíveis
• Suporte a múltiplos inventários – Funciona com qb-inventory, ox_inventory ou ps-inventory
• Suporte a Múltiplos Alvos – Compatível com sistemas qb-target ou ox_target
• Registro de webhook do Discord – Rastreamento opcional de aplicações e aprovações
• NPC Personalizável – Alterar modelo de ped, localização e configurações de blip

Perfeito para

• Servidores Roleplay que simulam lutas econômicas realistas e sistemas de bem-estar
• Servidores com governo detalhado trabalho roleplay (departamentos de serviços sociais)
• Comunidades que desejam variedade de pagamento além de apenas “todos usam dinheiro”
• Servidores com sistemas de lojas de alimentos/mercados onde o EBT faz sentido temático
• Criando um roleplay de disparidade econômica sem tornar os personagens de baixa renda impraticáveis
• Servidores que enfatizam serviços sociais e sistemas de apoio à comunidade

Detalhes técnicos

• Estrutura: QBCore (qb-core necessário)
• Sistemas de inventário: qb-inventory, ox_inventory ou ps-inventory
• Sistemas Alvo: qb-target ou ox_target
• Banco de dados: Integração SQL para rastrear períodos de espera e histórico de aplicações
• Webhook: Registro Discord opcional para monitoramento de administradores
• Esfriar: Padrão de 1 semana (10.080 minutos), totalmente configurável

Instalação

1. Certifique-se de que você está executando QBCore com seus sistemas de inventário e alvo preferidos
2. Importe o arquivo SQL para criar as tabelas de banco de dados necessárias.
3. Configurar sistema de inventário (“qb-inventory”, “ox_inventory” ou “ps-inventory”)
4. Configure o sistema de alvo (“qb-target” ou “ox_target”)
5. Defina valores mínimos/máximos de aplicação em config.lua
6. Configure a duração do período de espera (padrão 1 semana = 10.080 minutos)
7. Definir localização, modelo e preferências de blip do NPC de serviços governamentais
8. (Opcional) Adicione URL de webhook Discord para registro de aplicativos
9. Adicionar garantir ebt-vale-refeição para server.cfg e reinicie

Principais características da configuração

O arquivo de configuração é abrangente e bem documentado. Você pode alternar entre sistemas de inventário e alvo com simples alterações de string – não é necessário editar o código. O resfriamento é definido em minutos, facilitando o ajuste (1 dia = 1.440 minutos, 1 semana = 10.080 minutos, etc.). Os valores máximo e mínimo de aplicação permitem que você equilibre sua economia – defina-os de forma rígida para um bem-estar controlado ou flexível para benefícios mais generosos. A configuração do NPC inclui modelo de ped, coordenadas exatas com direção e blip opcional no mapa para que os jogadores possam encontrar facilmente os serviços governamentais.

Integração de pagamentos

Quando os jogadores fazem compras em lojas, eles veem duas opções de pagamento: Dinheiro e Cartão EBT. O sistema se integra aos scripts de loja existentes que suportam múltiplos métodos de pagamento. Isso cria cenários realistas onde os jogadores precisam decidir o que comprar com fundos EBT limitados versus dinheiro regular. Você também pode restringir certos itens apenas para pagamento em dinheiro se quiser simular restrições reais do EBT (como nos sistemas EBT reais dos EUA, onde você não pode comprar álcool ou alimentos quentes).

O que o torna especial

A maioria dos scripts de economia FiveM apenas rastreia “dinheiro” como um número. Isso adiciona um segundo tipo de pagamento especificamente para benefícios de bem-estar, o que cria um roleplay econômico mais nuancado. O sistema de tempo de espera persistente significa que os jogadores não podem enviar aplicações em spam desligando e ligando – o temporizador funciona no seu banco de dados independentemente. O suporte a múltiplos inventários e múltiplos alvos também é raro; a maioria dos scripts o tranca em um sistema, mas este funciona com todas as opções populares. E o registro de webhook Discord dá aos administradores visibilidade sobre quem está usando o sistema sem exigir verificações manuais no banco de dados.

Aplicações de RPG

Isso abre possibilidades de roleplay realista de pobreza e serviços sociais que geralmente são impossíveis no FiveM. Personagens podem ser “trabalhadores pobres” – empregados, mas lutando financeiramente – sem ficarem completamente quebrados e incapazes de participar. Jogadores de empregos governamentais (assistentes sociais, gerentes de caso) podem ter tarefas reais relacionadas a serviços de assistência social. Isso também cria dinâmicas interessantes no roleplay de supermercados ou mercados, onde caixas processam diferentes tipos de pagamento. O sistema de resfriamento impede abusos, mas ainda permite que os jogadores acessem benefícios quando realmente precisam para a história do seu personagem.

Equilíbrio da economia

Os valores mínimos/máximos configuráveis e a duração do período de espera dão a você controle total sobre o impacto econômico. Se você definir um período de espera de 1 semana com benefícios máximos de $50-$200, é uma pequena rede de segurança que não inundará sua economia. Se você definir períodos de espera mais curtos com valores mais altos, torna-se mais acessível, mas requer monitoramento para evitar exploração. O sistema rastreia tudo no SQL, então você pode consultar o histórico de aplicações para ver se ajustes são necessários. Comece de forma conservadora e ajuste com base na resposta da economia do seu servidor.

Arquivo de configuração

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 --

Sistema econômico relacionado ao FiveM

• Banca Brutal (ESX/QB)
• Mercado vendável avançado
• Codem – Bancos
• Estatísticas e Conquistas

Arquivo de configuração

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 --