Economy

Economy System

SCS2 integrates with Vault to provide a full economy system for claims. When enabled, players pay to claim chunks and can sell their claims to other players.

Enable economy in config.yml:

claims:
  economy:
    enabled: true
    max-price: 1_000_000_000
    formatted-number: true

• enabled — activates the economy system
• max-price — maximum price a player can set when selling a claim
• formatted-number — displays prices with formatting (e.g., 1,000,000 instead of 1000000)

Chunk Costs & Multipliers

Each time a player claims a chunk, they pay a configurable cost. The cost can increase with each additional chunk through the cost multiplier.

How chunk cost works

The formula for the Nth chunk is:

cost = chunk_cost * (cost_multiplier ^ (N - 1))

Where N is the number of chunks the player already owns + 1.

Example

With chunk-cost: 100 and cost-multiplier: 1.5:

Chunk #	Cost
1st chunk	100
2nd chunk	150
3rd chunk	225
4th chunk	337.5
5th chunk	506.25

Set cost-multiplier: 1.0 for a flat rate per chunk, or higher values to make large claims progressively more expensive.

Both chunk cost and cost multiplier can be set per player via permissions (scs.limit.cost.<amount>, scs.limit.cost-multiplier.<amount>) or admin commands.

Selling & Buying Claims

Players can put their claims up for sale and other players can buy them:

Selling

/claim sell [claim] <price>

Puts the specified claim up for sale at the given price. The claim appears in the sale list and on map integrations with a "for sale" style. A sale announcement can be broadcast to the server (configurable).

Cancelling a sale

/claim cancel-sale [claim]

Removes the claim from the sale listing.

Buying

/claim buy

Buys the claim you are standing in (if it is for sale). The price is deducted from the buyer's balance and added to the seller's balance. Full ownership — including all chunks, members, permissions, flags, and settings — transfers to the buyer.

Daily Tax / Rent

Claims can optionally incur a daily tax that the owner must pay to keep them. Disabled by default — opt in via config:

claims:
  tax:
    enabled: false
    amount-per-chunk-per-day: 1.0
    check-interval: 1h
    grace-period-days: 3

• amount-per-chunk-per-day — amount charged per chunk, per day.
• check-interval — how often the tax job wakes up to bill outstanding owners. Format: 30m, 1h, 12h, 1d.
• grace-period-days — how many consecutive days the owner can miss payment before their claims are auto-unclaimed.

How it works

• The tax collector runs every check-interval.
• Total charged = amount-per-chunk-per-day × number of chunks, summed across the owner's claims.
• If the owner's balance covers the bill, it's debited silently and last-tax-paid is updated.
• If not, a counter starts. When the counter exceeds grace-period-days, every claim the owner has gets unclaimed automatically.