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