OPAC Chunk Shop (NeoForge 1.21.1)

Sell server-owned Open Parties and Claims chunks to players for emeralds, custom items, or Create Numismatics coins. Includes admin tools to mark shop areas, audit inactive purchases, and manage player claim limits.

Minecraft: 1.21.1
Loader: NeoForge 21.1.228+
Mod ID: open_parties_claims_chunkshop

Requirements

Mod Required Side Open Parties and Claims (0.25+) Yes Server + Client Xaero's World Map (1.40+) Recommended Client only

Install this mod on both server and client for map buying, purchase confirmation screens, and the admin player list GUI.

Optional compatibility

Mod What it enables Create Numismatics Spur-based payments with automatic change

Installation

1. Install NeoForge 1.21.1, Open Parties and Claims, and this mod on the server.
2. Install the same mods on every client that should use map buying or admin GUIs.
3. Start the server once to generate the config file.
4. Edit config/open_parties_claims_chunkshop-common.toml (see Configuration).
5. Restart the world, or run /openpac-chunk-shop reload as an OP.

JAR name: open-parties-claims-chunshop-neoforge-1.21.1.jar

Quick start (server owner)

1. Set up OPAC server claims

Shop chunks are server claims, not personal player claims.

1. Open the OPAC claims menu in-game as an admin.
2. Switch to server claim mode.
3. Select a sub-profile with Claim with [profile name] (for example your shop profile).
   • Do not use the main/spawn server profile for shop chunks.
4. Claim the area you want to sell, or use /sellchunk on chunks the server already owns.

2. Mark chunks for sale

Stand in a chunk (with the correct OPAC server sub-profile selected) and run:

/sellchunk

Or set a custom price:

/sellchunk 25 /sellchunk 10 20 /sellchunk 10 20 15 25 30 /sellchunk 10 20 15 25 30

From console (uses buyableConfigIndex from config instead of your in-game OPAC selection):

/sellchunk 10 20 /sellchunk 10 20 15

Marked chunks are stored in <world>/chunk_shop_prices.json.

3. Let players buy

Players can buy using:

• Xaero's World Map — select an area of marked chunks, right-click, choose the buy option.
• Command — /buychunk at their position, or /buychunk <x> <z>, or /buychunk <x1> <z1> <x2> <z2>.

Purchases open a confirmation screen with a configurable warning and countdown timer.

4. Audit inactive builds

If a player does not build within the configured deadline (auditHours), use:

/internalBuyChunk audit /internalBuyChunk audit 72

Click TP, REMOVE, or IS OKAY in chat to teleport, revoke the claim, or mark it safe.

Player guide

Buying shop chunks

From the map (recommended)

1. Open Xaero's World Map.
2. Select one or more chunks that are marked for sale.
3. Right-click the selection and choose the buy option.
4. Read the warning on the confirmation screen and wait for the timer.
5. Click Confirm and pay.

From chat

/buychunk /buychunk 10 20 /buychunk 10 20 15 25

You must carry enough payment items in your inventory. The mod checks your balance before confirming.

Buying extra claim slots

Players can buy bonus OPAC claim slots (separate from shop chunk purchases):

Command

/buybonuschunk 5

Amount must be between 1 and 64.

OPAC main menu (if enabled in config)

1. Open the OPAC claims main menu.
2. Use the chunk slider (1–64).
3. Click Buy.

Price per slot is set by spurBonusClaimPrice in config.

Admin guide (OP level 2+)

Mark / unmark shop chunks

Command Description /sellchunk Mark your current chunk at default price /sellchunk <price> Mark current chunk at custom price /sellchunk <x> <z> Mark one chunk /sellchunk <x> <z> <price> Mark one chunk at custom price /sellchunk <x1> <z1> <x2> <z2> Mark a rectangular region /sellchunk <x1> <z1> <x2> <z2> <price> Mark a region at one price

Important: In-game admins must select the correct OPAC server sub-profile before using /sellchunk. The main/spawn server profile is blocked.

Purchase audit

Command Description /internalBuyChunk audit List purchases older than auditHours /internalBuyChunk audit <hours> List purchases older than custom hours /internalBuyChunk adminAction okay <id> Remove purchase from audit list (player keeps claim) /internalBuyChunk adminAction remove <id> Unclaim and return chunks to server shop

Purchase records are stored in <world>/buy_chunk_records.json.

Chunk shop admin commands

Command Description /openpac-chunk-shop reload Reload config and shop data /openpac-chunk-shop chunkadd <player> <amount> Add bonus claim slots to a player /openpac-chunk-shop chunkrevoke <player> <amount> Remove bonus claim slots /openpac-chunk-shop chunkrevoke <player> all Set player's available bonus slots to 0 /openpac-chunk-shop playerchunklist Open the player moderation GUI (in-game only)

Player moderation GUI

Run /openpac-chunk-shop playerchunklist to open a scrollable list showing each player's:

• Claimed chunks
• Available chunks (how many they can still claim)

Use the green + buttons to add bonus slots, red − buttons to revoke, or Revoke All to reset bonus slots to zero. System OPAC entries (Server, Expired) are hidden from this list.

