GateTown — Admin Commands

/townadmin (alias: /tadmin)

Command	Arguments	Permission	Description
/townadmin setGatePlots <town> <amount>	town: String; amount: Integer(0+)	gatetown.townadmin	Sets bonus gate plots for a town
/townadmin miningColonyGate offer create <id> <price> <displayName>	id: String; price: Double; displayName: String	gatetown.townadmin	Creates a mining-colony-gate offer at the player location; WorldGuard selection is its return portal
/townadmin miningColonyGate offer remove <id>	id: String (suggested)	gatetown.townadmin	Removes a mining-colony-gate offer
/townadmin miningColonyGate offer reload	—	gatetown.townadmin	Reloads mining-colony-gate offers and sale settings from GateTown's JSON configuration
/townadmin miningColonyGate sale start	—	gatetown.townadmin	Opens the current mining-colony-gate sale immediately
/townadmin miningColonyGate sale close	—	gatetown.townadmin	Closes the current sale and activates its purchased connections immediately
/townadmin miningColonyGate sale status	—	gatetown.townadmin	Shows the current mining-colony-gate sale round and schedule
/townadmin multiblocks reload	—	gatetown.townadmin	Reloads per-town multiblock limits from town-multiblocks.json
/townadmin vault previewGrid [amounts]	amounts: comma-separated monetary values with optional k, m, or b suffixes	gatetown.townadmin	Shows private 5×5 conical wealth samples using configured defaults or supplied amounts
/townadmin vault clearPreview	—	gatetown.townadmin	Removes the invoking administrator's vault preview grid
/townadmin vault reload	—	gatetown.townadmin	Reloads town-vault.json and refreshes loaded town vaults

Town vault setup

Town vaults are fixed, single-chunk multiblocks that visualize the owning town bank. After building the vault shell entirely inside one chunk:

1. Capture it with /gstructure createStructure <structureName>.
2. Configure its custom multiblock type as gatetown:town_vault.
3. Set its control panel inside the 15×15-or-smaller footprint.
4. Mark the interior floor blocks with /gstructure configure markBlocks <structureName> vault_floor.
5. Mark one block for the floating balance label with /gstructure configure markBlocks <structureName> balance_display.
6. Add the structure to bureaucratSchematicOffers in town-multiblocks.json; the vault limit is always one per town.

plugins/GateTown/town-vault.json controls the logarithmic 100K–100M display range, maximum physical treasure blocks, conical pile height, loose block-fragment count and scale, animation duration, preview amounts, structure tag names, and weighted iron/gold/diamond/netherite palettes. Treasure uses protected world blocks that are placed and removed without drops. Fractional wealth before the next full block is represented by small non-persistent block displays around the outer pile; the floating balance label and private admin previews also use non-persistent display entities.

Mining colony gate sale configuration

plugins/GateTown/mining-colony-gates.json contains the automated sale schedule alongside the destination offers:

{
  "offers": [],
  "sale": {
    "initialSaleStartsAt": "2026-10-07T17:00:00Z",
    "saleDurationDays": 7,
    "leaseDurationDays": 365,
    "soldPriceIncreasePercent": 10.0,
    "unsoldPriceDecreasePercent": 10.0,
    "outsideSaleSurchargePercent": 25.0,
    "announcementLeadDays": 7,
    "announcementTimeZone": "Europe/Prague",
    "discordChannel": "English"
  }
}

Each offer's configured price is its initial and minimum price. Sold destinations increase in price after a round; unsold destinations decrease toward, but never below, that initial price. The gate owner can instantly activate an unconnected destination outside the configured sale period for the current price plus outsideSaleSurchargePercent. Instant purchases remain active until the current round ends and are unavailable to gates that already have an active connection. During a sale, an active destination can only be renewed by the town that currently holds it, through the gate's next-lease destination page. Runtime round, reservation, instant-purchase, and adjusted-price state is persisted in mining-colony-gate-sales.json and should not be edited while the server is running.