Skip to content

Admin commands

Staff-only Economy operations. Gated by the economy.edit team permission (or owner / Administrator).

/peconomy give @user <amount> [reason]

Grant currency. Doesn't affect another member's balance — it mints new currency. Use for:

  • Compensating a member for a server issue
  • Event prizes
  • Recovering from /peconomy take mistakes

The grant logs to the ledger with your user ID and the optional reason.

/peconomy take @user <amount> [reason]

Burn currency from a member's balance. Used for:

  • Reversing fraudulent transfers
  • Penalty for rule-breaking
  • Cleanup after accidental grants

If the member has less than amount, only what they have is removed (their balance can't go negative).

/peconomy set @user <amount> [reason]

Set absolute balance. Overwrites whatever they had. Useful for:

  • Migrating from a previous bot's currency ("everyone starts at 500")
  • Surgical corrections

/peconomy reset @user

Wipe to zero. Equivalent to set 0 but with a confirm prompt because it's destructive.

Permissions

All four require economy.edit (or owner / Administrator). If your Team Role has only economy.view, the commands return a friendly "you don't have permission" error.

Ledger entries

Every admin command logs to the ledger with:

  • Actor (you)
  • Action (grant / take / set / reset)
  • Amount
  • Reason (the [reason] arg)
  • Timestamp
  • The before + after balance for the target

The dashboard's Economy → Ledger page surfaces this; it's also exportable as CSV.

Tips

  • Always include a reason. Six months from now you'll want to know why you gave someone 10K coins.
  • Big grants should be announced. A surprise 100K drop in someone's account looks like an exploit if not communicated.
  • For event payouts, batch via the dashboard. The dashboard supports multi-select-then-grant. Faster than 50 slash commands.

Limits

  • One operation at a time per actor (Phantom enforces a soft per-command cooldown).
  • amount is capped at max_balance (default 1B per guild). You cannot exceed this.

Phantom is a product of Hydra Labs. The bot is run as a managed service; you do not need to host it yourself.