Commands

HuskHomes provides a range of commands for you to use. This page will detail the permissions for each command to let you manage access to the plugin's different features.

Commands & Permissions Table

Command Conflicts:If you have multiple plugins providing similar commands, you may need to create aliases to ensure HuskHomes' commands take priority.

This is a table of HuskHomes' commands and their required permission nodes. Additional permissions provided by the plugin to control other variables are detailed further below!

CommandDescriptionBase Permission†Default‡
/home <name>Teleport to a homehuskhomes.command.home✅
/homelist [page]Get a list of your homeshuskhomes.command.homelist✅
/sethome <name>Set a new home with given namehuskhomes.command.sethome✅
/delhome <name>Delete a home you previously sethuskhomes.command.delhome✅
/edithome <name> [rename/description/relocate/privacy] [args]Edit one of your homeshuskhomes.command.edithome✅
/phome [<owner_name.home_name>]Teleport to a public homehuskhomes.command.phome✅
/phomelist [page]View the list of public homeshuskhomes.command.phomelist✅
/warp <name>Teleport to a warphuskhomes.command.warp✅
/warplist [page]View the list of warpshuskhomes.command.warplist✅
/setwarp <name>Set a new warp with given namehuskhomes.command.setwarp❌
/delwarp <name>Delete a warphuskhomes.command.delwarp❌
/editwarp <name> [rename/description/relocate] [args]Edit a warphuskhomes.command.editwarp❌
/tp <target> [destination]Teleport to another player or locationhuskhomes.command.tp❌
/tphere <player>Teleport another player to youhuskhomes.command.tphere❌
/tpa <player>Request to teleport to another playerhuskhomes.command.tpa✅
/tpahere <player>Request another player to teleport to youhuskhomes.command.tpahere✅
/tpaccept [player]Accept a teleport requesthuskhomes.command.tpaccept✅
/tpdecline [player]Decline a teleport requesthuskhomes.command.tpdecline✅
/rtp [player] [world]Teleport randomly into the wildhuskhomes.command.rtp✅
/tpignoreIgnore incoming teleport requestshuskhomes.command.tpignore✅
/tpoffline <player>Teleport to where a player was last onlinehuskhomes.command.tpoffline❌
/tpallTeleport everyone to your positionhuskhomes.command.tpall❌
/tpaallRequest that everyone teleports to youhuskhomes.command.tpaall❌
/spawnTeleport to spawnhuskhomes.command.spawn✅
/setspawnSet the spawn positionhuskhomes.command.setspawn❌
/backReturn to your previous position, or where you diedhuskhomes.command.back✅
/huskhomes [about/help/reload/import/update]View plugin information & reload configshuskhomes.command.huskhomes✅
  • † Base Permission — Required permission for basic command execution; some commands require additional permissions for certain functions (See below…)
  • ‡ Default — ✅ = Accessible by all players by default — ❌ = Accessible only by server operators by default.

Command Aliases

The following commands have aliases that can also be used for convenience:

CommandAliases
/homelist/homes
/phome/publichome
/phomelist/phomes, /publichomelist
/warplist/warps
/tp/tpo
/tpaccept/tpyes
/tpdecline/tpno, /tpdeny

Disabling Commands

If you'd like to disable a command, add it to the disabled_commands section of your config file as detailed below. Note that on servers running Paper for versions earlier than Minecraft 1.19.4, or servers just running plain Spigot instead of Paper (not recommended—please upgrade to Paper!), disabled commands will still be registered but a disabled command message will appear. On servers running Paper for Minecraft 1.19.4+, HuskHomes will be registered as a Paper Plugin (and will appear as such in the /plugins menu) and disabled commands will not be registered at all.

Disabling a command in config.yml
# Disabled commands (e.g. ['/home', '/warp'] to disable /home and /warp)
disabled_commands: [ '/rtp' ]

Home Limits

You can modify the maximum number of homes, the allotment of free homes and the number of public homes a user can set through permission nodes.

  • huskhomes.max_homes.<amount> — Determines the max number of homes a user can set
  • huskhomes.free_homes.<amount> — Determines the allotment of homes the user can set for free, before they have to pay†
  • huskhomes.max_public_homes.<amount> — Determines the maximum number of homes a user can make public

†Only effective on servers that make use of the economy hook.

If users have multiple permission nodes (i.e. from being in multiple permission groups), HuskHomes will accept the highest. If you prefer that the nodes stack, you can set the stack_permission_limits setting in the plugin config file to true (under general).

Note that these permission-set values override the values set in the plugin config (max_homes, max_public_homes under general and free_homes under economy).

Other Permissions

Return to last position or death with /back

These permissions control what the user can do with the back command, including the ability to return to their last position or to where they died.

CommandDescriptionPermissionDefault
/back (after respawning)Use /back to return to where you died†huskhomes.command.back.death✅
/backUse /back to return to your previous teleport positionhuskhomes.command.back.previous✅

†Note that return by death must be enabled in the plugin config files for this to work.

Home privacy

These permissions allow you to make a home public/private (toggling its privacy). There are also permissions that let you use, edit and delete homes that have not been set publicly.

CommandDescriptionPermissionDefault
/edithome <name> privacy [public/private]Modify the privacy of a homehuskhomes.command.edithome.privacy❌
/homelist <player> [page]View a list of a user's homeshuskhomes.command.home.other❌
/home [<owner_name>.<home_name>]Teleport to a user's home, public or privatehuskhomes.command.home.other❌
/edithome [<owner_name>.<home_name>] [rename/description/relocate/privacy] [args]Edit a user's homehuskhomes.command.edithome.other❌
/delhome [<owner_name>.<home_name>]Delete a user's homehuskhomes.command.delhome.other❌
Cooldown, warmup and economy bypasses

These permissions let you bypass teleportation warmup checks, rtp cooldown checks and economy checks

DescriptionPermissionDefault
Bypass timed teleportation warmups†huskhomes.bypass_teleport_warmupNot set
Bypass economy checkshuskhomes.bypass_economy_checksNot set
Bypass the cooldown on /rtp‡huskhomes.command.rtp.bypass_cooldown❌

†This is not effective when the teleport warmup time is set <= 0 in the config file.

‡This is not effective when the /rtp cooldown time is set <= 0 in the config file.

Additional teleportation permissions

These permissions allow you to use /tp and /rtp to teleport other players remotely, teleport to co-ordinates, and randomly teleport to other worlds.

CommandDescriptionPermissionDefault
/tp [player] [target] Teleport another playerhuskhomes.command.tp.other❌
/tp [player] <x> <y> <z> [world] [server]Teleport to a set of coordinates.huskhomes.command.tp.coordinates❌
/rtp [player] [world]Randomly teleport another player.huskhomes.command.rtp.other❌
/rtp [player] [world]Randomly teleport in a specific world.huskhomes.command.rtp.world❌
/spawn [player]Teleport another player to spawn.huskhomes.command.spawn.other❌
/warp [name] [player]Teleport another player to a warp.huskhomes.command.warp.other❌
/huskhomes command arguments

These permissions control what arguments of the /huskhomes command a user may use.

CommandDescriptionPermissionDefault
/huskhomes help [page]View a list of HuskHomes commandshuskhomes.command.huskhomes.help✅
/huskhomes [about]View the plugin about menuhuskhomes.command.huskhomes.about✅
/huskhomes reloadReload the plugin config and message fileshuskhomes.command.huskhomes.reload❌
/huskhomes import [list/start]Import data from other plugins/modshuskhomes.command.huskhomes.import❌
/huskhomes updateCheck for updateshuskhomes.command.huskhomes.update❌