Astral Realms Documentation Help

Commands

Base command: /town (aliases /v, /ville).

All gameplay is gated by the town's role permissions, not by command permissions — there is no astraltown.* tree. The exception is town.admin, which bypasses role checks entirely.

Core

Command

Description

Permission gate

/town create [name]

Create a town. Name validated against config.yml.

none + quota

/town select <town>

Set your active town context for other commands.

must be member

/town info [town]

Show town info card.

none

/town rename <new-name>

Rename your selected town.

NAME_CHANGE

/town motd [text]

Set or clear the MOTD (no arg = clear).

SETTINGS_CHANGE

/town leave

Leave the selected town (owner must transfer first).

none

/town transfer <member>

Hand ownership over.

owner only

/town disband (alias delete)

Delete the town after confirmation.

owner + DELETE_TOWN

/town online

List online members.

must be member

Spawn

Command

Description

Permission

/town spawn

Teleport to your selected town's spawn.

SPAWN_TELEPORT

/town spawn set

Set the spawn at your current location (must be inside a claim).

SPAWN_SET

/town spawn unset

Remove the spawn.

SPAWN_SET

A short-form /townspawn shortcut is also registered.

Claims

Command

Description

Permission

/town claim

Claim the current chunk.

CLAIM_LAND

/town claim all

Claim a 3×3 around your chunk.

CLAIM_LAND

/town unclaim

Unclaim the current chunk.

UNCLAIM_LAND

/town autoclaim

Toggle auto-claim while walking.

CLAIM_LAND

See Claims.

Bank

Command

Description

Permission

/town bank balance

Show balance.

none (member)

/town bank deposit <amount>

Move money from you to the bank.

BANK_DEPOSIT

/town bank withdraw <amount>

Move money from the bank to you.

BANK_WITHDRAW

Members & invitations

Command

Description

Permission

/town invite <player>

Send an invitation (expires by config).

INVITE

/town invitations

List pending invitations.

/town accept [town]

Accept the named invitation (or the only pending one).

/town decline [town]

Decline.

/town members

Member roster.

member

/town members kick <member>

Kick a member.

KICK

/town members role <member> <role>

Assign a role to a member.

ASSIGN_ROLES

Bans

Command

Description

Permission

/town ban <player> [reason]

Ban a player from entering the town.

BAN

/town unban <player>

Lift a ban.

BAN

/town bans

List active bans.

member

Warps

Command

Description

Permission

/town warp <name>

Teleport to a warp.

member (or public warp)

/town warp create <name>

Create a warp at your location.

WARPS

/town warp delete <name>

Delete a warp.

WARPS

/town warp list

Show all warps.

member

A short-form /townwarp is registered too. See Warps.

Subzones

Command

Description

Permission

/town subzone create

Enter corner-selection mode.

SUB_ZONES

/town subzone list

List subzones.

SUB_ZONES

/town subzone edit <subzone>

Edit metadata.

SUB_ZONES

/town subzone delete <subzone>

Delete subzone.

SUB_ZONES

/town subzone members <subzone>

Manage members.

SUB_ZONES

/town subzone roles <subzone>

Manage roles.

SUB_ZONES

/town subzone settings <subzone>

Manage settings.

SUB_ZONES

See Subzones.

Chat

Command

Description

Permission

/town chat [message]

Toggle town-chat redirect, or send one message.

/town chat broadcast <message>

Broadcast to every member.

CHAT_BROADCAST

A short-form /tc (/townchat) shortcut is registered. See Town Chat.

Tooling

Command

Description

/town particles

Toggle particle visualisation of claim borders.

/town menus

Open the menu hub.

Last modified: 25 July 2026