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

• 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

Configuration

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

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.