COWMODSКаталог модов

Homes

A simple and lightweight plugin that allows players to set and teleport to their personal homes.

Автор: NothingFlare4381обновлён 24 окт. 2026 г.
УправлениеТранспортУтилиты

Описание

Homes

Homes is a fast, secure, and lightweight home management plugin for Minecraft servers[cite: 4]. Featuring a clean compass GUI[cite: 5], multi-backend storage (SQLite, MySQL, and Legacy YAML)[cite: 4], end-to-end AES-256-GCM coordinate encryption for complete player privacy[cite: 4], and built-in localization in 13 languages[cite: 4].


Commands

Player & Admin Commands

CommandAliasesDescription
/sethome <name>/sethomesSets a home at your current location[cite: 4, 5]
/delhome <name>/rehome, /deletehomeDeletes an existing home[cite: 4, 5]
/home <name>/hTeleports you to the specified home[cite: 4, 5]
/homes/homelistOpens the homes GUI (compasses, click to teleport)[cite: 4, 5]
/home reload—Reloads configuration, language files, and hot-swaps storage backends[cite: 4]

Console-Only Commands

(Strictly restricted to the server console — in-game players, even OPs, cannot execute these)[cite: 4]

CommandDescription
/home clear <player|all>Purges all homes of a specific player or all players across the server[cite: 4]
/homes add <homes.yml|sqlite|legacy> to mysql <user:password>Migrates and encrypts all homes from YAML or SQLite directly into MySQL with zero server lag[cite: 4]

Permissions

NodeDescriptionDefault
homes.sethomeAllows setting homes[cite: 5]Everyone (true)[cite: 5]
homes.delhomeAllows deleting homes[cite: 5]Everyone (true)[cite: 5]
homes.homeAllows teleporting to a home[cite: 5]Everyone (true)[cite: 5]
homes.homesAllows opening the homes GUI[cite: 5]Everyone (true)[cite: 5]
homes.bypassBypasses the maximum home limit (home-limit)[cite: 5]op[cite: 5]

Key Features

Storage Backends & Hot-Swapping

BackendDescription
SQLite (Default)Local homes.db running in WAL mode (Write-Ahead Logging) with an isolated connection pool to prevent file locking[cite: 4]
MySQL / MariaDBRemote database support powered by an integrated, shaded, and relocated HikariCP connection pool[cite: 4]
Legacy YAMLUses homes.yml with atomic file saving via .tmp files (ATOMIC_MOVE) to prevent corruption during crashes[cite: 4]
Hot-Swap SupportSwitch between sqlite, mysql, and legacy in config.yml on the fly using /home reload without restarting the server[cite: 4]

Admin-Proof Privacy (AES-256-GCM Encryption)

  • End-to-End Coordinate Encryption: All coordinates ($X, Y, Z$), worlds, and viewing angles ($Yaw, Pitch$) are encrypted with AES-256-GCM before being written to SQLite, MySQL, or homes.yml[cite: 4].
  • Zero Admin Snooping: Server admins inspecting databases via phpMyAdmin, DBeaver, HeidiSQL, or text editors cannot view player coordinates (stored as encrypted ENC:v1:... strings)[cite: 4].
  • Per-Player Keys: Unique keys are derived via HMAC-SHA256(MasterKey, PlayerUUID) with a unique 12-byte IV per record[cite: 4]. Automatically generates a 256-bit key in .encryption_key if left blank[cite: 4].

Multi-Language Support (13 Languages)

  • Built-in Locales: Includes en, ru, zh, de, fr, es, pt, ja, uk, it, pl, tr, and ko inside the languages/ folder[cite: 4].
  • Full Localization: In-game messages, console logs, startup banners, and update notifications follow the selected language[cite: 4].
  • Auto-Sync: Existing language files automatically receive new keys on update without overwriting custom edits[cite: 4].

Configuration (config.yml)

# Language selection (en, ru, zh, de, fr, es, pt, ja, uk, it, pl, tr, ko)
language: "en"

storage:
  type: "sqlite" # "sqlite", "mysql", or "legacy"
  sqlite:
    file: "homes.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "homes"
    username: "root"
    password: ""
    table-prefix: "homes_"
    ssl: false
    pool-size: 10

encryption:
  enabled: true
  secret-key: "" # Leave blank to auto-generate a 256-bit key in .encryption_key

check-updates: true
home-limit: 10
teleport-timeout: 5

Последние версии

Все версии →
release

Homes 2.4

2.4
24 окт. 2026 г.99Minecraft: 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Скачать
Что нового
feat: v2.4 - modular multi-platform adapters (Folia, Paper, Purpur, Spigot, Bukkit 1.13 - 26.3+) - Implement modular adapter system: FoliaPlatformAdapter, PaperPlatformAdapter, SpigotPlatformAdapter - Dynamic platform and server version detection (1.13 - 26.3+) - Update plugin.yml api-version to 1.13 with folia-supported: true - Rename build output artifact to homes-${project.version}.jar (homes-2.4.jar) - Decouple GUI and teleportation engines from platform-specific APIs - Update documentation and fix unit test suite ### ⚠️ Testing & Stability Notice Please note that this release features newly updated cross-version and Folia adapters and has not yet undergone extensive production testing across every possible server environment. If you encounter any bugs, unexpected behavior, or console errors, please report them to our support mail: nothingflaresuport@gmail.com. Your feedback is greatly appreciated!
release

Homes 2.3

