🏡 BetterHomes

A lightweight, modern home plugin for Paper/Spigot servers — simple, safe, and fully customizable.
Players can set multiple homes, teleport safely, and admins can control home limits per rank!

✨ Features

🧭 Set, teleport, and delete homes easily
- /sethome [name] – Set a home (named or default)
- /home [name] – Teleport to a home
- /delhome [name] – Delete a home
🏠 Multiple homes per player
- Each player can have multiple named homes
- /home without a name uses the “default” home
⚙️ Configurable home limits
- Set a global max-home limit in config.yml
- Assign rank-based limits using LuckPerms permissions
🔐 LuckPerms integration
- Fully compatible — grant players more homes with:
```
/lp group vip permission set betterhome.group.vip true
```
- Configure rank limits directly in your config.yml:
```
rank-limits:
  vip: 3
  premium: 5
  admin: 10
```
☁︎ Placeholder API Support
- %free_homes%, %current_homes% and %possible_homes%
⚠️ Safety checks
- Prevent teleporting into blocks
- Shows an actionbar message Area is unsafe! if teleport would be dangerous
💾 Simple data storage
- Homes are stored in homes.yml
- Clean, human-readable format
✅ No OP required
- Everyone can use /home, /sethome, and /delhome by default

🛠️ Configuration Example

default-home-limit: 1

rank-limits:
  vip: 3
  premium: 5
  admin: 10

📜 Permissions

Permission	Description	Default
`betterhome.sethome`	Allows players to set homes	✅
`betterhome.home`	Allows teleporting to homes	✅
`betterhome.delhome`	Allows deleting homes	✅
`betterhome.group.<rank>`	Used for rank-based home limits	❌

🧩 Compatibility

Server Type	Supported
PaperMC	✅
Spigot	✅
Purpur	✅

Minecraft Versions: 1.18 → 1.21+
Java: 17 or higher recommended

🧑‍💻 Developer Info

Author: Mobilestars
Version: 1.0.0
Prefix: Home

❤️ Support the Project

If you enjoy BetterHomes, consider giving it a ❤️ on Modrinth or sharing it with your friends!

Better Homes