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
RankLevelDescription
User / Guest0All users including unregistered guests
Wizard / Operator1Moderator with kick/ban powers
God2Server administrator
Architect3Room & server configurator
Owner4Server owner — manages permissions and extensions
Host5Hosting-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 and their descriptions.
`mediagalleryurl
Show the URL of the server's media gallery page
  • Displays the full URL to the server's browsable prop/media gallery, if the gallery feature is enabled.
  • Available to all users. If the gallery is disabled the command says so.
`mediagalleryurl
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
`rpin <user>  /  `runpin <user>
Pin or unpin a user in your member room
  • `rpin <name> — prevent the specified user from changing rooms while in your member room.
  • `runpin <name> — release the pin, allowing them to navigate again.
`rpin TroubledUser `runpin TroubledUser
`rpropgag <user>  /  `runpropgag <user>
Prevent or restore prop wearing in your member room
  • `rpropgag <name> — prevent the user from dropping or wearing props in your room.
  • `runpropgag <name> — restore their prop access.
`rnolooseprops [on|off]
Disallow loose (dropped) props in your member room
  • `rnolooseprops on — prevent anyone from dropping loose props on the room floor.
  • `rnolooseprops off — allow loose props again.
`rnodupavatars [on|off]
Prevent duplicate avatar costumes in your member room
  • `rnodupavatars on — block users from wearing an avatar costume already worn by someone else in the room.
  • `rnodupavatars off — allow duplicate costumes.
`rbanlist
List sanctioned users in your member room
  • Shows all users who have been gagged, pinned, kicked, or prop-gagged in your member room.
`rbanlist

Wizards / Operators Wizard+

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

User Sanctions
`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.
`namegag <user>  /  `unnamegag <user>
Prevent or restore a user's ability to change their screen name
  • `namegag <name> — lock the user's current screen name; they cannot change it until released.
  • `unnamegag <name> — release the name lock.
`namegag Spammer `unnamegag Spammer
`pagegag <user>  /  `unpagegag <user>
Prevent or restore a user's ability to send pages
  • `pagegag <name> — the user can no longer send help-page requests to operators.
  • `unpagegag <name> — restore paging ability.
`listgag <user>  /  `unlistgag <user>
Prevent or restore a user's ability to view user lists
  • `listgag <name> — the user is blocked from using `who, `list, and similar listing commands.
  • `unlistgag <name> — restore listing access.
Disconnection & Banning
`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
`killx <user> [<message>]  /  `signoff <user>
Disconnect a user with a custom message or silently (no ban)
  • `killx <user> [message] — disconnect the user and display an optional farewell message to the room. No ban is applied.
  • `signoff <user> — force a user to disconnect immediately with no ban and no message.
  • Use `kill / `killfor when you want to apply a ban alongside the disconnect.
`killx Troll You've been removed for rule violations `signoff IdleBot
`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
Navigation & Locating Users
`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
`find <user>  /  `gotouser <user>
Locate a user or jump to their room
  • `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
`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!
Room Tools
`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.
`clean
Remove all loose props and paint from the current room
  • Clears the room floor of any dropped loose props and erases all paint strokes. No arguments.
  • Useful for tidying up after events or when a room has been cluttered.
`clean
`move <user> <dx> <dy>  /  `setpos <user> <x> <y>  /  `pinx <user> <x> <y>
Reposition a user on screen
  • `move <user> <dx> <dy> — shift the user by a relative pixel offset from their current position. When whispered to a user, the username argument is inferred.
  • `setpos <user> <x> <y> — teleport the user to exact pixel coordinates within the current room.
  • `pinx <user> <x> <y> — pin the user at specific coordinates, preventing them from moving while held in place.
`move Alice 50 0 `setpos Alice 320 240 `pinx Alice 320 240
`give [<user>]  /  `dress <user>
Give your props to another user
  • `give [<user>] — offer your current prop stack to another user in an offer/accept flow. The recipient sees the prop offer.
  • `dress <user> — immediately copy your current prop stack onto another user without requiring acceptance. The user is dressed instantly.