2.3
22 окт. 2026 г.34Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper, purpur, spigot
Скачать
Что нового
## HomesPlugin v2.3 ### What's New - **Multi-Language Support**: Added `languages/` folder with 13 languages (`en`, `ru`, `zh`, `de`, `fr`, `es`, `pt`, `ja`, `uk`, `it`, `pl`, `tr`, `ko`). Selectable via `language:` in `config.yml`. - **Auto-Sync & Fallbacks**: Existing language files on disk are automatically synced with new keys on update without overwriting custom edits. Built-in JAR fallback prevents missing key errors. - **Full Localization**: Startup/reload banner, console logs (storage setup, migrations), and update check messages now follow the selected language. - **Command Aliases**: Added clean aliases (`/h`, `/shome`, `/sethomes`, `/remhome`, `/rmhome`, `/deletehome`, `/homelist`). - **Fixes**: Removed SQLite `idleTimeout` warning on fixed connection pool; improved runtime reloading via `/home reload`.
release

Homes 2.2

2.2
22 окт. 2026 г.24Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper, purpur, spigot
Скачать
Что нового
# What's New in v2.2 - **Legacy YAML Storage (`storage.type: "legacy"`)**: - Added support for running the plugin directly with `homes.yml` without requiring SQLite or MySQL databases. - Implemented atomic file saving via temporary `.tmp` files (`ATOMIC_MOVE`) to prevent file corruption during server crashes or abrupt shutdowns. - Supports AES-256-GCM encryption in YAML mode: coordinates can remain encrypted even inside `homes.yml`. - Automatic migration is automatically bypassed when legacy mode is active, keeping `homes.yml` untouched. - Added legacy source support to the console migration tool: `/homes add legacy to MySQL <user:password>`. - **Hot-Swap Storage on `/home reload`**: - Storage backends (SQLite, MySQL, Legacy YAML) can now be changed in `config.yml` and swapped on the fly using `/home reload` without restarting the server. - Safely flushes all pending asynchronous save tasks before switching the storage provider. - **Test Suite Updates**: - Added unit tests for atomic YAML storage and on-the-fly storage switching (16 total tests).
release

Homes 2.1

2.1
21 окт. 2026 г.20Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper, purpur, spigot
Скачать
Что нового
# 🚀 Homes 2.1 Release Homes 2.1 introduces full database storage support (MySQL and SQLite), end-to-end AES-256-GCM coordinate encryption to protect player privacy from administrators, powerful console management commands, and an automated update checker. --- ### 🌟 New Features & Enhancements #### 🗄️ MySQL & SQLite Database Support * Added native storage support for **SQLite** (default, local file `homes.db`) and remote **MySQL / MariaDB**. * Integrated, shaded, and relocated **HikariCP** connection pooling to ensure zero classpath conflicts. * SQLite runs with **WAL mode** (*Write-Ahead Logging*) and an isolated single-connection pool to eliminate file locking issues. * **Automatic Migration**: detects legacy `homes.yml` on first run, imports all homes directly into the database, encrypts them, and renames the file to `homes.yml.migrated`. #### 🔒 AES-256-GCM Encryption (Admin-Proof Privacy) * All coordinates ($X, Y, Z$), worlds, and viewing angles ($Yaw, Pitch$) are encrypted with **AES-256-GCM** before being written to the database. * Server admins inspecting SQLite or MySQL via phpMyAdmin, DBeaver, or HeidiSQL **cannot view player home coordinates** (stored as encrypted `ENC:v1:...` strings). * Unique per-player keys derived via `HMAC-SHA256(MasterKey, PlayerUUID)`. * Every record is encrypted with a unique, cryptographically random 12-byte IV. * Automatically creates a secure 256-bit key in `.encryption_key` if none is configured. #### 💻 New Console Commands * **`/home clear <player|all>`**: * **Strictly console-only** (in-game players, even OPs, cannot execute it). * Purges all homes of a specific player or all players across the entire server. * **`/homes add <homes.yml|sqlite> to MySQL <user:password>`**: * **Strictly console-only** migration tool. * Exports all homes from a legacy `homes.yml` or local `SQLite` database directly into MySQL with real-time encryption and zero server lag. * Added contextual tab-completion for console operators. * Reserved the home names `reload` and `clear` to prevent command collisions. #### 🔄 Automated Version Checker * Asynchronously checks for new updates via **Modrinth API** and **GitHub Releases API** on startup and `/home reload`. * Prints `You running on the Latest version (v2.1)` to the console or displays an alert banner with direct download links if an update is found. --- ### ⚙️ Configuration (`config.yml`) ```yaml storage: type: "sqlite" # or "mysql" sqlite: file: "homes.db" mysql: host: "localhost" port: 3306 database: "homes" username: "root" password: "" table-prefix: "homes_" ssl: false pool-size: 10 encryption: enabled: true secret-key: "" # Leave blank to auto-generate a 256-bit key in .encryption_key check-updates: true home-limit: 10 teleport-timeout: 5
beta

Homes 2.0

2.0
21 окт. 2026 г.12Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper, purpur, spigot
Скачать
release

Homes 1.4

1.4
14 окт. 2026 г.92Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper, purpur
Скачать
Что нового
Code Optimization GUI Redesign Bug Fixes
release

Homes 1.3.2

1.3.2
12 окт. 2026 г.82Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Скачать
release

Homes 1.2.1

1.2.1
12 окт. 2026 г.12Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Скачать
release

Homes 1.2

1.2
12 окт. 2026 г.9Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Скачать