OPC Chunk Economy

OPC Chunk Economy is a Forge addon for Open Parties and Claims that adds a progression-based economy for buying extra claim chunks and forceload chunks.

Instead of giving players large claim limits immediately, server owners can start players with smaller OPC limits and let them earn more capacity by paying dynamically generated resource costs.

This mod is designed for survival, SMP, progression, and modpack servers that want chunk claiming and forceloading to feel earned.

Features

• Adds a claim and forceload upgrade shop
• Works with Open Parties and Claims
• Uses OPC’s native Bonus Chunk Claims and Bonus Chunk Forceloads
• Reads base claim and forceload limits from OPC
• Client/server shop UI
• Command support
• Separate locked invoices for claims and forceloads
• Dynamic resource costs using vanilla and modded items
• Recipe-complexity-based cost tiering
• Configurable max total claims and forceloads
• Admin tools for invoice management and debugging

Requirements

• Minecraft 1.20.1
• Forge
• Open Parties and Claims
• Install on both client and server for the UI version

How It Works

OPC Chunk Economy does not replace Open Parties and Claims. OPC still handles the actual claiming, forceloading, protection, and limits.

This mod adds the economy layer:

1. Players open the Chunk Shop with /chunkshop.
2. The mod shows current claim and forceload limits.
3. The mod generates separate locked invoices for:
   • the next claim upgrade
   • the next forceload upgrade
4. Players pay the invoice using the required resources.
5. The mod increases OPC’s bonus claim or bonus forceload value.
6. OPC applies the new limit normally.

Invoices are locked, so players cannot spam rerolls for easier costs. A new cost is generated after the current invoice is paid.

Dynamic Costs

Costs are generated from the server’s available vanilla and modded resources.

The mod scans resource-style item tags such as:

• ingots
• gems
• dusts
• nuggets
• raw materials
• coal-like items

It avoids obvious bad cost items such as creative items, spawn eggs, ores, building blocks, decorative blocks, slabs, stairs, food, and other awkward resources.

The mod also checks recipe complexity to help determine whether an item belongs in an early, mid, late, or endgame cost tier. This helps prevent high-tier modded resources from appearing too early.

General progression:

• Early purchases: common and uncommon resources
• Mid purchases: common, uncommon, and rare resources
• Late purchases: rare and endgame resources become possible
• Forceloads: cost more than claims because they are more server-impactful

Use this admin command to review what resources are eligible:

/chunkshop admin dumpresources

This creates a generated resource pool file in the config folder.

Player Commands

/chunkshop

Opens the Chunk Shop UI.

/chunkshop open

Also opens the Chunk Shop UI.

/chunkshop balance

Shows current claim and forceload limits.

/chunkshop invoice

Shows current locked invoices.

/chunkshop claim

Shows or creates the next claim upgrade invoice.

/chunkshop forceload

Shows or creates the next forceload upgrade invoice.

/chunkshop pay claim

Pays the current claim invoice.

/chunkshop pay forceload

Pays the current forceload invoice.

Admin Commands

Admin commands require operator/admin permission.

/chunkshop admin reload

Reloads the mod config.

/chunkshop admin dumpresources

Dumps the detected dynamic resource pool for review.

/chunkshop admin clearinvoice <player>

Clears a player’s locked invoice.

/chunkshop admin clearallinvoices
/chunkshop admin clearallinvoices confirm

Clears all locked invoices for all players/teams.

/chunkshop admin cycleinvoice <player> claim
/chunkshop admin cycleinvoice <player> forceload
/chunkshop admin cycleinvoice <player> all

Rerolls a specific player’s locked invoice.

/chunkshop admin refreshinvoices <player>

Creates missing invoices without changing existing locked invoices.

/chunkshop admin sync <player>

Re-syncs saved bonus values into OPC.

/chunkshop admin status <player>

Shows debug/status information for a player.

Configuration

Server config:

config/opc-chunk-economy-server.toml

Client UI config:

config/opc-chunk-economy-client.toml

Server economy settings are controlled by the server config. Client config is only for local UI behavior.

Recommended OPC setup:

• Set your starting claim and forceload limits in Open Parties and Claims.
• Set your max total limits in OPC Chunk Economy.
• Let players buy bonus claims and forceloads through the shop.

Notes

• This mod is intended for servers using Open Parties and Claims.
• It is best tested on a backup world before use on a live server.
• Dynamic costs depend on the items, tags, and recipes available in your modpack.
• For UI support, both the server and players need the mod installed.