Configuration

Configuration

The config file is generated on first launch at:

config/lc_ftb_hook-server.toml

Reload by restarting the server. Most values apply immediately; changes to protection/region settings, force-load, and war state are queued to the next upkeep period as noted in Features.

general

Key	Default	Description
claimPrice	10000	Used when claimPricingMode = CONSTANT. Flat cost in copper to claim one chunk, the same regardless of how many the team already has
claimPricingMode	EXPONENTIAL	How the price of a team's next claim scales with how many chunks it already has (excluding free-allowance chunks). One of CONSTANT, LINEAR, EXPONENTIAL — see Features
claimBasePrice	10000	LINEAR/EXPONENTIAL only: price of a claim at increment 0 (a team's first claimIncrementSize chunks). Ignored under CONSTANT
claimIncrementSize	20	LINEAR/EXPONENTIAL only: how many chunks make up one price tier
claimIncrementPrice	1000	LINEAR only: how much copper the price goes up per increment
claimPriceGrowthPercent	0.05	EXPONENTIAL only: fractional price increase per increment (compounding), e.g. 0.05 = +5% per increment
freeChunks	0	First N claimed chunks per team are free to claim and exempt from protection upkeep
unclaimRefundRatio	0.8	Fraction of the claim price refunded when unclaiming a chunk (0–1)
forceLoadUpkeepPrice	100000	Upkeep cost per force-loaded chunk per period (force-loading itself is free)
upkeepPeriodMinutes	60	How often upkeep is charged, in real-time minutes (1–10080)
forceLoadUpkeepMode	DEFAULT	When force-load upkeep is actually charged: ALWAYS = every period regardless of who's online; DEFAULT = only when at least one of the team's own members is online
protectionUpkeepMode	DEFAULT	When protection upkeep is actually charged (and can therefore be dismantled for non-payment): HEAVY = even when nobody is online at all; DEFAULT = when at least one player is online anywhere on the server; LIGHT = only when one of the team's own members is online

protectionPrices

Added to upkeep per billable chunk, per region.

Key	Default	Triggers when…
mobGriefProtectionPrice	80	Allow Mob Griefing = false
explosionProtectionPrice	70	Allow Explosion Damage = false
pvpDisablePrice	50	Allow PvP Combat = false
blockInteractProtectionPrice	100	Block Interact Mode ≠ Public
blockEditProtectionPrice	100	Block Edit Mode ≠ Public
entityInteractProtectionPrice	100	Entity Interact Mode ≠ Public

war

Key	Default	Description
warEnabled	true	Enable the war system entirely; when off, war costs are ignored, war actions are blocked, and the war button is hidden client-side
warOutgoingCostMultiplier	2.0	Flat multiplier x — declaring war costs x × target's base upkeep per period, regardless of existing war count
warCostMultiplier	1.2	Incoming war exponent l — surcharge is b × Σ(l^n) for n = 0..k-1 over k incoming wars

protectionDismantle

Order in which a region's protections are disabled when upkeep can't be paid (first = dropped first), applied per-region in region-list order (top of the list dismantled first). Use the protection property ids without namespace.

Key	Default order
protectionDismantleOrder	entity_interact_mode, block_edit_mode, block_interact_mode, allow_mob_griefing, allow_explosions, allow_pvp