`give Alice `dress Alice
`chat <user> <message>
Make another user appear to say a message
  • Causes the named user's avatar to display the specified chat bubble, as though they had typed it themselves.
  • Useful for scripted demos, rehearsals, or guided tours. The target user sees the message attributed to them.
`chat Alice Welcome everyone to the tour!
`userprefs <user>  /  `roomprefs
Show plugall stats for a user or the current room
  • `userprefs <user> — display plugall-tracked statistics and flags for the named user (rate-limit counters, gag/pin/listgag state, etc.).
  • `roomprefs — display the current room's plugall settings (loose-prop limit, dup-avatar flag, lockdown state, etc.).
`userprefs Alice `roomprefs
Messaging & Announcements
`roommessage <message>  /  `rmsg <message>  /  `globalmessage <message>  /  `gmsg <message>
Broadcast a message to a room or the entire server
  • `roommessage <text> (alias: `rmsg) — send a server announcement to everyone in your current room.
  • `globalmessage <text> (alias: `gmsg) — send a server-wide announcement to all connected users.
  • `rmsg and `gmsg are shorthand aliases for the respective commands above.
`rmsg Server maintenance in 5 minutes `gmsg Welcome to The Palace!
`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.
Monitoring & Investigation
`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.
`geoip [<user>]
Look up geographic information for a user
  • Displays the country, region, and city associated with the user's IP address.
  • Whisper the command to a user, or pass their name as an argument.
`geoip Alice
`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.
`notifybannedusers [on|off]
Control operator alerts when banned users attempt to log in
  • `notifybannedusers on — wizards receive a private page whenever a banned user's connection is rejected at login (default).
  • `notifybannedusers off — suppress these alerts.
  • Omit the argument to view the current status.
`analytics [on|off | status | top | user | room | geo | peak | flush | reset | http]
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.
`operatorcount
Show how many operators are currently online
Voting
`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.

Gods God+

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

Server Control
`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.
`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.).
Password Management
`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
Access & Restrictions
`nowhisper [off|wizard|god|architect|owner|on]  /  `noesp [off|wizard|god|architect|owner|on]  /  `operatorsonly [on|off]
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.
`botkill [on|off]
Allow or prevent operators from killing cyborg (bot) connections
`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.
`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.
`gatekeeper [help | bless | unbless | setrank | setpass | lockdown | list | changepass]
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.
Content Moderation
`wordfilter [use | add | remove | list | reload | test | action | warn]
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.
`wgmsg <message>
Send a private server-wide whisper to all users
  • Delivers the message as a private whisper to every connected user simultaneously. Unlike `globalmessage, the text appears in each user's whisper/ESP channel rather than as a broadcast room message.
  • Requires god (rank 2) or higher by default.
`wgmsg The server will restart in 2 minutes — please save your work!
Server Configuration
`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.
`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).
`pinprop [on|off]
Allow or disallow users from being pinned via prop scripts
  • `pinprop on — Iptscrae/prop scripts can pin user avatars in place (default behaviour).
  • `pinprop off — disable script-driven avatar pinning server-wide.
  • Omit the argument to view the current setting.
`palacepresents [on|off|query]
Control Palace Presents live auditorium event support
  • `palacepresents on — allow Palace Presents blowthru events (the live broadcast protocol used during auditorium-style presentations). This is the default.
  • `palacepresents off — block Palace Presents blowthrus server-wide.
  • `palacepresents query — show the current status.
`forward [<roomID>|off]
Set or clear a forward destination for the current room
  • `forward <roomID> — users who navigate to this room are silently redirected to the specified room ID.
  • `forward off — remove the forward, restoring normal room entry.
  • Omit the argument to view the current forward setting.
`forward 10 `forward off
`showranks
Display any commands whose required rank has been overridden
  • Shows all commands where `setrank was used to change the default rank requirement.
Geo & Notifications
`geo login [on|off]
Broadcast geographic information when users log in
  • `geo login on — when a user connects, their country/city is broadcast to operators.
  • `geo login off — disable login geo notifications.
  • Omit the argument to view the current state.
  • Per-user geo lookups are available to wizards via `geoip <user>.
`notifyevents [<event> everyone|wizards|off]
Configure room-activity notifications for events like painting and prop drops
  • Requires the notifyevents extension to be enabled (`extension notifyevents on).
  • `notifyevents — show current settings.
  • Events: roommsg, painting, erasing, propdrop.
  • Modes: everyone notifies all users in the room; wizards notifies only operators; off disables the notification for that event type.
`notifyevents painting wizards `notifyevents propdrop everyone `notifyevents roommsg off

Architects Architect+

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

Room Management
`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.
`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.
`defaultbg [<filename>|reset]
Set the default background image used when new rooms are created
  • `defaultbg — show the current default background setting.
  • `defaultbg <filename> — specify a file from the server's media folder (e.g. sunset.png) to use as the default for newly created rooms.
  • `defaultbg reset — clear the override and revert to the server's built-in default background.
`defaultbg lobby.webp `defaultbg reset
`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):

