eHome

🌟 Overview

eHome is a cutting-edge home management plugin engineered from the ground up for high-performance Paper, Purpur, and multi-threaded Folia servers.

Built with luxurious modern aesthetics, clean Unicode Small Caps typography, dynamic BossBars, and an intuitive Bed-Themed Matrix GUI, eHome completely transforms how players manage, customize, and share their home bases.

Whether you host an SMP, Survival, Skyblock, Towny, or RPG server, eHome guarantees seamless, featherlight performance with self-healing database engines, strict safe teleportation checks, and full cross-platform Bedrock compatibility.

---

📸 Media & Video Preview

---

🚀 Key Features

🛏️ Bed-Themed Matrix GUI

• Pattern-Based Layout: Fully customizable layout in gui.yml featuring dynamic quota indicators (Lime for open slots, Red for locked limits).
• 16-Color Customization: Players can personalize each home icon with any vanilla bed color (White, Red, Cyan, Lime, etc.).
• Pinned Favorites: Shift + Left-Click any home to pin it to the front with a radiant golden star badge (⭐).
• Instant Deletion: Shift + Right-Click directly deletes a home with sound effect feedback.

⚡ Native Folia Multi-Threading

• Built natively for Folia's regional threading architecture.
• GUI actions, teleports, and database interactions adhere strictly to region thread context with zero UnsupportedOperationException errors or main-thread stalls.

🛡️ Strict Safe Teleportation

• Rigorous safety scanner proactively blocks teleports into dangerous environments:
  • Suffocation inside solid blocks.
  • Lava pools, open fire, campfires, sweet berry bushes, or wither roses.
  • Floating in mid-air or falling into the void.

🤝 Social Home Sharing

• Invite friends to visit your home with /home share <player> <home>.
• Displays an elegant chat invitation with interactive, clickable [ACCEPT] and [DECLINE] buttons and hover tooltips.

📱 Bedrock Edition (Geyser / Floodgate)

• Automatically detects Bedrock players and delivers touch-friendly Cumulus Modal Forms.
• Features automatic Unicode Small Caps font sanitization to prevent missing character boxes (□) on mobile and console clients.

🗄️ Enterprise Multi-Storage

• Powered by shaded HikariCP 6.2.0 connection pooling.
• Supports SQLite, MySQL, MariaDB, PostgreSQL, and H2.
• Built-in Self-Healing Path Resolver guarantees 100% plug-and-play stability on Linux hosting and Pterodactyl containers.

---

🎮 Interactive GUI Controls

Action	Control	Result
Teleport	Left-Click	Warmup countdown with BossBar, ActionBar & sound feedback.
Change Color	Right-Click	Opens the 16-color bed picker menu.
Pin Favorite	Shift + Left-Click	Pinned homes move to the top with a ⭐ badge.
Delete Home	Shift + Right-Click	Deletes the home instantly.

---

⌨️ Commands & Permissions

Player Commands

• /home — Opens the personal Homes GUI.
• /home go <name> — Teleports to a home.
• /home set <name> or /sethome [name] — Creates a home at current location.
• /home del <name> or /delhome <name> — Deletes an existing home.
• /home share <player> <home> — Invites a friend to share home access.
• /home accept <player> <home> — Accepts an incoming invitation.
• /home deny <player> <home> — Declines an incoming invitation.
• /home pin <name> — Pins or unpins a home.
• /home rename <name> <new_name> — Renames an existing home.
• /home confirm — Confirms updating an existing home location within 15 seconds.
• /homes — Opens the Homes GUI directly.

Admin Commands (ehome.admin)

• /ehome reload — Reloads configurations and language files.
• /ehome admin view <player> — Inspects target player's homes in GUI.
• /ehome admin tp <player> <home> — Directly teleports admin to player's home.
• /ehome admin delete <player> <home> — Force-deletes a player's home.
• /ehome admin purge [days] — Purges inactive homes (default: 60 days).

---

📥 Installation

1. Download eHome-0.0.1.jar.
2. Place it into your server's /plugins/ directory.
3. Start the server. The plugin will automatically configure SQLite and generate default files.
4. (Optional) Configure MySQL, MariaDB, or Web Map integrations in /plugins/eHome/config.yml.
5. Run /ehome reload to apply changes!

---

📖 Wiki & Documentation

Comprehensive documentation, permission tables, and configuration examples are available on GitBook:
👉 https://epromc.gitbook.io/ehome

---

💖 Support the Developer

If you appreciate eHome, consider supporting continuous updates:

• 🔴 Trakteer: https://trakteer.id/epromite/tip
• ☕ Ko-fi: https://ko-fi.com/epromite/tip