Towns And Nations
- By
Towns And Nations is a Hytale plugin that lets players create, manage, and expand towns and nations with territory control, alliances, and strategic warfare.
File Details
TownsAndNations-0.1.0.jar
- R
- Feb 24, 2026
- 3.01 MB
- 38
- Early Access
File Name
TownsAndNations-0.1.0.jar
Supported Versions
- Early Access
# 📋 CHANGELOG - TownsAndNations
## Version 0.1.0 (Current Release)
### 🎨 GUI Interface - Complete Modernization
#### New Design System
- ✨ **Created `Styles.ui`** - Centralized reusable styles file
- Professional color palette (Primary, Secondary, Accent, Success, Danger)
- 6 button styles (`@ButtonPrimary`, `@ButtonSecondary`, `@ButtonAccent`, etc.)
- 5 text styles (Title, Subtitle, Heading, Body, Label)
- Consistent background colors (`@ColorBgDark`, `@ColorBgCard`)
- 🧭 **Created `NavBar.ui`** - Reusable horizontal navigation bar
- Navigation between Dashboard, Members, Bank, Plots, Nation, Browse
- Settings option visible only for mayor
- Modern design with hover effects
#### Modernized Pages
- ✅ **TownMenuPage.ui** - Redesigned main dashboard
- Card-based display system
- Town statistics grid
- "No Town" section for players without a town
- Quick Actions for rapid access
- ✅ **MayorMenuPage.ui** - Enhanced mayor interface
- Organized two-column layout
- Sections: Territory Management, Town Settings, Commands, Plots Info
- Danger Zone for critical actions (red background)
- ✅ **BrowseTownsPage.ui** - Town browsing interface
- Search bar and filter system
- Available towns list
- Hints section for instructions
- ✅ **CreateTownPage.ui** - Modern town creation
- Simplified form in a single card
- Clear cost display
- Integrated error messages
#### GUI Documentation
- 📄 **GUI_MODERNIZATION.md** - Complete technical documentation
- 📄 **GUI_README.md** - System overview
- 📄 **MIGRATION_GUIDE.md** - Migration guide for remaining pages
- 📄 **Commands.md** - Complete command list in French
### 🗺️ Map System (WorldMap)
- 🌍 **Ready minimap infrastructure**
- Town chunk display on map
- Customizable colors (RGB + transparency) via `/town mayor setcolor`
- Temporary border system (60s) with `/town mayor showborder`
- `TownsMapProvider.json` configuration created
- Awaiting official Hytale WorldMapManager API
### 🏘️ Plot System
- 📐 **Standardized dimensions**: 32x32 blocks per chunk
- 🏠 **Home Spawn system per plot**
- `/town home` - Teleport to town spawn
- `/town mayor sethome` - Set town spawn
- 💰 **Sale system**
- `/town mayor plot forsale <price>` - Put on sale
- `/town plot buy` - Buy a plot
- `/town mayor plot reclaim` - Reclaim a plot
- 👥 **Trust system**
- `/plot trust add <player>` - Add trusted player
- `/plot trust remove <player>` - Remove trust
- `/plot trust list` - List trusted players
- Per-plot permission management
- 📊 **Management**
- `/town plot list` - List all plots
- `/town plot myplots` - View own plots
- Fixed chunk coordinate system
### 🏛️ Nation System
- 🌐 **Nation interface created**
- GUI menu for nations
- Visual management of member towns
- Invitation system
- 👔 **Governance**
- `/nation create <name>` - Create a nation
- `/nation minister add/remove <player>` - Manage ministers
- `/nation invite <town>` - Invite a town
- `/nation info [nation]` - Nation information
### 🔐 Permission System
- 🔑 **LuckPerms integration**
- LuckPerms support as permission provider
- Role-based permissions (mayor, deputy, citizen)
- Permissions for town and plot commands
- Default permissions configuration
### 💾 Storage and Configuration
- 📁 **Flexible storage system**
- JSON support (default)
- MySQL support with connection pool
- Configurable auto-save
- SQL prefix: `townsandnations_`
- ⚙️ **Configuration files**
- `config.yml` - Main configuration
- `schema.sql` - Database structure
- `manifest.json` - Plugin metadata
### 🌐 Internationalization
- 🇬🇧 **English** (`en_US.properties`) - Complete language
- 🇫🇷 **French** (`fr_FR.properties`) - Complete translation
- 🔄 **Translation cleanup**
- PowerShell script `check-translations.ps1` to verify keys
- `unused-language-keys.txt` report for unused keys
- Modernized GUI translations
### 🏦 Economy and Bank
- 💰 **Town bank system**
- `/town bank deposit <amount>` - Deposit
- `/town mayor withdraw <amount>` - Withdraw (mayor only)
- GUI interface with quick amount buttons
- Real-time balance display
- 💵 **Configurable costs**
- Town creation (free by default)
- Nation creation (configurable)
- Chunk claim/unclaim with refund
- Plot prices set by mayor
### 👥 Member Management
- 📨 **Invitation system**
- `/town mayor invite <player>` - Invite
- `/town accept` - Accept invitation
- GUI interface for invitation management
- 👔 **Roles and hierarchy**
- Mayor (town creator)
- Deputies (`/town mayor deputy add/remove`)
- Citizens
- Kick system: `/town mayor kick <player>`
### ⚔️ PVP and Protection
- 🛡️ **Complete protections**
- Build protection
- Break protection
- Use protection (chests, doors, etc.)
- Configurable PVP protection per town
- ⚔️ **PVP Toggle**: `/town mayor togglepvp` - Enable/disable
### 🔧 Development and Build
- 🏗️ **Gradle configuration**
- Updated to latest Gradle version
- `build.gradle` and `build.gradle.kts` configuration
- Java 25 support
- Building against Hytale 2026.02.18-f3b8fff95
- 📦 **Project structure**
- Modular code organization
- Separated resources (Common, Server)
- Javadoc generation
- Shadow JAR build system
### 📝 Command System
- 🖥️ **Complete command overhaul**
- Town commands: `/town <action>`
- Mayor commands: `/town mayor <action>`
- Plot commands: `/town plot <action>` and `/plot <action>`
- Nation commands: `/nation <action>`
- Command logging for debugging
### 🐛 Bug Fixes
- ✅ Fixed command variables
- ✅ Fixed permissions
- ✅ Fixed chunk coordinates
- ✅ Fixed plot height
- ✅ Fixed NavBar for mayor
- ✅ Fixed translations
- ✅ Fixed UI (2 passes)
- ✅ Cleaned up code and unused UIs
### 📜 License
- 📄 Added LICENSE file to project
---
## 📊 Project Statistics
- **Current version**: 0.1.0
- **Modernized GUI pages**: 4/14 (28%)
- **Supported languages**: 2 (EN, FR)
- **Commits**: 40+
- **Last Hytale update**: 2026.02.18
---
## 🚀 Core Features
✅ Complete towns and nations system
✅ Chunk management (claim/unclaim)
✅ Plot system with sales
✅ Town bank
✅ Permissions and roles
✅ Modern GUI interface
✅ Complete zone protection
✅ Integrated economy
✅ Minimap with customizable colors
✅ Multi-language (EN/FR)
---
## 🔜 Upcoming Features
The following GUI pages are planned for modernization:
- [ ] MembersPage.ui
- [ ] BankPage.ui
- [ ] PlotsPage.ui
- [ ] TownInfoPage.ui
- [ ] NationMenuPage.ui
- [ ] CreateNationPage.ui
- [ ] NationTownsPage.ui
- [ ] InvitationsPage.ui
- [ ] LeaveTownConfirmPage.ui
- [ ] PlaceholderPage.ui
---
## 📝 Commit History Summary
Recent development activity includes:
- Fix NavBar mayor and add LICENSE file
- UI updates and modernization
- Translation cleanup and fixes
- Town display on map
- WorldMap integration
- Plot system improvements (32x32, height fixes, SetPos)
- Map overlay testing
- Nation UI addition
- Home spawn functionality
- Input fields for town creation and bank
- Commands list documentation
- 0.1.0 Release
- Town invite UI
- MiniMap testing
- LuckPerms integration
- Permissions fixes
- Plugin rename and UI updates
- UI pages creation
- UI testing phase
- Command logging
- Permissions management for town and plot commands
- Plot system implementation
- Plot home and sale fixes
- Chunk coordinate fixes
- GUI translation additions
- Menu GUI implementation
- Commands rework
- Initial commit
---
This plugin is under active development and continues to evolve with new features coming soon! 🎮