FieldPurposeNotes
categoryAudience / theme for the join screen and directory browseMust be one of the server’s recognised categories (see list below). Typos are rejected with a hint.
languagePrimary language of the palaceMust match a supported language name (e.g. English, Spanish, French); the server normalises spelling.
blurbShort taglineShown on the join screen.
descriptionLonger textShown on the directory detail view.
websitePublic web URLIf set, must start with http:// or https://.
sysopOperator or contact nameDisplayed alongside the listing.
addressPalace client connection string overrideIf 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 & Scripts
`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.
`blowthruscript [on|off]
Control Lua script-to-script blowthru messaging (SIPT)
  • `blowthruscript on — allow Iptscrae/Lua scripts to send blowthru messages to other scripts (SIPT protocol). This is the default.
  • `blowthruscript off — block all script-to-script blowthrus server-wide.
  • Omit the argument to view the current status.
Prop & Paint Control
`flushprops [<days>]  /  `killprop
Purge old props from the server prop store
  • `flushprops [days] — remove props from pserver.prp and HTTP media that have not been accessed in N days (defaults to `purgelimit). Props with ID below 100,000 are always kept. Props referenced by sources in `purgenot are always kept. The prop file is automatically sorted by ID after purging.
  • `killprop — immediately remove all props you are currently wearing from the server's binary prop store (pserver.prp) and HTTP media shards. The prop file is saved afterward.
`propcontrol [off | on | <rank>]  /  `purgelimit [<days>]  /  `purgenot [<tokens>]  /  `recycle [<threshold>]  /  `propmode [mixed|pchat|legacy]  /  `propsecurity [on|off]
Prop storage and upload configuration
  • `propcontrol off — disable prop uploads. on or <rank> — restrict uploads to that rank or above.
  • `purgelimit [days] — show or set the number of days before a prop is eligible for removal by `flushprops. 0 disables automatic purging. Default: 30. Persisted to serverprefs.json.
  • `purgenot [looseprops,xrom,pat] — show or set which prop stores are scanned for in-use prop IDs that must be kept during `flushprops. Accepts a comma-separated list of: looseprops (room loose props), xrom (xRom scripts), pat (pserver.pat hotspot scripts). Default: all three. Persisted to serverprefs.json.
  • `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).
`propautopurge [on|off]
Enable or disable automatic daily prop purging
  • `propautopurge on — the server will automatically run `flushprops once per day, removing props older than the `purgelimit age threshold (default 30 days). This is the default.
  • `propautopurge off — disable scheduled auto-purging; props will only be purged when you run `flushprops manually.
  • Omit the argument to view current status.
`paintlimit [strokes|bytes [<N>]]  /  `looseproplimit [<N>]
Set server-wide limits on painting and dropped props
  • `paintlimit — show both current paint limits (strokes and bytes).
  • `paintlimit strokes <N> — cap the total number of paint strokes stored per room. 0 = unlimited.
  • `paintlimit bytes <N> — cap the total bytes of paint data stored per room. 0 = unlimited.
  • Default limits: 68,000 strokes, 2,448,000 bytes. Operators and above bypass these limits.
  • `looseproplimit [N] — show or set the maximum number of loose props allowed on any room floor (range 1–500). All operators are paged when either limit changes.
