Skip to content
Magnus Jensen edited this page Jul 26, 2026 · 1 revision

Configuration

SimpleEconomy uses a single server config file. Because it is a SERVER-type config, it is stored per world rather than globally:

<world>/serverconfig/simpleeconomy-server.toml

On a dedicated server the world folder is usually the value of level-name in server.properties (defaults to world). The file is generated with all defaults the first time the mod loads, and is re-read whenever the config is reloaded.

Validation & fallbacks: Every option is range- or format-checked when the file is loaded. If a value fails validation it is silently replaced with the default shown below (config loading never crashes on a bad value), so if a setting isn't taking effect, check that it passes the validation rules.


Options

Option Type Default Description
storageConnectionString String jdbc:sqlite:simpleeconomy.db JDBC connection string for the storage backend.
startingBalance Integer (long) 0 Balance a new account is created with upon first login.
loginRewardAmount Integer (long) 0 Money granted on login per day interval (0 disables rewards).
loginRewardIntervalDays Integer (long) 1 Minimum days between login rewards. Calculated based on calendar days, not since last login.
currencyPrefix String $ Text shown before an amount.
currencySuffix String (empty) Text shown after an amount.

storageConnectionString

The JDBC connection string for the storage provider that holds all balances and the transaction ledger.

  • Default: jdbc:sqlite:simpleeconomy.db
  • Validation: Must be a non-blank string that starts with jdbc:sqlite:. Any other value falls back to the default.

SQLite (default, zero-setup, single-file database):

storageConnectionString = "jdbc:sqlite:path/to/database.db"

startingBalance

The balance a player's account is created with the first time they join the server.

  • Default: 0
  • Validation: Integer in the range 09223372036854775807 (Long.MAX_VALUE).

loginRewardAmount

Amount of money granted to a player when they log in, at most once per loginRewardIntervalDays.

  • Default: 0
  • Validation: Integer in the range 09223372036854775807 (Long.MAX_VALUE).
  • Note: Set to 0 to disable login rewards entirely.

loginRewardIntervalDays

How many calendar days (UTC) must pass between login rewards. 1 means a player can receive the reward once per day.

  • Default: 1
  • Validation: Integer in the range 19223372036854775807 (Long.MAX_VALUE).

currencyPrefix

Text shown before a money amount. For example, "$" renders 100 as $100.

  • Default: $
  • Validation: None. Leave blank for no prefix.

currencySuffix

Text shown after a money amount. For example, " coins" renders 100 as 100 coins.

  • Default: (empty string)
  • Validation: None. Include a leading space if you want one between the amount and the suffix. Leave blank for no suffix.

Example config

#The connection string for the storage provider.
storageConnectionString = "jdbc:sqlite:simpleeconomy.db"
#The balance a player's account is created with the first time they join the server.
startingBalance = 100
#Amount of money granted to a player when they log in, at most once per loginRewardIntervalDays. Set to 0 to disable login rewards.
loginRewardAmount = 50
#How many calendar days (UTC) must pass between login rewards.
loginRewardIntervalDays = 1
#Text shown before a money amount.
currencyPrefix = "$"
#Text shown after a money amount.
currencySuffix = ""

Clone this wiki locally