WizTerm32 User's Manual


Features

Input line

allows you to see and edit your input uninterrupted by output from the game. See CursorUp/CursorDown.

Auto-capture of player names

from the WHO and QU commands puts player names on F keys so you don't have to type them in for chatting and attacking. See F1..F10.

Auto-capture of score, hit points and hits

displays this vital data on the status line.

Back scroll buffer

captures your entire session and lets you go back to review it. See ScrollLock and PageUp/PageDown.

Automatic logging

writes all game output to a log file, whose name matches the current date.

Accessible configuration file

lets you modify fonts, colors, logging, etc. See WizTerm32 Config File Format.

Split screen for snooping

allows you to make extra good use of the mirror.

Multi-line input

If you type in a line containing pipe symbols ("|"), then the line will be sent to the game as multiple lines, broken where the pipe symbols are.

Hotkeys

You can define the keys ALT-A through ALT-Z to send any commands you want, including multi-line commands, to the game. See $KEY for details.

Aliases

You can define a short, simple word as a substitute for a longer, complicated word or an entire phrase. See $ALIAS for details.

Macros

Macros are like aliases, but they only substitute for the first word of a line of input, so they're especially suited for renaming commands. I plan to make macros even more powerful soon. See $MAC for details.

Commands

$ALIAS word1 word2

allows you to substitute a simple word for a complicated word or phrase. Example: $ALIAS smo Smotricz saves me some of the drudgery of typing my name. This abbreviation will then work in commands like GIVE CROWN TO smo. Note that "word2" can be an entire phrase, too. Try not to redefine important words used in the game; WizTerm32 doesn't check for this and it may mess you up to have access to these words.

$ALIAS word1
lets you un-alias "word1".
$ALIAS
by itself shows you all currently defined aliases.

$CONN (host) (port)

connects to the main MUD1 host to play the game.
The default (host) and (port) are 'british-legends.com' and '27750', respectively, so normally $CONN is all you need. You can change the default host and port in the configuration file. If you only enter a host (no parentheses!), then that host is used with port 27750. If you enter a host and port, then that host and port are used. For use as a 'normal' telnet client, specify a host and port '23'. Don't be surprised if it looks funny.

$DRINK

allows you to drink, repeatedly.

$FULL

un-splits your display (see $HALF).

$HALF

splits your display, for watching other players (if you can). Some people prefer to have their screen split top-to-bottom instead of left-to-right. If you are one of these, you can set HorizontalSplit=1 in the config file.

$HELP

summarizes some of this information.

$KEY letter command

lets you assign a command of your choice to any of the keys ALT-A through ALT-Z. You can "do" multi-line commands by inserting the pipe symbol (" | ") where you want line breaks, and you can position the cursor in the last (or only) line for modification in the command line by inserting an at-symbol (" @ ") where you want the cursor. If my explanation doesn't make sense, just try it out!

$KEY letter
with no defined phrase un-defines the hotkey.
$KEY
by itself shows you all currently defined hotkeys.

$MAC word = phrase

lets you define commands of your own, where phrase will be substituted for word whenever you type it in at the beginning of a line. Remember the equals sign (" = ") between the word and its definition!

$MAC word
with no defined phrase un-defines the macro.
$MAC
by itself shows you all currently defined macros.

$QUIT

terminates the program. An alternative to Alt-F4 or the 'X' button in the top right corner.

Keys

ScrollLock

  • If the back scroll window is open, closes it.
  • If not, and the back scroll window was opened before, opens it at the last position viewed.
  • Otherwise, opens it at the top, i.e. the beginning of the session.

PageUp

If the back scroll window is not open, opens it at the very bottom, i.e. displaying the most recent events. If it is open, scrolls up by one screen in the buffer.

PageDown

If the back scroll window is open, scrolls down by one screen in the buffer.

CursorUp/CursorDown

If the back scroll window is open, lets you scroll up and down by one line in the buffer. If it is closed, lets you scroll up/down in the list of commands you have entered in the current session.

Esc

  • If the back scroll window is open, closes it.
  • If it is closed, clears the input line.
  • If the input line is clear and you are not connected to the game, exits the program.

F1..F10

Automatically set up with the names of up to 10 players currently seen in the game, as taken from the output of WHO or QU. QU output does not capture novices.

Ctrl-B or Break

Sends Ctrl-C to the game, which interrupts a currently executing string of commands, such as a long path separated by periods.

Ctrl-I or Tab

Inserts a Tab character in the command line. This was useful with some rare commands in the original game, but is currently not supported in-game.

Ctrl-T

Sends a Ctrl-T to the game. This causes the game to return a timestamp for accurate timing of events in a log.

Ctrl-U

Clears the input line. If the input line is empty, sends Ctrl-C to the game (see Ctrl-B, above).

Numeric keypad keys

Keys 1 through 9 on the numeric keypad (the very right of your keyboard) take you in the 8 directions of the compass as well as in (that's the '5' key). The '-' (minus) key takes you out. You need to have NumLock active in order for this to work. If you don't like this feature for some reason, you can set KeyPadDirs=0 in the config file to turn it off.

Status line

The status line shows you the following useful information:

Score

auto-captured from the output of SCORE or QS and updated when the game shows you a [score update].
Stamina
Auto-captured from the output of SCORE or QS.

Hits taken

aounted up by 1 in most cases when you take a hit in the game. This counts hits, not stamina, and is only there to give you an idea of how much stamina you may have lost. You should use QS to update your stamina display and clear the hit count. Your stamina display will start blinking if you're hit, to remind you that you're in danger, that the displayed value is not accurate and that you should QS to learn the truth.

Real World Time (RWT)

as taken from your PC's internal clock.

British Legends Time (BLT)

shows the number of minutes you have been playing in the current session.


Back to Sirsloth's Wizterm Page