Main window
Once you open KMuddy, you will be presented with the main window, where you'll spend most of your time interacting with your MUD. The window consists of the output area (where you see text from your MUD), the input line, the status bar, and optionally gauges, actions, and other output windows. Take a look below for a sample screenshot:
The KMuddy window supports multiple connections at once; by default, you'll see a tab bar on top with all connections you have - to switch between them, simply click on the profile tab you want or use keyboard short-cuts (namely Alt-PageUp/PageDown, and Alt-number).
The main KMuddy window, called the output window, is where you can see all of the interaction that you do with your MUD, and generally all other information about things that go on in that MUD. KMuddy supports ANSI colors, so if your MUD uses them, you'll be able to see text in it's full color. To see previously received text, use the scrollbar that's on your right. When you do so, the output view gets split into two parts; the smaller one (on the bottom) showing the latest text - so you can still keep track of what's going on, and the larger part allows you to traverse through the output history as desired. Middle-clicking in the output area will automatically scroll to the bottom - so you don't have to scroll all the way down manually. If you wish to move the dividing line higher or lower, the default option for that is Alt-Ctrl-Up/Down. The default size of the output window is 1,000 lines - you can change this in the Output area section of the Global Settings.
To copy text from the output window to the input-line or to other programs, either use quick-copy (select it and middle-click in target place) or using the regular clipboard. There are many ways in which selected text can be copied to the clipboard. These include:
/
Use the "Copy Selection" option when you right-click in the output window
Use the default keycombo Ctrl-Shift-S
Next is the input line - it's where you type your commands and aliases. To use it, simply type in whatever you wish, and press Enter - your command will be parsed then to see if it's an alias, and if it's not, it'll be sent directly to the MUD. But the input line offers much more flexibility than that. Under the Input Line settings in Global Settings, you can select to keep the text you sent, enable auto-completion, change the colors of the input line, enable an additional command line and much more.
The input line also comes in two input modes - standard, and multi-line input modes. When in the multi-line input mode, you can use Ctrl+Enter to make a new line (unless you enabled the "Swap Enter and Ctrl+Enter for multi-line" option, in which case pressing Enter will make a new line, and Ctrl+Enter will send the text).
Last but not least, you can also send text via a special multi-line input dialog - more on that here.
To paste text into the input line, you have several options:
/
Use the "Paste As" option when you right-click in the output window
Use the Ctrl+V keybinding
By using the quick-paste (middle click in the input line)
When you paste text with multiple lines into the input line, the new lines are converted to spaces - unless the input line is in multi-line mode, in which case the new lines are preserved.
When you type something into the input line and press enter, it will be first parsed for your aliases/internal scripting commands, and then if your command doesn't match them, sent to your mud (you can disable command parsing with / if you wish).
However, besides that, KMuddy also offers you special strings which make manipulating text much easier. They are the command separator, multi-command, speed-walk, internal command call, tab focus strings, and several special characters.
Command separator - a semicolon (;) by default, it separates commands (e.g. command 'look;say hello;n' will execute three separate commands: look, say hello and n).
Repeater - a number sign (#) by default, it is used to repeat a command multiple times. Usage: #<number of times> <command>. For example, entering #10 smile will send the smile command 10 times. Note that repeater is limited to 100 repetitions, unless you disabled that option. Also note that repeater is handled AFTER the line you've entered has been split into individual commands. That means that typing #10 smile; say Hi will send smile 10 times, but say Hi only once. If you want to repeat a set of commands (e.g., smile, say Hi, smile, say Hi, ...), you can either use an alias or write an external script.
Speedwalk - a dot (.) by default, this accepts following letters/numbers which are treated as speed-walk commands - that is, one walking command is issued for every letter here. Note that you can customize those commands for profile-based connections in - - .
The following characters are recognized for the speedwalk:
n : command for North
e : command for East
s : command for South
w : command for West
j : command for North-East
k : command for South-East
l : command for South-West
m : command for North-West
u : command for Up
d : command for Down
1-9 : repeat following command (numbers bigger or equal to ten are NOT valid. Instead, use the same direction an needed number of times - eg., if you need to do fifteen 'e' commands, do .9e6e). A typical Speed-walking command looks like this - .ne3n2je4ked, which would mean North, East, North, North, North, North-East, North-East, East, South-East, South-East, South-East, South-East, East, Down.
Internal command call - a forward slash (/) by default, this string invokes the internal scripting commands.
Tab Focus - a colon (:) by default, this string sends text to a different tab window - the syntax is :tab window name: commands. For example, if you want to send some text to a tab named Me@MUD, you'd do :Me@MUD: hi.
Special characters - these start with a backslash (\), and do several useful things:
\n - means end of line, it can serve as another command separator,
if you disable the standard one for any reason. It is also possible to enable this
sequence only in aliases and triggers. So for example, doing look\nsay hello\nn will cause look, say hello, and n to be sent.
\t - expands to a TAB-character. Note that KMuddy does not display TABs properly - it merely ignores them.
\m can be used to launch external scripts. Handy if you disable the
standard script-character. Note that there mustn't be any space between \m and
script name. Also note that it is possible to enable this character only for aliases
and triggers. Refer to scripting section for more
information.
Please note that external scripting is available as a plug-in, so it will not work if it's not loaded.
Backslash followed by anything else is merely ignored (can be disabled).
Note that \\ (double backslash) can be used to
send the '\' character. This only applies if backslash expansion is on.
Don't forget that if you accidentally start sending a lot of commands, you can cancel them (if it's not already too late :P) with /
KMuddy also has a command history feature - try it out! To use it, just use the Up and Down arrows to scroll through it.
Note that some buttons are profile-based, and won't be accessible until you open one.
Establishes a new profile-based connection, and manages profiles. See connecting with KMuddy for more information.
Establishes a quick connection. Note that advanced features (aliases, triggers, etc.) are not accessible in this mode, as no profile is used.
Closes current connection (if any). It should be safe to use this without going net-dead, as it sends out a customizable quitcommand and then disconnects.
Re-opens last connection opened in this tab. This is only available after a connection is closed.
Closes current tab. Only available after the connection is closed and if there is at least one more tab.
Saves all settings and quits KMuddy.
Copies the currently selected text in the main output window to the clipboard.
Pastes text from the clipboard into where the cursor currently is.
Enables/disables command parsing (see the entering commands for more info). When this option is disabled, commands are sent out exactly as you've typed them without any interpretation by KMuddy.
Cancels all commands that were issued but not yet sent, in case you've gotten yourself into a large loop.
Shows/hides a multi-line input dialog, which allows you to type more commands and send them all at once. The large box is where you can type the text to be sent; you also have an option of filling in the 'Prefix' and the 'Suffix' fields. When you add something to either of them, it'll be prefixed/suffixed to every line in the big output box.
Displays an alias groups dialog, where you can manipulate them. See alias groups for more information.
Displays a trigger groups dialog, which is similar to alias groups. See trigger groups for more information.
Displays action toolbar where all buttons are mde. This is only available for profile-based connections - more information here.
Displays which scripts are currently active. See external scripting for more information.
Shows Connection statistics dialog. Here you can see some information about the active connection, such as whether MCCP/MSP is used, how many bytes/lines/commands have been sent/received so far, and connection time. The data displayed here is updated each second.
Manages aliases for current profile-based connection. More information on using aliases is avialable here.
Manages triggers for current profile-based connection. More information on using triggers is avialable here.
Manages a list of variables available for current profile-based connection. More information here.
Manages action toolbar buttons for current profile-based connection. More information here.
Manages a list of timers available for current profile-based connection. More information here.
Manages a list of macro keys available for current profile-based connection. More information here.
Manages a list of variable triggers available for current profile-based connection. More information here.
Manages a list of status variables available for current profile-based connection. More information here.
Manages a list of gauges available for current profile-based connection. More information here.
Manages a list of output windows available for current profile-based connection. More information here.
Manages a list of tick timer available for current profile-based connection. More information here.
Manages a list of scripts available for current profile-based connection. More information here.
Allows you to modify preferences for current profile-based connection. More information here.
Allows you to enable/disable all aliases.
Allows you to enable/disable all triggers.
Allows you to enable/disable all timers.
Allows you to enable/disable all macro keys.
Enables/disables/configures session transcript. More information here.
This will dump the output buffer to a file.
Writes a random sentence. You can use this when in doubt and no dices/coins are available. here.
Will export all profile settings, aliases, triggers and so on into a file. Useful to make backups and to transfer profiles between more computers.
Imports a profile previously exported with the Export profile command.
Hides the Menubar from view (can also be shown or hidden via the main window context menu).
Enter/Exit from Full Screen Mode (can also be done via the main window context menu).
Global settings (not profile-based). More information here.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team