About DonutHomes​

DonutHomes is a configurable homes plugin built for modern Minecraft servers. It combines classic inventory menus with native Minecraft dialog screens and provides the storage, permissions, integrations, migration tools, and administrative controls needed for individual servers and larger networks.

Two Menu Systems​

Choose the interface that fits your server:

• DonutHomev1: A classic inventory-based homes menu.
• DonutHomev2: Native Minecraft dialog screens with item sprites.
• Configurable titles, materials, icons, labels, tooltips, slots, and actions.
• Up to 90 home slots through the dialog interface.
• A searchable Minecraft material selector for custom home icons.
• Dedicated management, rename, and deletion confirmation screens.

The classic inventory menu is enabled by default. DonutHomev2 requires Paper 1.21.11 or newer.

Player Home Management​

• Create and manage multiple homes.
• Open homes through a configurable menu.
• Teleport by command or menu.
• Rename existing homes.
• Assign custom material icons.
• Delete homes through confirmation screens.
• Access team homes when DonutTeams is enabled.

Home limits are permission-based and configurable for different ranks. If a player has multiple home-limit permissions, DonutHomes automatically applies the highest available limit.

DonutTeams Integration​

The optional DonutTeams hook supports:

• Displaying the team home in both menu systems.
• Setting and teleporting to a team home.
• Renaming the displayed team home.
• Selecting a custom team-home icon.
• Confirming team-home deletion.
• Respecting team leadership and management permissions.

The hook is enabled by default but is automatically ignored when DonutTeams is unavailable. When the integration is disabled or missing, the team slot becomes an additional personal-home slot.

DonutTeams is optional and is not bundled with this resource.

Storage and Performance​

Choose the storage method appropriate for your server:

• SQLite for simple and fast local storage.
• MySQL for remote or networked storage.
• JSON with separate per-player files.
• HikariCP connection pooling for MySQL.
• Asynchronous data operations.
• Cached player and team-home data.
• Configurable JSON autosaving.

Cross-Server Homes​

Optional Redis-backed cross-server mode allows homes to work across a BungeeCord or Velocity network:

• Transfer players to the backend server containing their home.
• Apply the destination location when the player joins the target server.
• Synchronize online-player presence between backend servers.
• Configure Redis authentication, SSL, connection pooling, and Sentinel.
• Isolate multiple networks with configurable cluster identifiers.

Redis is required only when cross-server mode is enabled. DonutHomes is installed on the backend Paper servers, not on the proxy.

Data Migration​

Built-in migration tools can import home data from:

• EssentialsX
• SetHome
• Gerhart DonutHome v17 SQLite databases

Supported migration data includes player UUIDs, home slots, custom names, worlds, coordinates, yaw, and pitch where available. The Gerhart database migrator also provides an optional overwrite mode.

WorldGuard Support​

The optional WorldGuard hook adds an allowed-set-home region flag:


This allows administrators to control exactly where players may create homes. WorldGuard is optional and the integration can be disabled.

Teleport Experience​

• Configurable teleport countdown.
• Movement-based teleport cancellation.
• Instant-teleport bypass permission.
• Configurable countdown, success, and cancellation particles.
• Configurable sound effects.
• Local and cross-server teleport handling.

Configuration​

DonutHomes separates its settings into focused configuration files:

• General plugin settings
• Database configuration
• Messages and sounds
• Permission-based home limits
• Cross-server and Redis settings
• Classic inventory menus
• Native dialog menus

Player-facing text, menu content, materials, colors, sounds, particles, slots, and home limits can be customized. Hex colors are supported.

Player Commands​

/home
Open the configured homes menu.

/home <index>
Teleport to a numbered home.

/home Team Home
Open or teleport to the current team home when DonutTeams is enabled.

/sethome [index]
Create or update a home.

/delhome <index>
Delete a home.

Administrative Commands​

/dhomes help
Display available administrative commands.

/dhomes tp <player> <home>
Teleport to another player's home.

/dhomes delete <player> <home>
Delete another player's home.

/dhomes see <player>
View another player's homes.

/dhomes limits <player>
Inspect a player's calculated home limit.

/dhomes migrate <essentialsx|sethome|gerhart|status>
Run or inspect a data migration.

/dhomes reload
Reload DonutHomes configuration files.

Requirements​

• Server software: Paper 1.21.11 or newer
• Java: Java 21 or newer

Optional integrations:

• DonutTeams for team homes
• WorldGuard for region restrictions
• Redis for cross-server homes

Support​

When requesting support, include your server software and version, Java version, DonutHomes version, relevant configuration, and the complete console error. Always keep a backup of existing home data before changing storage types or running a migration.