Player defaults

Default Player Settings

Values under players.default are copied to each player the first time they join. Existing players are migrated lazily — when their data is loaded, any missing key from this block is added automatically (no server-wide scan needed).

players:
  default:
    # Auto-actions — toggle via /claim auto-*
    auto-claim: false
    auto-unclaim: false
    auto-addchunk: false
    auto-delchunk: false
    auto-merge: false
    auto-fly: false
    auto-map: false

    # Hard ownership limits (0 = unlimited)
    max-claims: 0
    max-chunks: 1
    max-radius: 1

    # Ceilings on how high max-claims / max-chunks may be RAISED afterwards (vote rewards,
    # quests, playtime bonus, permission nodes). 0 = no ceiling.
    max-claims-cap: 0
    max-chunks-cap: 0

    # Max chunks a SINGLE claim may hold. 0 = unlimited.
    max-chunks-per-claim: 0

    # Default radius applied to /claim with no argument (and /claim create <name>).
    # 0 = single chunk. 1+ = behave like /claim radius N. Capped at max-radius.
    default-claim-radius: 0

    # Internal — id of the claim selected with /claim respawn. 0 = none. Do not edit by hand.
    respawn-claim-id: 0

    # Internal — sentinel for the last successful tax debit. The default is the literal
    # string "none" (player never taxed); the job replaces it with a yyyy-MM-dd HH:mm:ss timestamp
    # after the first debit. Do not edit by hand.
    last-tax-paid: "none"

    # Economy (only active when claims.economy.enabled = true)
    chunk-cost: 0.0
    cost-multiplier: 1.0
    max-claim-price: 0.0

    # Membership / role limits (per claim)
    max-members: 3
    max-roles: 3

    # Misc gameplay
    distance: 1     # min chunk distance between this player's claims and other players'
    delay: 5        # teleport delay in seconds (/claim tp, menu tp, etc.)
    fly: 0          # remaining claim-fly seconds; replenished via /scs player commands

    # /claim auto-X anti-abuse timers (seconds). 0 disables.
    auto-default-timer: 0   # default timer when no [seconds] passed
    auto-max-timer: 0       # hard cap on player-supplied [seconds]

    # When true, the auto-purge job skips this player even if inactive
    auto-purge-bypass: false

    # Claim-chat socialspy (needs scs.admin.socialspy). Toggled in-game with /scs socialspy.
    socialspy: false

Key reference

