BL Home Manager

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