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.
| Key | |
|---|---|
| ✅ | Accessible by all players by default |
| ❌ | Accessible only by server operators by default |
This is a table of HuskHomes commands, how to use them, and their required permission nodes. Additional permissions for bypassing teleport warmup and economy checks are detailed below.
| Command | Description | Permission | Default | |
|---|---|---|---|---|
| Home commands | ||||
/home |
/home [name] |
Teleport to one of your homes | huskhomes.command.home |
✅ |
/home [<owner_name.home_name>] |
Teleport to another user's home | huskhomes.command.home.other |
❌ | |
/homelist |
/homelist [page] |
View a list of your homes | huskhomes.command.homelist |
✅ |
/homelist <owner_name> [page] |
View a list of another user's homes | huskhomes.command.homelist.other |
❌ | |
/sethome |
/sethome [name] |
Set a new home with a name | huskhomes.command.sethome |
✅ |
/delhome |
/delhome [name] |
Delete a home you previously set | huskhomes.command.delhome |
✅ |
/delhome all [confirm] |
Delete all of your homes | |||
/delhome <owner_name.home_name> |
Delete the home of another user | huskhomes.command.delhome.other |
❌ | |
/edithome |
/edithome <name> |
View and edit information about a home | huskhomes.command.edithome |
✅ |
/edithome <name> rename <new_name> |
Rename a home | huskhomes.command.edithome.rename |
||
/edithome <name> description <text> |
Set a home's description | huskhomes.command.edithome.description |
||
/edithome <name> relocate |
Move a home to your current position | huskhomes.command.edithome.relocate |
||
/edithome <name> privacy [public|private] |
Set a home's privacy (make it public or private) | huskhomes.command.edithome.privacy |
||
/edithome <owner_name.home_name> [args] |
View and edit another user's home | huskhomes.command.edithome.other |
❌ | |
/phome |
/phome [<owner_name.home_name>] |
Teleport to a public home | huskhomes.command.phome |
✅ |
/phomelist |
/phomelist [page] |
View the list of public homes | huskhomes.command.phomelist |
✅ |
| Warp commands | ||||
/warp |
/warp [name] |
Teleport to a warp | huskhomes.command.warp† |
✅ |
/warp <name> <teleporter_name> |
Teleport another online user to a warp | huskhomes.command.warp.other† |
❌ | |
/warplist |
/warplist [page] |
View the list of warps | huskhomes.command.warplist† |
✅ |
/setwarp |
/setwarp <name> |
Set a new warp with a name | huskhomes.command.setwarp |
❌ |
/delwarp |
/delwarp <name> |
Delete a warp | huskhomes.command.delwarp |
❌ |
/editwarp |
/editwarp <name> |
View and edit information about a warp | huskhomes.command.editwarp |
❌ |
/editwarp <name> rename <new_name> |
Rename a warp | huskhomes.command.editwarp.rename |
||
/editwarp <name> description <text> |
Set a warp's description | huskhomes.command.editwarp.description |
||
/editwarp <name> relocate |
Move a warp to your current position | huskhomes.command.editwarp.relocate |
||
| Spawn commands | ||||
/spawn |
/spawn |
Teleport to the spawn position | huskhomes.command.spawn |
✅ |
/spawn [teleporter_name] |
Teleport another online user to the spawn position | huskhomes.command.spawn.other |
❌ | |
/setspawn |
Set the spawn position to your current location | huskhomes.command.setspawn |
❌ | |
| Teleport commands | ||||
/tp |
/tp <target_name> |
Teleport to an online user | huskhomes.command.tp |
❌ |
/tp <teleporter_name> <target_name> |
Teleport an online user to another online user | huskhomes.command.tp.other |
❌ | |
/tp <(x) (y) (z) [yaw] [pitch] [world_name] [server_name]> |
Teleport to a set of coordinates | huskhomes.command.tp.coordinates |
❌ | |
/tp <teleporter_name> <coordinates> |
Teleport an online user to a set of coordinates | huskhomes.command.tp.otherhuskhomes.command.tp.coordinates |
❌ | |
/tphere |
/tphere <username> |
Teleport an online user to your position | huskhomes.command.tphere |
❌ |
/tpoffline |
/tpoffline <username> |
Teleport to where a user last logged out | huskhomes.command.tpoffline |
❌ |
/tpall |
Teleport everyone to your position | huskhomes.command.tpall |
❌ | |
| Teleport request commands | ||||
/tpa |
/tpa <username> |
Send a request to teleport to another online user | huskhomes.command.tpa |
✅ |
/tpahere |
/tpahere <username> |
Send a request asking another online user to teleport to you | huskhomes.command.tpahere |
✅ |
/tpaall |
Request that everyone teleports to you | huskhomes.command.tpaall |
❌ | |
/tpaccept |
/tpaccept |
Accept the last teleport request you received | huskhomes.command.tpaccept |
✅ |
/tpaccept [username] |
Accept a teleport request from a specific user | |||
/tpdecline |
/tpdecline |
Decline the last teleport request you received | huskhomes.command.tpdecline |
✅ |
/tpdecline [username] |
Decline a teleport request from a specific user | |||
/tpignore |
Toggle whether to ignore incoming teleport requests | huskhomes.command.tpignore |
✅ | |
| Random teleport command | ||||
/rtp |
/rtp |
Teleport randomly into the wild | huskhomes.command.rtp |
✅ |
/rtp <player> |
Teleport another user randomly into the wild | huskhomes.command.rtp.other |
❌ | |
/rtp <player> <world> |
Teleport randomly in a specific world | huskhomes.command.rtp.world |
❌ | |
| Back teleport command | ||||
/back |
Teleport to your last position (see below) | huskhomes.command.back |
✅ | |
| Teleport back to where you last teleported from | huskhomes.command.back.previous |
✅ | ||
| Teleport back to where you last died | huskhomes.command.back.death‡ |
✅ | ||
| Plugin management command | ||||
/huskhomes |
/huskhomes |
Use plugin management commands | huskhomes.command.huskhomes |
✅ |
/huskhomes about |
View the plugin about menu | huskhomes.command.huskhomes.about |
✅ | |
/huskhomes help [page] |
View the list of enabled plugin commands | huskhomes.command.huskhomes.help |
✅ | |
/huskhomes update |
Check for plugin updates | huskhomes.command.huskhomes.update |
❌ | |
/huskhomes reload |
Reload the plugin locales and config file | huskhomes.command.huskhomes.reload |
❌ | |
/huskhomes import |
Import data from another plugin | huskhomes.command.huskhomes.import |
❌ | |
/huskhomes delete player <username> [confirm] |
Delete player data from the system database | huskhomes.command.huskhomes.delete |
❌ | |
/huskhomes delete homes <world_name> [server_name] [confirm] |
Delete all homes on a specific world and/or server | |||
/huskhomes delete warps <world_name> [server_name] [confirm] |
Delete all warps on a specific world and/or server | |||
Notes
† — If Permission Restricted Warps are in use, the huskhomes.command.warp.(warp_name) permission node will also be required to be able to view and use warps.
‡ — Requires return_by_death to be enabled in config.yml.
Command Aliases
The following commands have aliases that can also be used for convenience:
| Command | Aliases |
|---|---|
/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 and the command will not be registered.
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 sethuskhomes.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).
Bypass permission nodes
These permissions let you bypass teleportation warmup checks, cooldown, and economy checks
| Description | Permission | Default |
|---|---|---|
| Bypass timed teleportation warmups† | huskhomes.bypass_teleport_warmup | Not set |
| Bypass cooldown checks | huskhomes.bypass_cooldowns | Not set |
| Bypass economy checks | huskhomes.bypass_economy_checks | Not set |
†This is not effective when the teleport warmup time is set to <= 0 in the config file.