GxDonutHomes - PREMIUM PLUGIN FOR FREE v3.1

This update focuses on giving server owners more control over the look and feel of the Home Menus! We’ve introduced dynamic layouts that allow you to center your homes perfectly, along with aesthetic features to fill empty menu gaps.

What's New?

• Dynamic Menu Layouts: You can now choose how many homes are displayed in the main row when Team Homes are disabled.
  • Choose between 1, 3, 5, or 7 home layouts.
  • Homes are now perfectly centered in the menu automatically!
• New Background Fillers: Added a feature to fill "removed" layout slots with customizable items.
  • Added empty-replace: true/false to the configuration.
  • Added empty-replace-item to define which material (e.g., GRAY_STAINED_GLASS_PANE) fills the gaps.
  • This ensures your menu always looks premium and "full," even with fewer homes.
• Refined Config Documentation: The config.yml has been updated with much clearer explanations for layout modes and new features.
• Code Optimizations: Improved GUI internal logic for better performance and alignment handling.

How to Install:

1. Stop your server.
2. Replace the old GxDonutHomes.jar with the new v3.1 version.
3. Delete your config.yml, let the plugin genarate new config.
4. Restart and enjoy the new aesthetic!

Support & Discord: Join our community for faster support and to request new features: https://discord.gg/TdFBuZHxJF

GxDonutHomes Update – Version 3.0​

We're excited to bring you the latest update for GxDonutHomes! This version includes new features, bug fixes, and performance improvements to enhance home management on your Minecraft server.

New Features​

Feature	Description
Team Home Toggle	Enable/disable team homes via config.yml — It gives more home slots!
Offline Player Support (/phome)	Correction: This version does NOT support offline player home management for admins. The feature was claimed but not implemented.
New Alias Command	/homeslist → works the same as /homes for more intuitive use
Tab Completion for /delhome	Quickly delete homes by name with tab suggestions
Admin Teleports from GUI	Admins can now teleport directly to any online player's home via /phome GUI

Bug Fixes & Improvements​

• Fixed GUI display issues for offline players
• Removed unnecessary permission messages (cleaner chat)
• Fixed Create Home button in GUI
• Resolved compilation errors
• Improved overall plugin stability

How to Update (Preserve Your Data!)​

Important: Do NOT skip these steps.

Click to expand...

Step-by-step:​

1. Stop your server completely.
2. Navigate to:
   /plugins/GxDonutHomes/
3. Keep ONLY these files/folders:
   • Data/ ← player home data
4. Delete everything else inside the GxDonutHomes/ folder.
5. Download the new GxDonutHomes.jar (Version 3.0).
6. Place the new .jar into /plugins/ (not inside the GxDonutHomes folder).
7. Start your server.
8. Verify: Run /homes and /phome to confirm everything works.

Note on Offline Player Support​

The claimed "offline player support for /phome" is not present in this version.
Admins cannot manage homes for offline players. It will be fixed soon.

Click to expand...

Need Help?​

If you encounter issues:

1. Restore from backup
2. Contact support with your server logs and error messages

Messages and some little bugs have been fixed!

## Version 2.1.1 - Bug Fix Update

### Bug Fixes
- Fixed Team Commands Execution: Team home and team delete buttons in the GUI now properly execute commands as the player instead of from console, resolving the "Only players can use this command" error when using team integrations.

### Technical Details

• Modified command dispatching in InventoryClickListener to use the player as the command sender
• Maintains compatibility with all team plugins that require player-executed commands
• No configuration changes required - existing team-home-command and team-delete-command settings work as before

### Migration
No migration needed - this is a drop-in bug fix. Simply replace the JAR file and restart your server.

---

This fix ensures that team integrations work correctly when players use the GUI buttons, providing a seamless experience for servers using team management plugins.

We published GxDonuthomes remake plugin for free for a limited time!

New Features​

GUI System​

• Modern Inventory Interface: Complete redesign with 36-slot inventory system
• Confirmation Delete Menu: Dedicated small chest GUI (27 slots) with confirmation buttons
  • Light blue dye in slot 13 displays home name
  • Red glass in slot 11 for cancel
  • Green glass in slot 15 for confirm
• Dynamic Slot Logic: Proper home limit handling without barriers
  • Normal players: configurable limit with red bed/dye for VIP-only slots
  • VIP players: access to all available slots

Commands​

• /sethome {name} - Set a new home from current location
• /delhome {homename} - Delete a home with confirmation menu
• /homes - List all your homes
• /donuthomes reload - Reload configuration without restart (admin only)
• /home - Open homes GUI (unchanged, now with better UX)

Configuration System​

• items.yml: Fully customizable item materials for all GUI elements
  • Change beds, dyes, glass blocks without recompiling
  • Override defaults: home-bed, home-delete, create-home-bed, vip-home-bed, etc.
• Team Commands: Configurable commands for team integrations
  • team-home-command: Execute any plugin command on team home button
  • team-delete-command: Execute any plugin command on team delete button
  • Supports %player% placeholder for player name
• Language System: Fully customizable messages in /lang folder
  • Delete confirmation messages
  • Command help messages
  • Home list formatting

Improvements​

Bug Fixes​

• Fixed home limit calculation (no more permanent barrier slots)
• Fixed command routing for /sethome, /delhome, /homes
• Proper home name extraction from GUI messages
• Confirmation menu now properly deletes homes
• Delete menu now opens from both /home GUI and /delhome command

UI/UX​

• Color-coded GUI elements (light blue = your homes, gray = empty, red = VIP only)
• Delete confirmation prevents accidental home deletion
• Better sound feedback for all interactions
• Small caps Unicode text for sleek appearance

Compatibility​

• Cross-version sound support (fallback names for older versions)
• Spigot/Paper API 1.13+ support
• Tested on 1.21.8 (Purpur)

Configuration Updates​

config.yml changes:

• Added team-home-command field
• Added team-delete-command field
• Existing homes.normal-limit and homes.vip-limit fully functional

New files:

• items.yml - Customize all GUI materials
• lang/english.yml - Complete message customization

Security​

• License verification system integrated
• Strict validation on startup (no fallback/offline mode)
• Persistent home data with JSON serialization

Technical Details​

• Size: 325 KB JAR (with all dependencies shaded)
• Build System: Maven with shade plugin
• JSON Storage: Homes stored in plugins/GxDonutHomes/data/
• Reflection-based: Action bar display for cross-version support

Migration from Previous Versions​

If upgrading from v2.0 or earlier:

1. Delete old plugin JAR
2. Replace with new GxDonutHomes-2.1.jar
3. Server will auto-generate new items.yml and updated lang/ files
4. Existing home data will be preserved

No additional steps needed - fully backward compatible!

​