🔧 Admin Reference (HideoutiaPlugin)

For server staff. Players don't need anything here.

Requirements

Paper 26.1.2 · Java 25
Vault + an economy plugin (player balances live there)
WorldGuard (land regions)
Data: SQLite at plugins/HideoutiaPlugin/data.db (self-contained, no DB server)

Admin commands

/hideoutia admin status — one-screen health check: DB, pending timers, open elections, current PM, treasury, plot/shop counts
/hideoutia admin reload — hot-reload config.yml: tax defaults, income payouts and exclusions, currency symbol, sign tags, mail limits, plot caps, plot auto-approval (toggle/size caps/per-block price), welfare amounts/threshold/toggles, party list, snap trigger percent. Not hot-reloadable: DB path, in-flight election timings, snap min-playerbase (restart)
/hideoutia admin setpm <player> — directly appoint a PM (escape hatch; an open election's result will overwrite it)

Key permissions (defaults)

hideoutia.admin — admin module + overrides (op)
hideoutia.plot.admin — approve/reject/tp/reclaim, manage gov plots (op; the elected PM is authorized in code without this)
hideoutia.shop.admin — break others' shops and create [Gov Shop] government shops (op)
hideoutia.contract.manage — post/payout/retender/cancel government contracts (op; the elected PM is authorized in code without this)
Player-facing modules all default true: hideoutia.mail.use, hideoutia.party.use, hideoutia.vote.use, hideoutia.citizen.use, hideoutia.election.view, hideoutia.plot.request, hideoutia.welfare.use, hideoutia.gov.view, hideoutia.tax.view, hideoutia.shop.create, hideoutia.contract.view, hideoutia.contract.accept

PM authority is data-driven — whoever wins the election gets PM powers automatically, no permission changes needed. Admin permissions are the override path.

Config highlights (`config.yml`)

timezone — election calendar + welfare day boundary
economy.currencySymbol — display symbol (default $)
economy.startingBalance — treasury seed credited once when a brand-new database is created (default 10000.0; negative starts the nation in debt; no effect on existing databases)
tax.* — the four default rates (seed a fresh DB only; thereafter the PM's settings rule)
parties.* — define parties (key + displayName); sync on start/reload, removed parties keep their data
election.pm.* — schedule (1st/5th), 72h vote, testCadenceSeconds to compress full election cycles to minutes for testing, snap settings
election.party.* — 20% trigger, 24h+24h windows
income.* — per-block/mob/crop/fish payouts, all fallbacks, anti-exploit toggles
welfare.* — daily check, wealth threshold, start check, toggles
land.*, shop.*, mail.* — caps, tags, limits
broadcasts.* — rotating server messages: tips (default every 5 min, random command tips, never the same twice in a row) and community (every 10 min, invite-your-friends). Messages/toggles hot-reload; intervals need a restart
commandAliases.enabled — register bare aliases so /plot, /gov, /party, /tax, /vote, /welfare, /election work like /hideoutia <module> (default true; /admin is never aliased; force-claimed after load so they win conflicts; /hideoutia <module> always works; restart to change)
mail.claimMailCommand — claim the bare /mail from other plugins (default true; Essentials' own stays at /essentials:mail; restart to change)
land.regionPriority — WG priority for plot regions (default 10, sub-plots +1). Keep it higher than any hand-made zone region (towns, spawn) so plots claimed inside those zones stay buildable by their owners. Existing plot regions are realigned automatically at startup.
land.autoApprove.* — instant approval of modest claims: enabled, inclusive size caps maxX/maxZ/maxY (default 100/100/50), and pricePerBlock (default 0.02, floored at zero). A claim within every cap and overlapping no protected region is sold instantly; anything bigger or region-overlapping queues for the PM. A WorldGuard lookup failure fails safe to the queue.

Operational notes