Getting Started

Overview

XHomes is a cross-server homes addon for XCore — a simple but complete homes system with a customizable GUI, warmup/cooldown teleports, permission-based and paid home slots, and homes that follow players across a Velocity / BungeeCord network.

• Homes — /sethome, /home, /homes, stored in the shared database
• Customizable GUI — per-home icon and name, paginated menu
• Teleportation — configurable warmup (cancel on move/damage) and cooldown
• Home limits — permission-based, plus optional paid extra slots (Vault)
• Cross-server — teleport to homes on other servers through the proxy
• Integrations — PlaceholderAPI, web dashboard, Folia-ready

Requirements

• Paper 1.21.1+ (or Folia)
• Java 21+
• XCore 1.0.4+
• Optional: Vault (paid slots), PlaceholderAPI
• Cross-server teleport additionally needs XCore cross-server mode + a Velocity/BungeeCord proxy

Installation

1. Install XCore in plugins/.
2. Place XHomes.jar in plugins/XCore/addons/.
3. Start the server; files generate in plugins/XCore/addons/XHomes/.
4. Tune limits, paid slots, teleport warmup/cooldown and the icon palette in config.yml.
5. Run /xhomes reload to apply changes.