GxDonutHomes 3.1
Advanced Home Management Plugin for Spigot & Paper
GxDonutHomes is a comprehensive and user-friendly home management plugin designed for Minecraft servers running Spigot or Paper. It provides players with an intuitive way to set, manage, and teleport to their homes using both commands and a sleek graphical user interface (GUI). Perfect for servers looking to enhance player experience with modern home management features.Perfect for servers that want reliable, feature-rich home management without unnecessary bloat.
Key Features
Core Home Management
| Feature | Description |
|---|---|
| Unlimited Homes | Players can set multiple homes with custom names |
| Instant Teleportation | Fast and reliable teleportation with built-in safety checks |
| Home GUI | Beautiful inventory-based interface for easy home management |
| Admin Home Management | Admins can view and teleport to players' home |
User Interface
- Modern GUI Design: Clean, responsive inventory menus with custom icons
- Customizable Layouts: Support for 1, 3, 5, or 7 home display modes to center homes perfectly
- Dynamic Background Fillers: Automatic gap detection that fills empty slots with custom items (e.g., Glass Panes)
- Visual Feedback: Color-coded items and hover tooltips for better usability
- Confirmation Dialogs: Safe deletion with confirmation prompts to prevent accidents
Performance & Compatibility
- Lightweight: Optimized code with minimal server impact
- Cross-Version Support: Compatible with multiple Minecraft versions (1.16.5 - 1.21.x)
- Data Persistence: Reliable JSON-based storage for home data
- Configurable: Extensive configuration options for server customization
Admin Features
- Admin Commands: Comprehensive admin tools for home management
- Permission System: Granular permissions for different features (donuthomes.1 through donuthomes.10)
- Player Home Lookup: View and manage any player's homes via
/phome - Teleport Override: Admin teleportation with bypass options
Multi-Language Support
- Built-in English language file
- Easily expandable to other languages
- All messages customizable via config
Commands
| Command | Description | Permission |
|---|---|---|
| /sethome <name> | Set a new home | donuthomes.sethome |
| /home <name> | Teleport to a home | donuthomes.home |
| /homes | Open homes GUI | donuthomes.homes |
| /homeslist | List all your homes | donuthomes.homeslist |
| /delhome <name> | Delete a home | donuthomes.delhome |
| /phome <player> | View online player's homes (Admin) | donuthomes.phome |
| /donuthomes | Main admin command | donuthomes.admin |
| /donuthomes reload | Reload configuration files | donuthomes.admin |
Permissions
Player Permissions
| Permission | Function |
|---|---|
| donuthomes.sethome | Set homes |
| donuthomes.home | Teleport to homes |
| donuthomes.homes | Access homes GUI |
| donuthomes.<1-10> | Set the home slots to a player |
| donuthomes.homeslist | List homes |
| donuthomes.delhome | Delete homes |
Admin Permissions
| Permission | Function |
|---|---|
| donuthomes.admin | Full admin access |
| donuthomes.phome | View other players' homes |
| donuthomes.bypass.* | Bypass all restrictions |
Installation
- Download the plugin JAR file
- Place the JAR in your server's plugins/ folder
- Restart your server
- Configure (optional) – edit config.yml
- Customize language (optional) – edit lang/english.yml
Configuration Options
| Setting | Description |
|---|---|
| Maximum Homes | Set per-player home limits |
| Teleport Cooldown | Configure teleport delays |
| GUI Settings | Customize inventory appearance |
| Sound Effects | Enable/disable teleport sounds |
| Home Layouts | Toggle between 1, 3, 5, or 7 slots to change how homes are centered. |
Requirements
| Requirement | Spec |
|---|---|
| Minecraft Version | 1.16.5 – 1.21.x |
| Server Software | Spigot, Paper, or compatible forks |
| Java Version | 17 or higher |
| Dependencies | LuckPerms [Permission management] |
Support
For bugs, help, or feature requests:
Check the documentation first
Join our Discord for real-time help
Submit bug reports with server logs
Why Choose GxDonutHomes?
| Reason | Why It Matters |
|---|---|
| User-Friendly | Intuitive commands + beautiful GUI |
| Feature-Rich | Everything you need in one plugin |
| Reliable | Stable performance, thoroughly tested |
| Customizable | Fits any server's needs |
| Active Development | Regular updates + community support |
