In-Client Help

Using This Guide

This guide covers the game client itself, meaning the Game panel where you read the game text and enter commands, as well as the interactive map, hotkeys, sound alerts, and other built-in features. It doesn't cover gameplay tips or in-world mechanics.

Gameplay Help

For help with gameplay (e.g. creating a character, learning game commands, entering combat, and taking on quests), you can either enter the command help into the game panel, or follow this link to view the game guide .

Shop

Open the MM Shop in a new tab, to purchase Reward Units which can be spent in-game.

Terminal Connection Indicator

This will turn red if you become disconnected from the game server at any point. You can click the indicator to reconnect.

Bug Reports

If you see something not working correctly in the game client or the game itself, you can let us know here.

Announcements

Here, you'll find announcements of new features, scheduled maintenance, updated patch notes, etc.

Use Simple Layout / Use Mosaic Layout

Toggle between the two layout modes for the game client. Simple mode is recommended for visually impaired players; it has a fixed layout and does not include a map. Mosaic mode is a customizable layout with draggable panels and a map.

Reset Mosaic Layout

Restore the default layout for mosaic mode.

Lock Tabs

Toggle this setting to control whether panels can be moved. Turning it on prevents accidental rearrangement of your layout (this can be especially useful on devices with small screens).

Search History

A searchable history of your previous commands and game text.

Client Patch Notes

Check here for new features, bug fixes, and improvements to the Game Client.

Client Known Issues

Before submitting a bug report, you can check here to see if it's something we're already working to fix. Thank you for your patience as we work to improve the Game Client.

Logout

This allows you to log out of the game client.

Note: Typing quit into the game terminal allows you to quit the game itself, without logging out of the client.

Overview

The game panel is where you read and respond to the game text. The game will prompt you for input, which you can enter into the text box at the bottom of the panel.

Mapper Commands

The game client has a map to make it easier for players to navigate their way through Alyria. Although you can interact with the map directly by clicking on rooms and menu options, you can also use keyboard commands to travel around on the map. As well as the cardinal directions (n, ne, e, etc), you can use mapper commands to travel longer distances quickly. The syntax is 'mapper goto ROOM', where ROOM is the number of the room you want to travel to. For example, mapper goto 5113.

Tip: Mapper commands can be aliased to save time. You could, for example, type mg instead of mapper goto. See the Aliases help section to learn how to set this up.

For a full list of mapper commands, enter mapper help into the game panel's text box.

Client Commands

If you prefer to control the game client through keyboard commands, you can perform actions like clearing your panel histories, toggling tab-lock, and toggling your stat bars through the client command system.

Tip: Client commands can be aliased to save time. You could, for example, type lt instead of client lock-tabs. See the Aliases help section to learn how to set this up.

For a full list of client commands, enter client help into the game panel's text box.

Clickable Game Text

The game text contains underlined items, such as shops, NPCs, and signposts, which you can click or tap on to open a menu of relevant actions. For example, when you encounter an NPC, you might notice that the text mentioning them is underlined. Clicking on the text will give you a list of available actions for interacting with that character.

Command History

If you're using a keyboard, the 'up' and 'down' keys let you navigate through your previously entered commands. For a more detailed view of previous commands, including game text and a built-in search feature, you can use 'Search History', which is found under the main Game Client menu.

Split History

You can split your terminal and freeze the top half as a snapshot of everything shown so far. The bottom half will continue with live game output. Use the command client split-history, or scroll up to automatically open a second pane (the split-on-scroll behavior can be toggled off in Settings).

Chaining Commands

You might want to enter several commands at once, to speed up your gameplay. You can chain commands by using a semicolon (;) to separate them. For instance, the chained command for traveling south, east, east again, then checking the weather in the new location, would be s;e;e;weather.

Tip: You can toggle command chaining and customize the separator from the Settings panel (under General) or with client commands in the terminal.

Quick Actions

Beneath the terminal input, a row of quick action buttons gives you one-tap access to commonly used commands. The Defaults toggle displays a group of commonly used built-in actions, and you can also add custom quick actions of your own.

