📊 Traditional Homes Plugins vs. THomes

Feature	Legacy Plugins (Essentials, etc.)	🏠 THomes
Interface	Clunky chat text or generic chests	Native 1.21.4+ Dialogs + Smart GUI Fallback
In-Game Alerts	Chat spam & wall of text	Clean Action Bar HUD & Mini-Fonts
Server Threading	Sync / Main-thread database queries	100% Async HikariCP Connection Pool
Folia Support	❌ Causes crashes & desync	✅ Full Regional Multi-Threading Support
Database Support	Plain YAML or slow SQL queries	Blazing-Fast SQLite & MySQL + Memory Cache
Safety Engine	Teleports into walls / void	Dynamic Hazard & Suffocation Prevention
Migration	Manual re-entry of homes	One-Click Instant Importer

---

🌟 Core Architectural Features

🖥️ Smart Hybrid UI Router

• Native 1.21.4+ Client Dialogs: Delivers sleek, lag-free client-side modal windows with button clicks and custom input boxes.
• Universal Chest GUI Fallback: Older clients (1.21–1.21.3) and Bedrock/Geyser players automatically receive a responsive custom inventory interface. Zero configuration needed.

🔤 Action Bar Delivery & Mini-Font Aesthetics

• Clean Player Viewport: All command confirmations, cooldowns, and error notifications appear smoothly on the Action Bar above the hotbar.
• Small-Caps Typography: Modern Unicode mini-font design (✔ ʜᴏᴍᴇ ᴄʀᴇᴀᴛᴇᴅ, ✔ ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ, ✖ ᴡᴏʀʟᴅ ʀᴇꜱᴛʀɪᴄᴛᴇᴅ) gives your server an instant high-budget polish.

⚡ Zero TPS Impact Database Engine

• HikariCP Asynchronous Pool: High-throughput connection pooling ensures database reads/writes never block player ticks.
• Memory Cache ($O(1)$ Lookups): Homes are cached in a thread-safe in-memory map. Accessing /home requires 0 disk reads.
• Dual Storage Engines: Works out of the box with zero-setup SQLite, or scales to networks via MySQL.

🛡️ Smart Teleportation & Hazard Protection

• Comprehensive landing-site scan prevents players from teleporting into suffocation blocks, lava pits, or the void.
• Built-in movement-cancelled warmup countdowns and customizable teleport cooldowns.

💰 Economy & Scalable Limits (Vault Supported)

• Charge in-game currency for creating homes or teleporting.
• Allow players to unlock or purchase additional home slots with permissions or currency.

---

🎮 Command & Permission Matrix

Command	Permission	Default	Description
/homes or /home	thomes.use	Everyone	Open Homes UI or list saved homes
/home <name>	thomes.use	Everyone	Teleport directly to a saved home
/sethome [name]	thomes.sethome	Everyone	Create a home at current location / open modal
/delhome <name>	thomes.delhome	Everyone	Delete a saved home
/public-homes	thomes.publichomes	Everyone	Browse community public homes
/homes reload	thomes.admin	OP	Hot-reload config & themes in <15ms
/homes import <plugin>	thomes.admin	OP	One-click import from EssentialsX / HuskHomes

🔑 Power & Bypass Permissions

thomes.bypass.warmup: Bypass teleport warmup delay
thomes.bypass.cooldown: Bypass teleport cooldown timer
thomes.bypass.cost: Bypass teleportation & slot fees
thomes.bypass.restrictions: Bypass world blacklists and hazard checks
thomes.limit.<count>: Set custom home slots (e.g. thomes.limit.5, thomes.limit.25, thomes.limit.unlimited)

---

🎨 Theme Customization (config.yml)

Choose from pre-built modern color palettes or design your own:

# Choose from: MODERN_GOLD, CYBER_NEON, EMERALD_CLEAN, MONOCHROME, or CUSTOM
theme: "MODERN_GOLD"

custom_theme:
  primary: "#F59E0B"
  secondary: "#FEF3C7"
  neutral: "#94A3B8"
  accent: "#38BDF8"
  success: "#10B981"
  error: "#EF4444"

---

🚀 Quick Start Installation

1. Download THomes-1.0.0.jar.
2. Place the jar file into your server's plugins/ folder.
3. Restart or start your server.
4. (Optional) Install Vault for economy integration.

---

⚙️ Technical Specifications

• Tested Server Engines: Paper, Purpur, Folia, Spigot
• Compatible Minecraft Versions: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4+
• Required Java Version: Java 21 LTS or newer
• Soft Dependencies: Vault, ViaVersion

---