Homes_Plus - arkcodes.com

# Homes++

[![Ko-fi](https://raw.githubusercontent.com/Fluxoah/Banners/main/available_for_paper.png)](https://modrinth.com/plugin/homes++/versions?l=paper)
[![Ko-fi](https://raw.githubusercontent.com/Fluxoah/Banners/main/available_for_pupur.png)](https://modrinth.com/plugin/homes++/versions?l=purpur)
[![Ko-fi](https://raw.githubusercontent.com/Fluxoah/Banners/main/available_on_modrinth.png)](https://modrinth.com/plugin/homes++)
[![Ko-fi](https://raw.githubusercontent.com/Fluxoah/Banners/main/available_on_github.png)](https://github.com/Fluxoah/Homes-)

Lightweight, survival-focused homes plugin for Paper / Purpur / Spigot / Bukkit (1.21.x).
Players can create named homes, teleport with a countdown (cancels on move), and admins can inspect/teleport to player homes using a polished GUI. Works with LuckPerms if present — **and still works without LuckPerms**.

---

## Features
- `/sethome ` — set a named home at your current location (configurable max, safety checks).
- `/home ` — teleport to a named home (delayed; actionbar countdown; cancels on move).
- `/homes` — list homes in clickable chat GUI with `[Go]` buttons.
- `/delhome ` — delete your named home.
- `/homesadmin ` / `/phomes ` — admin GUI to view a player’s homes, see creation time and safety status, and teleport to homes (requires admin permission).
- Safe-location checks (configurable list of forbidden blocks; checks the **feet** block).
- Permission-based max-homes via `homesplusplus.homes.` nodes — works with or without LuckPerms.
- Optional reflective read of LuckPerms `maxhomes` meta (safe; only used if LuckPerms is present).
- Saves homes to `homes.yml` with creation timestamp and safe flag.

---

## Requirements
- Java 17
- Paper / Purpur / Spigot / Bukkit server (1.21.x recommended)
- (Optional) LuckPerms for rank-based homes; plugin works without it

---

## Installation (server)
1. Download `homesplusplus-.jar` (or build from source).
2. Put the JAR into your server `plugins/` folder.
3. Start or restart server. On first run the plugin will generate `config.yml`, `messages.yml` and `homes.yml` in `plugins/HomesPlusPlus/`.
4. Edit `config.yml` / `messages.yml` as needed.

---

## Configuration examples
**config.yml (example)** — include these fields in your `config.yml`:
```yaml
teleport-delay: 5 # seconds
max-homes-default: 1
forbidden-blocks:
- LAVA
- FIRE
- CACTUS
safe-check-feet: true

---

## ❤️ Support Me

If you enjoy the plugin and want to support future development:

[![Ko-fi](https://raw.githubusercontent.com/Fluxoah/Banners/main/kofi.png)](https://ko-fi.com/fluxoah)