THomes

THomes — Smart Homes & Teleportation System
A modern, configurable, and feature-rich homes plugin for Minecraft servers.

THomes transforms the traditional /home experience into a polished home-management system with adaptive GUIs, categorized homes, public destinations, safe teleportation, configurable home limits, and persistent database storage.

Designed for server owners who want a clean player experience alongside flexible administration, THomes combines home management, teleport safety, rank-based progression, and optional economy integration in a single plugin.

✨ FEATURES
️ 1. Smart Hybrid UI
Choose how players interact with their saved homes.

• AUTO mode: Selects the configured UI strategy based on supported capabilities.
  
  
• Native Dialog UI: Designed for compatible modern server/client environments.
  
  
• Chest GUI fallback: A familiar inventory-based interface for supported legacy environments.
  
  
• CHEST_ONLY mode: Forces the configured 27-slot chest interface.
  
  
• DIALOG_ONLY mode: Requests the native dialog interface.
  
  
• Interactive home creation and management.
  
  
• Configurable GUI titles, borders, item icons, lore, and colors.
  

2. Advanced Home Management

• Create, access, edit, rename, and delete saved homes.
  
  
• Organize destinations into configurable categories.
  
  
• Track world, coordinates, category, and visibility.
  
  
• Configure home names and permitted characters.
  
  
• Restrict home creation in selected worlds.
  
  
• Prevent home creation in lava and void locations.
  
  
• Configure default and maximum home limits.
  

3. Public Homes
Let players share useful destinations with the server community.

• Browse public home destinations.
  
  
• Teleport to accessible public homes.
  
  
• Configure visibility for individual homes.
  
  
• Navigate paginated public home listings.
  

This feature is suitable for community destinations, shops, farms, bases, and other shared locations.

⚡ 4. Safe Teleportation
THomes provides configurable teleportation safeguards and visual feedback.

• Customizable teleport warmup.
  
  
• Teleport cooldowns.
  
  
• Cancel teleportation when the player moves.
  
  
• Cancel teleportation when the player takes damage.
  
  
• Destination safety checks for hazards such as lava, fire, void, and suffocating blocks.
  
  
• Configurable safe-location search radius.
  
  
• Action-bar, title, or chat-based warmup feedback.
  
  
• Progress bar, sound, and particle effects.
  

Default configuration uses a 3-second warmup and a 5-second cooldown. Both values can be changed in the configuration.

5. Home Limits & Rank Progression
Build a home progression system around your server ranks.

• Configurable default home limit.
  
  
• Permission-based home limits.
  
  
• Configurable rank groups such as VIP, MVP, Elite, Legend, and Staff.
  
  
• Support for group permission nodes.
  
  
• Configurable home-slot purchase prices.
  
  
• Configurable maximum purchasable slots.
  
  
• Administrative bypass permissions.
  

The included configuration sets a default limit of 3 homes and a maximum possible limit of 54. Customize these values to match your server.

6. Economy Integration
Optional Vault economy integration allows server owners to configure:

• Home-slot purchases.
  
  
• A fee for creating homes.
  
  
• A fee for teleporting to homes.
  
  
• Economy bypass permissions.
  

Economy features require Vault and a compatible economy provider when enabled.

7. Custom Themes & Categories
Personalize the plugin to match your server's branding.

Included theme presets:

• Modern Gold
  
  
• Cyber Neon
  
  
• Emerald Clean
  
  
• Monochrome
  
  
• Custom color palette
  

Configure category names, icons, colors, GUI titles, item names, lore, and player-facing messages.

Message formatting supports Adventure MiniMessage styling.

️ 8. Database & Persistent Storage
Configure persistent storage for player homes.

• SQLite as the supplied default.
  
  
• MySQL configuration.
  
  
• MariaDB configuration.
  
  
• Connection pooling through the bundled HikariCP library.
  
  
• Persistent home records across normal server restarts.
  

Choose the appropriate database configuration for your server environment and back up your data before making database changes.

️ 9. Administration & Migration

• Reload supported configuration and theme settings.
  
  
• Inspect a player's homes through the administration interface.
  
  
• Import homes from supported Essentials or HuskHomes sources.
  
  
• Configure world restrictions and home limits.
  
  
• Access administrative functions through the thomes.admin permission.
  

Migration requires the appropriate source plugin and a compatible setup.

10. Server Compatibility

• Paper-based server environment targeted by the supplied build.
  
  
• Paper API 1.21.4 build metadata.
  
  
• Minecraft API version declared as 1.21.
  
  
• Folia support declared in plugin metadata.
  
  
• Optional dependency relationships with Vault, ViaVersion, Essentials, and HuskHomes.
  

Actual compatibility can vary by server build and integration. Test the exact server version before production deployment.

INSTALLATION

1. Stop your Minecraft server.
   
   
2. Download THomes-1.0.0.jar.
   
   
3. Place the JAR inside your server's plugins folder.
   
   
4. Start the server using a compatible Paper-based server and Java 21.
   
   
5. Confirm that THomes loads successfully in the server console.
   
   
6. Open plugins/THomes/config.yml.
   
   
7. Configure UI mode, themes, home limits, teleport safeguards, database settings, and economy options.
   
   
8. Restart the server or use the supported reload command when appropriate.
   

⌨️ COMMANDS
Command Description
/homes Open the homes interface
/homes <name> Access a home by name
/sethome [name] Create a home
/delhome <name> Delete a home
/public-homes Browse public homes
/homes reload Reload configuration and themes
/homes admin <player> Open the administrative home inspector
/homes import essentials Import from Essentials
/homes import huskhomes Import from HuskHomes
Additional aliases are available:

• /homes: /home, /h
  
  
• /sethome: /createhome
  
  
• /delhome: /removehome, /deletehome
  
  
• /public-homes: /publichomes, /phomes, /phome
  

Administrative commands require thomes.admin. Migration commands require the relevant source plugin and a compatible configuration.

PERMISSIONS
Permission Purpose
thomes.use Use the homes interface
thomes.sethome Create homes
thomes.delhome Delete homes
thomes.publichomes Browse and access public homes
thomes.admin Administrative inspection, import, and reload commands
thomes.bypass.warmup Bypass teleport warmup
thomes.bypass.timer Alternative warmup bypass
thomes.bypass.cooldown Bypass teleport cooldown
thomes.bypass.restrictions Bypass configured world and danger restrictions
thomes.bypass.cost Bypass configured economy fees
thomes.limit.unlimited Grant unlimited home slots
thomes.limit.3, .5, .10, .25 Grant corresponding home limits
Permission defaults and effective limits are configurable through the plugin metadata and configuration.

✅ RECOMMENDED TESTING
Before enabling THomes on a live server, test:

• Plugin startup and configuration generation.
  
  
• Home creation, editing, renaming, deletion, and persistence.
  
  
• Chest GUI and native dialog behavior where supported.
  
  
• Public home visibility and teleportation.
  
  
• Warmup cancellation on movement and damage.
  
  
• Unsafe destination handling.
  
  
• Permission-based and purchasable home limits.
  
  
• Economy transactions with Vault and a compatible economy provider.
  
  
• SQLite storage and any configured MySQL/MariaDB connection.
  
  
• Essentials/HuskHomes migration on a staging server.
  
  
• Folia operation if deploying to Folia.
  

THomes — Your homes, your destinations, your server's rules.