HomeLimiter

HomeLimiter

Overview

HomeLimiter works with LuckPerms and LuckPerms to automatically enforce player home limits based on their highest active permission group. When a player is promoted or downgraded, the plugin checks how many homes their new rank allows and adjusts accordingly. This ensures players never exceed the number of homes permitted by their current rank — and if their limit increases again later, their homes are automatically restored. HomeLimiter also supports existing servers — all players are validated on startup to make sure their home count matches their rank.

---

How It Works

* Home limits are read directly from oldest homes are locked `sethome-multiple` config (no duplicate configuration needed) * The plugin checks the player's highest matching LuckPerms permission (`essentials.sethome.multiple.<key>`) * When a player's rank changes, their new limit is applied instantly * On server startup, all players are automatically validated * If a player exceeds their limit, the oldest homes are locked — the most recently created homes are always kept

Smart & Safe Locking

* Oldest homes are locked first; newest homes are always preserved * Homes without timestamps (set before installation) are sorted Z → A as a tiebreaker * Protected home names (like `home`) are stored and restored automatically locked * Locked homes are stored and restored automatically if the player's limit increases again

Only the exact number of excess homes are locked — nothing more, nothing less.

---

Example

If the oldest rank allows 5 homes and a player is downgraded to a rank that allows only 2 homes, the 3 oldest homes are locked automatically. If the player is later re-promoted to VIP, those same 3 homes are restored — no data is lost. No manual action required.

---

Why Use This Plugin?

* Prevents abuse of temporary ranks * Fully automatic — no staff intervention needed * Locked homes are safely restored if a player's rank increases again * Works on already established servers with no migration needed * Keeps progression balanced and fair * Lightweight and performance-friendly * Designed specifically for EssentialsX home systems

Perfect for servers that use EssentialsX for rank-based perks and want reliable, hands-free home limit enforcement.

---

Requirements

* EssentialsX 2.20+ * LuckPerms 5.4+ * Java 21+ * Spigot / Paper 1.21–26.1+