Each custom quick action can be set to either send its command immediately when tapped, or start the command in your input field so you can type a target after it. For example, inventory works well as a send-action, while get is better as a start-action so you can add the item name before sending.

Tip: You can also add, edit, and remove your custom quick actions in the Settings panel, under Quick Actions Management.

Overview

This is where you can find a detailed view of your character's current vital stats and character information.

Statistics

View your character information, worth, and attributes.

Overview

The Quests panel displays your character's current quests. You'll need to be logged in to your character to view them.

Usage

Sort your quests by time, type, and ID, and search by keywords. You can toggle the countdown for timed quests to show real time or Alyrian time (see the Quests options in Game Client Settings). Click on a quest to view more information about it, including its rewards and requirements.

Overview

The interactive map shows where your character is within the world of Alyria and gives you an additional way (alongside mapper commands) to fast-travel between locations in your current area.

Area Name

At the top-left of the map, you'll find the name of the area you're currently viewing.

Rooms

The map displays rooms within the current area, along with the connections between them.

Note: All visitable locations are known as 'rooms', whether they're indoor spaces, sections of road, or other outdoor locations.

Connections

Connections between rooms can be two-way (indicated by a line connecting two locations) or one-way (indicated by an arrow connecting one location to another). For example, if you exit a room by travelling north through a one-way connection, you won't be able to travel south from there to return to the previous room.

Current Location

You can see your current location by looking for the @ symbol.

Points of Interest

Some rooms contain symbols to show points of interest, such as shops and transportation. See Map Settings for more information on the map legend.

Waypoint Routing and Excluded Rooms

Shift+click rooms on the map to mark them as waypoints. Waypoints appear as numbered orange rings on the map. When you 'Go to room', your route will pass through each waypoint in numerical order before reaching the destination. In the terminal, the mapper goto command also supports a --via flag for specifying waypoints.

You can also do the opposite and exclude rooms when quick-traveling with 'Go to room'. Right-click a room to toggle 'Exclude room from routing' on and off. If you have multiple excluded rooms, the right-click menu also offers a 'Clear excluded rooms' option to remove them all at once.

Note: a room can't be both a waypoint and an excluded room at the same time. Marking one will clear the other.

Map Tools

Zoom In/Out and Re-Center the Map

These tools are in the bottom-right corner. Note that on mobile, you'll see only the 'center map' button since you can pinch to zoom. The map will center on your character's location, unless you have another room selected. Click or tap on a room to select it.

View Room Information

Once you have a room selected (its border will be highlighted), you can view room information by clicking the Room Info button in the bottom-left of the map. You'll see the room's name, ID (an identifying number which is useful for fast-travelling), description, exit directions, and tags showing which gameplay rules or restrictions apply in the current room. Tags may also let you know about dangers or helpful features of the room.

Context Menu

Right-click in the main map panel, or long-press on mobile, to view the context menu. This lets you clear a selected room, reset the map's zoom level, and choose whether to center the map on your character or the current selected room. Opening the context menu on a room gives you travel options, including travelling to that room or displaying the fastest route to it.

Minimap

The minimap is a small overview map displayed at the bottom of the map panel. It shows your current location (marked with a pin) within the wider world map of your current area, giving you a sense of your position at a glance.

You can collapse or expand the minimap using the toggle at the bottom of it. Minimap visibility and appearance can be configured in the Game Client Settings.

Map Settings

You can find the Map Settings menu in the top right corner of the map.

Note: All settings in the Map Settings menu are stored at device level, not account level (there is more information on this in the main Settings panel).

Search

This allows you to search for rooms within your current area by name. You can search for a resource such as a 'bank' or 'tavern' this way. Open the search results for a room to get additional actions: go to the room (fast travel), see the path to the room highlighted, or center the map on the room.

View Options

Travel Options

When you preview a route using the context menu, by default it will remain highlighted until you manually clear it. The toggle in this section allows you to clear it by clicking away.

Map Legend

This lets you identify passages (connections between rooms, such as doors, windows, and stairs) and points of interest on the map. Additionally, it allows you to toggle their visibility on and off individually. For example, you could toggle off all markers except shops and characters or show only death traps.

Overview

