Tax System

Tax System

The optional tax system requires players to pay periodic fees to maintain their claims.

Overview

Taxes take a percentage of rent/purchase transactions, creating ongoing revenue from claim economic activity.

Features:

• Configurable percentage per transaction
• Per-type application (rent, sell, mailbox, claim-block purchases)
• NPC account or server bank deposit
• Transaction ledger
• Exemptions via permissions

How It Works

1. Transaction - A player rents or buys a claim via a sign
2. Calculation - Tax percent × transaction amount
3. Payment - Tax deducted from payment before it reaches the recipient
4. Deposit - Tax deposited into NPC account or server bank
5. Notification - Both parties are notified of the tax amount

Configuration

tax:
  enabled: true
  percent: 5
  account-name: "Tax"
  exempt-permission: griefprevention.tax.exempt
  apply-to:
    rent: true
    sell: true
    mailbox: false
    claim-block-purchases: false
  deposit-mode: npc-account
  round-mode: nearest
  minimum-tax: 0
  notify-payer: true
  notify-payee: true
  ledger:
    enabled: false
    retain-days: 90

Tax Calculation

Tax = Transaction Amount × (Percent / 100)

Example:

• Claim sale price: 10,000
• Tax percent: 5
• Tax: 500 currency units per transaction

Payment Methods

GPExpansion supports multiple economy types per transaction — the player chooses when using the sign.

Notifications

Players are notified per-transaction when tax is applied (configurable via tax.notify-payer and tax.notify-payee).

Grace Period

Tax is deducted at transaction time (rent, sell). There is no periodic collection or grace period — the transaction fails if the player cannot afford the tax.

Exemptions

Players with griefprevention.tax.exempt permission skip all taxes.

Common exemption groups:

• Staff members
• VIP donors
• Long-term players
• Specific rank tiers

Tax Status Commands

Command	Description
/claim tax	View your tax status
/claim tax pay	Pay outstanding taxes
/claim tax info [claimId]	View claim tax details

Admin Commands

Command	Description
/gpx tax check <player>	Check player's tax status
/gpx tax waive <player>	Waive taxes for player
/gpx tax collect	Force tax collection
/gpx tax simulate	Run simulation (no actual charges)

Economic Balancing

Recommended Rates

Tax is a flat percentage per transaction. Suggested values:

Server Type	Suggested Percent
Small/Casual	1-3%
Medium/Active	5%
Large/Competitive	5-10%

Disabling Taxes

To completely disable:

tax:
  enabled: false

Or set percent to 0:

tax:
  percent: 0

Best Practices

1. Start low - Begin with low rates, increase gradually
2. Communicate - Announce tax system clearly
3. Provide exemptions - Reward loyal players
4. Monitor economy - Watch for inflation/deflation
5. Be flexible - Adjust rates based on feedback

Integration with Other Systems

Global Claims:

• Global claims may have different rates
• Popular claims could have higher taxes

Rental System:

• Rental income can offset tax costs
• Eviction for tax delinquency configurable

Sell Signs:

• Tax debt may transfer with claim sale
• Or clear on sale (configurable)