Configuration

⚙️ Configuration

The config.lua file is where you control all the behavior of Space Economy, including progressive taxation, debt management, inflation, money laundering, and police integrations.

Below is a breakdown of each section:

---

🔹 Progressive Tax System (Config.TaxBrackets)

Defines the tax brackets applied to player transactions. Each bracket has a maximum limit (limit) and a tax rate (rate).

Config.TaxBrackets = {
    { limit = 1000, rate = 0.01 },   -- Up to $1,000 → 1%
    { limit = 5000, rate = 0.03 },   -- Up to $5,000 → 3%
    { limit = 10000, rate = 0.05 },  -- Up to $10,000 → 5%
    { limit = nil, rate = 0.08 },    -- Above $10,000 → 8%
}

💡 Note: The last bracket with limit = nil ensures that any value above the highest threshold will always be taxed at that rate.

---

🔹 Permissions (Config.Permissions)

Defines who can use the script’s administrative commands and panels. Permissions are based on job names and minimum grade levels.

Config.Permissions = {
    ['admin']    = { min_grade = 0 },
    ['police']   = { min_grade = 2 },
    ['governor'] = { min_grade = 0 },
}

• admin → Any grade can access.

• police → Only grade 2+ can access.

• governor → Full access by default.

---

🔹 Inflation System (Config.Inflation)

Controls the dynamic inflation mechanic, which can adjust prices over time.

Config.Inflation = {
    Enabled = true,              -- Enable/disable inflation system
    UpdateInterval = 15,         -- Update frequency in minutes
    MinRate = 0.8,               -- Minimum rate (20% cheaper)
    MaxRate = 1.2,               -- Maximum rate (20% more expensive)
    AdminInjectionPenalty = true,-- Penalize manual treasury injections
    InjectionMultiplier = 0.5,   -- Reduces inflation when injecting funds
}

This system helps keep the economy balanced, preventing excessive inflation or deflation.

---

🔹 Logging (Config.Logging)

Controls how financial actions are logged. The script supports file logs, Discord webhooks, and database logging simultaneously.

Config.Logging = {
    Enabled = true,
    LogToFile = true,
    LogToWebhook = true,
    LogToDatabase = true,
    WebhookURL = "YOUR_DISCORD_WEBHOOK",
    LogGlobalMoneyChanges = true,
    IgnoredReasons = { ['salary'] = true, ['pagamento_salario'] = true },
    LogAdminActions = true,
    LogTreasuryChanges = true,
    LogTaxCollection = true,
    LogDebtActions = true,
    LogInflation = true,
    LogPlayerActions = true,
    LogPruning = {
        Enabled = true,
        PruneOlderThanDays = 30
    }
}

💡 This ensures admins always have traceability for transactions, taxes, debts, and treasury changes.

---

🔹 Money Laundering Fronts (Config.LaunderingFronts)

Allows certain jobs/businesses to act as laundering spots for dirty money.

Config.LaunderingFronts = {
    ['police'] = {
        job_name = 'police',
        min_grade = 2,
        location = vector3(-211.8, -1323.5, 30.9),
        label = "Benny's Office",
        min_fee_percent = 10.0,   -- Minimum laundering fee
        max_fee_percent = 40.0,   -- Maximum laundering fee
        max_daily_wash = 100000,  -- Daily limit per business
    },

    ['burgershot'] = {
        job_name = 'burgershot',
        min_grade = 3,
        location = vector3(-1188.7, -889.2, 13.8),
        label = "Back Kitchen",
        min_fee_percent = 15.0,
        max_fee_percent = 50.0,
        max_daily_wash = 50000,
    },
}

• Each business can set laundering fees within defined limits.

• Laundering has a daily cap to prevent abuse.

---

🔹 Dirty Money Item

Defines the item name in the inventory system that represents dirty money.

Config.DirtyMoneyItem = 'black_money'

---

🔹 Police Warrant Alerts (Config.WarrantAlert)

Controls the message sent to police jobs when unpaid debts generate an arrest warrant.

Config.WarrantAlert = {
    title = "WARRANT ALERT",
    description = "An arrest and asset seizure warrant has been issued for %s (ID: %s) due to unpaid government debt of $%s. All units, proceed with capture.",
    police_job_name = 'leo'
}

---

🔹 MDT Charge Configuration (Config.WarrantCharge)

Defines the default charge created in ps-mdt when a warrant is issued.

Config.WarrantCharge = {
    charge_code = "evasion_of_debt",
    jail_time = 30,
}

---

🔹 Admin Panel (Config.AdminPanel)

Defines the physical admin panel location in the game world, where admins can interact with the economy.

Config.AdminPanel = {
    Location = vector3(-531.82, -217.16, 37.65),
    Blip = {
        sprite = 478,
        color = 2,
        scale = 0.8,
        text = "Economic Control Panel"
    },
    InteractionDistance = 2.0
}

• Adds a blip and marker to the map.

• Only authorized players can interact with it.