The Atlas is a region-level view that complements the room-level Map panel. While the Map shows the rooms and connections within your immediate area, the Atlas shows your character's position on the broader regional map, giving you a sense of where you are in the world at a glance.

Current Region

A banner at the top of the panel displays the region you're currently in. The Atlas automatically switches to the relevant map when your character crosses into a new region. Some areas of the world are intentionally left for you to discover without a regional view. In those areas, the panel will let you know that no Atlas is available.

Player Marker

A pin shows your character's current location on the regional map. As you walk, the pin updates to follow your character. The pin color can be changed in Game Client Settings under "Map pin color" (the same setting also controls the minimap pin color).

Map Tools

The zoom and recenter controls are in the bottom-right corner.

Zoom In/Out

Unlike the Minimap overlay for the room-level Map, the Atlas allows you to zoom in and explore your current region in detail.

Recenter

The recenter button snaps the view back to your character's current location.

Standalone Atlas

The Atlas is also available as a standalone page on the Materia Magica website: Atlas page.

The standalone version can be explored without logging in, and includes a region selector so you can freely switch between maps to look around the world.

Overview

Aliases are text shortcuts for longer commands.

Usage

Example: A psionic who frequently casts the spell 'telekinetic punch' in combat could set tkp as an alias for the command cast 'telekinetic punch'.

Because aliases can take arguments, client and mapper commands can be aliased. For instance, mapper goto could be aliased as mg so that you can simply type mg 1234 instead of mapper goto 1234. Aliases can also span multiple words and chain several commands together.

Open the Aliases panel for detailed instructions, including the syntax for argument markers (%1–%9 and %*), and to start setting up your own aliases.

Notes

