Skip to content

Commands

Jump to bottom
Magnus Jensen edited this page Jul 26, 2026 · 1 revision

Commands

All commands live under a single command tree with three interchangeable roots:

/simpleeconomy   (alias: /se, /simpleeco)

The examples below use /se for brevity, but /simpleeconomy and /simpleeco work exactly the same.

Table of contents

Reading the tables

Each command is documented with:

  • Syntax: <required> arguments in angle brackets, [optional] arguments in square brackets.
  • Arguments: what each argument means and how it is validated.
  • Permission node: the node used by permission mods (e.g. LuckPerms), and the fallback operator level (see Permissions).

Common arguments (shared across many commands):

Argument Meaning
<player> A player name. Resolved through the server's profile cache, so it works on offline players. Must resolve to exactly one player: multi-target selectors like @a are rejected.
<amount> A whole number of currency. Must be ≥ 1.
[reason] Free text (the rest of the line) stored against the ledger entry. If omitted, a sensible default reason is recorded.
[page] Page number for paginated output. Must be ≥ 1. Defaults to 1. Output includes clickable Prev/Next buttons.

Player commands

/se balance

Check your own balance.

  • Syntax: /se balance
  • Arguments: none.
  • Permission node: simpleeconomy.balance (default: everyone, op level 0)

/se balance <player>

Check another player's balance.

  • Syntax: /se balance <player>
  • Arguments:
    • <player>: the player whose balance to look up.
  • Permission node: simpleeconomy.balance.others (default: op level 2)

/se pay <player> <amount> [reason]

Transfer money from your account to another player.

  • Syntax: /se pay <player> <amount> [reason]
  • Arguments:
    • <player>: the recipient. Must already have an account, and cannot be yourself.
    • <amount>: how much to send (≥ 1).
    • [reason]: optional note stored on the transaction. Defaults to Payment from <you>.
  • Permission node: simpleeconomy.pay (default: everyone, op level 0)

Confirmation required. Running /se pay does not move money immediately. You are shown a clickable [Click here to confirm] message; the transfer only happens once you click it. The request expires after 60 seconds, and starting a new payment cancels any previous pending one. (Confirmation is handled internally via /se pay confirm <token> – you never need to type this yourself.)

/se baltop [page]

List the richest players, paginated in chat (10 per page).

  • Syntax: /se baltop [page]
  • Arguments:
    • [page]: page number (≥ 1, defaults to 1).
  • Permission node: simpleeconomy.baltop (default: everyone, op level 0)

Admin commands

/se admin deposit <player> <amount> [reason]

Add money to a player's balance.

  • Syntax: /se admin deposit <player> <amount> [reason]
  • Arguments:
    • <player>: the account to credit.
    • <amount>: how much to add (≥ 1).
    • [reason]: optional note. Defaults to Admin adjustment by <you>.
  • Permission node: simpleeconomy.admin.deposit (default: op level 4)

/se admin withdraw <player> <amount> [reason]

Deduct money from a player's balance.

  • Syntax: /se admin withdraw <player> <amount> [reason]
  • Arguments:
    • <player>: the account to debit.
    • <amount>: how much to remove (≥ 1). Fails if the player has insufficient funds.
    • [reason]: optional note. Defaults to Admin adjustment by <you>.
  • Permission node: simpleeconomy.admin.withdraw (default: op level 4)

/se admin log [page]

View the whole transaction log across all players, newest first (10 per page). Each entry shows the owner, amount, optional reason, and resulting balance.

  • Syntax: /se admin log [page]
  • Arguments:
    • [page]: page number (≥ 1, defaults to 1).
  • Permission node: simpleeconomy.admin.log (default: op level 2)

/se admin log <player> [page]

View the transaction log for a single player.

  • Syntax: /se admin log <player> [page]
  • Arguments:
    • <player>: the account whose log to view.
    • [page]: page number (≥ 1, defaults to 1).
  • Permission node: simpleeconomy.admin.log (default: op level 2)

Permissions

Every command is gated by a permission node. The node integrates with permission mods so you can grant or deny commands per group/player. When no permission provider resolves a node, the mod falls back to a vanilla operator level (0 = everyone, 2/4 = op tiers).

Command Permission node Default op level
/se balance simpleeconomy.balance 0 (everyone)
/se balance <player> simpleeconomy.balance.others 2
/se pay simpleeconomy.pay 0 (everyone)
/se baltop simpleeconomy.baltop 0 (everyone)
/se admin deposit simpleeconomy.admin.deposit 4
/se admin withdraw simpleeconomy.admin.withdraw 4
/se admin log simpleeconomy.admin.log 2

Platform differences:

  • Fabric: nodes are checked through the fabric-permissions-api, so any compatible permission mod (LuckPerms, etc.) can grant/deny them. The operator level is used as the fallback when no provider decides the node. This API is bundled inside SimpleEconomy (jar-in-jar), so you do not need to install it separately — it is not a required dependency.
  • NeoForge: permission checks currently use the operator level only; the nodes above are not consulted by a permission mod. Grant access by opping players to the appropriate level.

Tender integration

SimpleEconomy is a native Tender backend. When Tender is present, SimpleEconomy registers itself as an economy provider automatically — no configuration required — so any Tender-aware mod reads and writes balances straight through SimpleEconomy's storage via Tender's shared API. Balances, deposits, withdrawals, and transfers are all served by SimpleEconomy, including for offline players.

Clone this wiki locally