Skip to content

Configuration

Jump to bottom
Create: Hydraulics edited this page Jul 13, 2026 · 1 revision

Configuration

This page covers every major section of config.yml. Restart or run /exchequer reload after making changes.

Materials

materials:
  tracked:
    - IRON_INGOT
    - GOLD_INGOT
    - EMERALD
  starting-reserves:
    IRON_INGOT: 10000
    GOLD_INGOT: 5000
    EMERALD: 1000

Emerald is the default top tier currency. Adding a new material later does not retroactively affect GDP history, only GDP calculated after the addition, since GDP is derived dynamically from whatever the current tracked set is at calculation time.

Removing a material from this list does not delete existing player balances in that material. See [Troubleshooting](Troubleshooting.md) for how to handle deprecated materials safely.

Tax Cycle

tax:
  macro-cycle-hours: 6
  min-rate: 0.02
  max-rate: 0.15
  jitter-minutes: 15
  burn-percent: 0.6
  treasury-percent: 0.4

burn-percent and treasury-percent must sum to 1.0. The burned portion is removed from the economy entirely and is the plugin's primary inflation control. The treasury portion is credited to the trading player's nation (if Towny is present) or discarded if there is no nation context.

jitter-minutes adds randomness to when the tax cycle hits its low point, intended to discourage scripted timing. Setting this to 0 makes the cycle fully predictable, which is not recommended on larger servers.

Vault Capacity Tiers

vault-capacity:
  default: 50000
  tiers:
    tier-1: 100000
    tier-2: 250000
    tier-3: 1000000

Values are total ledger value across all materials, computed against the reference currency (gold by default). Tier upgrade costs are set separately under vault-capacity-upgrade-cost.

Price History

price-history:
  snapshot-interval-minutes: 60
  retention-days: 30

Lowering the snapshot interval increases database write frequency. On a network license with many players trading constantly, consider raising this rather than lowering it.

GDP and Dutch Disease

gdp:
  recalculation-interval-minutes: 30
  dutch-disease-strength: 0.35

dutch-disease-strength controls how aggressively a concentrated treasury depresses that material's local rate. 0 disables the effect entirely. Values above roughly 0.5 tend to produce very sharp rate swings for heavily specialized nations, test on a staging server before applying that high on a live economy.

Shares

shares:
  dividend-interval-hours: 24
  dividend-percent-of-tax-revenue: 0.25

Insurance

insurance:
  premium-percent: 0.1
  coverage-duration-hours: 48

Database

database:
  mode: sqlite   # or mysql, required for network license cross server sync
  mysql:
    host: localhost
    port: 3306
    database: exchequer
    username: exchequer
    password: ""
  redis:
    enabled: false
    host: localhost
    port: 6379

See [Cross Server Setup](Cross-Server-Setup.md) before switching mode to mysql.

Governance Ranks (Towny only)

governance-ranks:
  - mayor
  - king

Controls which Towny ranks are automatically granted exchequer.governance.

Clone this wiki locally