Easy Homes v1.4

Most home plugins are glorified coordinate storage. They work for 20 players and fall apart at 200. Database queries run on the main thread. There's no GUI - just a wall of text in chat. Organizing 50 homes across 5 worlds is a disaster. And you're out of luck if your players speak anything other than English.

EasyHomes fixes every one of these problems. It ships with a premium 6-row GUI that shows every home as a clickable icon with world, coordinates, date, visit count, and description. It supports three storage backends (MySQL via HikariCP, SQLite with WAL mode, YAML flat-file) with async operations that never touch the main thread. It auto-detects your player's Minecraft client language - English, Polish, German, French - and switches messages instantly. And every feature is configurable down to the sound effect.

The homes GUI isn't an afterthought. It's a 6-row interactive dashboard that makes every other home plugin look like a command-line tool from 2012.

◆ Visual Grid

• 21 homes per page in a centered 7-column grid - no overlapping, no visual clutter
• Each home shows as its world block (grass for plains, stone for caves, netherrack for the Nether)
• Left-click teleports. Right-click opens a full context menu with 8 actions.

◆ Context Menu (Right-Click)

• Teleport - full safety pipeline (combat check, cooldown, economy, lava/fire detection)
• Set Icon - hold any item in your hand, click, and that item becomes the home's icon
• Public / Private Toggle - share your home with the server in one click
• Rename - type the new name in chat, validated in real time
• Edit Description - chat-based editor, right-click to clear
• Move to Folder - opens a graphical folder picker. Click a folder to move. Create new folders inline.
• Delete - with optional economy refund

◆ Search & Sort

• Type a search term in chat - filters homes by name, world, or description
• Sort by Name (A→Z), Date (newest), Visits (most popular), or World
• One-click folder tabs filter to a specific category

Homes without folders are chaos. EasyHomes gives you a first-class folder system that eliminates the mess.

• Create homes in folders: /sethome bases/main_base - the home appears in the "bases" folder automatically
• Folder manager GUI - view every folder with home counts, create and delete folders
• Graphical folder picker - when moving a home, choose from a visual grid of existing folders
• Delete a folder - all homes inside move to uncategorized. Nothing is lost.

EasyHomes doesn't force you into one storage engine. Pick what works for your setup - switch anytime with the migration command.

◆ MySQL (HikariCP)

• Connection pooling with configurable pool size, timeout, and SSL
• All queries async via CompletableFuture - zero main thread blocking
• Prepared statement caching, batch rewrite, server-side prepare
• Automatic table creation and column migration for existing installs

◆ SQLite (WAL Mode)

• Single-file database - zero external dependencies
• WAL journal mode for concurrent reads, NORMAL synchronous for performance
• Busy timeout handling prevents "database locked" errors

◆ YAML Flat-File

• Automatic fallback if MySQL or SQLite is unavailable
• One YAML file per player - no database required
• Async saves to avoid main-thread I/O

◆ Migration

• /easyhomes migrate YAML MYSQL - move everything in one command
• Supports all 6 direction combinations (YAML ↔ MySQL ↔ SQLite)