TownGenesis | Next-Generation Civilization & Nation Simulation

What is TownGenesis?
TownGenesis is a modern, performance-first civilization and town management core engine built for modern Minecraft servers. Unlike legacy plugins weighed down by bloat and complicated text-only commands, TownGenesis delivers a clean, intuitive GUI experience backed by deep gameplay mechanics: full plot ownership, dynamic chunk visualization, democratic town governance, siege warfare, and town defense raids.

Designed from the ground up to be strictly modular, TownGenesis Core provides the complete town foundation without forcing extra unwanted bloat on your server.


✨ Core Features

Comprehensive Town Management

• Interactive Dashboard (/t): Manage residents, treasury, claims, and policies with sleek, zero-lag chest GUIs.
• 14 Progressive Town Tiers: Advance from a small Hamlet all the way to an Ancient Union, unlocking higher chunk claim caps and bank rewards.
• Fine-Grained Role Permissions (/t perm): Independently configure Build, Destroy, Switch, Item Use, and Setting privileges for Mayors, Assistants, Residents, and Outsiders.
• Daily Upkeep & Bankruptcy: Automated upkeep scheduling with grace periods and visual ruined-state indicators.

Plot Sub-division & Real Estate (/tplot)

• Chunk Plot System: Residents and Mayors can put individual chunks up for sale with custom pricing.
• Independent Plot Permissions: Plot-specific toggles for PvP, fire spread, explosion protection, and member access.
• Instant Particle Borders: Visual client-side particle boundaries demarcating owned plots.

️ Territory Protection & Particle Visualizer

• Real-Time Particle Walls: Display chunk boundaries and claim borders with client-side particle effects.
• Anti-Grief Suite: Complete protection against unauthorized breaking, placing, container access, fire spread, explosion damage, and Enderman grief.
• Open / Closed Border Policies: Enforce strict border debuffs (slowness fields) against trespassers or welcome friendly visitors.

⚔️ Strategic War & Siege Warfare (/t war)

• War Declaration & Siege Windows: Declare war on rival towns through democratic member voting prerequisites.
• War Shield Mechanics: Cooldown and shield periods after conflict to prevent endless griefing.
• Dynamic Siege PvP: Automatic PvP overrides inside active siege zones regardless of town safe settings.
• Enemy Radar (/t enemies): Real-time tracking of rivals, siege status, and tribute demands.

Town Defense Raids (/t raid)

• PvE Town Invasion Events: Trigger multi-wave tactical mob raids directly at your town center.
• Scaling Difficulty & Elite Bosses: Defend your town against elite mob waves for community loot and rewards.
• Mayor & Admin Tools: Start, pause, skip waves, or purge remnant mobs with simple subcommands.

️ Democratic Governance & Audit Logging

• Policy Voting Panel: Propose and vote on city laws (PvP, open borders, mob spawning, tax rates) via 6-hour democratic polls.
• Town Audit Ledger: Transparent records tracking every mayoral change, treasury deposit, withdrawal, and policy shift.

⌨️ Commands & Permissions

Player & Mayor Commands (/t or /town):

• /t - Opens the Town Interactive GUI Dashboard (towngenesis.use)
• /t <town> - Inspect another town's public profile and stats (towngenesis.use)
• /t new <name> - Establish a new town on your chunk (towngenesis.town.create)
• /t claim - Claim your current chunk for your town (towngenesis.town.claim)
• /t unclaim - Unclaim the chunk you are standing on (towngenesis.town.unclaim)
• /t spawn - Teleport to your town spawn (towngenesis.town.spawn)
• /t set <spawn|homeblock> - Set town spawn point or homeblock (towngenesis.town.setspawn)
• /t invite <player> - Send an invitation to join your town (towngenesis.town.invite)
• /t kick <player> - Kick a resident from the town (towngenesis.town.kick)
• /t deposit <amount> - Deposit money into town bank (towngenesis.town.bank)
• /t withdraw <amount> - Withdraw money from town bank (towngenesis.town.bank)
• /t perm - Open rank permission management GUI (towngenesis.town.perm)
• /t levelup - Upgrade town level (towngenesis.town.level)
• /t raid <start|stop> - Manage PvE town raids (towngenesis.town.raid)
• /t war / /t enemies - Open War search and enemy menu (towngenesis.town.war)

Plot Commands (/tplot):

• /tplot claim - Claim an unowned town plot (towngenesis.plot.claim)
• /tplot forsale <price> - Put your plot up for sale (towngenesis.plot.manage)
• /tplot notforsale - Cancel sale of your plot (towngenesis.plot.manage)
• /tplot buy - Purchase a plot that is listed for sale (towngenesis.plot.buy)
• /tplot perm - Open plot permission override GUI (towngenesis.plot.perm)

Official Modular Addons Ecosystem
TownGenesis Core operates independently. To expand your server into a full-scale civilization RPG, install our official companion plugins:

• TownEconomy - Standalone economy & Vault provider.
• TownJobs - Branching job professions, level progression & trade perks.
• ️ TownAuction - Interactive global auction house (/ah).
• TownOrders - Wholesale player procurement order board (/order).
• ️ TownTitles - Player prefix, titles & chat formatting.
• ⭐ TownRanks - 15-tier progression rank ladder with claimable daily kits.
• TownCases - 3D in-world interactive animated crates & keys.
• TownSkills - 150+ branching town skill tree research nodes across 5 branches.
• ⚙️ TownMachines - Autonomous industrial stations (Bakery, Butcher, Breeder, Lumberjack, Rancher, Collector).

Compatibility & Performance

• Supported Engines: Paper, Purpur, Spigot (1.20.x - 1.21+)
• Java Version: Java 17 or Java 21
• Storage: Optimized asynchronous flatfile storage (Zero SQL configuration required).