Configuration

Config file path after first launch:

config/open_parties_claims_chunkshop-common.toml

A commented example is included in this repo at config/open_parties_claims_chunkshop-common.toml.

Apply changes by restarting the world or running:

/openpac-chunk-shop reload

Shop pricing

Option Default Description chunkPrice 12 Default price per chunk when /sellchunk has no price argument currencyName "Emerald" Currency name shown in UI and chat paymentItem "minecraft:emerald" Item ID used for payment (ignored when Numismatics Spurs are active) useNumismaticsSpurs false Use Create Numismatics coin values instead of a single item spurBonusClaimPrice 1 Price per bonus claim slot (/buybonuschunk and OPAC menu slider)

Emerald example

chunkPrice = 12 currencyName = "Emerald" paymentItem = "minecraft:emerald" useNumismaticsSpurs = false

Numismatics example

chunkPrice = 48 useNumismaticsSpurs = true spurBonusClaimPrice = 4

When Numismatics is enabled, the mod accepts Spur, Bevel, Sprocket, Cog, Crown, and Sun coins and gives change automatically.

OPAC shop profile

Option Default Description buyableConfigIndex 1 Server-claim sub-profile index used by console /sellchunk

Index reference:

Index OPAC profile 0 Main / spawn server profile (not allowed for shop chunks in-game) 1 First sub-profile 2 Second sub-profile

In-game admins ignore this setting and use whichever server sub-profile they have selected in OPAC.

Purchase behaviour

Option Default Description auditHours 48.0 Build deadline shown in warnings and used by /internalBuyChunk audit confirmDelaySeconds 4 Seconds before the Confirm button unlocks on the purchase screen clearPlatform true Clear blocks between Y 71–74 in newly purchased chunks grantBonusClaims true Grant one bonus OPAC claim slot per shop chunk purchased minBonusChunkClaims -1000000 Lowest bonus value admins can set via revoke commands (allows going below OPAC base limit)

Purchase confirmation screen

Option Default purchaseScreenTitle "Purchase Confirmation" warningTitle "WARNING" warningChunkLabelSingular "shop chunk" warningChunkLabelPlural "shop chunks" totalCostLine "Total Cost: %cost% %currency%"

Warning lines (warningLines) support these placeholders:

Placeholder Replaced with %chunks% Number of chunks being bought %chunkLabel% Singular or plural chunk label from config %hours% auditHours value %cost% Total price %currency% Currency display name

Example:

auditHours = 72.0 confirmDelaySeconds = 8 warningLines = [ "You are about to buy %chunks% %chunkLabel%.", "You must start building within %hours% hours.", "Claims with no progress will be REMOVED with NO REFUND.", "Total due: %cost% %currency%." ] totalCostLine = "Total Cost: %cost% %currency%"

OPAC compatibility toggles

Option Default Description silenceChunkProtectionWarnings true Reduce OPAC protection warning spam in chat fixWidgetListScreenCrash true Prevent OPAC list screen crashes on bad page indices enableMainMenuSpurBuy true Show bonus-chunk slider and Buy button in OPAC main menu fixAsyncExplosions true Fix explosion ticks when Async mod is installed fixHarvestPermissions true Respect OPAC claims when Actually Harvest is installed

World data files

These files are created in your world folder:

File Purpose chunk_shop_prices.json Which chunks are for sale, their prices, and OPAC sub-profile index buy_chunk_records.json Purchase history used by the audit system

Back these up before resetting a world.

Command reference (all)

Players

/buychunk /buychunk <x> <z> /buychunk <x1> <z1> <x2> <z2> /buybonuschunk <1-64>

Admin (OP 2+)

/sellchunk [price] /sellchunk <x> <z> [price] /sellchunk <x1> <z1> <x2> <z2> [price] /internalBuyChunk audit [hours] /internalBuyChunk adminAction okay <id> /internalBuyChunk adminAction remove <id> /openpac-chunk-shop reload /openpac-chunk-shop chunkadd <player> <amount> /openpac-chunk-shop chunkrevoke <player> <amount> /openpac-chunk-shop chunkrevoke <player> all /openpac-chunk-shop playerchunklist

Troubleshooting

/sellchunk says to select a server sub-profile

Open OPAC, switch to server claim mode, and choose Claim with [profile] before marking chunks. The main spawn profile cannot be used.

Map buy option does not appear

• Install this mod and Xaero's World Map on the client.
• Make sure the chunk is marked with /sellchunk.
• The selected map area must match marked shop chunks.

Purchase confirmation never opens

• Client must have this mod installed.
• Chunks must still be marked as buyable on the server.

Player list GUI does not open

/openpac-chunk-shop playerchunklist must be run by a player in-game, not from the console.

Config changes have no effect

Run /openpac-chunk-shop reload or restart the world. Do not use vanilla /reload alone.

Payments fail even with enough items

• Check paymentItem is a valid item ID like minecraft:emerald.
• If using Numismatics, set useNumismaticsSpurs = true and ensure Create Numismatics is installed on the server.