`paintlimit strokes 1000 `paintlimit bytes 500000 `looseproplimit 20
Security & Protection
`flood [<limit> | off]  /  `floodkill [<minutes>]  /  `poundprotect [on|off]  /  `strictprotocol [on|off]
Flood protection, kill duration, and protocol enforcement
  • `flood <n> — set the flood protection threshold in events per second. off disables it.
  • `floodkill [minutes] — set how long (in minutes) a user is banned when flood protection triggers a kill. Set to 0 to disconnect without banning. Omit to view the current value.
  • `poundprotect on — enable pound-sign (registration) protection against spoofed registrations.
  • `strictprotocol on — reject clients that deviate from the Palace protocol specification.
`flood 10 `floodkill 30 `floodkill 0
`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.
`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
Access Control
`guestaccess [on|off] alias: `guests
Allow or deny guest (unregistered) users from connecting
`agecheck [on|off | min <age> | message | format | list | clear]
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.
Logging & History
`chatlog [off | on | file | format | talk | whisper | esp | page | room | events | cmds | rotate]
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.
`backlog [on|off | retention | room | flush | status]
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.
Configuration
`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).
`picdir
Show the server's media directory path
`sitepage
Display the server's configured site/entry page URL
  • Shows the site URL currently configured on the server. This URL is typically used as a link shown in the Palace client's connection dialog.
  • To set the entry page URL use `entrypage <url> (God rank — see Gods).
`sitepage
`godpassword <password|disable> alias: `godpass
Set or disable the god login password
  • Stored as bcrypt hash. disable removes the password requirement.

Owners Owner+

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

Rank & Permissions
`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 nameUsually called
0userGuest / member (everyone)
1wizardWizard / operator
2godGod
3architectArchitect
4ownerOwner
5hostHost (if in a server hosting environment)
`setrank ban 2 `setrank shutdown 3
`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.
`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
Passwords
`architectpassword <password|disable> alias: `archpass
Set or disable the architect login password
  • Stored as bcrypt hash. disable removes the password requirement.
`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.
Extensions & API
`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.
Rules & Authentication
`rules [help | on | off | add | remove | list | confirm | timeout | killtime | clear | accepted | reset | resetall]
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.
`siteauth [on|off | mode | scope | authurl | logofftrack | user | attempts | timeout | status]
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.
Media, Props & Emotes
`mediagallery [on|off]
Enable or disable the browsable media gallery web page
  • `mediagallery on — enable the /gallery HTTP page that lets visitors browse all uploaded props and images. This is on by default.
  • `mediagallery off — disable the gallery page.
  • Omit the argument to view current status and the gallery URL.
  • All users can view the gallery URL with `mediagalleryurl.
`mediagallery `mediagallery off
`mediaupload [bless <user> | bless list | unbless <N> | blessrank]  /  `mediauploadblessrank <wiz|god|architect|owner>
Manage HTTP prop/media upload access and upload permissions
  • `mediaupload — show your personal media upload URL.
  • `mediaupload bless <user> — grant a connected user upload access by adding their identity to the bless list. Can also be used by whispering `mediaupload bless directly to the user.
  • `mediaupload bless list — show all currently blessed users.
  • `mediaupload unbless <N> — remove blessed entry #N (number from the bless list).
  • `mediaupload blessrank — show the current minimum rank required to run bless/unbless subcommands.
  • `mediauploadblessrank <rank> — set who can use bless/unbless: wiz (default), god, architect, or owner. Requires owner rank and is not setrankable.
`mediaupload `mediaupload bless Alice `mediaupload bless list `mediaupload unbless 2 `mediauploadblessrank god
`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).
`emotes [on|off | upload-permission <rank> | manage-permission <rank>]
Configure the custom emotes feature
  • `emotes — show current emote status and permission settings.
  • `emotes on / off — enable or disable custom emote support for clients that advertise emote capability.
  • `emotes upload-permission <rank> — set the minimum rank that can upload custom emotes (member, wizard, god, architect, or owner).
  • `emotes manage-permission <rank> — set the minimum rank that can manage (approve/remove) emotes. Cannot be set below wizard.
  • Requires owner (rank 4) or higher by default.
`emotes on `emotes upload-permission member `emotes manage-permission wizard
Server Control
`restart
Restart the server process in-place
  • Broadcasts a warning to all connected users, then re-launches the server process using the same binary and configuration. Equivalent to a process restart without requiring shell access.
  • Requires owner (rank 4) or higher by default.
  • To stop the server entirely, use `shutdown (God+). To schedule a rolling upgrade restart, see `upgrade.
`restart

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.