Key	Type	Description
`auto-*`	boolean	Player-opt-in modes. Keep at `false` — players toggle them with `/claim auto-*`.
`max-claims`	int	Maximum number of separate claims. `0` = unlimited.
`max-chunks`	int	Maximum total chunks across all claims. `0` = unlimited.
`max-radius`	int	Maximum value for `/claim radius <n>`. The claimed bounding box has side = 2n+1.
`max-claims-cap`	int	Ceiling `max-claims` can be raised to. `0` = no ceiling. Permission override: `scs.limit.claims-cap.<n>`. (2.7.0)
`max-chunks-cap`	int	Ceiling `max-chunks` can be raised to. `0` = no ceiling. Permission override: `scs.limit.chunks-cap.<n>`. (2.7.0)
`max-chunks-per-claim`	int	Maximum chunks a single claim may hold. `0` = unlimited. Permission override: `scs.limit.chunks-per-claim.<n>`. (2.7.0)
`default-claim-radius`	int	Player's default radius when typing `/claim` alone. `0` = single chunk. Capped at `max-radius` so raising it cannot bypass the limit.
`respawn-claim-id`	int	Internal — id of the claim the player respawns in (set via `/claim respawn`). `0` = no respawn claim. Do not edit manually.
`last-tax-paid`	string	Internal — sentinel for the last successful tax debit (see Claim Tax / Rent). Defaults to the literal string `"none"` for players who have never been taxed; replaced with a `yyyy-MM-dd HH:mm:ss` timestamp after the first successful debit. Do not edit manually.
`chunk-cost`	double	Flat economy cost per chunk claimed/added.
`cost-multiplier`	double	Cost multiplier applied as the claim grows (see Chunk Costs).
`max-claim-price`	double	Hard cap on `/claim sell` price. `0` = no cap.
`max-members`	int	Maximum members per claim. `0` = unlimited.
`max-roles`	int	Maximum custom roles per claim. `0` = unlimited.
`max-warps`	int	Maximum claims the player may keep open as public warps at the same time. `0` = unlimited. Permission override: `scs.limit.warps.<n>`. (2.7.1)
`tax-multiplier`	double	Multiplier applied to the player's claim tax. `1.0` = full price, `0` = exempt. Permission override: `scs.limit.tax-multiplier.<value>`. (2.7.1)
`distance`	int	Minimum chunk distance enforced between this player's claims and other players' claims.
`delay`	int	Teleport delay in seconds before `/claim tp` / menu teleports execute.
`fly`	int	Remaining claim-fly time in seconds; replenished via admin commands.
`auto-default-timer`	int	Anti-abuse default timer (seconds) applied when the player runs `/claim auto-X` without an explicit `[seconds]`. `0` = no timer (mode stays on until toggled off). Permission override: `scs.limit.auto-default-timer.<n>`.
`auto-max-timer`	int	Hard cap on the `[seconds]` a player can pass to `/claim auto-X`. `0` = no cap. Permission override: `scs.limit.auto-max-timer.<n>`.
`auto-purge-bypass`	boolean	When `true`, the player is skipped by the `claims.auto-purge` job even if inactive.
`socialspy`	boolean	Claim-chat socialspy. When `true`, the player receives a copy of every `/cc` message server-wide (requires `scs.admin.socialspy`). Toggled in-game with `/scs socialspy` rather than edited by hand.

Any of these can be overridden per player via permissions or admin commands — see the Limits page.

Playtime-Based Limits

Grant players extra claims and/or chunks the longer they play. The bonus is read from the vanilla playtime statistic (so it applies retroactively to existing players), recomputed when a player joins and — if refresh-interval is above 0 — periodically while they are online. It is added on top of the permission/command base limit and only ever raises a finite limit: a base of 0 (unlimited — e.g. an admin or scs.limit.claims.*) is never modified.

Disabled by default. This is a third way to grant limits, complementing the permission- and command-based methods.

players:
  playtime-limits:
    enabled: false

    # How often (seconds) each online player's bonus is recomputed. Minimum 30s. 0 = only on join.
    refresh-interval: 300

    # +<amount> claims for every <every-hours> hours played, capped at <max-bonus> (0 = uncapped).
    claims:
      enabled: true
      every-hours: 25
      amount: 1
      max-bonus: 5

    # +<amount> chunks for every <every-hours> hours played, capped at <max-bonus> (0 = uncapped).
    chunks:
      enabled: false
      every-hours: 10
      amount: 4
      max-bonus: 40

Key reference

Key	Type	Description
`enabled`	boolean	Master switch for the whole feature. When `false`, no bonus is applied (a stored bonus is ignored immediately).
`refresh-interval`	int	Seconds between automatic recomputes for each online player. Minimum `30`. `0` = recompute only on join (a newly crossed threshold then applies on the player's next login).
`claims.enabled` / `chunks.enabled`	boolean	Enable the bonus for that dimension independently.
`every-hours`	int	Hours of playtime that grant one `amount` step. Must be above 0.
`amount`	int	Bonus granted per completed `every-hours` block.
`max-bonus`	int	Maximum bonus for that dimension. `0` = uncapped.

The bonus is floor(hoursPlayed / every-hours) × amount, capped at max-bonus. With the defaults above a player earns +1 claim every 25 h played, up to +5 claims from 125 h onward. See the Limits page for how this stacks with the base limit.