MasuPlots

MasuPlots

A plot-based building and shop system for Minecraft hub worlds. Admins define arbitrary-shape plots with a polygon wand, players buy and manage them through an in-game GUI, and the mod handles everything else -- block protection, gamemode switching, upkeep billing, repossession, and terrain restoration.

Built for Wold's Vaults and similar modpacks running Vault Hunters and Lightman's Currency on Forge 1.18.2. Works on any Forge 1.18.2 server, but requires at least one of those economy mods for the payment system -- without either, plots must be set to free (price/upkeep 0).

Plot System

• Arbitrary polygon shapes -- not just rectangles. Admins click vertices with the Plot Wand to define any shape, including compound polygons (L-shapes, multi-room plots, etc.)
• Full block protection -- 13 event listeners cover break, place, right-click, bucket, piston, explosion, farmland trample, and more. One auth gate, zero gaps.
• Automatic gamemode switching -- Survival inside your plot, Adventure everywhere else. Tick-throttled server-authoritative poll, no client trust.
• Boundary rendering -- Marching ants dashed line at ground level, state-tinted per plot. X-ray mode activates during GUI preview so boundaries show through buildings.

Economy and Upkeep

• Configurable upkeep cycle -- plots charge upkeep on a timer (default: weekly). Miss payments and the plot enters Grace, then Frozen, then Repossessed.
• Multi-source payment -- draws from Lightman's Currency wallets, Vault Hunters coin pouches, and raw inventory coins in configurable priority order.
• Vacation tokens -- admin-granted items that pause the upkeep clock. Players choose which plot and how many days.
• Automatic refunds -- on admin reset or forced deletion, the purchase price is refunded to the owner's wallet/pouch/vault.

Plot Lifecycle

Plots follow a strict state machine: Available -> Owned -> Grace -> Frozen -> Repossessed -> Available.

• Grace period (default 3 days) -- owner can still build but needs to pay. Upkeep debt accumulates.
• Frozen (default 7 days) -- building locked, shop listings auto-closed. Pay debt to unfreeze.
• Repossessed (default 30 days) -- all container contents (chests, barrels, LC traders) drained into the owner's vault. Owner can reclaim by paying the plot price. After the window expires, terrain reverts to the admin's factory snapshot.
• Vault system -- recovered items are stored per-player. Owners browse and claim them through the MyPlots GUI.

Player GUI

All plot management happens through screens, not chat commands.

• MyPlots screen (press B or /plot) -- three tabs: Plots (owned list with state timers, debt, prepaid info), Vault (recovered items grid), Offers (incoming transfer offers)
• Plot Detail screen -- stats panel with state-aware timers, plus action buttons: Teleport Home, Set Home, Pay Upkeep, Manage Trust, Transfer Plot, Plot Flags, Shop Settings
• Plot Browser (/masuplots browse) -- browse available plots with aerial camera preview, smooth dolly between plots
• Stores browser (/stores) -- browse all open player shops, favorite them, teleport directly, report inappropriate content

Shop System

Plot owners can list their plot as a shop in the public /stores directory.

• Set a description (up to 180 characters, supports &-color codes, 3-line cap)
• Toggle the shop open/closed from the plot detail screen
• Shops appear in /stores with camera preview, owner name, coordinates, and teleport
• Favorites pinned to top, rest randomly shuffled per session
• Report button notifies all online admins with a 5-minute cooldown
• Visitor interaction whitelist -- non-owners can right-click whitelisted blocks (default: all Lightman's Currency blocks) inside OWNED/GRACE plots. Configurable via regex patterns.

Holograms

Optional integration with MasuHolograms (soft dependency). Admins enable per plot.

• Floating text at plot centroid with state-aware info (price, owner, shop message, reclaim status)
• Click-to-interact: owners see their management screen, shop customers land in /stores, browsers see the plot ledger
• Position override for precise placement

Soft Dependencies

All optional -- the mod works without any of them.

Mod	What it enables
Lightman's Currency	Wallet payment/refund, trader inventory drain on repossession
Vault Hunters (The Vault)	Coin pouch payment/refund
MasuHolograms	Floating plot info tags with click actions
Taterzens	NPC-triggered plot browsing (admin configures NPCs to run /masuplots browse)

Configuration

Server config in serverconfig/masuplots-server.toml:

• Hub dimension, plot vertical bounds (dig depth / build height)
• Ownership caps (plots per player, trusted players per plot)
• Full upkeep tuning (cycle days, grace/frozen/repossession windows, auto-pay, warnings)
• Payment source priority order
• Visitor interaction block whitelist (regex patterns)
• Hologram integration toggle and height offset
• Camera preview settings
• Per-plot PvP and mob spawning flags

Commands

Player commands:

• /plot -- open MyPlots GUI
• /plot home <id> -- teleport to plot home
• /stores -- open shop browser

Admin commands (/plot admin ..., requires op2):

• Plot creation: newshape, finalize_piece, commit, shape modify/clear
• Economy: price, upkeep, sim upkeep, force_repo
• Management: reset, delete --force, reload
• Holograms: hologram set <id> [pos], hologram remove <id>
• Vault: vault peek/clear/give_hand <player>
• Items: grant_token, spawn_realtor, closeshop