Commands

All AstralHomes commands are registered independently — there is no shared base command tying them together. Nearly every command is player-only; the two exceptions are /home reset and /home reload, which accept any CommandSender (including console) because their target/scope doesn't require a player context. Subcommands marked hidden are annotated @Private — they still execute when typed, but are omitted from tab-completion.

Homes

Base command: /home (aliases /homes, /h).

Subcommand	Syntax	Permission	Description
(none)	`/home`	—	Opens the `homes` GUI menu.
(none)	`/home <name>`	—	Teleports to one of your homes. `<name>` uses `@homes` tab-completion — the invoking player's own home names.
`list`	`/home list`	`astralhomes.admin.list`	Currently a no-op — the handler method body is empty.
`reset`	`/home reset <player>`	`astralhomes.admin.reset`	Clears every home belonging to `<player>` (looks up their `HomePlayerData` and calls `clearHomes()`). Sender is a plain `CommandSender`, so console can run it. Hidden.
`reload`	`/home reload`	`astralhomes.admin.reload`	Reloads `config.yml`, `messages.yml`, and the menu definitions. Sender is a plain `CommandSender`, so console can run it. Hidden.

See Homes for how homes are stored, limited, and teleported to.

`/sethome`

/sethome <name>

Creates (or overwrites) a home named <name> at the player's current location. The name is validated first:

Rule	Failure message
Must be 16 characters or fewer	`HOME_NAME_TOO_LONG`
Must match `^[a-zA-Z_:-]+$`	`HOME_NAME_INVALID`

Once the name is valid, the world blacklist and the per-player home limit are checked before the home is saved — see Homes and Configuration for both. No permission node gates /sethome itself.

`/delhome`

/delhome <name>

Aliases: /removehome, /deletehome, /rmhome. Deletes the named home. <name> uses @homes tab-completion. No permission node gates it.

Warps & Spawn

Base command: /warp (alias /warps).

Subcommand	Syntax	Permission	Description
(none)	`/warp <name>`	—	Teleports to a warp. `<name>` uses `@warps` tab-completion — every warp name, network-wide.
`set`	`/warp set <name>`	`warps.set`	Creates or overwrites a warp at the player's current location.
`delete` (aliases `del`, `remove`, `rm`)	`/warp delete <name>`	`warps.delete`	Deletes a warp. `<name>` uses `@warps` tab-completion.

/spawn teleports to whichever warp is literally named spawn. If no warp by that name exists, the player receives NO_SPAWN_SET instead of teleporting. /spawn carries no permission node of its own.

See Warps & Spawn for how warps are stored and resolved.

`/back`

/back

Permission: homes.back, applied at the command class level. Teleports the player to the location tracked before their last teleport. If none is recorded, the player receives BACK_NO_PREVIOUS_LOCATION instead of teleporting.

Teleport requests

All six commands below are player-only and carry no permission node. Whenever a target player is resolved (explicitly or implicitly) and turns out to be the sender, the command is rejected with REQUEST_SELF.

Command	Aliases	Syntax	Description
`/tpa <player>`	—	`<player>`	Send a request to teleport to `<player>`.
`/tpahere <player>`	—	`<player>`	Request `<player>` teleport to you.
`/tpaaccept [player]`	`/tpaccept`, `/tpyes`	`[player]`	Accept a pending request. Omitting `[player]` accepts the most recently received request.
`/tpadecline [player]`	`/tpdeny`, `/tpn`	`[player]`	Decline a pending request. Omitting `[player]` declines the most recently received request.
`/tpacancel [player]`	—	`[player]`*	Cancel a request you sent. Omitting `[player]` cancels your own most recently sent request.
`/tpatoggle`	`/tptoggle`	—	Toggles whether you accept incoming requests, replying with `TELEPORTATION_REQUEST_ENABLED` or `TELEPORTATION_REQUEST_DISABLED`.

<player>/[player] arguments all use @networkPlayers tab-completion — resolved network-wide, not just against players on the local server.

* /tpacancel declares @Syntax("<player>") in source even though its parameter is @Optional and the command behaves as optional at runtime, matching /tpaaccept//tpadecline — the syntax string doesn't reflect the real argument shape.

See Teleport Requests for request expiry, cross-server delivery, and the REQUESTS_DISABLED/REQUEST_ALREADY_PENDING cases that can also stop these commands short.

Command summary

Command	Aliases	Arguments	Permission	Description
`/home`	`homes`, `h`	—	—	Open the homes GUI menu.
`/home <name>`	`homes`, `h`	`<name>`	—	Teleport to a home.
`/home list`	`homes`, `h`	—	`astralhomes.admin.list`	No-op.
`/home reset <player>`	`homes`, `h`	`<player>`	`astralhomes.admin.reset`	Clear a player's homes. Hidden, console-capable.
`/home reload`	`homes`, `h`	—	`astralhomes.admin.reload`	Reload configuration. Hidden, console-capable.
`/sethome <name>`	—	`<name>`	—	Create or overwrite a home.
`/delhome <name>`	`removehome`, `deletehome`, `rmhome`	`<name>`	—	Delete a home.
`/warp <name>`	`warps`	`<name>`	—	Teleport to a warp.
`/warp set <name>`	`warps`	`<name>`	`warps.set`	Create or overwrite a warp.
`/warp delete <name>`	`warps` (subcommand aliases `del`, `remove`, `rm`)	`<name>`	`warps.delete`	Delete a warp.
`/back`	—	—	`homes.back`	Return to the previous location.
`/spawn`	—	—	—	Teleport to the `spawn` warp.
`/tpa <player>`	—	`<player>`	—	Send a teleport request.
`/tpahere <player>`	—	`<player>`	—	Request a player teleport to you.
`/tpaaccept [player]`	`tpaccept`, `tpyes`	`[player]`	—	Accept a request.
`/tpadecline [player]`	`tpdeny`, `tpn`	`[player]`	—	Decline a request.
`/tpacancel [player]`	—	`[player]`	—	Cancel a sent request.
`/tpatoggle`	`tptoggle`	—	—	Toggle incoming requests.

Last modified: 25 July 2026