Homes!

🗄️ Multiple Storage Backends

New: YAML / SQLite / MySQL storage

Select your storage backend in config.yml under storage.type:

Backend	Description
yaml	Default. Per-player .yml files in playerdata/. Zero setup required.
sqlite	Single embedded database file (homes.db). No external dependencies. Recommended for mid-size servers.
mysql	External MySQL or MariaDB server with full HikariCP connection pooling. For large networks.

All three backends are bundled inside the JAR so no extra JARs to install.

Auto-migration (storage.auto-migrate: true)

Switch backends without losing data. On the next server start, Homes automatically reads all existing YAML player files and imports them into the new backend, then marks the source files as migrated.

SQLite specifics

• Uses WAL journal mode for better concurrent read performance
• Pool size locked to 1 (SQLite supports only one writer at a time)
• No external server or credentials required

MySQL/MariaDB specifics

• Full HikariCP connection pool (configurable size, timeouts, idle settings)
• ON DUPLICATE KEY UPDATE for safe upserts
• Configurable table prefix (safe to share a database with other plugins)
• Tables created automatically on first start

New config section

storage:
  type: yaml           # yaml | sqlite | mysql
  auto-migrate: true
  sqlite:
    file: homes.db
  mysql:
    host: localhost
    port: 3306
    database: homes
    username: root
    password: ""
    table-prefix: homes_
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000

---

🌍 Broad Server Compatibility (1.13 → Latest)

Spigot, Paper, and Bukkit support

• Compiled against Spigot API 1.13.2 — runs on Spigot, Paper, and any fork

Java requirement

• Minimum: Java 17

---

Added

• Retro-compatibility & auto-migration — old plugin data files (pre-1.0.0 format) are automatically detected on startup and migrated to the current format with no data loss
• Smart config/lang auto-merge (ConfigUpdater) — when new keys are added in an update, they are automatically inserted into existing config.yml and lang/*.yml files without overwriting any of the user's existing customizations; no more manual YAML merging
• GUI-based home creation — players can create a new home directly from the homes GUI by clicking the + (add) button; a chat prompt collects the name inline and the home is created without leaving the flow
• GUI-based home management — each home entry now opens a management sub-menu (HomeManageMenu) where players can rename a home, change its icon, toggle its beacon color, or delete it — all without typing commands
• Classic command aliases — /sethome [name], /delhome <name>, /listhomes, and /home <name> direct-teleport are now registered as first-class commands (toggleable per-alias in config.yml under classic-commands)
• Enhanced tab completion — home names, beacon colors, player names, and subcommands are all tab-completed contextually, including for the new classic aliases

Changed

• All lang files now use single-line MiniMessage strings (more robust and easier to hand-edit)

Added

• Complete rewrite from ground up for modern Paper servers (1.21.11+)
• MiniMessage support throughout plugin—full color and formatting control via YAML, no more legacy § codes
• Particle beacon system with 13 customizable colors, per-home visibility control, and zero external dependencies
• Per-player data storage using individual YAML files (playerdata/<uuid>.yml) instead of monolithic storage
• Configurable GUIs entirely defined through simple YAML files in menus/ directory
• Multi-language support with 7 built-in languages (EN, IT, ES, FR, DE, RU, UK) and extensible lang system
• Teleport warmup & cooldown with real-time action bar countdown
• Home sharing system allowing players to share homes with others
• Admin tools for server management (delete any home, force-teleport)
• Vault economy integration with optional teleport costs
• Granular permission nodes for fine-grained access control
• Tab completion for homes, colors, and subcommands
• Input validation and comprehensive error handling

Technical Improvements

• Atomic YAML writes for data safety
• Sound and particle effect system with configurable options
• Distance and world checks for beacon rendering (128-block range)
• Safe concurrent data structures for multi-threaded access

Removed

• Legacy § color codes (replaced with MiniMessage)
• Monolithic YAML file storage (split to per-player files)
• Static/hardcoded GUI layouts (now fully configurable)

Fixed

• Beacon visibility now properly player-only (no cross-player beam visibility)
• Particles render correctly on all server versions
• Proper cleanup of tasks on player disconnect
• Correct handling of world changes and dimension travel
• Safe handling of player data with concurrent access

---

Note: This is a full rewrite targeting modern server infrastructure. Configurations from older versions are not compatible and should be replaced with the new format.