Tax System

Tax System

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

Overview

Taxes create ongoing costs for claim ownership, encouraging active use and preventing claim hoarding.

Features:

• Configurable tax rates
• Multiple payment methods
• Grace periods
• Exemptions via permissions
• Automated collection

How It Works

1. Tax Period - Regular intervals (daily, weekly, etc.)
2. Calculation - Tax rate × claim blocks
3. Payment - Deducted from player's chosen currency
4. Grace Period - Time to pay before claim deletion
5. Notification - Advance warnings sent to players

Configuration

tax:
  enabled: false
  
  # Tax rate per claim block per period
  rate: 0.01
  
  # Collection period
  period: 7d
  
  # Grace period before claim deletion
  grace-period: 14d
  
  # Payment method priority
  payment-methods:
    - money
    - claimblocks
    
  # Notification schedule (days before due)
  notification-days-before:
    - 7
    - 3
    - 1
    
  # Exemption permission
  exempt-permission: "griefprevention.tax.exempt"
  
  # Delinquent actions
  delinquent:
    disable-teleport: true
    disable-global: true
    notify-on-login: true

Tax Calculation

Tax = Claim Blocks × Rate

Example:

• 10,000 claim blocks
• Rate: 0.01 per block
• Tax: 100 currency units per period

Payment Methods

Method	Description
money	Vault economy currency
claimblocks	Deduct from accrued blocks
xp	Experience levels

Priority order is followed if player lacks funds in primary method.

Notifications

Players receive warnings at configured intervals:

• 7 days before - First notice
• 3 days before - Reminder
• 1 day before - Urgent warning
• Overdue - Daily notices

Notification format:

[Tax] Your claim tax of $100 is due in 3 days.
[Tax] Failure to pay may result in claim deletion.

Grace Period

If tax cannot be collected:

1. Day 0 - Tax due, notifications sent
2. Days 1-14 - Grace period, warnings continue
3. Day 14 - Claim deletion if unpaid

During grace period:

• Claim protections remain active
• Some features may be disabled (configurable)
• Player can pay any time to restore

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

Server Type	Suggested Rate	Period
Small/Casual	0.001-0.005	7d
Medium/Active	0.01	7d
Large/Competitive	0.02-0.05	1d

Progressive Tax (Advanced)

Higher rates for larger claims:

tax:
  brackets:
    - max-blocks: 10000
      rate: 0.01
    - max-blocks: 50000
      rate: 0.02
    - max-blocks: 100000
      rate: 0.05

Troubleshooting

Taxes not collecting?

• Check if tax system is enabled
• Verify economy/Vault integration
• Check payment method configuration

Wrong tax amounts?

• Review rate calculation
• Check claim block counts
• Verify period settings

Players not notified?

• Check notification schedule
• Verify messaging permissions
• Review notification cooldowns

Disabling Taxes

To completely disable:

tax:
  enabled: false

Or set rate to 0:

tax:
  rate: 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)