Home Point

# <p align="center">🏠 Home Point</p> <p align="center"><strong>A lightweight, interactive teleport system for your Minecraft server.</strong></p> <p align="center"> <img src="https://img.shields.io/badge/VERSION-26.1_(soon)_|_1.21.11_|_1.21.1_|_1.20.1_|_1.19.2_|_1.16.5_|_1.12.2_|_1.8.9-orange?style=for-the-badge&logo=modrinth&logoColor=white" alt="Versions"> <img src="https://img.shields.io/badge/LOADERS-FORGE_|_FABRIC_|_NEOFORGE_|_QUILT-blue?style=for-the-badge&logo=minecraft&logoColor=white" alt="Loaders"> </p> --- ### 🛡️ About the Mod **Home Point** is a server-side only mod that completely overhauls the standard `/home` command experience. Instead of using clunky inventory GUIs or forcing you to type out long commands, everything is managed through a clean, clickable interface right in your chat box. Since it's server-side only, your players don't need to download anything to play! ### ✨ Features * **📡 Share Your Base (`/home share`):** Proud of your build? Share your home in the global chat. Other players will see a green `` button they can click to instantly save your coordinates to their own list. **NEW in 1.5.6:** Now supports `@a`, `@p`, `@r` selectors to share with multiple players at once! * **⌨️ Smart Autocomplete:** Start typing `/home tp `, press `TAB`, and the mod will automatically suggest and safely quote your home names, even if they have spaces or Cyrillic letters! * **⚔️ Combat Tagging (Anti-PvP):** No more running away from fights. If a player deals or takes damage, they get placed in combat mode, blocking them from teleporting. * **🌍 Dimension Control:** Only want players to use homes in the Overworld? You can easily restrict teleportation using whitelists or blacklists in the config. * **🎛️ 100% Configurable:** Tune practically every aspect of the mod. Want a 5-second warm-up delay? Custom particle effects? A strict max home limit? It's all there. ### 🚀 Technical Performance Home Point is built with massive multiplayer servers in mind: * **Zero TPS Impact:** The teleport wait timers do not use standard server `onTick` event loops. Everything relies on highly efficient task schedulers. * **Asynchronous I/O Saving:** When the mod saves your player's coordinates, it offloads the save process to a background thread (`system_async_saving`). It will never freeze or lag the main server thread! --- ### 💬 Commands & Arguments Everything runs through the `/home` command, which fully supports **TAB-Autocomplete**. If your home name contains spaces, don't worry—the mod will automatically add quotes around the name for you! #### 🔹 Basic Navigation | Command | Description | |---------|-------------| | `/home` | Opens the interactive Chat Menu with clickable ``, ``, ``, `` buttons | | `/home list <page>` | Shows a specific page of your homes list | | `/home <name>` | Instantly teleports you to the specified home | | `/home set <name>` | Creates a new home at your current location | | `/home del <name>` | Deletes an existing home | | `/home rename <old_name> <new_name>` | Renames an existing home | #### 🔹 Sharing When sharing homes, you can optionally specify **who** to share with using player names or entity selectors (`@a`, `@p`, `@r`), and control whether the clickable `` button is included. | Command | Description | |---------|-------------| | `/home share <name>` | Broadcasts your home to the **global chat** with an `` button | | `/home share <name> <target>` | Sends your home to specific player(s). Supports `@a` (all), `@p` (nearest), `@r` (random) | | `/home share <name> <target> true` | Shares with target(s) **with** the `` button | | `/home share <name> <target> false` | Shares with target(s) **without** the `` button (coordinates only) | | `/home share_coords <name>` | Broadcasts your home to the **global chat** as plain coordinates (no button) | | `/home share_coords <name> <target>` | Sends plain-text coordinates to specific player(s) | > **Example:** `/home share "My Base" @a false` — sends coordinates of "My Base" to every online player, without any clickable buttons. #### 🔹 Permission Ranks & Limits The config allows you to set specific quotas like `homes_limit_vip` and `homes_limit_admin`. The mod automatically determines these quotas based on standard permission levels or Operator status. You can instantly bypass all limits natively by granting OP status if `homes_unlimited_for_operators` is set to `true`. --- ### ⚙️ Server Configuration (v1.5.6+) **Where to find it:** `config/home_mod.json` The config file is incredibly detailed but easy to read. If you ever update the mod, new settings will be safely added without breaking your existing config! Here is the full breakdown of every single setting you can tweak: #### 📐 1. Player Limits (`homes_limit_*`) * `homes_limit_default` ****: The maximum number of homes a standard player can set. * `homes_limit_vip` **[Int, Def