PreethamB-Homes | Adv GUI Homes Plugin v3

Overview​

PreethamB-Homes is a modern, GUI-based homes plugin built for Paper and Folia servers running 1.21.8+.


It is designed for servers that want a polished homes experience with strong backend support and premium user-facing visuals. Players can create, manage, rename, replace, delete, and teleport to homes through a clean inventory GUI, while administrators get advanced control tools, SQL storage, license protection, migration tools, and rank-based home slot systems.

This plugin is built for both performance and usability, making it a strong replacement for basic homes systems.

---

Main Features​

Player Features​

• GUI-based homes menu
• Set homes directly from the GUI
• Teleport to homes from the GUI
• Manage homes through a dedicated manage menu
• Rename homes through chat input
• Replace existing home locations
• Delete homes with confirmation menu
• Clean teleport countdown system
• BossBar countdown
• Title and subtitle effects
• Action bar updates
• Teleport particles and sounds
• Teleport cancel on move
• Rank-based home limits
• Disabled world support
• Configurable home slot layout

Storage Features​

• SQLite support
• MySQL support
• SQL-based home storage
• Safe insert/update handling for both SQLite and MySQL

Admin Features​

• View another player’s homes
• Teleport to another player’s homes
• Set homes for another player
• Delete homes for another player
• Admin homes viewer GUI

Migration Features​

• EssentialsX homes migration
• Import existing EssentialsX player homes into this plugin

Security / Commercial Features​

• Built-in license system
• Startup license validation
• Server binding support
• Offline grace period support
• Periodic revalidation
• License status banner in console

Server Compatibility​

• Paper 1.21.8+
• Folia supported

---

Why This Plugin?​

Most home plugins only offer basic commands and simple teleportation.

PreethamB-Homes goes much further by giving servers:

• a premium GUI workflow
• rank-based progression through permissions
• SQL-ready backend
• migration tools
• admin utility
• polished teleport effects
• commercial license protection

It works well for:

• survival servers
• SMP servers
• rank-based economy servers
• premium / donor perk systems
• servers replacing EssentialsX homes with a more modern system

---

How It Works​

For Players​

Players can open the homes GUI with /home.

Inside the GUI:

• clicking an empty slot sets a home
• clicking a saved home teleports to it
• clicking the manage dye opens the manage menu

Inside the manage menu:

• teleport to the home
• replace the home location
• rename the home
• delete the home through a confirmation menu

For Admins​

Admins can manage homes for other players with /home-admin.


This allows staff to:

• inspect another player’s home setup
• teleport to player homes
• create homes for players
• remove problematic homes

Rank-Based Home Limits​

Home access is controlled by permissions like:

• preethamb.homes.1
• preethamb.homes.2
• preethamb.homes.3

The plugin checks the highest numbered permission a player has and unlocks home slots up to that value.

Example:

• a player with preethamb.homes.3 can use home-1, home-2, and home-3
• a player with preethamb.homes.10 can use up to 10 homes

Restrictions​

You can block home usage in selected worlds through the config.

This can be used to prevent homes in:

• spawn worlds
• event worlds
• dungeon worlds
• temporary map worlds

License System​

The plugin includes a built-in license system intended for premium distribution.

On startup it:

• reads the license key
• generates or reads server ID
• validates the license through the API
• allows startup only if the license is valid
• periodically rechecks license status
• supports offline grace time when the API is temporarily unreachable

---

Commands​

Player Commands​

/home
Open the homes GUI.

/home <home-id>
Teleport directly to a home if it exists and the player has access to that slot.

/sethome <home-id>
Set a home manually.

/delhome <home-id>
Delete a home manually.

/renamehome <home-id> <new name>
Rename a home manually.

---

Admin Commands​

/home-admin view <player>
Open the admin homes viewer for that player.

/home-admin tp <player> <home-id>
Teleport to one of the player's homes.

/home-admin set <player> <home-id>
Set a home for a player at your current location.

/home-admin delete <player> <home-id>
Delete one of the player's homes.

/migratehomes
Migrate homes from EssentialsX userdata into this plugin.

---

Permissions​

General​

preethambhome.use
Allows use of player home commands and GUI.

preethambhome.admin
Full admin access. Also bypasses home count limits and restrictions.

preethambhome.bypass.restrictions
Bypasses blocked-world restrictions.

---

Rank-Based Home Permissions​

preethamb.homes.1
Allows use of 1 home slot.

preethamb.homes.2
Allows use of 2 home slots.

preethamb.homes.3
Allows use of 3 home slots.

And so on.

You can create as many levels as your configured homes support.

---

Installation Guide​

1. Put the plugin jar and the dependencies into your plugins folder.
2. Start the server once.
3. Configure:
   • config.yml
   • homesettings.yml
   • gui.yml
   • messages.yml
   • sounds.yml
   • mysql.yml if using MySQL
4. Enter your license key in the config.
5. Restart the server.
6. Set permissions for players and ranks.
7. Done.