DonutHomes

DonutHomes – Modern GUI-Based Home System (Folia & Paper)

Overview DonutHomes is a lightweight, high-performance home management solution designed for modern Minecraft servers. Moving away from clunky text-based systems, DonutHomes features a sleek, intuitive blue GUI that allows players to manage their teleportation points with ease. Built with Folia-native async logic, it ensures your server maintains 20.0 TPS while providing a premium, sound-integrated experience for your community.

Key Features Modern Blue GUI providing a clean visual overview of all saved locations, including world data and coordinates. Smart Home Management featuring left-click to teleport and a secure right-click confirmation menu to prevent accidental deletions. Dynamic Slot System that visually displays available home slots based on the player's specific permission limits. Folia & Paper Ready utilizing asynchronous teleportation and regional schedulers for maximum performance. LuckPerms Integration allowing for tiered home limits (e.g., donuthomes.5) to easily monetize or reward ranks. 100% Configurable through an extensive config.yml—tweak every message, material, sound, and GUI layout to fit your server's theme.

Commands and Permissions /home [name] - Teleports to a home or opens the GUI if multiple homes exist. /sethome - Sets a new home at the current location. /delhome - Deletes a specific home. /homes - Opens the central home management interface.

Permissions:

• donuthomes.use: Basic access to the home system (Default: everyone).
• donuthomes.: Defines the maximum homes (e.g., donuthomes.3).
• donuthomes.*: Grants unlimited home slots (Default: op).

Technical Specifications Async Teleport Engine with configurable warm-up delays to prevent combat-logging and ensure server stability. YAML Per-Player Storage for lightning-fast data access and easy manual backups. Integrated Sound Engine providing high-quality audio feedback for every GUI interaction and teleport. Placeholder Support within the GUI lore to display {home}, {world}, {x}, {y}, and {z} coordinates.

Installation

1. Place the DonutHomes jar into your /plugins/ folder.
2. Ensure you are using Java 21 and Paper/Folia 1.21.1+.
3. Restart the server to generate the configuration files.
4. Define your home limits in your permission plugin (e.g., /lp group vip permission set donuthomes.5).

Developer MattisStudios Clean code. High performance. Modern design.