ThunderCity

# **ThunderCity** *thunderplugins.com by Thunder-Relay* **Player-run cities and groups for Paper servers — mayors, votes, shared banks, HQs, and custom roles in one clean package.** **ThunderCity** lets players found cities and groups, manage members, run democratic votes, share a bank account powered by **ThunderEconomy**, set a headquarters, and transfer leadership with clickable confirmations. Built for modern Paper with Adventure components, tab completion, and persistent data that survives restarts. ## Features ### Cities (`/city` · alias `/town`) * `/city create` — found a city with `&` color codes in the name; founder becomes **mayor** * Mayor / vice-mayor / citizen ranks with styled chat tags (gold mayor, green vice) * `/city invite` — clickable **[Accept] [Deny]** invites in chat * `/city join` — request to join; every online mayor and vice gets the prompt * `/city promote` / `/demote` / `/kick` — full staff moderation * `/city war` / `/peace` — server-wide war state with a red mark in chat * `/city chat` — mayor-only broadcast to all citizens * `/city info` / `/list` — inspect members and browse every city * `/city of ` — see which city a player belongs to and their rank ### Votes * `/city vote ` — closed yes/no votes (e.g. `10m`, `1h`, `1d`, `1mo`) * Clickable **[Yes] [No] [Abstain]** buttons for every citizen * `/city voting` — list active votes; staff see live tallies * `/city showvotes` / `/endvote` — live results or early close by the mayor * Auto-close when time runs out or everyone has voted; highlighted **Passed / Rejected / Tie** results * Join reminders for players who haven’t voted yet (including new citizens mid-vote) ### City bank *(requires ThunderEconomy)* * `/city deposit` / `/withdraw` — citizens deposit; mayor/vice withdraw * `/city pay ` — any player can pay any city * `/city balance` / `/baltop` — balances and richest-cities leaderboard ### City HQ * `/city sethome` — set headquarters (mayor/vice) * `/city home` — teleport every citizen to the city HQ ### Leadership transfer * `/city transfer ` — hand over the mayorship with clickable **[Confirm] [Cancel]** ### Groups (`/group` · aliases `/g` `/clan`) — separate from cities * `/group create` — create a group (progressive cost: 20k → 40k → 80k…); clickable **[Confirm] [Cancel]** before payment * Multi-group membership — players can join more than one group * `/group select` / `/mygroups` — switch active group when you belong to several * Custom **roles** — leader creates named roles and promotes members * `/group rules` — set and read group rules * Group bank, HQ (`sethome` / `home`), invite/kick, and leadership **transfer** with confirmation * `/group of ` — see which groups a player is in * `/group balance` / `/baltop` — group wealth leaderboard ## Requirements * Paper (or a Paper-based fork) * Java 25+ * **ThunderEconomy** (hard dependency — player wallets & currency formatting) ## Data * `cities.yml` — cities (members, war, bank, HQ) * `groups.yml` — groups (roles, rules, bank, HQ) * `votes.yml` — active votes and ballots ## Permissions | Permission | Description | Default | |---|---|---| | *(none required for players)* | All city & group commands are available to players by design | true | | Server ops | Full access including admin-side economy via ThunderEconomy | op | --- *Drop **ThunderEconomy** and **ThunderCity** into `plugins/`, restart, and let players build their world.*