Skip to content

The Web Portal

Every SharpMUSH server serves a web portal from the same origin as the game. It is not an optional add-on or a separate deployment: the Blazor portal is baked into the server image, so if the game is running, the website is running.

This is where most administration happens. There is no mush.cnf to edit and no @config incantation to remember for the common cases — you change a setting in a form and it takes effect.

The first visitor to /setup claims the admin account, which is made in advance and linked to God (#1). The setup wizard then walks through five more steps:

  1. Import a PennMUSH, TinyMUX or RhostMUSH database, or start fresh.
  2. Introduce the game: its name and a first step for new players. This can wait until later.
  3. Choose the staff roles that sit beside Player, Builder, Royalty and Wizard: SharpMUSH’s helper and moderator, or RhostMUSH’s staff levels.
  4. Choose the objects that answer HTTP requests and events.
  5. Choose the bundled packages.

The wizard stays open until the admin finishes it, and comes back to the step they left.

There are three different kinds of guidance. These descriptions distinguish what each is for; the game’s navigation labels may differ.

You needWhere to look
Learn to play — how the interface worksThe guided introduction at /welcome, also linked from Help. Try the example game’s guide without signing in.
About this game — setting, rules and character requirementsThe game’s own welcome, rules and character-guide pages. Staff choose this material; the wiki at /wiki is another place to find what they publish.
Command reference — syntax and what a command doesThe server’s help at /help, or help in a client. Try the example game’s reference. For installed systems and staff-written topics, see Game Help with +help.

The interface guide does not replace a game’s rules or approval process. Available sign-in methods, packages and player permissions depend on that game. You can also play with a MU* client or connect directly through the terminal; the guided introduction is not a required step.

Your account is your private sign-in. A character is who you play in the shared world. One account can own several characters; check which character you are playing before acting.

Select a character already listed on your account. To link an existing character that is not yet linked to an account, sign in and claim it with its character password rather than creating a duplicate. If it has no character password, ask staff for help. Account and character passwords are separate, but a MUD client connects to any character on your account with your account password: connect <character> <account password>.

PageWhat it is for
/register, /loginAccount signup and login, with a password, a passkey or a sign-in service
/charactersThe public character directory
/characters/newCreate a new character
/characters/claimLink an eligible existing character; see the guidance above.
/character/{name}A public character profile
/account, /settingsAccount details, passkeys and linked sign-in services, characters, theme (/settings/theme), notifications

Because the login is an account rather than a character, switching characters does not mean disconnecting and reconnecting. Staff reset a lost password from /admin/accounts. Guest access upgrades into a real character without losing the session.

/play is a full terminal in the page — telnet-equivalent access with no MU* client installed. It connects over a WebSocket served by the connection server, and out-of-band data from the game drives the live side panes.

The terminal connects to /ws on the portal’s own address, wss://<your-domain>/ws, and the proxy sends that path to the connection server’s /ws endpoint. See The browser terminal address for why this path goes to the connection server and not the game server.

A prompt is the line a game shows while it waits for an answer: a reader’s bb: [n]ext [q]uit, or the question an @input session asks. On telnet it is simply the last line. In the browser it sits in its own row just above the input box, so it stays in view however much output arrives, and any links in it (made with cmdlink()) can be clicked or reached with Tab and Enter.

When you send a line, the prompt is copied into the output above what you typed, so a saved log reads the same as a telnet session. A prompt from an @input session stays in its row until the session ends, whether you finish it, cancel it, it times out, or you disconnect; then the row empties. A one-off prompt from prompt() or @prompt goes as soon as you send a line.

&CMD`ASK Greeter=$+ask:@input/start What is your name? (q to skip)=q,INPUT`ASK`SKIP,*,INPUT`ASK`ANSWER
&INPUT`ASK`ANSWER Greeter=@pemit %#=Hello, %0.; @input/cancel
&INPUT`ASK`SKIP Greeter=@pemit %#=Maybe later.

Output: after +ask, the row above the input box reads What is your name? (q to skip). Answer Alice and the output shows the question, then Alice, then Hello, Alice., and the row empties because INPUT`ASK`ANSWER ended the session. Answer q instead and the session ends on that line, INPUT`ASK`SKIP runs and says Maybe later., and the row empties the same way. After the prompt, @input/start takes pairs of a line and the attribute it runs. The first pair is required and ends the session, so a player always has a way out; * stands for any other line.

For anyone writing their own WebSocket client: the connection server marks a prompt frame as {"type":"markup","data":…,"prompt":true,"session":"<id>"}, and when an @input session ends it sends {"type":"prompt","clear":true,"session":"<id>"} naming the same id. Take the prompt down only when the clear names the prompt’s session, or names none (sent after a reconnect when no session is waiting). A one-off prompt has no session. A client that ignores these fields shows each prompt as an ordinary line.

Wiki

/wiki — namespaced, categorised pages with full edit history and diffs. Approved characters and staff write and edit pages, a character’s own biography included; staff control who may edit what.

Mail

/mail — read and compose in-game @mail from the web.

Scenes

/scenes — browse logged scenes, and watch running ones at /scenes/active as poses land. On a phone, and for the schedule in a calendar app, see Scenes on a Phone. Scenes are part of the Scene System, a bundled application a new game has unless staff remove it.

Help

/help — the server’s own helpfiles, searchable, with working cross-links.

Games can also publish Dynamic Applications at /apps/{slug} — forms such as chargen or job requests, defined by admins as a softcode schema rather than written as web code.

Softcode layouts also render as native portal structure: boxes become panels, fields become definition lists, columns wrap on narrow screens, and figures show real images. The same softcode still produces terminal art and accessible reading order. See Visual Layouts and Images.

For running the game, use the Operator Handbook alongside this panel reference. The first-player readiness checklist is at /admin/onboarding; it is separate from the player’s interface guide. Keep the game’s own welcome and rules under staff control.

/admin is the staff dashboard. What a given staffer sees is governed by roles, not by a single wizard bit. The pages are grouped as the portal’s sidebar groups them.

  • /softcode — edit the attributes on objects you control, and try code in a console. See The softcode editor.
  • /admin/snapshots — capture a recovery point for an object, and restore fields from it.
  • /admin/jobs — run an attribute on a schedule, as your character.
  • /admin/diagnostics — queued and running work, and why recent work failed.
  • /admin/accounts — reset passwords, and disable, close or delete web accounts.
  • /admin/characters — find any character by name, account, flag or whether they are online, with a detail view for each at /admin/characters/<number>, where a role can be given to that character alone.
  • /admin/guests — the characters handed out to visitors who connect as a guest.
  • /admin/activity — when people play, who is drifting away, and which rooms are used.
  • /admin/roles — create roles, decide what each one allows, and assign them.
  • /admin/moderation — warn, boot, ban or unlink a character, with a reason.
  • /admin/audit — who changed what, in the portal and in the game.
  • /admin/wiki — publish, protect, file and bulk-edit wiki pages.
  • /admin/media — the image library, where staff lock a file to a permission.
  • /admin/suggestions — the word lists that suggest a fix for a mistyped help topic or function name.
  • /admin/messages — the connect screen, the messages of the day and the other texts a connection is shown.
  • /admin/scenes/types — how each kind of scene line reads in the portal. Listed only while the Scene System is installed.
  • /admin/applications — the Dynamic Applications published at /apps/{slug}.
  • /admin/layout — the portal’s own layout: which widgets appear on which pages, edited per scope in a layout editor.
  • /admin/themes — the portal’s colour themes, and which one players get. See Portal Themes.
  • /admin/packages — installed softcode packages, plus browse, remotes, review and author views. See Softcode Packages.
  • /admin/profiles — check and reset the softcode that serves character profiles.
  • /admin/server — uptime, connections, queue, storage and backups, read live.
  • /admin/backups — encrypted copies of the world sent to remote storage, on a schedule. See Deployment Reference.
  • /admin/config — the server’s configuration, grouped into categories and rendered as typed form fields, including array and dictionary values as editable lists. Its sub-pages are /admin/config/restrictions (command and function restrictions), /admin/config/sitelock, /admin/config/bannednames (disallowed character names), /admin/config/secrets, /admin/config/mssp, /admin/config/asciitranslations, /admin/config/import and /admin/config/apps (the apps that may act for players).
  • /admin/import — bring a PennMUSH, RhostMUSH or TinyMUX database into this game. With /admin/config/import this is a staged, one-way operation; use the migration runbook, not the upload form alone, to plan rehearsal, validation, cutover, and rollback.
  • /admin/discord — the bot, linked channels, role mappings and linked members. Listed only while the Discord application is installed.

/softcode is a Monaco-based editor for attribute code, with multi-tab editing, syntax highlighting, hover help drawn from the helpfiles, and signature help for functions. It shares its analysis engine with the language server, so the diagnostics it shows are the real parser’s, not an approximation.