sHomes | Modern GUI Home Plugin

sHomes is a modern, fully GUI-driven home management plugin designed for smooth gameplay and clean user experience.

Create homes, teleport instantly, rename homes, change custom icons, delete homes, search through hundreds of Minecraft item icons, manage home slots with permissions, and use an optional Homes Book system.


✨ Features


✔ Native Minecraft Dialog GUI System (No Inventory Clicks)
✔ Modern 6-Column Home Grid Layout
✔ Create Homes Directly from the GUI
✔ Instant Home Teleportation
✔ Home Rename System with Validation
✔ Change Home Icon from 500+ Minecraft Item Icons
✔ Built-in Icon Search System
✔ Custom Home Icons Stored Per Home
✔ Configurable Default Home Icon
✔ Permission-Based Home Limits
✔ Admin Per-Player Home Limit Override
✔ Admin View Any Player's Homes (Online + Offline)
✔ Locked Home Slots Display
✔ Home Deletion Confirmation Dialog
✔ Duplicate Home-Name Protection
✔ Configurable Maximum Home Name Length
✔ Configurable Maximum GUI Rows
✔ World Validation Before Teleport
✔ Async Player-Data Saving
✔ Persistent Per-Player YAML Data Storage
✔ Optional Homes Book System
✔ Admin Reload Command
✔ Tab Completion for Admin Commands
✔ Fully Configurable GUI Titles, Button Names and Messages
✔ Custom Icon Resource Pack Included
✔ MiniMessage + Legacy Color Code Support


Commands:-


/homes, /home, /shome, /shomes Open the Homes GUI
/homes admin reload Reload the plugin config
/homes admin view <player> View any player's homes (online or offline)
/homes admin set <player> <amount> Set a player's home limit
/homes admin remove <player> Remove a player's custom home limit

Note: sHomes is designed around the GUI system. Home creation and management are handled directly through the Dialog GUI.


Permissions


homesgui.use (default: true) - Allows the player to use the Homes GUI
homesgui.admin (default: op) - Allows the player to use admin commands
homesgui.admin.reload (default: op) - Allows reloading the plugin config
homesgui.admin.view (default: op) - Allows viewing other players' homes
homesgui.admin.set (default: op) - Allows setting a player's home limit
homesgui.admin.remove (default: op) - Allows removing a player's custom limit
homesgui.limit.5 (default: false) - Allows up to 5 homes
homesgui.limit.10 (default: false) - Allows up to 10 homes
homesgui.limit.25 (default: false) - Allows up to 25 homes
homesgui.limit.90 (default: false) - Allows up to 90 homes

Permission behavior: The plugin checks admin override first, then uses the highest available permission-based limit, then falls back to the default limit.


Dependencies


✔ Server: Paper 1.21.6+ (Paper 26.2 recommended)
✔ Java: 21 or higher
✔ No Vault required
✔ No PlaceholderAPI required
✔ No database required
✔ Built-in YAML storage

Important: This plugin uses the Paper 26.2 Dialog API for native client-side GUIs.


Home GUI


The main Homes GUI provides a clean grid-based interface for managing all available home slots.

New Home Create a new home at your current location

Locked Shows home slots that require a higher permission limit

Home Button Shows the home icon and name. Click to manage


Teleport Teleport to the selected home

Change Icon Choose a Minecraft item icon for the home

Rename Rename the selected home

Delete Open a confirmation dialog before deleting the home

Back Return to the main Homes menu


Admin Commands


/homes admin reload Reload the plugin configuration without restart

/homes admin view <player> View any player's homes - works for online AND offline players. Players GUI for admins, text list for console

/homes admin set <player> <amount> Set a custom home limit for a specific player. Overrides permission-based limits

/homes admin remove <player> Remove a player's custom limit, reverting to permission-based limits


Icon Search System


sHomes includes a built-in Minecraft material icon browser with 500+ items.

✔ Search by item/material name
✔ Browse available item icons
✔ Select an icon directly from the GUI
✔ Current home icon preview
✔ Icon selection is saved per home


⚙ Default Config


homes:
default-limit: 3
default-icon: PURPLE_BED
max-name-length: 32
max-rows: 15

permission-limits:
homesgui.limit.5: 5
homesgui.limit.10: 10
homesgui.limit.25: 25
homesgui.limit.90: 90

homes-book:
enabled: false
material: BOOK
name: "Homes Book"


Data Storage


Player home data is stored separately for each player as YAML files.

Location: /plugins/sHomes/playerdata/<player-uuid>.yml
Limits: /plugins/sHomes/player-limits.yml

Each home stores:

✔ Home UUID
✔ Home name
✔ World
✔ X / Y / Z coordinates
✔ Yaw / Pitch rotation
✔ Selected icon


Homes Book


sHomes includes an optional Homes Book feature. Right-click a named book item to open the Homes GUI instantly.

Default: Disabled

Configure it in config.yml:
homes-book:
enabled: false
material: BOOK
name: "Homes Book"


Resource Pack / Custom Icons


sHomes includes its custom icon font resource pack files.

Resource pack namespace: sHomes

The custom font renders Minecraft material icons inside the Dialog UI while keeping normal text on the vanilla Minecraft font.

Recommended: Use the resource pack included with the plugin for custom item icons to display correctly.


⚙ Installation

1. Download the Zip and Extract
2. Stop your Paper server
3. Put sHomes.jar into the /plugins folder
4. Apply resource pack on server
5. Start the server
6. Open the GUI using /homes
7. Configure config.yml if needed
8. Run /homes admin reload after config changes

No external dependency is required.


Troubleshooting


If icons display as square boxes:

1. Make sure the included sHomes resource pack is loaded
2. Reload the client resource pack with F3 + T
3. Make sure the client is running the intended Minecraft version
4. Restart the server after replacing the plugin JAR

If a home cannot teleport:

• Check that the saved world still exists
• Check the server console for teleport errors
• Verify the home data file is valid

Support:

• Author: DedEnd
• Discord: mr.dedend

If you find bugs, please provide:

• Minecraft / Paper version
• sHomes version
• Console errors
• Steps to reproduce
• Screenshot or video if the issue is visual