Server Command Reference

palaceserver-go — complete backtick command guide

Note: This is a complete rewrite of The Palace Server from scratch. Commands are similar in concept to the original Palace server but many work differently. Use this reference to get familiar with the new server software.

How to Use Commands

All server commands are entered by prefixing them with a backtick character (`) or a single quote ('). For example: `help, `ban Alice 60, `kill Bob.

Arguments in <angle brackets> are required. Arguments in [square brackets] are optional. A pipe | means "or" — choose one of the listed values.

Rank levels

Rank	Level	Description
User / Guest	0	All users including unregistered guests
Wizard / Operator	1	Moderator with kick/ban powers
God	2	Server administrator
Architect	3	Room & server configurator
Owner	4	Server owner — manages permissions and extensions
Host	5	Hosting-level superuser (system account)

Owners can change which rank is required for any command using `setrank.

Identity targeting

Commands like `ban, `kill, and `killfor accept a username or a specific identity dimension:

reg:<hash> — registration key
puid:<hash> — PUID / zcode
uuid:<id> — machine UUID
<IP address> — by IP (ban only)
<username> — by screen name (bans all identity dimensions simultaneously)

Everyone All users

Available to all users including unregistered guests.

`help [<category|command>]

Show available commands or detailed help on a specific command

`help — list all commands available to your current rank, grouped by category.
`help <command> — show detailed help for a specific command.
`help all — list every command on the server regardless of rank.
Unique prefix matching works: `help ban can match banlist.

`help `help ban `help all

`rev alias: `revision

Show server version banner

No arguments. Prints the server build version as a room message visible to everyone present.

`rev

`who / `roominfo

List users in current room / show room information

`who — list users currently in your room.
`roominfo — show room ID, name, occupancy, and settings.

`gotoroom <roomID>

Navigate to a room by numeric ID

`gotoroom <roomID> — go to the specified room (plugall). Operators use `find / `gotouser to locate users first.

`gotoroom 86

`page <message>

Send a help request to all online wizards / gods

Delivers your text privately to every wizard and god currently online.
Wizards can use `er to jump to the room you were in when you paged.
Wizards reply with `repage <message>.

`page I need help in the Ballroom!

`password <password>

Supply a navigation password for a password-protected room

Sets your current navigation password. If the server challenged you for a room password, this retries entry.
Password must be 2–31 characters.

`password opensesame

`hide / `unhide

Hide from the global user list

`hide — you appear absent in global listings; wizards can still see you via `list.
`hide off or `unhide — clears global hide.

`hidefrom <user> / `unhidefrom <user>

Hide from one specific user's point of view

`hidefrom <name> — that user will not see you in room or user lists.
`unhidefrom <name> — undo for that user.

`hidefrom TroubledUser `unhidefrom TroubledUser

`mute <user> / `unmute <user>

Suppress a user's chat messages on your client

`mute <name> — hides that user's chat messages from you only (client-side).
`unmute <name> — restores their messages.

`rejectesp [on|off] / `rejectprivate [on|off]

Block cross-room whispers or in-room private messages

`rejectesp on — block ESP (cross-room whisper) messages from other users.
`rejectprivate on — block in-room private whispers.
Pass off or omit to toggle off.

`re <message> alias: `respond

Reply via ESP to the last person who whispered you cross-room

Sends an ESP whisper back to whoever last sent you an ESP message.

`re Thanks, I found it!

`ping [<user>]

Measure network round-trip latency

`ping — ping yourself (measures your own latency to the server).
`ping <user> — ping another user and display their round-trip time.

`offer [<user>] / `accept [<user>]

Share avatars (offer / accept extension)

`offer [<user>] — offer your current prop stack to another user. They type `accept to wear it.
`accept [<user>] — wear the prop stack that was offered to you.
To copy another user's props without a prior offer, use the plugall `take command (owner rank by default — see Owners).

`offer Alice `accept

`naked [<user>]

Remove all worn props

`naked — strip all props from yourself.
`naked <user> — strip props from another user (wizards can do this to others).

`setface <0–13> [<user>] / `setcolor <0–15> [<user>]

Change face expression or color

`setface <n> — change your face to expression 0–13.
`setcolor <n> — change your face color 0–15.
Wizards can pass a second argument to change another user's face/color.

`mediaurl

Show the server's media (prop/image) URL

No arguments. Displays the base URL where room images and props are served from.

`aliases <user>

Show all known screen names used by a user

Lists all screen name aliases associated with the specified user's identity dimensions.

`votestart [<seconds>] / `votecancel / `votestatus

Participate in or initiate a room vote

`votestart [seconds] — start a vote in your current room, optionally specifying duration.
`votecancel — cancel the currently active vote.
`votestatus — show the current vote tally.

`newroom [<room name>]

Create a new member-owned room

Creates a temporary member room you own. Requires the server's memberrooms feature to be enabled.
Manage your room with the `r* commands below.

`tock / `reset / `plugins /

Miscellaneous informational commands

`tock — display the server's current local time.
`reset — reset your own rate-limit counters.
`plugins — list loaded server plugins.

Member Room Commands

Available to the owner of a member-created room. Use `newroom to create one.

`ropen / `rclose

Open or close your member room to other users

`rdelete

Permanently delete your member room

`rname <title>

Rename your member room

`rpicture [<filename>]

Set the background image for your member room

`rpassword [<password>]

Set or clear the entry password for your member room

`rguests [on|off]

Allow or deny guests from entering your member room

`rhide [on|off] / `runhide

Hide or unhide your member room from the room list

`rkick <user> / `runkick <user>

Kick or unkick a user from your member room

`rgag <user> / `rungag <user>

Gag or ungag a user within your member room

`rpainting [on|off]

Allow or deny painting in your member room

`rscripts [on|off]

Allow or deny Iptscrae scripts in your member room

`rlockdown [on|off]

Lock your member room so no new users can enter

`rowner <user>

Transfer ownership of your member room to another user

Wizards / Operators Wizard+

Moderation tools. Requires operator (rank 1) or higher.

`gag <user> / `ungag <user>

Prevent or restore a user's ability to chat

A gagged user cannot send public room messages. They receive a notice when they try.
`ungag <user> — restore chat ability.

`gag Spammer `ungag Spammer

`pin <user> / `unpin <user>

Lock a user in place so they cannot navigate to another room

Pinned users can still chat but cannot change rooms.
`unpin <user> — release the pin.

`propgag <user> / `unpropgag <user>

Disable or re-enable prop wearing for a user

Prop-gagged users cannot wear or change props until ungagged.

`kill <target> / `killfor <minutes> <target>

Disconnect a user and apply a temporary ban

`kill <target> — disconnect and ban for the server's default death penalty duration.
`killfor <minutes> <target> — disconnect and ban for a specific number of minutes.
Target can be a username, reg:<hash>, puid:<hash>, or uuid:<id>.

`kill Troublemaker `killfor 30 Troublemaker `killfor 60 uuid:abc123

`ban <target> [<minutes>] / `banip <IP or CIDR> [<minutes>] / `unban <id or key>

Ban or unban a user or IP address

`ban <target> — permanently ban across all identity dimensions (name, puid, reg, uuid).
`ban <target> <minutes> — ban for a fixed duration in minutes.
`banip <IP> — ban a specific IP address, with optional CIDR range notation.
`banip <CIDR> <minutes> — timed IP ban.
`unban <id or key> — remove a ban by its ID or identity key. Get IDs from `banlist.

`ban Alice `ban Alice 1440 `banip 192.168.1.100 `banip 10.0.0.0/8 60 `unban 42

`banlist / `purgebanlist

View or clean up the ban list

`banlist — display active bans with their IDs and expiry times.
`purgebanlist — remove all expired (past-duration) bans from the list.

`extend <user or IP> <minutes> / `comment <id> <text>

Modify a ban's duration or add a note

`extend <target> <minutes> — add or subtract minutes from an existing ban. Negative values reduce the ban.
`comment <id> <text> — attach a freeform comment to a ban record for operator notes.

`extend Alice 60 `comment 42 Repeated spamming in Lobby

`list [-dkopuw] [<user>] / `glist [-dkopuw] [<user>]

Detailed user listing for current room or whole server

`list — show all users in current room with extended details (IP, puid, reg, flags).
`glist — show all users on the entire server.
Flags: -d details, -k kicked, -o operators, -p props, -u users, -w wizards.
Pass a username to filter output to that user only.

`list `glist Alice `list -o

`goto <roomID> / `er / `repage <message>

Navigate to a room and respond to pages

`goto <roomID> — navigate to a room by numeric ID.
`er — jump to the room of the last user who paged you (emergency response).
`repage <message> — send a private reply to the last user who paged you.

`goto 10 `er `repage I'll be right there!

`roommessage <message> / `globalmessage <message>

Broadcast a message to a room or the entire server

`roommessage <text> — send a server announcement to everyone in your current room.
`globalmessage <text> — send a server-wide announcement to all connected users.

`roommessage Server maintenance in 5 minutes `globalmessage Welcome to The Palace!

`track <user> / `trackfor <minutes> <user> / `trackip [<minutes>] <IP or CIDR> / `untrack <user or IP>

Monitor a user's logons and room movements

`track <user> — notify you whenever the specified user logs on or changes rooms.
`trackfor <minutes> <user> — track for a limited duration.
`trackip <IP> — track all logons from an IP address or CIDR range.
`untrack <user or IP> — stop tracking.

`roommaxocc [<limit>] / `roommaxguests [<limit>]

Set occupancy limits for the current room

`roommaxocc <n> — set the maximum number of users allowed in this room.
`roommaxguests <n> — cap how many guests can be in this room simultaneously.
Omit the argument to view the current limit.

`give [<user>]

Give your props to another user (dressing room style)

Transfers your current prop stack to the specified user.

`dupipctl [reload | status | limit <n> [ip-pattern]]

Manage duplicate IP connection limits

`dupipctl status — show current dup-IP limits and connection counts.
`dupipctl limit <n> — set maximum connections from the same IP.
`dupipctl reload — reload dup-IP configuration from disk.

View server usage analytics and statistics

`analytics or `analytics status — show analytics summary.
`analytics top — top users and rooms by activity.
`analytics user — per-user stats.
`analytics room — per-room stats.
`analytics geo — geographic distribution.
`analytics peak — peak occupancy records.
`analytics on / off — enable or disable analytics collection.
`analytics flush — write analytics to disk immediately.
`analytics reset — clear all collected analytics data.

`autoannounce [<message>] / `userlistorder [alphabetical|id] / `roomsay [on|off]

Logon greeting and user-list settings

`autoannounce <text> — set the message broadcast to all users when a new user logs on.
`autoannounce — show the current auto-announce message.
`userlistorder alphabetical or id — set the order users appear in room lists.
`roomsay on / off — control whether users can send MSG_RMSG room messages.

`votesetup / `votedisable

Set up or remove voting zones in the current room

`votesetup — configure interactive vote hotspots in your current room.
`votedisable — remove all vote zones from the current room.

`operatorcount

Show how many operators are currently online

`find <user> / `gotouser <user>

Locate a user or jump to their room (plugall)

`find <user> — report which room the named user is in.
`gotouser <user> — navigate to that user's room.
Requires wizard (rank 1) or higher by default.

`find Alice `gotouser Alice

Gods God+

Server administration. Requires god (rank 2) or higher.

`shutdown / `serverinfo / `reportprefs

Server control and status

`shutdown — gracefully stop the server.
`serverinfo — show running configuration summary.
`reportprefs — display all current preference/setting values.

`maxocc [<users>]

Set the server-wide maximum user count

Caps the total number of users that can be connected at once.
Omit the argument to view the current limit.

`operatorpassword <password|disable> aliases: `wizpassword, `wizardpassword, `wizpass

Set or disable the wizard login password

Passwords are stored as bcrypt hashes — never in plain text.
`wizpass disable — remove the wizard password requirement.

`wizpass MySecretPass `wizpass disable

`memberrooms [on|off] / `customprops [on|off]

Toggle member room creation and custom prop uploads

`memberrooms on — allow users to create member-owned rooms with `newroom.
`customprops on — allow users to upload custom props to the server.

Restrict whispers, ESP, or room access by rank

`nowhisper <rank> — only users at or above the specified rank can send in-room private whispers. off = no restriction.
`noesp <rank> — only users at or above rank can send cross-room ESP whispers.
`operatorsonly on — restrict the current room to operators only.

`unicodename [on|off] / `roomenhancements [on|off]

UTF-8 display names and xRom room extensions

`unicodename on — allow UTF-8 characters in display names (god+ by default).
`roomenhancements on — enable xRom extended room descriptor support (god+ by default).
UTF-8 chat mode is controlled separately by `unicode (architect+ by default — see Architects).

`passwordsecurity [on|off] / `poundcheckinterval [<seconds>]

Password security and registration check tuning

`passwordsecurity on — enforce stricter password-change security requirements.
`poundcheckinterval <n> — set the registration check interval in seconds (1–5).

`botkill [on|off]

Allow or prevent operators from killing cyborg (bot) connections

`url [<url>] / `entrypage [<url>] / `roomsfile [<path>]

Set server URLs and paths

`url <url> — set the server's public URL (shown in directory listings).
`entrypage <url> — set the entry/welcome page URL.
`roomsfile <path> — set the path to the rooms data file.
Omit the argument on any of these to view the current value.

`vpncontrol [...]

Manage VPN and proxy detection

Controls whether connections from known VPN or proxy IP ranges are allowed, challenged, or blocked.
Use `vpncontrol without arguments for built-in help.

Manage the chat word filter

`wordfilter list — show all active filter entries.
`wordfilter add <word> — add a word to the filter list.
`wordfilter remove <word> — remove a word from the filter list.
`wordfilter test <phrase> — test whether a phrase would be filtered.
`wordfilter action <action> — set what happens when a match is detected (warn, gag, kill, etc.).
`wordfilter reload — reload filter lists from disk.

`propsafety [warn <n> | block <n> | duration <min>]

Tune HTTP prop upload rate-limiting

`propsafety warn <n> — warn after n prop uploads in the window.
`propsafety block <n> — block uploads after n in the window.
`propsafety duration <min> — set the rate-limit measurement window in minutes.

`listbans

Show detailed ban list with all identity dimensions

Extended version of `banlist showing all ban record fields including reg, puid, uuid, and IP entries.

Manage user authentication via the Gatekeeper extension

`gatekeeper list — list gatekeeper-authenticated users.
`gatekeeper bless <user> — grant a user gatekeeper access.
`gatekeeper unbless <user> — revoke gatekeeper access.
`gatekeeper setrank <user> <rank> — set a user's rank via gatekeeper.
`gatekeeper lockdown — enable lockdown mode requiring gatekeeper auth for all logins.
Use `gatekeeper help for full subcommand list.

`upgrade [check | status | cancel | channel | rollback] or <delay>

Upgrade the server binary or schedule a timed upgrade

`upgrade check — check for a newer version.
`upgrade <delay> — schedule an upgrade after a delay (e.g. 5m, 1h).
`upgrade status — show pending upgrade status.
`upgrade cancel — cancel a scheduled upgrade.
`upgrade rollback — roll back to the previous binary.
`upgrade channel <name> — switch update channel (stable, beta, etc.).

`showranks

Display any commands whose required rank has been overridden

Shows all commands where `setrank was used to change the default rank requirement.

Architects Architect+

Room management and deeper server configuration. Requires architect (rank 3) or higher.

`delete [<roomID>] / `duplicate [<roomID>]

Delete or duplicate a room

`delete — delete the current room (or specify a room ID).
`duplicate — create a copy of the current room.

`sortprops / `purgeprops

Manage the server prop file

`sortprops — re-sort the props file by usage.
`purgeprops — remove unused or old props based on the purge limit.

`uplist [<n>] / `downlist [<n>]

Move the current room up or down in the room list

Adjusts the sort position of the current room in the room browser list. Pass a number to move by multiple positions.

`dropzone [on|off]

Toggle the prop drop zone in the current room

`servername [<name>] / `defaultroomocc [<limit>]

Set server name and default room occupancy

`servername <name> — change the server's display name.
`defaultroomocc <n> — set the default max occupancy for rooms that have no specific limit set.
Omit the argument on either to view the current value.

`directory [set <field> <value> | interval <minutes> | announce | enabled on|off]

View or configure Palace web directory listing (directory.thepalace.app)

Requires architect (rank 3) or higher by default (use `setrank directory to change). Preview and all subcommands use the same rank gate.
`directory (no arguments) — preview JSON fields the server would publish, visitor stats, last announce status, and countdown to the next announce.
`directory set <field> <value> — update one configurable field (value can be multiple words). Empty value clears the field where allowed.
`directory interval N — set how often the server announces to the directory. Allowed range: 5–60 minutes. Use 0 to turn off timed announces (same effect as disabling the listing interval).
`directory announce — push an immediate directory update (wizards/gods are paged with a system notice).
`directory enabled on / off — enable listing (restores interval to last saved value, or 15 minutes if none) or disable by clearing the interval.

Configurable fields (with `directory set):

Field	Purpose	Notes
`category`	Audience / theme for the join screen and directory browse	Must be one of the server’s recognised categories (see list below). Typos are rejected with a hint.
`language`	Primary language of the palace	Must match a supported language name (e.g. English, Spanish, French); the server normalises spelling.
`blurb`	Short tagline	Shown on the join screen.
`description`	Longer text	Shown on the directory detail view.
`website`	Public web URL	If set, must start with `http://` or `https://`.
`sysop`	Operator or contact name	Displayed alongside the listing.
`address`	Palace client connection string override	If set, must start with `palace://` (e.g. `palace://myserver.example.com:9998`). Clear with an empty value to use the server’s auto address.

Recognised category values (examples — use exact names the server accepts):

Everyone, Kids, PG, PG-13, Adults Only, BDSM, BDSM/Gor, Gor, Anime, Cartoons, Comics, Furry, Art & Creative, Pixel Art, Fantasy & RPG, Sci-Fi, Horror & Gothic, Historical, Slice of Life, Social, LGBTQ+, Support, Religious & Spiritual, Dating & Romance, Family, Gaming, Music, Movies & TV, Education, Tech, Sports, Pets, Photography

Preview-only fields (shown on `directory but supplied by the live server, not via set): server name, population, max population, provider, software version, visitors today/week, etc.

`directory `directory set blurb The friendliest room on the net `directory set category Gaming `directory interval 15 `directory enabled on

`authoring [off | on <rank>] / `paint [on|off] / `spoof [on|off]

Control authoring, painting, and spoof permissions

`authoring off — disable Iptscrae authoring.
`authoring on <rank> — allow authoring for users at or above the specified rank.
`paint on / off — enable or disable painting in all rooms.
`spoof on / off — enable or disable name spoofing in scripts.

`operatorkill [on|off] / `playerkill [on|off] / `bots [on|off]

Control kill permissions and cyborg (bot) scripts

`operatorkill on / off — allow or prevent operators from using `kill.
`playerkill on / off — allow or prevent members from using `kill.
`bots on / off — enable or disable cyborg script connections.

`flood [<limit> | off] / `poundprotect [on|off] / `strictprotocol [on|off]

Flood protection and protocol enforcement

`flood <n> — set flood protection threshold in events per second. off disables it.
`poundprotect on — enable pound-sign (registration) protection against spoofed registrations.
`strictprotocol on — reject clients that deviate from the Palace protocol specification.

Prop storage and upload configuration

`propcontrol off — disable prop uploads. on or <rank> — restrict uploads to that rank or above.
`purgelimit <days> — purge props not accessed in this many days.
`recycle <threshold> — set the guest ID recycling threshold.
`propmode mixed|pchat|legacy — set the HTTP prop upload format mode.
`propsecurity on / off — write prop file securely (atomic rename).

`antispam [on|off | <feature> [value]]

Configure anti-spam protection

`antispam on / off — enable or disable the anti-spam system.
Use `antispam without arguments or with a feature name for tunable options (rate limits, penalties, etc.).

`death [<minutes>]

View or set the default kill duration

`death — show the current default death penalty in minutes (used by `kill when no duration is specified).
`death <n> — set the default death penalty. Accepts suffixes: s, m, h, d.

`death `death 30 `death 2h

Control chat and event logging

`chatlog on / off — enable or disable chat logging.
`chatlog file <path> — set the log file path.
`chatlog format <format> — set log output format.
Individual toggles: talk, whisper, esp, page, room, events, cmds — enable/disable logging for each event type.
`chatlog rotate — manually rotate the log file.

Manage age verification settings

`agecheck on / off — enable or disable age verification at login.
`agecheck min <age> — set the minimum required age.
`agecheck message — configure the age-check prompt message.
`agecheck list — list users who have verified.
`agecheck clear — clear the age verification list.

Manage chat backlog recording

`backlog on / off — enable or disable backlog recording.
`backlog retention <n> — set how many messages to retain per room.
`backlog room <roomID> — view the backlog for a specific room.
`backlog flush — clear all stored backlogs.
`backlog status — show current backlog configuration.

`godpassword <password|disable> alias: `godpass

Set or disable the god login password

Stored as bcrypt hash. disable removes the password requirement.

`guestaccess [on|off] alias: `guests

Allow or deny guest (unregistered) users from connecting

`picdir

Show the server's media directory path

`unicode [on|off]

Enable UTF-8 chat mode

`unicode on — allow UTF-8 text in chat (up to 250 runes vs 255-byte legacy limit).
`unicode off — classic byte-oriented chat.
Requires architect (rank 3) or higher by default. Display names and xRom are separate commands (see Gods).

Owners Owner+

Ownership-level controls: permissions, extensions, and site authentication. Requires owner (rank 4) or higher.

`setrank <command> [<rank>]

Override the minimum rank required for any command

`setrank <command> <rank> — change the minimum rank needed to use that command.
`setrank <command> — view the current rank for that command.
Use `showranks to see all overridden commands.

Rank numbers (same values the server echoes in parentheses after `setrank):

#	Server name	Usually called
0	`user`	Guest / member (everyone)
1	`wizard`	Wizard / operator
2	`god`	God
3	`architect`	Architect
4	`owner`	Owner
5	`host`	Host (if in a server hosting environment)

`setrank ban 2 `setrank shutdown 3

`extension [list | <name> [on|off]]

List or toggle server extensions

`extension list — show all available server extensions and their status.
`extension <name> on / off — enable or disable a specific extension.

`managementapi [on|off | addkey | delkey | status]

Control the Management API used by go_servermanager

`managementapi on / off — enable or disable the HTTP management API.
`managementapi addkey <key> — add an API key for authenticated access.
`managementapi delkey <key> — revoke an API key.
`managementapi status — show API status and active keys.

`architectpassword <password|disable> alias: `archpass

Set or disable the architect login password

Stored as bcrypt hash. disable removes the password requirement.

`allowoperators [on|off]

Enable or disable operator (wizard) access server-wide

When off, no one can log in as a wizard even with the correct password.

Manage required rules acceptance at login

`rules on / off — require or not require users to accept rules before entering.
`rules add <text> — add a rule line.
`rules list — show the current rules text.
`rules accepted — list users who have accepted.
`rules reset <user> — force a user to re-accept rules on next login.
`rules resetall — require all users to re-accept.
`rules timeout <seconds> — set how long a user has to accept rules.
`rules killtime <seconds> — set how long before a non-accepting user is kicked.

Manage site authentication (siteauth) extension

`siteauth on / off — enable or disable external site authentication.
`siteauth authurl <url> — set the authentication endpoint URL.
`siteauth mode <mode> — set the authentication mode.
`siteauth scope <scope> — set who must authenticate.
`siteauth attempts <n> — max auth attempts before kick.
`siteauth timeout <seconds> — auth timeout window.
`siteauth status — show current configuration.
`siteauth user <user> — show auth status for a specific user.

`ownerpassword <password|disable> alias: `ownerpass

Set or disable the owner login password

Stored as bcrypt hash. disable removes the password requirement.
Requires owner (rank 4) or higher by default.

`take <user>

Copy another user's props onto yourself (plugall)

Requires the plugall extension to be enabled.
Requires owner (rank 4) or higher by default (use `setrank take to change).

`disablerank <wizard|god|architect|owner>

Completely disable a rank tier's password

Replaces the password hash for the tier with a random unusable value, so no one can log in at that rank until a new password is set (e.g. via the matching `*password command).
Requires owner (rank 4) or higher by default.

`disablerank wizard `disablerank god

Hosts Host only

System-level superuser commands. Requires host (rank 5). These are typically reserved for the server hosting environment.

`reloadhostpass

Reload the host-level password file from disk

Re-reads /etc/passwd_palace without restarting the server.