DonutHomes gives each player a menu of home slots. Clicking a slot teleports them after a short countdown, an empty slot sets a home where they stand, and each home can be deleted from the menu with a confirmation. Which slots a player can use is decided by permissions.
If a team plugin is installed, the menu also shows the team's home.
Permissions#
| Permission | Lets a player | Default |
|---|---|---|
home.teleport.1 to home.teleport.5 | Each one adds one home slot. A player with 3 of them has 3 homes. | None |
The node names come from home-permissions in config.yml, so you can rename them or add more slots.
Warning
A player without any of these permissions can't set a home. Give your default group at least one, for example /lp group default permission set home.teleport.1 true.
Commands#
| Command | What it does | Permission |
|---|---|---|
/home | Opens your homes menu. Aliases /h and /homes. | None |
/home <number> | Teleports to that home. | None |
/sethome [number] | Sets a home where you stand, in the first free slot or the one you name. | A free home slot |
/delhome <number> | Deletes a home. | None |
Configuration#
config.yml holds everything. Homes are saved per player in the homes/ folder.
| Key | Default | What it does |
|---|---|---|
license-key | none | Your license key. |
settings.delay-to-teleport-in-seconds | 3 | Countdown before a home teleport. Moving cancels it. |
home-permissions | home.teleport.1 to 5 | The permission for each home slot. |
disable-team-hook | false | Hide the team home even when a team plugin is installed. |
list-player-homes-inventory | The homes menu: title, rows, slots and every icon. | |
confirm-home-delete-inventory | The delete confirmation menu. | |
messages | Every message, each with its own type and sound. |
WorldGuard#
DonutHomes adds a WorldGuard flag, allowed-set-home. Set it to deny on a region to stop players setting homes there:
Install#
- Install WorldGuard. DonutHomes doesn't load without it.
- Put the DonutHomes jar in
plugins/and start the server once to createconfig.yml. - Paste your license key into
license-keyinconfig.yml. Your key is under My Licenses on the BlazeZ portal; licenses linked to your Discord account show up there automatically. If yours is missing, open a License Key ticket in the BlazeZ Discord. - Grant the home permissions (see Permissions) and restart the server.
If Essentials is installed, its /home, /sethome and /delhome can take over. Add home, sethome and delhome to disabled-commands in plugins/Essentials/config.yml. DonutHomes reminds you of this in the console on startup.