• The game has a built-in aliases system which allows you to create and manage aliases through the Game Panel (enter the command help aliases into the game panel's text box to learn more). Aliases made this way won't appear in the game client's Aliases panel, as these are separate systems. For simplicity, we suggest choosing one system or the other rather than using both at once.

Overview

You can set up keyboard shortcuts using hotkeys. Hotkeys are a combination of keys that trigger a given command.

Usage

Choose between Send and Start actions:

• Send: This sends the command immediately.
• Start: This queues the command in the text box until you press Enter.

Open the Hotkeys panel for more detailed instructions and to start setting up your own hotkeys. You'll find some defaults in place, which you can edit to suit your own needs.

Overview

Captures look for specific lines of game text and store it in a dedicated panel when a match is found. This is useful because game text often includes important details about your environment, like interactions with NPCs and other players, and isolating those key lines makes it easier to find the information you care about.

Usage

The Captures feature has two pattern modes:

Simple Mode

Accepts plain text, like tells you. Captures made using this mode will return the entire line of text where the capture text is found (case-insensitive). For example, A dwarf tells you "XYZ".

Advanced Mode

Accepts a full regular expression (regex). The capture will only occur when the text matches your pattern exactly. When adding or editing a pattern, you can use the built-in tester to check that your regex works as intended.

You can toggle between Simple and Advanced modes when creating a new capture.

Open the Capture Settings panel to find more detailed instructions and to start setting up your own captures. A set of default capture patterns is available. You can turn them on or off, or use one as a starting point when creating your own.

Tip: You can choose an output panel when setting up a new capture in Capture Settings. By default, captures are set to store the relevant game text in either the Captures or the Chat panel, but it's also possible to set up Custom Panels through the Game Client Settings.

Overview

Triggers look for specific game text and run a command of your choosing when a match is found. You can use them to respond to events and automate behavior.

Usage

The Triggers feature has two pattern modes:

Simple Mode

Accepts plain text, like tangle vine. The trigger runs its command any time that exact text appears in a line of game output (case-insensitive). For example, both A tangle vine twists around your feet. and You see a tangle vine. would activate the associated command.

Advanced Mode

Accepts a full regular expression (regex). The trigger will only fire when the text matches your pattern exactly. When adding or editing a trigger, you can use the built-in tester to check that your regex works as intended.

You can toggle between Simple and Advanced modes when creating a new trigger.

Open the Trigger Settings panel for more detailed instructions on creating triggers.

Overview

The Sounds feature works similarly to Triggers: it looks for specific game text and plays a sound of your choosing when a match is found. You can use it to alert you to events in the game or just to add atmosphere.

Usage

The Sounds feature has two pattern modes:

Simple Mode

Accepts plain text, like tangle vine. The sound trigger plays its assigned sound any time that exact text appears in a line of game output (case-insensitive). For example, both A tangle vine twists around your feet. and You see a tangle vine. would activate the same sound.

Advanced Mode

Accepts a full regular expression (regex). The sound will only play when the text matches your pattern exactly. When adding or editing a sound trigger, you can use the built-in tester to check that your regex works as intended.

You can toggle between Simple and Advanced modes when creating a new sound trigger.

Once you've set a pattern, choose a sound for your trigger from the preset sound library. You can play sounds to preview them before selecting.

Open the Sounds panel for more detailed instructions and to start setting up your own sound triggers.

Overview

Filters remove lines within the game text, preventing them from being displayed in the game panel or processed by the game client. It’s a way of removing any information that you’re not interested in seeing.

Usage

The Filters feature has two pattern modes:

Simple Mode

Accepts plain text, such as a butterfly. Filters made using this mode will filter out the entire line of text where the pattern is found (case-insensitive). For example, the whole line A butterfly flies past would be removed.

Advanced Mode

Accepts a full regular expression (regex). The filter will match exactly what your pattern describes. When adding or editing a filter, you can use the built-in tester to check that your regex works as intended.

You can toggle between Simple and Advanced modes when creating a new filter.

Note: If a line is filtered out, it will continue to activate relevant capture patterns, triggers, and sound triggers.

Open the Filters panel for more detailed instructions and to start setting up your own filters.

Overview

Timers automatically run one or more actions at a set interval, so you don’t have to type repetitive commands manually. For example, you might send a command every few minutes, or play a sound as a regular reminder.

Usage

Open the Timers panel, click the Create New Timer button, set an interval (how often the timer should fire), and add one or more actions. A single timer can hold several actions, and they all run together whenever the timer triggers.

Action types

Choose an action based on what you want the timer to do:

• Send: Runs the command in the game, just as if you had typed it and pressed Enter.
• Echo: Prints the text to the game panel only. It is shown to you but not sent to the game.
• Info: Prints the text to the Logs panel.
• Play: Plays one of your sounds.

Chaining commands

Within a single Send action you can run several commands at once by separating them with a semicolon ; (or your custom command separator). Example: score;inventory would check your score and inventory together.

Open the Timers panel for more detailed instructions and to start setting up your own timers.

Overview

The chat panel stores conversational game text such as Clan Talk, Formation Talk, and uses of Tell, Talk, Shout, Yell, and Chat. To do this, it makes use of Captures. The captured game text will still be displayed in the main Game panel; this is simply a more focused way to view conversations in the game.

Usage

To view, change, or add new rules about what will be shown in this panel, open the Capture Settings panel for more detailed instructions and to start setting up your own captures.

Overview

The Logs panel stores a record of all triggers that have been activated. (Triggers are set through the Trigger Settings, Sounds, and Filters tools).

Layout Management

The game client's layout is customizable. On both mobile and desktop devices, you can drag panels to resize and reposition them. To keep things organized, the Settings panel has some tools for managing the layout:

Reset Layout

If you want to restore the default layout at any time, open the Settings panel and hit the 'Reset Layout' button.

Lock Tabs

Toggle this setting to control whether panels can be moved. Turning it on prevents accidental rearrangement of your layout (this can be especially useful on devices with small screens).

General

Controls

Stat Bars

Toggle these settings to individually show or hide the character vitals stat bars (Hit Points, Spell Points, Stamina).

Captures

Quests

Map

Scan Depth

This determines how far out rooms are drawn on the map. Higher values allow you to see more of your current area at a time, but may impact performance.

Save all Wilds Rooms

Some rooms in the game are known as 'wilds' rooms, as they exist outside of the main areas. Toggle this setting on to retain information about all wilds rooms that you've discovered, on your current device or browser.

Note: This may impact performance.

Show Excluded Rooms

Toggle the visibility of markers for your excluded rooms.

Trackpad Panning

Toggle this off to use scroll-to-zoom gestures with a trackpad or mouse without holding down ctrl. Toggling on allows you to pan the map with the same gestures.

Note: Scroll-to-zoom may cause map positioning issues for some users, particularly those with trackpads. Try toggling Trackpad Panning on if you experience any issues.

Show Minimap

Toggle the minimap overlay on or off. When enabled, a small overview map appears at the bottom of the map panel showing your current location.

Minimap in Wilds Only

When enabled, the minimap will only be shown when your character is in the Wilds (outside of a named settlement).

Minimap Opacity

Adjust the transparency of the minimap, from fully opaque to nearly transparent.

Minimap Pin Color

Choose the color of the pin that marks your location on the minimap.

Panel Visibility

Individual toggles to show or hide the non-essential default panels.

Quick Actions Management

Custom Quick Actions

Quick actions are shortcut buttons that appear beneath the terminal input in the game panel, giving you one-tap access to commonly used commands. You can add custom quick actions here, to be used alongside the built-in defaults.

Adding a Quick Action

To add a custom quick action, open the Settings panel and within Quick Actions Management, use the plus icon. Each quick action needs a short label (up to 3 characters) and a command. You can also use Fill from Alias to prefill the label and command from one of your existing aliases.

Each quick action can be set to either send or start its command:

• Send runs the command immediately when you tap the button. Use this for self-contained commands, such as inventory, score, or a direction.
• Start places the command in your input field so you can type a target after it. Use this for commands that act on something, like get or kill.

Editing and Deleting

Each saved quick action card has edit and delete icons for updating or removing it.

Custom User Chat Management

Custom Chat Panels

You can create custom panels to store output from captures. (Captures watch for specific game text and store it in a dedicated panel when a match is found.)

By default, you start with a Chat panel for conversational captures and a Captures panel for everything else, but you can add panels for anything from combat to quests. Custom panels are simply a way of separating out the captured game text into themed panels which are easier for a player to scan through.

Adding a Custom Chat Panel

To add a custom panel, open the Settings tab and within Custom User Chat Management, use the plus icon. Give the new panel a title and save it. The next step is to add some capture patterns to send relevant game text to that panel, which you can do with Capture Settings.

Saved Layouts

You might want to use several different game client layouts, e.g. one for combat and another for chatting and exploring. This is a short guide to creating, saving, and applying layouts.

Resizing Panels

Click or long-press on the border between two panels and drag it to increase/decrease the space given to each panel. You can also minimize and maximise each panel using the icon in its top-right corner.

Repositioning Panels

Click or long-press on the tab of the panel you'd like to move and start to drag it towards where you'd like it to be. You'll see the available locations highlighted as you hover over them. Some locations will move the tab to a different tab bar or a different position in its current bar, and others will open up the panel into its own dedicated space within the game client layout.

Saving and Applying Layouts

To save a layout, open the Settings panel and use the plus icon within Saved Layouts. This will allow you to save your current layout under the title you choose for it. You can then swap quickly between layouts with the 'Use Layout' button from the Saved Layouts list.

If you want to restore the default layout at any time, open the Settings panel and hit the 'Reset Layout' button.

Editing a Layout

To edit a layout, open the Settings panel and use the 'Update Saved Layout' button for the layout you want to change. This will overwrite the previous saved layout with your current one.

Advanced

The Advanced section contains tools for managing your local rooms database.

Refresh and Clear DB

These options are usually not needed and may result in data loss.

Export and Import Local Room Data

These options let you transfer your room data between browsers and devices.

Some rooms are visible to all players automatically, but many only appear on the map after your character has visited them. Exporting your room data lets you carry over the rooms you've already discovered, so they will appear on the map when you import that data into another browser or device.

You can choose whether to include markers for excluded rooms when you import room data. If you keep this option checked, the excluded markers from the file will replace your current ones. If you uncheck this option, your pre-import excluded markers will be preserved and no additional ones will be added to your map.

Note: If you’re experiencing issues with rooms not showing as expected after importing data, check that you have “Save all wilds rooms” toggled ON in the Map section of the Game Client Settings.