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.