Installation & Configuration

Introduction:

Looking to bring realistic financial assistance and deeper roleplay to your FiveM server? Dynyx Scripts introduces the EBT Card System – a fully interactive and customizable welfare feature that adds immersion and economy control to your server like never before.

🔹EBT Card System – Players receive government-issued cards to spend on approved items.

🔹 Metadata-Based Balance – Each card tracks its own balance with dynamic metadata.

🔹 Payment Validation – Automatically checks for EBT eligibility at participating shops.

🔹 Multi Inventory Support – Fully integrated with both ox_inventory / qb-inventory / ps-inventory.

🔹 Client-Side Interaction – Players can choose how they want to pay with a sleek interface.

🔹 Webhook Integration – Optional Discord logging for staff/admin tracking.

🔹 Highly Configurable – Control item eligibility, payment logic, and shop compatibility.

🔹 Optimized & Lightweight – Clean code and efficient performance for all server sizes.

Take your economy and roleplay to the next level with EBT Cards – the smart way to simulate real-world assistance programs!

Configuration / Installation:

1. Drag dynyx_ebtcards into your resources folder then ensure dynyx_ebtcards in your cfg file.

2. Install all Dependencies

3. Import the SQL file to your SQL

4. Now navigate into the inventory folder. You will need to follow a different guide depending on your chosen inventory. The item images can be found in the images folder

5. PLEASE SELECT YOUR INVENTORY BELOW TO CONTINUE WITH THE INSTALLATION!

• ox_inventory
• qb-inventory
• ps-inventory

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",
    DialogTitle = "EBT Application",

    -- Labels for EBT Application Form
    SliderLabel = "How much are you seeking to receive on your EBT Card? ($)",
    SliderDescription = "Select an amount between $"..Config.MinApply .. " and $".. Config.MaxApply,
    HouseholdMembersLabel = "Number of Household Members",
    HouseholdMembersDescription = "Enter the total number of people in your household",
    MonthlyIncomeLabel = "Monthly Income ($)",
    MonthlyIncomeDescription = "Enter the amount of money you make per month",
    PrimaryReasonLabel = "Primary Reason for Applying",
    PrimaryReasonDescription = "Why are you applying for an EBT Card?",
    TypeOfAssistanceLabel = "Type of Assistance Needed",
    TypeOfAssistanceDescription = "Select the type(s) of assistance you need:",
    EmploymentStatusLabel = "Current Employment Status",
    EmploymentStatusDescription = "Select your current employment status:",
    DietaryRestrictionsLabel = "Do You Have Any Dietary Restrictions?",
    DietaryRestrictionsDescription = "Select dietary needs for food assistance:",
    ResidencyLabel = "Are You a Resident of This State?",
    ResidencyDescription = "Select your place of residence:",
    AgreeInformationLabel = "Do you agree to provide accurate and truthful information?",
    AgreeTermsLabel = "I agree to the terms and conditions of the EBT program.",

    -- Options for Primary Reason
    LowIncome = "Low Income",
    Unemployment = "Unemployment",
    EmergencyExpenses = "Emergency Expenses",
    MedicalBills = "High Medical Bills",
    OtherReason = "Other",

    -- Options for Type of Assistance
    FoodAssistance = "Food Assistance",
    CashAssistance = "Cash Assistance",
    HousingSupport = "Housing Support",
    ChildcareSupport = "Childcare Support",
    UtilityBills = "Help with Utility Bills",
    MedicalExpenses = "Help with Medical Expenses",
    OtherAssistance = "Other",

    -- Options for Employment Status
    EmployedFull = "Employed Full-Time",
    EmployedPart = "Employed Part-Time",
    Unemployed = "Unemployed",
    Student = "Student",
    Retired = "Retired",
    Disabled = "Unable to Work",

    -- Options for Dietary Restrictions
    NoRestrictions = "No Restrictions",
    Vegetarian = "Vegetarian",
    Vegan = "Vegan",
    Halal = "Halal",
    Kosher = "Kosher",
    GlutenFree = "Gluten-Free",
    FoodAllergies = "Food Allergies",

    -- Options for Residency
    LosSantos = "Los Santos County",
    BlaineCounty = "Blaine County",
    NotResident = "No, I am not a resident of this state",

    -- Notification Title 
    NotifyTitle = "EBT",

    AlertHeader = "EBT Application",
    AlertContent = "Congratulations, You have received an EBT Card from the Government. You can apply for another card in 1 week."

}