Описание
# BL Home Manager
> A clean, no-typing GUI for managing server homes — fully client-side, no server plugin required.
---
## 🏠 What Is This?
Tired of typing `/sethome basement_storage_room_3` and praying you spelled it right? **BL Home Manager** wraps your server's existing home commands in a proper graphical interface. Set, teleport to, rename, and organize homes from a searchable, scrollable list — no command memorization, no typos, no scrolling through chat history to remember what you named that one home. The mod never touches your homes' actual locations; it's a smart client-side wrapper around whatever home plugin your server already runs.
---
## ✨ Features
- **One-Click Teleport** — Browse your homes and teleport with a single button press instead of typing commands
- **Searchable Home List** — Instantly filter homes by name as you type
- **Categories** — Sort homes into Bases, Farms, Mines, Villages, or your own custom categories
- **Favorites** — Star your most-used homes to keep them easy to find
- **Safe Delete Confirmation** — A two-stage "are you sure?" prompt with a 5-second countdown and cancel option, so a misclick never costs you a home
- **Server Sync** — Automatically pulls your existing home list from the server's `/homes`-style command and keeps your local list up to date
- **Configurable Commands** — Works with any server's command syntax (`/sethome`, `/home`, `/delhome`, etc.) — just set them once in setup
- **Keybind Access** — Press a single key to open the Home Manager from anywhere (rebindable in Controls)
- **Persistent Local Database** — Home metadata (favorites, categories) is saved locally so it survives restarts and isn't wiped by server-side resyncs
---
## 🕹️ How To Use
1. Join any multiplayer server with a home plugin (Essentials, CMI, or similar)
2. Press your configured key (default unbound — set it in Controls) to open BL Home Manager
3. On first launch, enter your server's home commands (e.g. `/sethome`, `/home`, `/delhome`, `/homes`)
4. Click **+ Set Home**, type a name, and confirm — the mod sends the command for you
5. Click **Teleport** next to any home to warp there instantly
6. Use the search bar or category tabs to find what you need in a long list
> **Note:** The mod relies on parsing your server's chat output to detect home names during Sync. If your server uses an unusual home-list format, you may need to add homes manually instead.
---
## ⚙️ Technical Details
- **100% client-side** — No server plugin, mod, or configuration needed on the server
- Works with **any command-based home system** — Essentials, CMI, or custom plugins, as long as commands are configurable
- Uses Fabric's `ClientReceiveMessageEvents` API to read chat output during sync — no mixins into server internals
- Home data stored as JSON under `.minecraft/config/bl-home-manager-homes.json`
- Sync parses multi-line chat responses and filters out non-home tokens automatically