LC FTB Hook

LC FTB Hook connects Lightman's Currency with FTB Chunks and FTB Teams. Territory becomes part of your server economy — claims cost money, protections and force-loaded chunks require recurring upkeep, and teams manage everything through the familiar FTB menus.

Features

Paid chunk claims

Claiming a chunk withdraws money from the player's personal bank account (solo play) or the linked LC team account (parties).
Bulk claims on the chunk map are supported.
Configurable free chunks: the first N claims per team/player are free to claim and exempt from protection upkeep.
Unclaim refunds: a configurable percentage of the claim price is refunded when unclaiming.
Bulk actions show a single chat summary (count, amount spent/refunded, refund percentage).

Recurring upkeep

Every upkeep period, teams and solo players pay for:

Protection settings (mob griefing, explosions, PvP, block interact/edit, entity interact)
Force-loaded chunks (force-loading itself is free; upkeep is charged per loaded chunk)

If the account cannot afford upkeep:

All protections reset to the cheapest settings
Protection changes are locked until the balance is sufficient again
A chat message notifies the team

When upkeep succeeds, a summary is shown with a clickable "[See more]" link for a full breakdown.

Pending changes

Protection and force-load toggles do not apply immediately. They are queued until the next upkeep cycle:

The UI shows pending values (e.g. → Allies pending)
Clicking the same setting again cancels the pending change
Force-load: clicking load while unload is pending cancels the unload (and vice versa)
Changes only commit if the team can afford the new upkeep total at settlement time

Land chunks vs. build chunks

Each claimed chunk is either a build chunk (default) or a land chunk (state territory):

	Build chunk	Land chunk
Protections	Full FTB Chunks protection set	Block interact & block edit only
Upkeep pricing	Per chunk	Per group of N chunks (configurable, default: 5)
Map appearance	Normal opacity	Reduced opacity tint

Alt + click or Alt + drag on the claim map to toggle build ↔ land (claimed chunks only)
Land and build chunks have separate protection settings in Team Properties under Build Chunk Protection and Land Chunk Protection
Bulk toggles show one summary message instead of spamming chat

FTB Teams ↔ Lightman's Currency sync

FTB parties automatically get a linked LC team bank account
FTB ranks map to LC roles: Owner → Owner, Officers → Admin, Members → Member
Only owners and officers can claim chunks or change protections on behalf of the team
Disbanding an FTB party while linked to an LC team requires proper party dissolution first
Party disband settlement: team balance and chunk refunds are distributed to members
Party join: personal claims are dissolved with refunds when joining a party

Claim map UI

Shows claim price, account balance, and force-load upkeep rate in the bottom panel
Protection prices are displayed next to each setting in Team Properties
Pending states are visually indicated in both the chunk map and settings screen

Commands

Command	Description
`/lc_ftb_hook upkeep_details`	Shows the breakdown of the most recent upkeep payment (owners & officers only for parties)

Configuration

All options are server-side in serverconfig/lc_ftb_hook-server.toml.

Option	Default	Description
`claimPrice`	`100`	Cost in copper units to claim one chunk
`freeChunks`	`0`	First N chunks free to claim and exempt from protection upkeep
`landChunkGroupSize`	`5`	Land chunks pay protection upkeep once per group of N chunks (rounded up)
`unclaimRefundRatio`	`0.6`	Fraction of claim price refunded on unclaim (0–1, e.g. 0.6 = 60%)
`forceLoadUpkeepPrice`	`25`	Upkeep per force-loaded chunk per period
`upkeepPeriodMinutes`	`60`	Real-time minutes between upkeep charges
`mobGriefProtectionPrice`	`10`	Upkeep add-on when mob griefing is disabled
`explosionProtectionPrice`	`10`	Upkeep add-on when explosion damage is disabled
`pvpDisablePrice`	`5`	Upkeep add-on when PvP is disabled
`blockInteractProtectionPrice`	`15`	Upkeep add-on when block interact is not public
`blockEditProtectionPrice`	`15`	Upkeep add-on when block edit is not public
`entityInteractProtectionPrice`	`15`	Upkeep add-on when entity interact is not public

Upkeep formula

Build chunks: cost = basePrice × billableBuildChunks

Land chunks: cost = basePrice × ceil(billableLandChunks / landChunkGroupSize)

Force-load: cost = forceLoadUpkeepPrice × forceLoadedChunks

Base price = sum of all active protection prices (build and land calculated separately).

Dependencies

Required:

NeoForge 21.1.231+
Minecraft 1.21.1
FTB Library
FTB Teams
FTB Chunks
Lightman's Currency

Make sure to add these as Required Dependencies on your CurseForge project so modpacks resolve them automatically.

Notes

Claim visibility is locked to public and cannot be changed.
Upkeep waits one full period after a server restart before charging again. The timer pauses while no players are online.
Pending protection states, protection locks, and land-chunk assignments are saved to the world.
Console/command-block claims bypass payment checks.

Support

Found a bug or have a suggestion? Leave a comment on CurseForge or open an issue on the project repository.

Lightman's Currency X FTB Chunks