MUDMaster Help
Note: 1.3.0 is out and fixes the sticky keyboard issue. If your text color is black on black, type appset basecolor default. If you experience strange behavior after the latest update, you may have corrupt settings--try removing app completely and re-installing.
KEYBOARD INPUT
Tap
to toggle the keyboard:
COMMANDS
Console commands are a quick way to access app features while playing.
apphelp - Displays this help file. Read it all to make sure you're getting the most out of this app!
appset bgcolor black - Changes the background color. Any web color is valid, e. g. "black" or "#000000". To use the default textured background, set to "transparent".
appset basecolor white - Changes the base color (all non-colored text). Any web color is valid, e. g. "white" or "#FFFFFF"
appset font consolas - Changes the display font on the fly. Valid font names are shown in the font wheel under settings. If the font name is not valid, the display defaults to Times until changed.
appset fontsize 12 - Changes the base font size on the fly. The base font size controls line wrapping & zooming to width.
apptime - Shows the iPhone status bar for a bit so you can see current time, connection type, etc. Set the status bar frequency to 0 in setup to disable status bar flashing.
appset prompt - Toggles autocorrection on/off
applock (v1.2.2+) - Locks or unlocks orientation changes.
appmap (v1.2.3+) - Toggles non-breaking spaces between characters. This enables ANSI map recognition and proper display (when a monospace font like Consolas is used). It's also helpful if you don't want text auto-wrapping. This option may degrade performance significantly on servers with lots of indents so disable it if you don't need it.
scrollback 6 - Sets scrollback length to approx. 6 landscape screens and saves it to preferences. Note that scrollback length affects responsiveness dramatically, especially on older devices, and especially with ANSI colors enabled.
apprc (v.1.2.9+) - Toggles auto-reconnect on/off. The default setting is on.
rc (v.1.2+) - Attempts a reconnect to server. Useful when you 'lag out', change connection type, or the app appears to freeze.
enc (v.1.2+) - Type enc to list all available encoding commands. Type enc chinese trad to change the encoding to Chinese Traditional. Saved to preferences. Use only if you're sure you need it!
appmain | appquit | appexit (v.1.2.3+) - Return to main server connect menu. Equivalent to shaking the device if you have enabled appshake.
apptrans (v1.2.8+) - Toggles transparent keyboard mode on/off during an active session.
macro (show | v1.2+ macro1 | macro2) - The entry command(s) for all macro management.
trig - The entry command for all trigger management. See below for more details.
email - Email yourself or someone else a copy of the current log.
TOUCHES
Touches provide intuitive access to certain app features while playing.
Press both south and west button. Release. - Sends a diagonal movement command, e. g. 'southwest'.
Single-tap area under macro wheel(s). - Exposes macro wheels if hidden.
Double-tap area under macro wheel(s). - Hides the macros if shown.
Tripple-tap area under macro wheel(s). - Hides the macros as well as the directional buttons. 3-tap again to expose directionals.
Double-tap a macro button. - Kicks off the macro shown.
Pinch, double-tap main text area. - Resizes, scales text to fit window.
MACROS (CUSTOM BUTTONS)
Set up an unlimited number of server-specific custom buttons. They can send one or more commands quickly, including variables.
Configured macros appear at the top right corner as a vertical scrollable wheel of buttons when you connect to a server. Flip the macro menu vertically and 2tap on the active macro to kick it off. Note that if you extend the keyboard and type a few letters, the macro menu will jump to any macros that start with these letters.
To set up a new macro, connect to your preferred server, then type macro(1|2) name action1;action2...'. On v1.2+, the commands are macro1 and macro2 for each of the macro wheels.
To set up a macro with multiple actions, use semi-column. For example:
macro(1|2) sarm smile;cast 'armor' self;cast 'agony' dragon
To set up a macro with variables, use special chars $1, $2, $3, .., $*.
Examples:
macro(1|2) sarm smile $1;cast 'armor' $2;wait 10;cast 'agony' $3
macro(1|2) say emote whispers, '$*'
To kick off a macro with arguments, type, e. g. 'sm James me dragon', listing all the arguments. The $* argument means all the macro arguments will appear in that position and you will whisper a line instead of saying it.
To delete a macro named 'sarm', type 'macro(1|2) sarm' when connected to the server for which this macro is valid.
v1.1+
macro show prints a list of all macros defined for the current connection.
You can sort macros by typing: macro(1|2) up|down - shift the current macro one position in the specified direction on the macro wheel.
v1.2+
You can add macros by 2tapping an always present 'add macro' button on each of the two macro wheels.
v1.2.9+
You can use any "app*" commands in your macros. For instance, to go to main menu after quitting the game: "quit;appquit".
v1.2.2+:
You can send ad hoc macros / multi-commands by typing them directly into the text input field. For example, smile;laugh will send these two actions together to server. Add a space before or after ';' to prevent it from being interpreted as a series of commands, e. g. 'say hi; i used a semi-column'.
You can also type macroname1;macroname2 to kick off two macros together.
Typing 2macroname will send the same macro twice, etc. Up to 100 repeats are supported (not just for macros, but for any commands, e. g. 5bash).
If your macro has a wait command at the end, then repeating it enables interval commands, such as eating every 120 seconds. For example: add 'macro autoeat eat bread;wait 120', then type '100autoeat'.
You can send multiples of any action by adding a number in the front. For example, the macro 10s;3kick ogre;2flee will send 10 moves south, 3 kicks, and 2 flee attempts. This can also be typed directly as a multi-command (doesn't have to be saved as a macro).
TRIGGERS
back to top
Response triggers will kick off one or more actions when a certain event occurs. They can also kick off a sound effect or drive a status bar (see below). Triggers are organized in sets/groups which are totally independent of current server or character and can be enabled/disabled at any time. Up to two wildcards ($1, $2) are supported.
trig list - Shows a list of available trigger sets/groups.
trig on healer - Loads or initiates a trigger set called 'healer'. You can also name trigger sets after a character, e. g.
trig off - Unloads/disables the active trigger set, if any.
trig show - Lists the triggers in the active trigger set, if any.
trig attach - Attaches the active trigger set to the active session on connect. Very useful for auto-login sequences.
trig $1 growls at you=cast 'blind' $1;grin - Adds a new trigger to the current set, but only if a set was loaded/inititialized first using 'trig on setname'. Note that there is no space before = since every character before '=' is matched against.
trig $1 growls at you - Deletes the trigger '$1 growls at you' if found in the current set.
trig del - Deletes the entire active trigger set, if any.
More examples:
trig The hour passes=eat bread;drink cup - autofeed your character every game hour.
trig $1 says, 'assist me'=assist $1 - autoassist any player who requests it.
trig $1 tells you, '$2 me'=cast '$2' $1 - autocast any spell on a player who requests it.
Tip: If your trigger is not firing, try putting a '\' in front of any special characters in your keyphrase, e. g. trig dying\?=cast 'heal'. If the phrase you're keying off of seems to have multiple spaces (e. g. is indented by the server), you can try putting ' ' (non-breaking space) for every space.
v1.1+:
You can use a trigger to kick off any simple macro (w/o arguments) by referencing its name. E. g. 'trig The hour passes=eatmacro'.
v1.2.4+:
Up to three status bars (red, blue, green):
These will appear automatically when you set up special triggers to grab the current and maximum value you want displayed.
Example:
prompt: [83/100health 49/100mana 92/100move]>
triggers:
trig [rr/RRhealth=redbar
trig bb/BBmana=bluebar
trig gg/GGmove]=greenbar
The capital letters reflect the placement of the maximum value. The bars will then appear, and your prompt will become ">" If you configure the greenbar trigger to include ">", then your prompt will be "consumed" entirely.
If you're grabbing the numbers from a command as opposed to a prompt, you may have to configure a repeated timed macro (using 'wait') to ensure that the status bars get refreshed automatically.
(v1.2.4+) Bar-driven triggers:
If you have one or more status bars enabled, you can define triggers that will kick off when the bar reaches a certain level. Excercise caution when defining such triggers because they will keep firing as long as the condition remains true. This may cause an infinite loop and lag you out of the game/app. It's usually a good idea to use 'wait' in such triggers.
Example:
trig redbar10=cast 'heal' self
- Casts heal spell when your red bar falls to 10%.
(v1.2.4+) Trigger-driven sound effects:
Note that enabling sound effects will stop any iTunes music that may be playing in the background.
Example:
trig The bells of the city tower mark an hour's passing=belltower
trig tells you=ding
Sound Effect Keywords:
alert
sword
coin
paper
levelup
jungle
lion
ocean
rainforest
river
rain
storm
swamp
thunder
thunderrain
thunderstorm
wave
evilmagic
farm
forest
badmagic
bellower
ding
goodmagic
heartbeat
newmail
v1.2.9 RELEASE NOTES
back to top
- After a long delay due to technical issues on Apple's side, version 1.2.9 is finally out. Here's the list of changes and fixes:
- Fix for iOS5-specific issue where some text is hidden by the keyboard in landscape mode.
- Fixed multiple issues with quick orientation changes and exits to main menu sometimes messing up keyboard and UI elements.
- Improved speed of ANSI color processing for better overall responsiveness in color mode.
- Added new monospace fonts from the list of best / most popular.
- Added "apprc" command to turn autoreconnect on/off.
- Fix for app crashing on empty data packages, such as when typing "skills" in Dark & Shattered Lands. Fix for app crashing if the user suspends it, locks device, unlocks device, and returns to app.
- Added option to change the background color and base text color (in color mode only for now). The commands are 'appset bgcolor' and 'appset basecolor'. The color can be any CSS string (e. g. '#ff00ff', 'darkblue'). Default for background is 'transparent', which now shows off a new brushed steel texture.
- Added Russian encoding support. Use 'appenc' to enable.
- Added an option to quickly import some popular games listed on mudconnect.com if your quick connect menu is empty.
- You can now add "app*" commands in your macros. For instance, to disconnect without auto-reconnecting: "quit;appquit"
- Disabled unreliable app notification when suspended in background. Suspended app now exits to main menu when the OS is about to shut it down (9:30 min).
- You can now multiply individual commands without needing to end them in semi-column, e. g. "3bash" instead of "3bash;"
- Increased default scrollback size. Made app autoselect monospace font (Courier) when the user enables "appmapp". Monospace font+appmap detection is now default.
- Transparent keyboard mode now allows the user to retract the keyboard temporarily.
- Version 1.2.8 fixed some rotation issues, added European language support, and also 'exit' and 'help' buttons which will appear sometimes when you tap the area under the macro wheels. Since v1.2.8 you can override the directional buttons using macros called 'east', 'west', etc.
- If you're on an older version and experiencing a blank screen when connecting to some servers, type 'enc ascii' into the blank screen, then close the app fully and restart.
- Read all of this help file to make sure you're getting the most of this app. It has a lot of hidden power. Type 'apphelp' at any time to access this file while playing.
- This app is under active development. Email any issues and questions to mudmaster@eyecandid.com or use the [issue?] button in the main menu.
- Performance tip: On versions prior to 1.2.3, lower the scrollback buffer under settings. On v1.2.3 and later, also try disabling color support (speed mode) in settings. If you select speed mode and begin to see strange characters, disable ANSI colors in your server/game preferences (the command for doing this varies so consult your game's help files).
- Stability tip: If your wifi is weak or inconsistent, switching to 3G may be better, and vice versa. At this point, nearly all app crashes are caused by network issues or iOS not liking networking in the background. If you can reproduce an app crash during normal play, please report it immediately by email mudmaster@eyecandid.com or web form.
- FAQ: Will MUDMaster support multitasking? A: It will when iOS does. Currently, iOS4 will kill the network connection of any non-VoIP app running in the background for more than ten minutes. If you return to the app within that time, your connection will still be up and it will 'feel like' multitasking. Otherwise, you'll need to reconnect (since v1.2.3 auto-login via "trig attach" is easy).
back to top