Back to overview
Update

🪙 v3.3.0 Preview: /pay taxes and periodic interest on player balances

Coming in v3.3.0: Added taxes to the /pay command. Collected taxes can either be transferred to the server bank for future community redistribution (api) or be voided.

S
System Owner
2 days ago

💸 Tax System

> New in v3.3.0

Player to player payments can now include an optional tax system. Taxes are only applied to the /pay command and never affect API transfers, Vault transactions, or other internal economy operations.

Features

  • Configurable tax percentage.
  • Taxes are applied only to /pay player transfers.
  • API (CoinApi.transfer()), Vault, and internal transfers remain tax free.
  • Uses precise rounding to prevent balance inconsistencies.
  • Players are informed about the deducted tax before the payment is completed.
  • Includes a new TaxAppliedEvent for developers.

Tax Destinations

Collected taxes can be configured to:

  • 🔥 Burn the coins (remove them from the economy)
  • 🏛️ Transfer them to the Server Account
  • 💼 Transfer them to any custom account

Everything can be configured through:

settings:
  economy:
    taxes:
      enabled: true
      percent: 2.0
      recipient: SERVER_ACCOUNT # BURN | SERVER_ACCOUNT | CUSTOM_ACCOUNT

Interest System

Automatically reward players with interest based on their account balance. The entire system is configurable and designed to work reliably on both standalone and networked servers.

Features

  • Fully configurable interest rate.
  • Adjustable payout interval.
  • Minimum and maximum balance requirements.
  • Optional payout cap.
  • Support for online only or all players.
  • Optional player notifications after receiving interest.
  • Safe for large databases using batch processing.
  • Network safe scheduler ensures each payout cycle runs exactly once.
  • Every interest payment is recorded in the transaction ledger.
  • Includes the new InterestPaidEvent for developers.
  • Includes a new /bank command for players.
Read more posts →