Iron Realms Nexus Client Documentation - User contributions [en]

Nexus Discord

2026-05-19T22:05:54Z

Jeremy: Headings pass + AI tic strip: add H2 structure (What you'll find there / Getting help); drop embark on close; trim marketing fluff

<table>
<div class="row">
<div class="large-8 columns">

Welcome to the Iron Realms Nexus Discord community. Join us to connect with other Nexus users, ask questions, and stay up-to-date with the latest news.

'''Discord Server Link''': [https://discord.gg/Tz7t5SaD4q Nexus Discord]

== What you'll find there ==
The server is a place to discuss bugs and features of the Nexus Client, collaborate with other community members, and share what you've learned. As the community grows, we plan to expand into more topics beyond bugs and features.

== Getting help ==
If you have questions or need help, reach out to a community moderator or administrator in the server. They'll point you in the right direction.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Game Selection

2026-05-19T22:05:54Z

Jeremy: Headings pass + AI tic strip: add H2 structure (Connect to a game / Notes); remove seamless and Additionally; cut marketing close

<table>
<div class="row">
<div class="large-8 columns">

The Iron Realms Nexus Client connects to any Iron Realms game. You can also add login information for other games by providing the game URL and port.

[[Image:Nexus_3_Game_Select.png]]

== Connect to a game ==

[[Image:Nexus_3_Select_Phone.jpg|frameless|right|thumb]]
# '''Select a Game''': Click on the game you want to play from the available options. The list includes all Iron Realms games as well as any other games you have added to the client.
# '''Character Management''': Once you have chosen a game, you have several options:
#* '''Create a New Character''': If you're starting fresh, create a new character within the game you selected. The client will guide you through character creation.
#* '''Add an Existing Character''': If you already have a character in the game, you can add it to the client by providing the necessary details.
#* '''Select a Character''': If you have already added characters to the client, click the desired character to start playing.

== Notes ==

* '''Support for Iron Realms games only''': We provide support only for our own Iron Realms games. You can add login information for other games, but we don't support them directly.

* '''Limited features for non-Iron Realms games''': The client's functionality may be limited when connecting to games other than Iron Realms titles.

If you have questions about Iron Realms games, our support team can help.

[[Image:Nexus_3_Game_Select_Tablet.jpg]]

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Colors

2026-05-19T22:05:54Z

Jeremy: Headings pass: add H2 structure (Accessing/Switch to light mode/What color settings affect); light prose tightening

<table>
<div class="row">
<div class="large-8 columns">

== Accessing color options ==
The Colors options live in the settings menu. Click the gear icon in the bottom right corner of the Nexus client, then select '''Colors'''.

== Switch to light mode ==
Turn on '''Show inverted colors''' to switch the client from the default dark mode to light mode.

== What color settings affect ==
Color options only affect the output and communication windows. If you're playing an Iron Realms game, adjust the game's own color settings first before changing the client's.

[[Image:Colors.png]]
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 General Functions

2026-05-19T22:03:16Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">

==== Backup Current Client Settings ====
If you wish to create a backup for your current settings and triggers, follow these instructions:

# Access the settings window by clicking the gears icon located in the lower-right corner.
# Select 'Import/Export' from the Settings Menu.
# Click on 'Save Settings to Disk'. This will save your current settings on your computer as a .nxs file (Nexus Settings).

==== Restore Client Settings ====
If you need to revert to older settings that you've previously saved, follow these steps:

# Open the settings window by clicking the gears icon in the lower-right corner.
# Choose 'Import/Export' from the Settings Menu.
# Either drag your Nexus Settings File (.nxs) to the Import Settings box or click the box to load your settings file.

Please note that Nexus automatically saves older versions of your settings from the past few weeks, as a safety net if you've made a serious error and need to restore your settings. You can retrieve these from the 'Restore older settings' section under the 'Import/Export' tab in the Nexus settings menu.

==== Modify Music Volume or Mute It ====
Simply use the control that resembles a speaker in the lower right. Click and adjust the slider to modify the volume or mute.

==== Tab Targeting - Select Targets Using Tab Key ====
You can cycle through denizen/NPC/mob targets (excluding players) in your room by simply pressing the tab button on your keyboard. You will notice the target change at the bottom of the client, directly underneath the input box. If the room info window is active, the target text will be highlighted in yellow.

Keep in mind that tab targeting usually avoids selecting pets, guards, and a few other creature types that you typically wouldn't want to attack unintentionally.

'''PvP Tab Targeting''': To tab-target players, use tab-space to cycle through players.

==== Command Completion ====
For command completion, use shift-tab to finish a partially-typed command from your buffer of past commands. This might not work with certain Chrome installs, as some of them use shift-tab.

==== Zoom In/Out on the Map ====
Place the cursor over the map and gently use the mouse wheel to zoom in or out.

==== Redirect Command Output to a Floating Window ====
Simply type WINDOW <command>, and the output of whatever <command> contains will be redirected to a floating window. This feature is quite useful for tasks such as reading long letters, logs, etc.

==== Enable/Disable Logging ====
Click the paper & pen icon in the lower right to start a log. When you click it again to stop it, you'll be given the option to save the log.

==== Enable/Disable Scripts ====
You can turn your scripts on or off using the lightning bolt icon, located on the Nexus footer bar, in the lower right.

==== Provide Feedback on the Client ====
The preferred method to report bugs is through the following URLs. We use Mantis Bug Tracker for tracking bugs in Nexus 3.0. You need to log in to report bugs using your character name and password on the corresponding game website for your character. For example, if your character is in Aetolia, you should use the Aetolia link below.

* [https://client.achaea.com/bugs Submit a bug for Achaea]
* [https://client.aetolia.com/bugs Submit a bug for Aetolia]
* [https://client.imperian.com/bugs Submit a bug for Imperian]
* [https://client.lusternia.com/bugs Submit a bug for Lusternia]
* [https://client.starmourn.com/bugs Submit a bug for Starmourn]

Please remember to log in using your character name and password to report a bug.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Client Download

2026-05-19T22:03:16Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">
Welcome to the Iron Realms Nexus Client download page. We offer multiple options for accessing the Nexus Client, ensuring compatibility across various platforms. Please select the appropriate download method based on your device or operating system:

==== Desktop Downloads ====
* '''Browser Version''': Access Nexus directly through your web browser by visiting [https://play.ironrealms.com Play Iron Realms]
* '''Windows Desktop Version''': Download the Nexus Client for Windows by [https://www.ironrealms.com/local/nexus-3.0.exe clicking here].
* '''Linux Version''': Obtain the Nexus Client for Linux by downloading the [https://www.ironrealms.com/local/nexus-linux-3.0.tar.gz tarball here].

==== Mobile Downloads ====
* '''Android Version''': Install the Nexus Client for Android devices from the Google Play Store by following [https://play.google.com/store/apps/details?id=com.ironrealms.nexus this link].
* '''iOS Version''': Access the Nexus Client for iOS devices through the Apple App Store by visiting [https://apps.apple.com/us/app/nexus-mud-client/id1641739522 this link].

We greatly appreciate your support and encourage you to contribute to the ongoing development of the Nexus Client. By submitting detailed bug reports, you play a vital role in helping us improve the client's performance and overall user experience. To learn more about how you can assist us by reporting bugs, see our guide: [[How_To_Submit_Bugs|How to Submit Bugs]]

Thank you for choosing the Iron Realms Nexus Client. Enjoy your immersive gaming experience!
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Character Management

2026-05-19T22:03:15Z

Jeremy: Voice/structure cleanup (3 edits): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">
===Adding Existing Characters===

If you have previously created characters in any of the Iron Realms games, it's effortless to include them in your character list within the Iron Realms Nexus Client.

Follow these steps to add your existing characters to the client:

#'''Login to Your Nexus Account''': Start by logging into your Nexus account using your credentials. This ensures access to the necessary functionality for character management.
#'''Select the Game''': Once logged in, choose the specific Iron Realms game in which your character was originally created. Click on the game from the available options.
#'''Add a Character''': Within the game selection, locate the "Add a Character" option and click on it. You will then be prompted to provide the following details:
#*'''Character Name''': Enter the name of your existing character.
#*'''Password''': Provide the password associated with your character's account.
#'''Character List Update''': After entering the character name and password, click the appropriate confirmation button. Your character will now be added to your character list within the Iron Realms Nexus Client. Each time you log into your Nexus account, the character will be readily accessible.

By following these simple steps, you can easily include your existing Iron Realms game characters in the character list of the Iron Realms Nexus Client. This feature enables convenient access and management of your characters through a centralized platform.

===Creating New Characters===

If you want to create a new character in the Iron Realms Nexus Client, follow these steps to create a new character:

#'''Access the Character Creation''': Locate and click on the "Create New Character" button within the Nexus Client. This will initiate the character creation process, which may vary slightly depending on the specific Iron Realms game you choose.

#'''Follow the Creation Process''': As you progress through the character creation process, you will be guided step by step. Pay attention to the prompts provided by the game, as they will assist you in crafting your character effectively. While the details may differ for each game, you will eventually be prompted to select a character name and password.

#'''Select a Character Name and Password''': Once prompted, choose a unique character name. Also pick a strong password to protect the account. This ensures the confidentiality and safety of your character's information.

#'''Begin the Tutorial''': After completing the character creation process, you will enter the game world and commence the tutorial. This initial phase will familiarize you with the game mechanics, controls, and basic concepts necessary to navigate and immerse yourself in the gameplay.

By following these steps, you can successfully create a new character in the Iron Realms Nexus Client. Enjoy the thrilling experience of bringing your character to life and embarking on epic journeys in the Iron Realms game of your choice.

===Deleting Characters===

To remove a character from your character list within the Iron Realms Nexus Client, follow these steps:

#'''Locate the Character''': Find the character you wish to remove from the character list. Look for the character's name within the list displayed in the Iron Realms Nexus Client.
#'''Click the Trash Can Icon''': Next to the character's name, you will see a trash can icon on the far right. Click on this icon to initiate the removal process. Please note that removing the character from the list will not delete the character in the actual game; it simply removes it from your character list within the client.

If you desire to permanently delete your character from the game, follow these additional steps:

#'''Access the Game''': Launch the game and enter the game world where your character is located.
#'''Issue the Command''': While playing the game, enter the command "HELP DELETE" to obtain specific instructions on how to proceed with permanently deleting your character. The game will provide you with the necessary guidance to carry out the deletion process effectively.

Please exercise caution when deleting characters, as the action is irreversible. Make sure you truly intend to delete the character before proceeding.

Remember, removing a character from the character list within the Iron Realms Nexus Client is separate from deleting the character in the game. Choose the appropriate action based on your specific needs and preferences.

If you encounter any difficulties or have further questions, our support team is available to assist you. Feel free to reach out for any necessary clarification or additional guidance regarding character removal.

===Character Settings===

To conveniently edit character settings within the Iron Realms Nexus Client, without being logged into the game, follow these steps:

#'''Access the Character List''': Locate the character you wish to edit within the character list displayed in the Iron Realms Nexus Client.
#'''Click the Gear Icon''': On the far right side of the character name, you will find a gear icon. Click on this icon to initiate the editing process. By doing so, you can modify the character settings without the need to be logged into the game.

This feature allows you to conveniently customize and adjust various settings to enhance your gameplay experience.

===Other Games===

The Iron Realms Nexus Client empowers users to connect to various MUD games. To seamlessly connect to another game, follow these simple steps:

#'''Access Game Addition''': Within the Iron Realms Nexus Client, locate and click the "Add Game" button. This action will initiate the process of adding a new game to your client.
#'''Provide Game Information''': Enter the necessary details to connect to the desired game:
#*'''Game Name: Specify the name of the game you wish to connect to.
#*'''Game Server IP or Domain Name''': Input the IP address or domain name of the game server.
#*'''Port''': Enter the specific port number used by the game for connection.
By following these steps, you can expand your gaming experience by connecting to additional MUD games through the Iron Realms Nexus Client.

Kindly note that while we offer the capability to connect to other games, our support is primarily focused on resolving bugs and issues pertaining to the Nexus client itself. We may not be able to provide support for external games beyond ensuring the smooth functioning of the Nexus client.

If you encounter any difficulties during the game addition process or have further inquiries, our support team is available to assist you. Feel free to reach out for any necessary guidance or clarification. In addition, our Discord is a great place to get help: [https://discord.gg/Tz7t5SaD4q Nexus Discord]

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Game Client

2026-05-19T22:03:15Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<div class="row">
<div class="large-8 columns">

This page is a guide to the Nexus Client interface for Iron Realms game worlds. Each game world is navigated through the Nexus Client, which contains a multitude of interactive windows for an immersive gaming experience. We shall explore the different windows of the Nexus Client below.

<gallery>
Image:ClientWeb_01.png|Web and Desktop Version
Image:Nexus_3_Tablet_Play.jpg|Tablet Version
Image:Nexus_3_Phone_Play.jpg|MobileVersion
</gallery>

=== Output Window ===
The output window illustrates the game's responses to your inputs and other in-game activities. New outputs appear from the bottom and move upwards.

[[Image:OutputWindow_01.png]]

==== Scrollback ====
To review the game history, users can scroll using the page-up and page-down keys or the mouse wheel.

[[Image:Scrollback_01.png]]

=== Command Line ===
This is where users initiate actions in the game by typing commands. The dropdown arrow to the left of the command line shows the recent command history.

The right arrow on the right side serves as an alternative to pressing enter to send the command.

[[Image:CommandLineWeb_01.png]]

=== F-Key Buttons ===
The F-Key buttons are editable through the settings menu (accessed via the gears icon). Each button corresponds to a specific command that is activated upon clicking the button or pressing the respective F-Key.

[[Image:ButtonsWeb_01.png]]

=== Gauges ===
These gauges, located above the buttons, show stats such as health and mana, depending on the game being played.

[[Image:GaugesWeb_01.png]]

=== Balance and Equilibrium Indicators ===
These indicators, found to the left of the gauges, display your balance and equilibrium status. Note: Not used in Starmourn.

[[Image:Balance_01.png]]

=== Avatar ===
Your character avatar, initially set by default, can be customized or replaced by clicking on it.

[[Image:Avatar_01.png]]

=== Map Window ===
This window indicates your character's current location within the game world. You can navigate by typing directions or by interacting with the elements within this window.

[[Image:MapWindowWeb_01.png]]

==== Map Compass ====
The Map Compass, located at the top right corner of the main output window, allows for easy navigation. This feature is off by default and can be activated in your settings.

[[Image:MapCompass_01.png]]

=== Character Tab ===
This window provides an overview of your character's current status, name, basic information, and a list of current afflictions and defenses.

[[Image:CharacterWindow_01.png]]

=== Skills Tab ===
Displays your current skillsets and individual abilities. Each ability can be expanded for more information.

[[Image:SkillsWindow_01.png]]

=== Inventory Tab ===
Presents a categorized view of your inventory, with options to expand container items for a detailed view of their contents.

[[Image:InventoryWindow_01.png]]

=== Room Tab ===
Shows a detailed view of your current room, including other players, NPCs, and items present. Interactions can be initiated by clicking on an item, NPC, or player.

[[Image:RoomWindow_01.png]]

=== Who Tab ===
Lists all visible players in the game and provides basic HONORS information when a player name is clicked.

[[Image:WhoWindow_01.png]]

=== Quests, Tasks, and Achievement Tabs ===
Display your quests, tasks, and achievements. Details of these activities can be accessed by clicking on them.

[[Image:QuestsWindow_01.png]]

=== Communications Tab ===
This window consolidates all chat communication received in the game.

[[Image:CommWindow_01.png]]

=== Status bar ===
Situated at the bottom of the client, the status bar provides an array of accessible tools and crucial game information.

From left to right, the icons symbolize the following:

*Help: Provides access to the wiki for assistance.
*Level: Displays your character's current level and progress towards the next.
*Gold in Inventory: Indicates the amount of gold your character is carrying.
*Gold in Bank: Shows the quantity of gold deposited in your character's bank.
*Ping: Represents your connection speed to our servers. A lower number is better.
*Current Target: Specifies the player or NPC your character is currently targeting.
*Messages: If the envelope icon is green, it signifies unread messages.
*News: A green news icon suggests there are unread news items.
*Day/Night Indicator: Displays the in-game time of day. Hover over the icon for more details.
*Full Screen: Clicking the monitor icon enables the client to run in fullscreen.
*Logging: Allows recording all game output to a text file for future reference.
*Triggers: The lightning icon toggles all your reflexes on/off.
*Sound: Manages in-game sound settings.
*Settings: The gear icon opens the window for adjusting your settings.
*Refresh Layout: Resets the client to its default layout when clicked.

[[Image:StatusBar_01.png]]

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>

Predefined variables

2026-05-19T22:03:14Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

Predefined variables are set by the game as text is sent to the clients.

{| class="wikitable"
! style="text-align:left;" | Variable Name
! style="text-align:left;" | Description
|-
! scope="row"|@tar
|Your current enemy target.
|-
! scope="row"|@match
|The text matched in a trigger.
|-
! scope="row"|@line
|The complete line of text that executed the trigger.
|-
! scope="row"|@suffix
|The suffix is set to all of the text received in a line after the matching text.
|-
! scope="row"|@prefix
|The prefix is set to all of the text received in a line before the matching text.
|}

Nexus also automatically fills the in these variables for you:

{| class="wikitable"
|-
! scope="col"| Variable
! scope="col"| Description
! scope="col"| Game
|-
! scope="row"| @my_hp
| Your current health
| All
|-
! scope="row"| @my_maxhp
| Your maximum health points
| All
|-
! scope="row"| @my_mp
| Your current mana points
| All
|-
! scope="row"| @my_maxmp
| Your maximum mana points
| All
|-
! scope="row"| @my_nl
| Your experience percentage to next level
| All
|-
! scope="row"| @my_bal
| If you currently have balance
| Achaea, Aetolia, Imperian
|-
! scope="row"| @my_eq
| If you currently have equilibrium
| Achaea, Aetolia, Imperian
|-
! scope="row"| @my_balance
| If you currently have balance
| Lusternia
|-
! scope="row"| @my_equilibrium
| If you currently have equilibrium
| Lusternia
|-
! scope="row"| @my_health_reserve
| Your currently available health reserves.
| Imperian
|-
! scope="row"| @my_mana_reserve
| Your currently available mana reserves.
| Imperian
|-
! scope="row"| @my_vote
| If you have not voted for your game recently
| All
|-
! scope="row"| @my_string
| Your current prompt string
| All
|-
! scope="row"| @my_wp
| Your current willpower points
| Achaea, Aetolia
|-
! scope="row"| @my_maxwp
| Your maximum willpower points
| Achaea, Aetolia
|-
! scope="row"| @my_awp
| Your current aetherwill points
| Lusternia
|-
! scope="row"| @my_maxawp
| Your maximum aetherwill points
| Lusternia
|-
! scope="row"| @my_ep
| Your current endurance points
| Achaea, Aetolia
|-
! scope="row"| @my_maxep
| Your maximum endurance points
| Achaea, Aetolia
|-
! scope="row"| @my_ego
| Your current ego points
| Lusternia
|-
! scope="row"| @my_maxego
| Your maximum ego points
| Lusternia
|-
! scope="row"| @my_pow
| Your current power
| Lusternia
|-
! scope="row"| @my_maxpow
| Your maximum power
| Lusternia
|-
! scope="row"| @my_reserves
| Your current power reserves
| Lusternia
|-
! scope="row"| @my_ep
| Your current endurance points
| Achaea, Aetolia
|-
! scope="row"| @my_maxep
| Your maximum endurance points
| Achaea, Aetolia
|-
! scope="row"| @my_xp
| The numerical amount of experience you have for your current level.
| Aetolia
|-
! scope="row"| @my_maxxp
| The numerical amount of experience needed to advance from your current level.
| Aetolia
|-
! scope="row"| @my_blood
| Your blood reserves percentage
| Aetolia
|-
! scope="row"| @my_bleeding
| The current amount of health you're bleeding for.
| Aetolia, Lusternia
|-
! scope="row"| @my_bleed
| The current amount of health you're bleeding for.
| Imperian
|-
! scope="row"| @my_bruising
| The current amount of health you're bruised for.
| Lusternia
|-
! scope="row"| @my_hemorrhaging
| The current amount of health you're hemorrhaging for.
| Lusternia
|-
! scope="row"| @my_blind
| If you are blind.
| Aetolia, Imperian, Lusternia
|-
! scope="row"| @my_deaf
| If you are deaf.
| Aetolia, Imperian, Lusternia
|-
! scope="row"| @my_prone
| If you are prone.
| Aetolia, Imperian, Lusternia
|-
! scope="row"| @my_stunned
| If you are stunned.
| Imperian
|-
! scope="row"| @my_cloak
| If you have the Cloak (tattoo) defence.
| Aetolia
|-
! scope="row"| @my_fangbarrier
| If you have the fangbarrier defence.
| Aetolia
|-
! scope="row"| @my_phased
| If you are phased.
| Aetolia, Imperian
|-
! scope="row"| @my_elevation
| What room elevation you're currently at.
| Aetolia
|-
! scope="row"| @my_flying
| Whether you are currently flying (per the elevation).
| Imperian
|-
! scope="row"| @my_herb
| If you have herb/slice balance.
| Aetolia, Imperian
|-
! scope="row"| @my_salve
| If you have salve/poultice balance.
| Aetolia, Imperian
|-
! scope="row"| @my_pipe
| If you have pipe/tincture balance.
| Aetolia, Imperian
|-
! scope="row"| @my_elixir
| If you have elixir/serum balance.
| Aetolia
|-
! scope="row"| @my_health
| If you have elixir balance.
| Imperian
|-
! scope="row"| @my_toadstool
| If you have toadstool balance.
| Imperian
|-
! scope="row"| @my_moss
| If you have moss/kidney balance.
| Aetolia
|-
! scope="row"| @my_tree
| If your tree tattoo is off cooldown.
| Aetolia, Imperian
|-
! scope="row"| @my_renew
| If your renew ability is off cooldown.
| Aetolia
|-
! scope="row"| @my_affelixir
| If your affliction elixir/serum balance is off cooldown.
| Aetolia
|-
! scope="row"| @my_focus
| If your focus ability is off cooldown.
| Aetolia, Imperian
|-
! scope="row"| @my_ice
| Curative balance for restorative ice
| Lusternia
|-
! scope="row"| @my_slush
| Curative balance for lucidity slush
| Lusternia
|-
! scope="row"| @my_steam
| Curative balance for soothing steam
| Lusternia
|-
! scope="row"| @my_dust
| Curative balance for purity dust
| Lusternia
|-
! scope="row"| @my_healing
| Curative balance for healing elixir
| Lusternia
|-
! scope="row"| @my_sparkleberry
| Curative balance for sparkleberry
| Lusternia
|-
! scope="row"| @my_scroll
| Curative balance for healing scroll
| Lusternia
|-
! scope="row"| @my_purge
| If your purge blood ability is off cooldown.
| Imperian
|-
! scope="row"| @my_writhing
| If you are currently writhing.
| Aetolia
|-
! scope="row"| @my_soul
| Your soul percentage (drained by Carnifex).
| Aetolia
|-
! scope="row"| @my_madness
| Your Shapeshifter madness percentage.
| Aetolia
|-
! scope="row"| @my_left_arm
| If you have left arm balance.
| Aetolia, Lusternia
|-
! scope="row"| @my_right_arm
| If you have right arm balance.
| Aetolia, Lusternia
|-
! scope="row"| @my_left_leg
| If you have left leg balance.
| Lusternia
|-
! scope="row"| @my_right_leg
| If you have right leg balance.
| Lusternia
|-
! scope="row"| @my_leftarm
| If you currently have left arm balance.
| Imperian
|-
! scope="row"| @my_rightarm
| If you currently have right arm balance.
| Imperian
|-
! scope="row"| @my_head
| If you have head balance.
| Lusternia
|-
! scope="row"| @my_psisub
| If you have psionic sub balance. (-1 if channel is locked.)
| Lusternia
|-
! scope="row"| @my_psisuper
| If you have psionic super balance. (-1 if channel is locked.)
| Lusternia
|-
! scope="row"| @my_psiid
| If you have psionic id balance. (-1 if channel is locked.)
| Lusternia
|-
! scope="row"| @my_modulebal
| If you have aethership module balance. (-1 if not locked into a module.)
| Lusternia
|-
! scope="row"| @my_eflowbal
| If you have enigmatic flow balance.
| Lusternia
|-
! scope="row"| @my_leftwield
| Item number of the item you are wielding in your left hand.
| Imperian
|-
! scope="row"| @my_leftwield_name
| The short name of the item you are wielding in your left hand (e.g. "broadsword")
| Imperian
|-
! scope="row"| @my_rightwield
| Item number of the item you are wielding in your right hand.
| Imperian
|-
! scope="row"| @my_rightwield_name
| The short name of the item you are wielding in your right hand (e.g. "broadsword")
| Imperian
|-
! scope="row"| @my_wield_left
| What item are you wielding in your left hand.
| Aetolia
|-
! scope="row"| @my_wield_right
| What item are you wielding in your right hand.
| Aetolia
|-
! scope="row"| @my_essence
| Your remaining life essence percent (Necromancy).
| Aetolia, Imperian
|-
! scope="row"| @my_devotion
| Your remaining devotion percent (Devotion).
| Aetolia, Imperian
|-
! scope="row"| @my_fanatism
| Your current fanatism level (Kanai).
| Imperian
|-
! scope="row"| @my_rage
| Your current rage level (Warchants).
| Imperian
|-
! scope="row"| @my_fire
| Your current fire level (Shapeshifting).
| Imperian
|-
! scope="row"| @my_ice
| Your current rage level (Shapeshifting).
| Imperian
|-
! scope="row"| @my_gunfocus
| Your current focus level (Focus). Only sent if you have a focus target.
| Imperian
|-
! scope="row"| @my_focustarget
| Your current focus target (Focus). Only sent if you have a focus target.
| Imperian
|-
! scope="row"| @my_spark
| Your remaining spark percent (Illumination).
| Aetolia
|-
! scope="row"| @my_empathy
| Your current empathy.
| Lusternia
|-
! scope="row"| @my_enigmaticflow
| Your current enigmatic flow.
| Lusternia
|-
! scope="row"| @my_stance
| What stance you are currently in (Tekura for Aetolia, Kata for Lusternia).
| Aetolia, Lusternia
|-
! scope="row"| @my_kai
| What your kai level is at (Kaido).
| Aetolia, Imperian
|-
! scope="row"| @my_momentum
| Your current momentum level (Terramancy).
| Aetolia
|-
! scope="row"| @my_charge_left
| Current charge of your left-hand weapon (Bladefire).
| Aetolia
|-
! scope="row"| @my_charge_right
| Current charge of your right-hand weapon (Bladefire).
| Aetolia
|-
! scope="row"| @my_mounted
| What steed you are currently mounted upon.
| Aetolia
|-
! scope="row"| @my_mount
| What steed you are currently mounted upon.
| Imperian, Lusternia
|-
! scope="row"| @my_faith
| Your current Cult/Sect faith amount
| Imperian
|-
! scope="row"| @my_res_weakness
| The remaining duration of your PVP resurrection weakness.
| Imperian
|-
! scope="row"| @my_headwounds
| Your current head wounds.
| Lusternia
|-
! scope="row"| @my_chestwounds
| Your current chest wounds.
| Lusternia
|-
! scope="row"| @my_gutwounds
| Your current gut wounds.
| Lusternia
|-
! scope="row"| @my_leftarmwounds
| Your current left arm wounds.
| Lusternia
|-
! scope="row"| @my_rightarmwounds
| Your current right arm wounds.
| Lusternia
|-
! scope="row"| @my_leftlegwounds
| Your current left leg wounds.
| Lusternia
|-
! scope="row"| @my_rightlegwounds
| Your current right leg wounds.
| Lusternia
|}

=== Example ===

This is the output from the game, showing some predefined variables. It uses the trigger below.

[[File:PredefinedOutput.png]]

This is the sample trigger used display the predefined variables above.

[[File:PredefinedTrigger.png]]

3.0 Display Options

2026-05-19T22:03:14Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">

You can access the 'Display Options' via the settings menu. To do this, click on the gear-shaped icon located in the bottom right corner of your Nexus client, then select the 'Display Options' button.

====Display Elements====
* Tooltips: Choose whether tooltips appear when you move your cursor over different areas of the main client window.
* Compass (web/desktop): Enables a movement compass on the web or desktop versions of the Nexus client.
* Compass (mobile): Enables a movement compass on the mobile version of the Nexus client.
* Gauges: View your character's stat gauges (such as health, mana, etc) within the Nexus client.
* Buttons: Decide whether buttons are visible in the Nexus client. Regardless of your choice, F1 keys will still function.
* Balances: View the Balance and Equilibrium icons in the Nexus client.
* Avatar: Show your character's avatar in the Nexus client.
* Notifications: The client will forward notifications to your OS if it's not the current window in use.
* Extra Padding: Add some extra spacing beneath each line in the output window for improved readability.
* Item Numbers: View item numbers in the Inventory and Room Info windows.
* Room Descs: View room descriptions in the Room Info window.
* Help Popups: When using the HELP command, the client will present the information in a new pop-up window.
* Timestamps: Show timestamps next to every line of game output in the output window.
* Scrollback Timestamps: Show timestamps next to every line of game output in the scrollback window (only applies when using a split screen).
* Prompt Lines: Display the prompt information after every line in the output window.
* Last Prompt: Display the prompt on the last line only.
* Reveal Map: Show all rooms on the map, even the ones you haven't explored yet.

====Output====
The following options affect the appearance of information in the output window.

=====Echo Commands=====
'''Show all commands I enter in the output window'''<br>
This choice allows all commands you input to appear in the output window. You can also change the command color.

=====Echo Targets=====
'''Display target changes'''<br>
Any changes to mob or player targets, made using the tab or shift+tab keyboard commands, will appear in the output window. You can also change the color of the target change message.

=====Hide Chat=====
'''Conceal all chat messages in the main window if they appear in another tab'''<br>
Turn on this option if you prefer chat messages to only appear in their dedicated windows.

=====Display Font and Font Size=====
Here, you can select the font type and size for the output buffer.

The display font will only change the text in the output and communication windows. Adjusting the font size will affect all text in the Nexus client.

====Interface====
'''Empty the input bar after sending'''<br>
This option will clear the command line each time you send a game command.

'''Automatically copy highlighted text'''<br>
Selecting text with your mouse will automatically copy it to your clipboard.

'''Play background music'''<br>
Switch the Nexus client's background music on or off.

====Logging====
'''Add history at the beginning when logging starts'''<br>
When you start logging, everything currently in the output window will be added at the beginning of the log.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Nexus Account

2026-05-19T22:03:13Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">
Welcome to the Iron Realms Nexus Client! With the introduction of Nexus 3.0, we have implemented new features that enhance your gameplay experience. To access these features and enjoy their benefits, we invite you to create a Nexus account. Although it is not mandatory to create an account to use the Nexus client, doing so allows us to save basic information that contributes to improving your overall experience. Creating your account is a simple and efficient process.

'''Key Features of a Nexus Account:'''

# '''Convenient Character Management''': Save and access character lists for one-click logins, simplifying the process of transitioning between different characters in your gameplay.
# '''Offline Editing of Settings and Reflexes''': Modify your client settings and reflexes even when not logged into the game, enabling you to customize and optimize your preferences at your convenience.
# '''Non-IRE Game World Support''': Save non-Iron Realms game world information and characters, expanding the versatility of Nexus beyond Iron Realms Entertainment (IRE) games.

If you are playing an Iron Realms game, character reflexes and settings are stored independently and do not require a Nexus account. However, for games outside the Iron Realms universe, the creation of a Nexus account is necessary to save information to our servers. If you plan to play non-IRE worlds, we recommend creating a Nexus account to maximize your gaming experience.

===How to Create a Nexus Account===
<br>
* '''Launch the Nexus Client''': Once the Nexus Client loads up, locate the "Login" button. It is conveniently positioned in the top right corner of the client window, directly above the world game names. Alternatively, the "Register" text link is on the right side of the client in the Character List area. If you select the "Login" button, you will then need to click the "Create an Account Link" to reach the correct screen. Refer to the images below for visual guidance.

<gallery>
Image:Nexus_3_Login_Button.png|Login Button
Image:Nexus_3_Login_Text.png|Login and Registration Links
Image:Nexus_3_Login_Prompt.png|Login Dialog
</gallery>

* '''Account Creation Screen''': Clicking a "Create an Account" link will redirect you to the account creation screen. Provide your email address and password to create your Nexus account. To ensure account security, choose a strong and unique password. See the image below for reference.

<gallery>
Image:Nexus_3_Login_Create.png|Create Nexus Account
</gallery>

* '''Logging into Nexus''': After successfully creating your account, log in to the Nexus Client by clicking the "Login" button, located at the top right corner of the client window. Enter your email address and password to complete the login process.

By following these simple steps, you will establish your Nexus account, granting you access to the full range of features and capabilities offered by the Iron Realms Nexus Client.

If you run into trouble, see [[How To Submit Bugs]].
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Help

2026-05-19T22:03:13Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">

===Getting Help with the Nexus Client===

The Iron Realms Nexus client is designed to be user-friendly and intuitive, but sometimes, you might need assistance or encounter a problem that needs resolving. Here are several ways to seek help: via Discord, submitting a bug report, or sending an email to our support team.

====1. Seek Assistance on Discord====

Iron Realms has an active Discord community where you can get help. If you have a question or encounter an issue, feel free to post it on the appropriate channel in the Discord server. Fellow players and staff members are typically online and ready to help.

Please remember to be clear and concise when describing your problem to enable others to understand and respond effectively.

If you are not yet a member, you can join the Iron Realms Discord server by clicking the invitation link on the official Iron Realms website or from within the Nexus client itself.

'''Discord Server Link''': [https://discord.gg/Tz7t5SaD4q Nexus Discord]

====2. Submitting a Bug Report====

If you encounter a bug in the Nexus client, it is highly recommended that you report it through the bug tracker. This helps our development team to identify, investigate, and fix issues more efficiently.

You can submit a bug report by following these steps:

1. Access the bug tracker for the appropriate game by using the corresponding URL:

* [https://client.achaea.com/bugs Submit a bug for Achaea]
* [https://client.aetolia.com/bugs Submit a bug for Aetolia]
* [https://client.imperian.com/bugs Submit a bug for Imperian]
* [https://client.lusternia.com/bugs Submit a bug for Lusternia]
* [https://client.starmourn.com/bugs Submit a bug for Starmourn]

2. Login using your character name and password.

3. Click on "Report Issue".

4. Fill in the necessary details about the bug, including a clear summary and a detailed description of the problem, the steps to reproduce it, and any additional information that may help the development team.

5. Submit the bug report.

Your report will be reviewed, and our team will work to resolve the issue.

'''Also See''': [[How To Submit Bugs]]

====3. Emailing Support====

If you're having technical issues or other problems that can't be solved through Discord or by submitting a bug report, you can reach out to the Iron Realms support team directly by sending an email to support@ironrealms.com.

When emailing, please provide as much detail as possible about the issue you're experiencing, including any error messages you've received and the steps you've already taken to try to resolve the issue. This will help our support team to understand your problem and provide a suitable solution.

Remember, our team is here to help ensure your gaming experience is enjoyable and smooth. Don't hesitate to reach out if you need assistance.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 advanced scripting

2026-05-19T22:03:12Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">

While the Simplified Scripting system in Nexus 3.0 is designed to cater to the majority of game players with its extensive options, we understand that some users might require more power or specific functions that the Nexus client may not traditionally offer. For these needs, Nexus 3.0 lets you use JavaScript for virtually all other tasks.

====JavaScript in Nexus 3.0====
[[javascript|JavaScript]] is the primary scripting language utilized by the Nexus client. By understanding and employing JavaScript, you can unlock the full potential of Nexus 3.0 and create a highly personalized gaming experience.

====Functions====
Nexus 3.0 allows you to craft custom JavaScript [[Functions|functions]] that can be utilized with other [[3.0_Reflexes|reflexes]]. These custom functions can help you manage complex tasks, automate repeated actions, and further enrich your game interactions.

====GMCP====
The game server communicates with the Nexus client using a protocol known as [[GMCP|GMCP (Generic Mud Communication Protocol)]]. As an advanced user, you can directly access and interact with this information, allowing you a deeper level of control and customization over your gaming experience.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Keys, Gauges, and Avatars

2026-05-19T22:03:11Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">

<table>
<div class="row">
<div class="large-8 columns">

The section below the main output is multifunctional. It houses gauges that display fundamental character information, including stats like health and mana, although these may vary across different game worlds. A customizable avatar, an array of buttons that can be activated via mouse click or F key, and the command line where you input game commands are also part of this section.

Here is a representative image of this area within the client:

[[Image:AvatarArea.png]]

Each Iron Realms game has subtle differences in the information presented here. Some may display additional gauges, and all games will tailor the button commands for new characters based on their respective classes.

==== Reconfiguring the F-Keys ====

To customize the F-Keys:

# Click on the gears icon [[Image:OpenSettings.png|frame|Click the gear icon to open your settings.]] located at the lower right-hand corner of the client to access the settings window.
# Proceed to the Buttons tab.
# Select the F-Key you wish to modify.
# Update it according to your preference.
# Use @tar to represent the target you usually opt for. For instance, to command KICK to kick your current target, input "kick @tar."
# Label the button in the Text field as desired.
# You may disregard the 'Script' field at this moment

You can also adjust the quantity of F-Keys from this section.

Additional information is available on the [[3.0_Buttons|Buttons Page]].

[[File:Buttons.png]]

==== Managing F-Keys, Gauges, and Avatar ====
[[File:OpenSettings.png|right]] To enable or disable any of the gauges, buttons, or avatar elements within the client:

# Access your settings by clicking on the gear icon located at the bottom right of the client.
# Click on "Display Options".
# Within "Display Elements", you'll find toggles for Gauges, Buttons, Avatar, and Balances. Switch them on or off as per your requirements.

[[Image:DisplayOptionsStatus.png]]

==== Modifying your Avatar ====

Simply left-click on the avatar to select from the pre-loaded options.

Alternatively, you can upload your own by clicking on the 'Upload' link at the bottom of the window.

[[Image:AvatarSelection.png]]

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Simplified Scripting

2026-05-19T22:03:11Z

Jeremy: Voice/structure cleanup (3 edits): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">
== Effortless Scripting with Nexus 3.0 ==

Nexus 3.0 Simplified Scripting tool enables users to craft intricate triggers, aliases, events, and keybinds using an easy-to-understand interface. This is an alternative to advanced scripting, which is more complex and needs JavaScript knowledge.

The tool incorporates 15 distinct actions for various uses. 'Hide the line', 'Highlight', and 'Rewrite' work for triggers and events only, not aliases or keybinds.

=== Action Options in Nexus 3.0 ===

==== Send a Command ====
The most fundamental and frequently used action, this allows the trigger to automatically send a text response to the game. For instance, when the action is activated, it could send the command 'attack rat'.
[[Image:Action-command.png]]

==== Show a Notice ====
This action displays a notice in the colors of your choosing. Players often use this feature to highlight an event or occurrence that they need to take note of but not necessarily respond to immediately. An example usage could be to display a bright red 'HIT HIM AGAIN' message when activated.

[[Image:Action-notice-new.png]]

==== Desktop Notification ====
This action provides a desktop notification when a specific trigger has been fired. For instance, you could create a trigger that sends a desktop notification whenever someone enters the room.
NOTE: You must have "notifications" turned on in Settings -> Display Options. In addition, you may have to "allow" notifications in your browser.

[[Image:Action-notification-new.png]]

[[File:Notification.png]]

==== Play a Sound ====
This action lets you play a specific sound when a trigger is fired. You could set up an alert sound to be played whenever another player enters the room.

[[Image:Action-sound-new.png]]

==== Wait ====
The wait action is generally used alongside other actions. For instance, you could set up an action to 'wait' for 3 seconds and then 'attack the rat'.

[[Image:Action-wait-new.png]]

==== Wait for ====
This action acts as a temporary trigger. It allows you to stipulate a line or pattern to wait for. Once detected, the script continues its execution normally. If not found within the defined timeout, the script is halted. For example, you could set up a trigger to fire when you regain your mental equilibrium and then wait for 10 seconds to receive the text 'You have recovered balance.' before sending the next command, 'kick rabbit'.

[[Image:Action-wait-for-new.png]]

==== Hide the Line (or Gagging) ====
This option lets you hide any line that matches your trigger, which can be handy for repetitive text you're tired of seeing. This action is also known as 'gagging'.

==== Highlight ====
This action enables you to highlight the matched text. There are also additional options to highlight the surrounding text associated with the trigger.

==== Rewrite ====
A rewrite will replace the trigger text with whatever you prefer. This can be particularly useful for abbreviating lengthy combat messages. For instance, you could rewrite a lengthy message to simply display 'Balance back' in bright yellow.

==== Linkify ====
Like Rewrite, Linkify changes the trigger text to your preferred phrase. It also makes the text a clickable link that runs any command you choose. For example, you could change the trigger text to 'Need to wake up!' and make it a link that will issue the 'wake' command.

==== Modify Variable ====
This action is used to modify a specified variable. You can set its value, increase or decrease it, assign the value of another variable to it, or modify it by the value of another variable. You can also assign the matched text or a captured part of it. This is a highly flexible action.

==== If ====
This is a powerful action for reflexes, allowing your reflexes to execute actions based on certain conditions. For instance, you can compare two variables, or a variable and a fixed value. You can also compare it against the matched text or a captured part of it. Depending on whether the check succeeds or fails, you can determine whether the reflex continues to run normally, stops, or continues running from a 'Label' action.

==== Repeat ====
This action lets you repeat a block of actions multiple times. All actions leading up to a label that you specify will be repeated.

==== Label ====
This action doesn't do anything by itself. However, it's used in conjunction with 'If', 'Repeat', and 'Jump to Label' actions to allow for conditional execution and looping.

==== Jump to Label ====
This action prompts a jump to a label of your choice. It's best used within an 'If' or 'Repeat' block to avoid creating an endless loop.

==== Disable this Reflex ====
This action disables the current reflex, which can be useful when creating reflexes intended for single-use.

==== Disable Reflex ====
This action lets you disable a chosen reflex, which must have a name. It can also disable entire groups of reflexes.

==== Enable Reflex ====
Similar to 'Disable Reflex', this action enables a named reflex or a group of reflexes.

==== Stop ====
This action halts all actions beyond this point. This can be useful for testing or within 'If' actions.

==== Modify a Button ====
This action allows you to modify any of the client's buttons. You can change the label, change the command, highlight, unhighlight, or reset the button to its default state.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

GMCP

2026-05-19T22:03:11Z

Jeremy: Voice/structure cleanup (1 edit): strip AI tics, light prose tightening, headings where applicable

[[File:Aetolia-dwarf.jpg|right|frame|caption|Dwarf Terradrim from Aetolia.]] General MUD Telnet Protocol (GMCP) is a protocol used to send data from the game server to the player client. This data transfer happens behind the scenes and is not seen by the players. This allows the game server to send messages to the client to update basic character, room, and game information. Character health is an example of information that is continually passed to the client from the game.

These messages can also be accessed by the player for use in [[reflexes]]. We are working simplifying the process of capturing GMCP data for use in the client in a future version of the client.

There is a configuration option in the Advanced Settings tab that will allow you to see GMCP messages as they happen.

Module and message names are not case sensitive. JSON key names are case sensitive.

=== Supported modules ===

This documentation covers the following GMCP messages for the Iron Realms Games.

* Core: core functionality
* Char: information about a character
* Char.Afflictions: information the characters afflictions
* Char.Defences- information the characters defences
* Char.Items: information about items in inventory and room, with live updates
* Char.Skills: information about skills known by the player
* Comm.Channel: identification of communication channels and player lists
* Room: various information about the current room
* Redirect: redirect outpot to another window
* IRE.Composer: IRE-specific, used to edit bigger texts client-side
* IRE.Display: IRE-specific display information
* IRE.FileStore: used internally by the Nexus client
* IRE.Misc: used internally by the fMUD and Nexus clients
* IRE.Rift: IRE-specific, transmits information about the Rift contents
* IRE.Sound: Yes. Sound can be sent.
* IRE.Target: information about the current player target.
* IRE.Tasks: information about tasks, quests, and achievements.
* IRE.Time: information about the current time and date conditions in the game.
* IRE.CombatMessage: currently only used by Starmourn - information about attacks seen
* IRE.Wiz: used internally by the Nexus client

=== Supported messages by modules ===

==== Core ====
* Sent by client:
** Core.Hello
*** Needs to be the first message that the client sends, used to identify the client
*** Message body is an object with keys "client" and "version", containing the client's name and version
*** '''Example''': Core.Hello {"Client":"Mudlet","Version":"3.0.0"}
** Core.Supports.Set
*** Notifies the server about packages supported by the client
*** If another Core.Supports.*** package has been received earlier, the list is deleted and replaced with the new one
*** Message body is an array of strings, each consisting of the module name and version, separated by space
*** Module version is a positive non-zero integer
*** Most client implementations will only need to send Set once and won't need Add/Remove; exceptions are module implementations provided by plug-ins
*** '''Example''': Core.Supports.Set [ "Char 1", "Char.Skills 1", "Char.Items 1" ]
** Core.Supports.Add
*** Similar to Set, but appends the supported module list to the one sent earlier
*** If no list was sent yet, the behaviour is identical to Set
*** If the list includes module names that were already included earlier, the new version number takes precedence over the previously sent one, even if the newly sent number is lower
*** Message body format is identical to that of Set
*** '''Example''': Core.Supports.Add [ "Char 1", "Char.Skills 1", "Char.Items 1" ]
** Core.Supports.Remove
*** Removes specified modules from the list of supported modules
*** Message body format is similar to Set, except that module version numbers are optional and ignored if given
*** '''Example''': Core.Supports.Remove [ "Char", "Char.Skills", "Char.Items" ]
** Core.KeepAlive
*** Causes the server to reset the timeout for the logged character, no message body
** Core.Ping
*** causes the server to send a Core.Ping back
*** message body is a number which indicates average ping time from previous requests, if available
*** '''Example''': Core.Ping 120

* Sent by server:
** Core.Ping
*** Sent in reply to Core.Ping. No body.
** Core.Goodbye
*** Sent by server immediately before terminating a connection
*** Message body is a string to be shown to the user - it can explain the reason for the disconnect
*** '''Example''': Core.Goodbye "Goodbye, adventurer"

==== Char ====
* Sent by client:
** Char.Login
*** Used to log in a character, only interpreted if no character is logged in for that connection
*** Message body is an object with keys "name" and "password"
*** '''Example''': Char.Login { "name": "somename", "password": "somepassword" }

* Sent by server:
** Char.Name
*** Sends the character name and full name which includes the title. This is only sent on login.
*** '''Example''': Char.Name { "name": "Olad", "fullname": "Neophyte Olad" }
** Char.Vitals
*** Basic character attributes such as health, mana, etc.
*** Message body is an object containing several variables
*** Each variable is also included in a string, in the format name:cur/max
*** Interpretation of the variables is game specific
*** It is generally safe to assume that the known values are numbers (even though encoded as strings), but other datatypes can be present
*** The "charstats" attribute, if present, holds a list of strings that the client may choose to display to the player in a client-specific way, these hold information about the character state that the game wishes to show to the player
*** '''Example''': Char.Vitals { "hp": "4500", "maxhp": "4800", "mp": "1200", "maxmp": "2500", "ep": "15000", "maxep": "16000", "wp": "14000", "maxwp": "15000", "nl": "10", "string": "H:4500/4800 M:1200/2500 E:15000/16000 W:14000/15000 NL:10/100" }
*** '''Additional Achaea Keys'''
**** All classes: Bleed, Rage
**** Apostates: Essence
**** Bard: Stance, Voice Balance
**** Blademaster: Stance
**** Druid: Current Morph, Sunlight Energy
**** Infernal: Essence, Weaponmastery Spec
**** Magi: Channels
**** Monk: Kai Energy, Tekura stance
**** Occultist: Karma, Entity Balance
**** Paladin: Devotion, Weaponmastery Spec
**** Priest: Devotion
**** Runewarden: Weaponmastery Spec
**** Sentinel: Current Morph
**** Serpent: Secreted Venom
**** Shaman: Number of spirits bound
**** Sylvan: Elemental Channels, Sunlight Energy
*** '''Additional Aetolia Keys'''
*** '''Additional Imperian Keys'''
**** General: bleed, flying, prone, stunned, dead, blind, phased, res_weakness, vote
**** Balances: leftarm, rightarm, health, herb, salve, toadstool, pipe, tree, focus, purge
**** Resources: kai, devotion, essence, fanatism, rage, fire, ice, faith, health_reserve, mana_reserve
**** Items: leftwield, leftwield_name, rightwield, rightwield_name, mount
*** '''Additional Starmourn Keys'''
**** General: "xp" (raw xp), "nl" (percent xp to next level), "ww" (wetwiring not on cooldown), "combat" (are you in combat?), "vote" (have you voted on TMS recently?)
**** Subsystems: "em" (electromagnetic damage), "external", "muscular", "internal", "sensory", "mind", "wetwiring"
**** Class-specific: "class" (current class), "pl" / "maxpl" / "formatpl" (plasma), "bl" / "maxbl" / "formatbl" (bullets), "nn" / "maxnn" / "formatnn" (nanites), "sa" / "maxsa" / "formatsa" (sanity), "rg" / "maxrg" / "formatrg" (rage), "pt" / "maxpt" / "formatpt" (parts), "st" (stance)
** Char.StatusVars
*** Sent by server after a successful login or after the module is enabled
*** Contains a list of character variables (level, race, etc)
*** Message body is an object
*** Each object element is a name-caption pair, name is the internal name and caption the user-visible one
*** '''Example''': Char.StatusVars { "level": "Level", "race": "Race", "guild": "Guild" }
** Char.Status
*** Values of character values defined by StatusVars.
*** A full list is sent by server right after StatusVars, and changes are sent in subsequent messages as they occur.
*** With the exception of the initial Status message, messages only contain changed values; if a variable is not included, it has not changed since the previous Status message.
*** Message body is an object.
*** Each object element is a name-value pair, name is the internal name defined by the StatusVars message and value is the variable value.
*** '''Example''': Char.Status { "level": "58", "city": "Antioch" }
*** ''' Achaea Keys'''
**** name
**** fullname
**** age
**** race
**** specialisation
**** level
**** xp
**** xprank
**** class
**** city
**** house
**** order
**** boundcredits
**** unboundcredits
**** lessons
**** explorerrank
**** mayancrowns
**** boundmayancrowns
**** gold
**** bank
**** unread_msgs
**** unread_news
**** target
**** gender

===== Char.Afflictions =====
* Sent by server:
** Char.Afflictions.List
*** Sends an array of current character afflictions.
**** name: The name of the affliction
**** cure: The basic cure of the affliction. This is used for links to cure even though other options may exist to cure the affliction.
**** desc: A description of what this affliction does.
*** '''Example''': Char.Afflictions.List [ { "name": "weariness", "cure": "eat kelp", "desc": "Decreases cutting and blunt damage that you inflict by 30%." }, { "name": "asthma", "cure": "eat kelp", "desc": "Makes you unable to smoke pipes." }, { "name": "slow herbs", "cure": "apply epidermal", "desc": "Increases the time needed to regain herb balance by 1.25 seconds." }, { "name": "nausea", "cure": "eat nightshade", "desc": "Causes periodic vomiting, which does damage and increases hunger." } ]
** Char.Afflictions.Add
*** Add an affliction to the character.
*** '''Example''': Char.Afflictions.Add { "name": "asthma", "cure": "eat kelp", "desc": "Makes you unable to smoke pipes." }
** Char.Afflictions.Remove
*** Removes an affliction from the character.
*** '''Example''': Char.Afflictions.Remove [ "asthma" ]

===== Char.Defences=====
* Sent by server:
** Char.Defences.List
*** Send an array of all the defences a character currently has.
**** name: The name of the defence.
**** desc: The description of the defence.
*** '''Example''': Char.Defences.List [ { "name": "deaf", "desc": "deaf" }, { "name": "blind", "desc": "blind" }, { "name": "nightsight", "desc": "nightsight" } ]
** Char.Defences.Add
*** Sent when a defence is added to a character.
*** '''Example''': Char.Defences.Add { "name": "deaf", "desc": "deaf" }
** Char.Defences.Remove
*** Sent when a defence is removed from a character.
*** '''Example''': Char.Defences.Remove [ "blind" ]

===== Char.Items =====
* Sent by client:
** Char.Items.Contents
*** Request for the server to send the list of items located inside another item.
*** Message body is a number identifying the item.
*** Causes the server to send back an appropriate Char.Items.List message.
*** '''Example''': Char.Item.Contents 12345
** Char.Items.Inv
*** Request for the server to send the list of items in player's inventory.
*** Message body is empty.
*** Causes the server to send back an appropriate Char.Items.List message.
*** '''Example''': Char.Items.Inv ""
** Char.Items.Room
*** Sent by the client to refresh the items in a room.
*** Message body is empty
*** Causes the server to send back an appropriate Char.Items.List message.
*** '''Example''': Char.Items.Room ""

* Sent by server:
** Char.Items.List
*** List of items at a specified location (room, inv, held container)
*** Message body is an object with keys "location" and "items"
*** Location value is a string, "inv", "room", or "repNUMBER" - the last one is container identification
*** Items value is an array, whose each item is an object with keys "id", "name" and optionally "attrib"
*** ID is a number identifying the item, name is a string containing a short player-visible item description
*** Icon is the image the item is associated with in the client.
*** Attrib is a string consisting of characters describing item properties:
**** "w" = worn,
**** "W" = wearable but not worn
**** "l" = wielded
**** "g" = groupable
**** "c" = container
**** "t" = takeable
**** "m" = monster
**** "d" = dead monster
**** "x" = should not be targeted (guards, ...)
*** '''Example''': Char.Items.List { "location": "inv", "items": [ { "id": "12807", "name": "a personal journal", "icon": "scroll", "attrib": "l" }, { "id": "303060", "name": "a gold nugget", "icon": "commodity" } ] }
** Char.Items.Add
*** Informs the client about an item being added to the specified location
*** Message body is an object with keys "location" and "item"
*** Location is same as with List, item is an object with the same structure as one item from the items array of List
*** '''Example''': Char.Items.Add { "location": "room", "item": { "id": "239602", "name": "an elegant white letter", "icon": "container", "attrib": "c" } }
*** '''Example''': Char.Items.Add { "location": "room", "item": { "id": "303060", "name": "a gold nugget", "icon": "commodity" } }
*** '''Example''': Char.Items.Add { "location": "inv", "item": { "id": "303060", "name": "a gold nugget", "icon": "commodity", "attrib": "t" } }
** Char.Items.Remove
*** Informs the client about an item being removed from the location
*** Message body is an object with keys "location" and "item"
*** Location is same as with List, item is an integer value identifying the item
*** '''Example''': Char.Items.Remove { "location": "room", "item": { "id": "239602", "name": "an elegant white letter", "icon": "container", "attrib": "t" } }
*** '''Example''': Char.Items.Remove { "location": "inv", "item": { "id": "303060", "name": "a gold nugget", "icon": "commodity" } }
** Char.Items.Update
*** Informs the client about an item's attributes being changed - only sent for inventory items
*** Message body syntax the same as with Add
*** '''Example''': Char.Items.Update { "location": "inv", "item": { "id": "60572", "name": "an ornate steel rapier" } }

===== Char.Skills =====
* Sent by client:
** Char.Skills.Get
*** Sent by client to request skill information
*** Message body is an object with keys "group" and "name"
*** If both group and name is provided, the server will send Char.Skills.Info for the specified skill
*** If group is provided but name is not, the server will send Char.Skills.List for that group
*** Otherwise the server will send Char.Skills.Groups
*** '''Example''': Char.Skills.Get {"group":"Perception"}
*** '''Example''': Char.Skills.Get {"group":"perception","name":"Deathsight"}

* Sent by server:
** Char.Skills.Groups
*** Groups of skills available to the character
*** Sent by server on request or at any time (usually if the list changes)
*** For IRE games, groups are skills like Survival or Elemancy
*** Message body is an array including the name and current rank of each skill the character has.
*** '''Example''': Char.Skills.Groups [ { "name": "Perception", "rank": "Transcendent (100%)" }, { "name": "Survival", "rank": "Inept (0%)" }, { "name": "Weaponry", "rank": "Inept (0%)" }, { "name": "Tattoos", "rank": "Inept (0%)" }, { "name": "Evasion", "rank": "Inept (0%)" }, { "name": "Engineering", "rank": "Inept (0%)" }, { "name": "Taming", "rank": "Inept (0%)" }, { "name": "Concoctions", "rank": "Inept (0%)" }, { "name": "Toxins", "rank": "Inept (0%)" }, { "name": "Smithing", "rank": "Inept (0%)" }, { "name": "Malignosis", "rank": "Adept (1%)" }, { "name": "Necromancy", "rank": "Inept (0%)" }, { "name": "Evileye", "rank": "Adept (40%)" } ]

** Char.Skills.List
*** List of skills in a group available to the character
*** Sent by server on request only
*** For IRE games, this is the list visible on AB <skillname>
*** Message body is an object with keys "group", "list", and "desc".
*** The list value is an array of strings, each being the name of one skill
*** '''Example''': Char.Skills.List { "group": "perception", "list": [ "Looking", "Glancing", "Secrets", "Decaylist", "Squinting", "Flyers", "Observe", "Farsight", "Containerlist", "Vigilance", "Treewatch", "Deathsight", "Pipelist", "Elixlist", "Search", "Letterlist", "Booklist", "Skywatch", "PowerNodes", "Keylist", "Alertness", "Rites", "Traps", "Magicklist", "Nightsight", "Hypersight", "Thirdeye", "Tattoos", "Discernment", "Wormholes", "Rivensense", "Contemplation", "Scan", "Telesense", "Appraise", "Trueassess", "Artifactlist", "Warning", "Viewshrine", "Landsense" ], "descs": [ "Gain knowledge of your immediate surroundings.", "See summarized information about your surroundings.", "Discover hidden exits.", "How much more time do those items have?", "See extended distances in your line of sight.", "Take notice of those in the skies.", "Gain information about your extended surroundings.", "Attempt to locate another player from afar.", "What do you have in your containers?", "Increase your resistance to hypnosis.", "Watch the forest canopies for movement.", "Attune yourself to the Underworld.", "Scan your pipes with utmost speed.", "Quickly discover what elixirs and salves you are holding.", "Search your location for hidden beings.", "Quick glance of all your letters.", "Scan the titles of books you own.", "Watch the skies for movement.", "Detect the nodes of power in your area.", "See a list of your keys and which doors they open.", "Heightened awareness of your surroundings.", "View the holy rites operating in your location.", "The ability to search for traps in your location.", "Check the status of your magickal items.", "Use infravision to see in the dark.", "See the actions of cloaked players.", "Give yourself the power of the third eye.", "Discover what tattoos are on another player.", "Discover what defences are protecting an individual.", "The ability to sense wormholes in your location.", "Sense the bodies of the recently slain.", "Perceive the state of another's mental strength.", "Seekout the locations of your allies and enemies.", "Heighten your awareness to telepathic attempts.", "Quickly take note of someone's carried possessions.", "Gain more detailed information concerning your foe.", "See what artifact powers surround an individual.", "Watch for the prying eyes of the enemy.", "Gain a detailed understanding of a shrine.", "The ability to recognize mortals entering the realm." ] }

** Char.Skills.Info
*** Information about a single skill, only sent upon request
*** Message body is an object, keys are "group", "skill", and "info", values are strings
*** Group and skill identify the request, info is a description (usually multi-line) of the skill's functionality and usage
*** '''Example''': Char.Skills.Info { "group": "perception", "skill": "deathsight", "info": "Syntax: DEATHSIGHT\n RELAX DEATHSIGHT\n\nUsing this ability, your mind is now capable of attuning itself to the realm of the dead. While doing so, you will be alerted whenever anyone dies." }
==== Comm.Channel ====
* Sent by client:
** Comm.Channel.Players
*** Request for the server to send Comm.Channel.Players
*** No message body.
*** '''Example''': Comm.Channel.Players ""
** Comm.Channel.Enable
*** Used to tell the game to turn on a character channel without typing in a command line command.
*** Example: Comm.Channel.Enable "newbie"
*** Example: Comm.Channel.Enable "clt Consortium"

* Sent by server:
** Comm.Channel.Players
*** List of players and organizations (city, guild, ...) that they share with this player
*** Message body is an array with each element describing one player
*** Each element is an object with keys "name" and "channels", name is a string, channels is an array
*** The channels array may be omitted if empty; if given, it is a list of organization names
*** '''Example''': Comm.Channel.Players [{"name": "Player1", "channels: ["Some city", "Some guild"]}, {"name": "Player2"}]
*** '''Example''': Comm.Channel.Players [ { "name": "Ahkan", "channels": [ "The City of Stavenn" ] }, { "name": "Sharatar", "channels": [ "The City of Stavenn", "The Revenants" ] } ]

** Comm.Channel.List
*** List of communication channels available to the player, sent on login/negotiation and if changed
*** Message body is an array of objects, each object representing one channel
*** Each object has keys "name", "caption" and "command" - name is internal name, caption is player-visible name, command is command used to communicate over this channel
*** '''Example''': Comm.Channel.List [{"name":"ct", "caption":"Some city", "command":"ct"}, {"name":"gt", "caption":"Some guild", "command":"gt"}]
*** '''Example''': Comm.Channel.List [ { "name": "newbie", "caption": "Newbie", "command": "newbie" }, { "name": "market", "caption": "Market", "command": "market" }, { "name": "ct", "caption": "Stavenn", "command": "ct" }, { "name": "gt", "caption": "Revenants", "command": "gt" } ]

** Comm.Channel.Start
*** Informs the client that text that follows is something said over a communication channel
*** Message body is a text containing the channel name
*** For tells from/to another player, the channel name is "tell Name"
*** '''Example''': Comm.Channel.Start "ct"
*** '''Example''' :Comm.Channel.Start "tell Jeremy"
** Comm.Channel.End
*** Ends a channel text started by Comm.Channel.Start
*** Message body is a text containing the channel name
*** '''Example''': Comm.Channel.End "tell Jeremy"

** Comm.Channel.Text
*** The text of the communication that you heard, who spoke, and which channel it was on
*** '''Example''': Comm.Channel.Text { "channel": "says", "talker": "Tecton", "text": "(Tecton the Terraformer says, \"Are we releasing dragon lairs or the phase artefact first?\"" }
*** '''Example''': Comm.Channel.Text { "channel": "tell Jeremy", "talker": "Olad", "text": "\u001b[0;1;33mYou tell Jeremy, \"Hi.\"\u001b[0;37m" }
*** '''Example''': Comm.Channel.Text { "channel": "newbie", "talker": "Olad", "text": "\u001b[0;1;32m(Newbie): You say, \"Hello.\"\u001b[0;37m" }

==== Room ====
* Sent by server:
** Room.Info
*** Contains information about the room that the player is in. Some of these may be IRE-specific
*** Message body is an object with the following keys
**** "num" - number identifying the room
**** "name" - string containing the brief description
**** "area" - string containing area name
**** "environment" - string containing environment type ("Hills", "Ocean", ...)
**** "coords" - room coordinates (string of numbers separated by commas - area,X,Y,X,building, building is optional
**** "map" - map information - URL pointing to a map image, followed by X and Y room (not pixel) coordinates on the map
**** "details" - array holding further information about a room - shop,bank,...
**** "exits" - object containing exits, each key is a direction and each value is the number identifying the target room
*** '''Example''': Room.Info {"num": 12345, "name": "On a hill", "area": "Barren hills", "environment": "Hills", "coords": "45,5,4,3", "map": "www.imperian.com/itex/maps/clientmap.php?map=45&level=3 5 4", "exits": { "n": 12344, "se": 12336 }, "details": [ "shop", "bank" ] }
** Room.WrongDir
*** Sent if the player attempts to move in a non-existant direction using the standard movement commands
*** Upon receiving this message, the client can safely assume that the specified direction does not lead anywhere at this time
*** Message body is a string with the name if the non-existant exit
*** Example: Room.WrongDir "ne"
** Room.Players
*** Object containing player details, each key is the short name of the player and each value is the full name including titles for the player
*** '''Example''': Room.Players [{ "name": "Tecton", "fullname": "Tecton the Terraformer" }, {"name": "Cardan", "fullname": "Cardan, the Curious" }]
** Room.AddPlayer
*** Message body has the same object structure as Room.Players except that it only contains the one player being added to the room.
*** '''Example''': Room.AddPlayer { "name": "Cardan", "fullname": "(Cardan, the Curious)" }
** Room.RemovePlayer
*** Message body has the same object structure as Room.Players except that it only contains the one player being removed from the room.
*** '''Example''': Room.RemovePlayer "Cardan"

==== Redirect ====
* Sent by server:
** Redirect.Window
*** Specifies a window to redirect further input to
*** Message body is a string specifying the window to redirect to
*** The main window is referred to as "main", and is the default if the message body is omitted or empty
*** Example: Redirect.Window "map"
==== IRE ====
===== IRE.Composer =====
* Sent by server:
** IRE.Composer.Edit
*** Sent by the server when the player enters an in-game editor. Body is an object, with keys "title" and "text". Text contains the current buffer, title is a title that can be shown to the user.
*** '''Example''': IRE.Composer.Edit { "title": "Composer", "text": "" }

* Sent by client:
** IRE.Composer.SetBuffer
*** Sent by the client upon successfully editing a text which was sent to the client in an IRE.Composer.Edit message earlier
*** Sending this message only changes the edit buffer, but does not end the editing session
*** On IRE games, the client may send the command ***save to save a text, or command ***quit to abort editing (IRE.Composer.SetBuffer is not sent in this case) - this behaviour is IRE-specific and is one of the reasons why the Composer module is in the IRE namespace
*** '''Example''': IRE.Composer.SetBuffer "This is a bunch of text."

===== IRE.Display =====
* Send by server:
** IRE.Display.FixedFont "start" | "stop"
*** Sent by the server to indicate between the start and stop messages should be displayed in a fixed-width font.
** IRE.Display.Ohmap "start" | "stop"
*** Sent by the server to indicated that an overhead map is being sent to the client.

===== IRE.Misc =====
* Sent by client:
** IRE.Misc.Voted
*** Informs the game a vote button was clicked.
*** Example: IRE.Misc.Voted ""

* Sent by server:
** IRE.Misc.RemindVote
*** Message sent to remind the player to vote.
*** '''Example''': IRE.Misc.RemindVote "http://www.imperian.com/vote"

** IRE.Misc.Achievement
*** Used to send basic achievement data to the client.
*** '''Example''': IRE.Misc.Achievement [{"name": "HighestLevelAchieved", "value": "89" }]

** IRE.Misc.URL
*** Sends a url to the client to open in a window when clicked.
*** '''Example''': IRE.Misc.URL[{"url": "http://www.imperian.com/tos", "window": "ire_game_tos" }]

** IRE.MISC.Tip
*** Sends a line of text to the client.
*** '''Example''': IRE.Misc.Tip "This is a tip!"

===== IRE.Rift =====
* Sent by server:
** IRE.Rift.List
*** contents of a Rift storage
*** sent upon receiving the IRE.Rift.Request message
*** message body is an array, with each element being an object containing three keys - "name" is item name, "amount" is a number holding the item's amount, and "desc" is user-visible description
** IRE.Rift.Change
*** sent whenever the item amount in a Rift changes
*** message body is an object with the same structure as one element of an array sent with the IRE.Rift.List message

* Sent by client:
** IRE.Rift.Request
*** asks the server to send the Rift contents using the IRE.Rift.List message

===== IRE.Sound =====
These messages are used internally within the Nexus client to play sounds.
* Sent by server:
** IRE.Sound.Play
*** Sent to inform a client that a sound should be played. Keys: name (required), fadein_csec, fadeout_csec, loop (bool)
** IRE.Sound.Stop
*** Sent to inform a client that a specific sound's playback should be halted. Keys: name (required), fadeout_csec
** IRE.Sound.Stopall
*** Sent to inform a client that all sounds' playback should be halted. Keys: fadeout_csec
** IRE.Sound.Preload
*** Sent to inform a client that it should download a sound resource for future playing. Keys: name (required)

===== IRE.Target =====
* Sent by client:
** IRE.Target.Set
*** Sends the currently set target to the server to be used by the internal alias system.
*** '''Example''': IRE.Target.Set "1101"
* Sent by server

** IRE.Target.Set
*** Sends the target the client is trying to set. This is called from cycling targets with tab targeting.
*** '''Example''': IRE.Target.Set "1101"
** IRE.Target.Info
*** Sends an array with the current target information.
*** '''Example''': IRE.Target.Info { "id": "1101", "short_desc": "a brawny goblin smith", "hpperc": "100%" }
** IRE.Target.Request

===== IRE.Tasks =====

* Sent by client:
** IRE.Tasks.Request

* Sent by server:
** IRE.Tasks.List
*** This is used to send a list of quest, tasks, and achievements, depending on what the game supports.
*** Sends an array of items with the following keys:
**** id: A numeric identifier
**** name: The name of the quest, task, or achievement.
**** type: Is this a quest, task, or achievement.
**** cmd: The command to get more information for the quest. Good for MXP links.
**** desc: The description of the event.
**** status: 0 or 1 based on if it is completed or not.
**** group: What group should this be assigned to. This is mainly for client display purposes.
*** '''Example''': IRE.Tasks.List [ { "id": "184", "name": "For the sake of the village", "desc": "The herbs in Maeven's garden are painstakingly cared for so that her fellow villagers can stay healthy. She won't object to borrowing a bit of the magick power the bakuls have, if it can help with her work.\n\nThe bakul herbalist might have something Maeven wants.", "type": "quests", "cmd": "quest For the sake of the village", "status": "0", "group": "Current Quests" }, { "id": "313", "name": "Apostate", "desc": "Destroy a Shrine.", "type": "achievements", "cmd": "achievement apostate", "status": "0", "group": "Sects" } ]
** IRE.Tasks.Update
** IRE.Tasks.Completed

===== IRE.Time =====
* Sent by client:
** IRE.Time.Request

* Sent by server:
** IRE.Time.List
*** A list of the current time condition in the game world.
*** Used in the client to display the the day/night indicator.
*** '''Example''': IRE.Time.List { "day": "1", "mon": "1", "month": "Letum", "year": "98", "hour": "41", "daynight": "80" }
** IRE.Time.Update
*** Used to update time conditions.
*** '''Example''': IRE.Time.Update { "daynight": "112" }

===== IRE.CombatMessage =====
* Sent by client:
** N/A

* Sent by server:
** IRE.CombatMessage
*** Information about an attack that you have seen. Currently only used by Starmourn.
*** '''Example''': <nowiki>IRE.CombatMessage {["skirmishing kick"] = {target = "Tecton",message = [[You cock back your leg and unleash a swift kick at Tecton.]],caster = "Iorwerth"}}</nowiki>

How To Submit Bugs

2026-05-19T22:03:10Z

Jeremy: Voice/structure cleanup (3 edits): strip AI tics, light prose tightening, headings where applicable

<table>
<div class="row">
<div class="large-8 columns">
Thank you for choosing the Iron Realms Nexus Client. We greatly appreciate your support and commitment to helping us improve our software. If you encounter any bugs or issues while using the Nexus Client, we encourage you to submit a bug report. By reporting bugs, you contribute to enhancing the overall user experience and ensuring a smooth gameplay environment.

To submit a bug report for the Iron Realms Nexus Client, please follow the steps outlined below:

== Navigate to the Bug Submission Form ==
The following links provide a structured format for reporting bugs and collecting the necessary information to address the issue effectively.

* [https://client.achaea.com/bugs Submit a bug for Achaea]
* [https://client.aetolia.com/bugs Submit a bug for Aetolia]
* [https://client.imperian.com/bugs Submit a bug for Imperian]
* [https://client.lusternia.com/bugs Submit a bug for Lusternia]
* [https://client.starmourn.com/bugs Submit a bug for Starmourn]

For those of you without a character on an IRE game, you can submit issues here:

* [https://betaclient.ironrealms.com/bugs Submit a bug for the beta client]

== Provide Detailed Information ==
Fill out the Bug Submission Form with accurate and specific details regarding the encountered bug. Be sure to include the following information:

* '''Category''' Select the "General Category" for the time being.
* '''Reproducibility''' Select how easily you can reproduce this issue.
* '''Severity''': Select a severity level for this issue.
* '''Priority''': Select a priority level for this issue.
* '''Select Profile''': Please, specify the platform and operating system you are using (e.g., Windows, Browser, Linux, iOS, Android).
* '''Summary''': Give a concise and descriptive title for the bug report, summarizing the issue.
* '''Description''': Provide a detailed explanation of the bug, including the steps to reproduce it. The more information you provide, the easier it will be for our development team to identify and resolve the issue.
* '''Severity''': Assess the severity level of the bug based on its impact on gameplay or functionality (e.g., critical, major, minor).
* '''Priority''': Assign a priority level to the bug, indicating its urgency in terms of fixing (e.g., high, medium, low).
* '''Steps To Reproduce''': Please give us as much information as you can about how to recreate the issue you are experiencing.
* '''Additional Information''' Provide any other information about this issue you deem relevant.
* '''Upload Files''': If applicable, attach relevant screenshots or log files that can assist in understanding and diagnosing the bug.

== Monitor Bug Status ==
After submitting the bug report, you can track its progress through our bug tracking system. Our team will review the report, investigate the issue, and provide updates on its status as they work towards a resolution. Our Discord group also has a channel which automatically updates as bugs are addressed. You can find the group here: [https://discord.gg/Tz7t5SaD4q Nexus Discord]

We highly value your contribution to improving the Iron Realms Nexus Client. Your bug reports help us identify and address issues promptly, ensuring a more enjoyable and stable gaming experience for all users. We appreciate your time and effort in reporting bugs and helping us make the Nexus Client the best it can be.

If you have any further questions or require additional assistance, please don't hesitate to reach out to our support team.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Reflex Packages

2026-05-19T19:55:19Z

Jeremy: Add See also section cross-linking to 3.0 Import/Export (related but distinct feature)

<table>
<div class="row">
<div class="large-8 columns">

Reflex Packages are a way to group character settings. What makes packages different from groups in reflexes? You can export packages to share with other characters and friends.

For example, you may create a package of triggers and aliases used for bashing mobs in the game. You can export these settings, save them to your computer, and share them with other players or your other characters.

The following steps detail how to create, edit, export, and import reflex packages.

== Creating a New Reflex Package ==
The first step to using the reflex package system is to create a new package. You can then copy reflexes into the new package.

Creating a new package is very simple.

The following steps will walk you through the process of creating a new package. Keep in mind it will not add reflexes to it, you must do that separately.

=== Step 1: Click Add a Package ===
Click the 'Reflex Packages' tab in the settings window and then click the 'Add a package' button.

[[Image:Package_01.png]]

=== Step 2: Name and Describe Package ===
Decide on a package name and description then click 'Save'. In the example below, we are creating a new package called 'mining'.

[[Image:Package_02.png]]

=== Step 3: View Package in List ===
Once you confirm, the package is automatically displayed in the reflex package list. Below you can see that the 'Mining' package has been added to the list. You may then edit the description or name of the package right in the text input areas.

[[Image:Package_03.png]]

== Add Reflexes to a Package ==
Now that you have a package, you will want to add reflexes to it. Note that it will NOT delete the existing reflex. It will make a copy of the reflex and then add it to the package you select. You will then have two copies of the reflex.

=== Step 1: Check the Reflexes to Add ===

[[Image:Package_04.png]]

=== Step 2: Click Add to Package ===

[[Image:Package_05.png]]

=== Step 3: Select Package and Confirm ===

[[Image:Package_06.png]]

Note: The original reflexes are not deleted. A copy is made in the selected package.

== Editing Reflexes in a Package ==
Editing a reflex inside a package works the same as editing any other reflex, but you have to filter the Reflexes list first.

Go to the '''Reflexes''' settings (not the '''Reflex Packages''' settings). At the top left of the Reflexes menu, click the package dropdown and select the package you want to view. The list narrows to just the reflexes assigned to that package.

== Downloading a Package ==
You can download a package in order to save it as a backup, use it with other characters, or share it with your friends.

To download a package, just click on the small download icon on the Reflex Packages tab.

[[Image:Package_10.png]]

Note that the file is saved as a .nxs file. This is short for 'Nexus'.

== Exporting Selected Reflexes ==
You can also export a subset of your reflexes to a .nxs file without creating a package first.

In the '''Reflexes''' menu, check the boxes next to the reflexes you want to export. Then click the '''Export selected''' button below the reflex list. Your browser saves the file as a .nxs download.

== Importing a Package ==

Importing a package is a drag and drop, one step process. Simply click the 'Reflex Packages' tab and drag the .nxs file to the 'Import Reflex Package' area. These reflexes will now work automatically with your client.

[[Image:Package_11.png]]

Notice that once you have done this, the package will be listed in the 'Reflex Packages' section.

[[Image:Package_10.png]]

== See also ==
* [[3.0 Import/Export]] for backing up and restoring all your character settings (whole-character backup, distinct from per-reflex package sharing)

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Template:Nexus 3 Sidebar

2026-05-19T19:55:18Z

Jeremy: Add Import/Export to Client Settings section (between Variables and Advanced)

__NOTOC__
===Important Links===
* [[Client_Download|Download Nexus]]
* [[How_To_Submit_Bugs|How to Submit Bugs]]
* [[Nexus_3.0_Changelog|Nexus 3.0 Changelog]]
* [[Nexus_Discord|Join the Nexus Discord]]

===Nexus 3.0 Documentation===
The following links describe how to use the Nexus Client.

====The Basics====
* [[3.0_Nexus_Account|Nexus Account]]
* [[3.0_Game_Selection|Game Selection]]
* [[3.0_Character_Management|Character Management]]
* [[3.0_Game_Client|The Game Client]]
* [[3.0_Windows_and_Tabs|Windows and Tabs]]
* [[3.0_Keys,_Gauges,_and_Avatars|Keys, Gauges, Avatars]]
* [[3.0_General_Functions|General Functions]]

====Client Settings====
* [[3.0_Display_Options|Display Options]]
* [[3.0_Colors|Colors]]
* [[3.0_Buttons|Buttons]]
* [[3.0_Reflex_Packages|Reflex Packages]]
* [[3.0_Reflexes|Reflexes]]
* [[3.0_Variables|Variables]]
* [[3.0_Import/Export|Import/Export]]
* [[3.0_Advanced|Advanced]]
* [[3.0_Feedback|Feedback]]
* [[3.0_Help|Help]]

====Scripting====
* [[3.0_Simplified_Scripting|Simplified Scripting]]
* [[Simple Scripting Conversion|Simplified to JavaScript]]
* [[3.0_advanced_scripting|Advanced Scripting]]
* [[GMCP|GMCP]]
* [[Predefined_variables|Predefined Variables]]
* [[3.0_Examples|Examples]]

3.0 Import/Export

2026-05-19T19:55:18Z

Jeremy: Restructure with H2/H3 headings; strip AI tics (Additionally, Moreover); tighten prose; add See also cross-link to 3.0 Reflex Packages

<table>
<div class="row">
<div class="large-8 columns">

== Backing Up and Restoring Settings ==

To access the Import/Export options, open the settings menu (gear icon, bottom right of the Nexus client) and click the '''Import/Export''' button.

These options let you back up all your character settings to a file on your computer, or restore from one of two sources: a local backup file or a server-side backup that Nexus creates automatically.

=== Restore from a local file ===
Drag and drop the .nxs file from your computer into the '''Import Settings''' section.

=== Restore from a server backup ===
Nexus periodically creates backups of your character settings on our servers. To use one, click the version you want to restore.

== See also ==
* [[3.0 Reflex Packages]] for exporting and sharing individual reflexes or grouped packages (a different feature: targeted reflex sharing, not whole-character backup)
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Javascript

2026-05-19T19:43:47Z

Jeremy: Fix prefix-collision bug from previous bare-URL pass: /js replaced inside /jsref, leaving malformed wikitext

<table>
<div class="row">
<div class="large-8 columns">
JavaScript is an accessible programming language that significantly enhances the interactivity and dynamism of web pages. It offers the ability for users to unlock a wide range of advanced scripting features through the implementation of JavaScript functions. You can learn more about [[Functions]].

As a highly popular language, there is a multitude of dedicated resources available for learning JavaScript. These resources range from beginner's guides to advanced tutorials, and they are geared toward helping individuals grasp the nuances of this versatile language. Explore the links provided below for more in-depth information and tutorials:

==== Beginning JavaScript ====
* [https://www.javascript.com/ JavaScript.com] - Homepage of JavaScript.
* [http://www.w3schools.com/jsref W3Schools JavaScript Reference] - JavaScript reference guide.

==== Online Courses ====
* [http://www.w3schools.com/js W3Schools JavaScript Tutorial] - Introduction to JavaScript
* [https://www.codecademy.com/courses/getting-started-v2/0/1 Codecademy: Getting Started with JavaScript] - Getting started with JavaScript online course.
* [http://javascript-roadtrip.codeschool.com/ JavaScript Road Trip (Code School)] - JavaScript road trip course.

==== Expanding JavaScript with jQuery ====
* [https://learn.jquery.com Learn jQuery] - jQuery homepage.
* [http://www.w3schools.com/jquery/ W3Schools jQuery Tutorial] - Introduction to jQuery.

==== Regular Expressions ====
* [http://regexone.com/ RegexOne] - Introduction to regular expressions.
* [http://txt2re.com/ Txt2RE] - Online tool to convert a line of text into a regular expression.
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Triggers

2026-05-19T19:36:07Z

Jeremy: Convert bare URLs to named links (1 URL)

Triggers are a very powerful and versatile type of reflexes. Triggers allow you to automatically react when text (and other events) is sent to your character from the game.

A few brief examples of things triggers can do:

* Automatically send commands to the game when certain text is received.
* Hide unimportant lines you don't want to see.
* Highlight lines of text you do not want to accidentally miss.
* Modify portions of the lines received from the game.
* Save data in a variable for later use. Such as how much gold you picked up or the name of a player that hit you.

The basic usage of triggers is similar to that of [[aliases]] or [[keybinds]]. One thing to be careful of is that by default, triggers can match anywhere in the received text, not only at the beginning (you can change the ''Matching Type'' accordingly, if desired).

== How to Create a New Trigger ==

Triggers are a reflex. They are created and managed from the Reflexes tab in the settings window. To open the settings window, click on the gear icon [[File:Settings_icon.jpg|text-bottom]] in the lower right part of your main game screen

=== Step 1. Open the settings page and click the 'Reflexes' tab. ===

To create a new trigger, open your settings window by clicking on the gear icon [[File:Settings_icon.jpg|text-bottom]] in the lower right part of your game screen. This will popup a new window in your browser.

In the settings window, click on the 'Reflexes' tab as shown in the image below.

[[File:tab-reflexes.png|frame|center|Setting window displaying the reflexes tab.]]

=== Step 2. Click the 'Add' Button and select 'Add a Trigger'. ===

There are several different reflexes you can create. We want to create a trigger. In order to do this, click the 'Add' button located in the left pane and then click on 'Add a Trigger'. This will create a new, undefined trigger.

Should you want to delete a trigger, you can select the trigger from the list, and then click the 'Remove' button.

[[File:Trigger-create.png|frame|center|Example of creating a new trigger.]]

=== Step 3: Triggers Options. ===

There are two main option sections for triggers; '''Matching''' and '''Actions'''.

'''Enabled''' This checkbox marks if the trigger is currently being used by the system. If unchecked, this trigger will not be used.

'''Matching''' is used to find the text you would like to use for this trigger. When the game sends text to your character that matches, it will automatically send the action defined below it.

'''Actions''' is what will happen when the trigger matches text from the game. Actions can be used to automatically send text to the game, highlight you want to stand out, create complicated functions, and other things.

[[File:trigger-blank.png|frame|center|This is a blank trigger. It will not do anything until you add text to match and an action to do when that text is matched.]]

== Matching Options Explained ==

Matching is used to find text sent from the game to create an action for. You can match entire lines of text, single words, partial lines, and lines of text with variable words.

[[File:trigger-matching.png]]

There are five options for matching text.

=== Trigger Text ===

This field is required and contains the text to match.

Examples of Trigger Text:
* You have recovered balance.
* You have recovered
* recovered balance.
* You have recovered balance.

This works hand in hand with the '''Matching Type''' option. See below.

==== Wildcards in Trigger Text ====

This is a very powerful feature in the Nexus client that you will want to understand.

There are times when you'll want to use wildcard matches in your triggers. Most messages you will want to trigger will vary slightly. Character names, item number, and more.

For example, let's say someone is entering the room you are in.

You can the name in <>'s to allow the trigger to fire. You can also assign the name to a variable. If an example line is ''Jeremy enters from the north'', you could configure your trigger to match on ''<person> enters from the <direction>''. As an added bonus, you can then use @person and @direction as variables in the trigger actions.

These simplified triggers do not work with regular expressions, and if using this advanced feature, you'll want to ensure that you're using the correct syntax.

[[WildcardMatching|Here is a full example of a basic wildcard match.]]

=== Matching Type ===

There are four options for matching text.

* '''Contains''': This will match any line that has your trigger text in it.
* '''Begins with''': Will only match a line that starts with your trigger text in it.
* '''Exact match''': Will only match a line that matches exactly like your trigger text.
* '''Regular expression''': This will match any regular expression patterns. This is advanced, but good to learn.

In most cases you will want to use ''Contains'' option unless you have more complicated situations.

=== Whole Words Only ===

If checked, the trigger will only match whole words.

For example; you create a trigger with trigger text set to 'You have recovered bal'.

If the game sends the text - You have recovered balance. - it will '''NOT''' match, because 'balance.' is a different whole word than 'bal'.

If I uncheck 'Whole words only', the trigger would work.

In almost all cases you will just want to keep 'Whole words only' turned on and be sure to include the full trigger text. Remember that whole words are separated by spaces and punctuation is considered part of a word.

=== Match Case ===

If checked, capitalization must match.

For example, if checked, 'You have recovered balance' is not the same as 'You HAVE reCOvered balance'.

If unchecked, the example above will work.

=== Trigger Name ===

(Optional) The name of the trigger. The name is an identifier that will show up in your list of triggers. It is used for organizing your triggers. It is not required for your trigger and has nothing to do with the actual operation of the trigger.

== Action Options Explained ==

Once you have matched text from the game, you can initiate a single action, or a series of multiple actions. Actions will fire in the order they are listed.

[[File:trigger-actions.png]]

Above is a simple example of three separate actions that will happen when a trigger fires.

=== Simplified Scripting ===

The Nexus client allows for fifteen different [[SimplifiedScripting|simplified scripting]] actions. In most cases instantly returning a command is the best option. However, the Nexus client will allow you to loop through commands, use if statements, wait commands, highlight text, and much more.

All of these options, with full explanations and examples can be found here: [[SimplifiedScripting|simplified scripting]].

=== Advanced Scripting ===

There are two main [[AdvancedScripting|advanced scripting]] options. You can ''Call function'' or you can ''Execute script''. Both options allow for the use of javascript. You can learn more and [[functions]] here and more about [[javascript]] here.

== Examples ==
You can view some example triggers on the [[examples]] page.

== Regular Expression Help ==
* [http://www.regular-expressions.info/ Regular-Expressions.info]

Nexus Discord

2026-05-19T19:36:07Z

Jeremy: Convert bare URLs to named links (1 URL)

<table>
<div class="row">
<div class="large-8 columns">
Welcome to the Iron Realms Nexus Discord community! We invite you to join us on our Discord server, where you can connect with other Nexus users, engage in discussions, and stay up-to-date with the latest news and developments.

'''Discord Server Link''': [https://discord.gg/Tz7t5SaD4q Nexus Discord]

Our Discord server serves as a platform for discussing bugs and features related to the Nexus Client. It provides an opportunity to collaborate with fellow community members and share valuable insights to enhance the client's performance and usability. We encourage you to actively participate in discussions, share your experiences, and contribute your suggestions and feedback.

As our Discord community continues to grow, we aim to expand the scope of discussions beyond bugs and features. This expansion will allow for a more diverse range of topics and interactions, fostering a thriving community of Nexus enthusiasts.

Join us on Discord and become part of the Iron Realms Nexus community. We look forward to connecting with you, exchanging ideas, and working together to create an exceptional gaming experience.

Should you have any questions or need assistance, feel free to reach out to our friendly community moderators or administrators. They will be more than happy to assist you.

Thank you for being a part of the Iron Realms Nexus Discord community. Let's embark on an exciting journey together!
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Javascript

2026-05-19T19:36:06Z

Jeremy: Convert bare URLs to named links (9 URLs)

<table>
<div class="row">
<div class="large-8 columns">
JavaScript is an accessible programming language that significantly enhances the interactivity and dynamism of web pages. It offers the ability for users to unlock a wide range of advanced scripting features through the implementation of JavaScript functions. You can learn more about [[Functions]].

As a highly popular language, there is a multitude of dedicated resources available for learning JavaScript. These resources range from beginner's guides to advanced tutorials, and they are geared toward helping individuals grasp the nuances of this versatile language. Explore the links provided below for more in-depth information and tutorials:

==== Beginning JavaScript ====
* [https://www.javascript.com/ JavaScript.com] - Homepage of JavaScript.
* [[http://www.w3schools.com/js W3Schools JavaScript Tutorial]ref W3Schools JavaScript Reference] - JavaScript reference guide.

==== Online Courses ====
* [http://www.w3schools.com/js W3Schools JavaScript Tutorial] - Introduction to JavaScript
* [https://www.codecademy.com/courses/getting-started-v2/0/1 Codecademy: Getting Started with JavaScript] - Getting started with JavaScript online course.
* [http://javascript-roadtrip.codeschool.com/ JavaScript Road Trip (Code School)] - JavaScript road trip course.

==== Expanding JavaScript with jQuery ====
* [https://learn.jquery.com Learn jQuery] - jQuery homepage.
* [http://www.w3schools.com/jquery/ W3Schools jQuery Tutorial] - Introduction to jQuery.

==== Regular Expressions ====
* [http://regexone.com/ RegexOne] - Introduction to regular expressions.
* [http://txt2re.com/ Txt2RE] - Online tool to convert a line of text into a regular expression.
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

How To Submit Bugs

2026-05-19T19:36:06Z

Jeremy: Convert bare URLs to named links (7 URLs)

<table>
<div class="row">
<div class="large-8 columns">
Thank you for choosing the Iron Realms Nexus Client. We greatly appreciate your support and commitment to helping us improve our software. If you encounter any bugs or issues while using the Nexus Client, we encourage you to submit a bug report. By reporting bugs, you contribute to enhancing the overall user experience and ensuring a smooth gameplay environment.

To submit a bug report for the Iron Realms Nexus Client, please follow the steps outlined below:

'''Navigate to the Bug Submission Form''': The following links provide a structured format for reporting bugs and collecting the necessary information to address the issue effectively.

* [https://client.achaea.com/bugs Submit a bug for Achaea]
* [https://client.aetolia.com/bugs Submit a bug for Aetolia]
* [https://client.imperian.com/bugs Submit a bug for Imperian]
* [https://client.lusternia.com/bugs Submit a bug for Lusternia]
* [https://client.starmourn.com/bugs Submit a bug for Starmourn]

For those of you without a character on an IRE game, you can submit issues here:

* [https://betaclient.ironrealms.com/bugs Submit a bug for the beta client]

'''Provide Detailed Information''': Fill out the Bug Submission Form with accurate and specific details regarding the encountered bug. Be sure to include the following information:

* '''Category''' Select the "General Category" for the time being.
* '''Reproducibility''' Select how easily you can reproduce this issue.
* '''Severity''': Select a severity level for this issue.
* '''Priority''': Select a priority level for this issue.
* '''Select Profile''': Please, specify the platform and operating system you are using (e.g., Windows, Browser, Linux, iOS, Android).
* '''Summary''': Give a concise and descriptive title for the bug report, summarizing the issue.
* '''Description''': Provide a detailed explanation of the bug, including the steps to reproduce it. The more information you provide, the easier it will be for our development team to identify and resolve the issue.
* '''Severity''': Assess the severity level of the bug based on its impact on gameplay or functionality (e.g., critical, major, minor).
* '''Priority''': Assign a priority level to the bug, indicating its urgency in terms of fixing (e.g., high, medium, low).
* '''Steps To Reproduce''': Please give us as much information as you can about how to recreate the issue you are experiencing.
* '''Additional Information''' Provide any other information about this issue you deem relevant.
* '''Upload Files''': If applicable, attach relevant screenshots or log files that can assist in understanding and diagnosing the bug.

'''Monitor Bug Status''': After submitting the bug report, you can track its progress through our bug tracking system. Our team will review the report, investigate the issue, and provide updates on its status as they work towards a resolution. Our Discord group also has a channel which automatically updates as bugs are addressed. You can find the group here: [https://discord.gg/Tz7t5SaD4q Nexus Discord]

We highly value your contribution to improving the Iron Realms Nexus Client. Your bug reports help us identify and address issues promptly, ensuring a more enjoyable and stable gaming experience for all users. We appreciate your time and effort in reporting bugs and helping us make the Nexus Client the best it can be.

If you have any further questions or require additional assistance, please don't hesitate to reach out to our support team.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Client Download

2026-05-19T19:36:05Z

Jeremy: Convert bare URLs to named links (1 URL)

<table>
<div class="row">
<div class="large-8 columns">
Welcome to the Iron Realms Nexus Client download page. We offer multiple options for accessing the Nexus Client, ensuring compatibility across various platforms. Please select the appropriate download method based on your device or operating system:

==== Desktop Downloads ====
* '''Browser Version''': Access Nexus directly through your web browser by visiting [https://play.ironrealms.com Play Iron Realms]
* '''Windows Desktop Version''': Download the Nexus Client for Windows by [https://www.ironrealms.com/local/nexus-3.0.exe clicking here].
* '''Linux Version''': Obtain the Nexus Client for Linux by downloading the [https://www.ironrealms.com/local/nexus-linux-3.0.tar.gz tarball here].

==== Mobile Downloads ====
* '''Android Version''': Install the Nexus Client for Android devices from the Google Play Store by following [https://play.google.com/store/apps/details?id=com.ironrealms.nexus this link].
* '''iOS Version''': Access the Nexus Client for iOS devices through the Apple App Store by visiting [https://apps.apple.com/us/app/nexus-mud-client/id1641739522 this link].

We greatly appreciate your support and encourage you to contribute to the ongoing development of the Nexus Client. By submitting detailed bug reports, you play a vital role in helping us improve the client's performance and overall user experience. To learn more about how you can assist us by reporting bugs, please refer to our guide: [[How_To_Submit_Bugs|How to Submit Bugs]]

Thank you for choosing the Iron Realms Nexus Client. Enjoy your immersive gaming experience!
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Help

2026-05-19T19:36:05Z

Jeremy: Convert bare URLs to named links (7 URLs)

<table>
<div class="row">
<div class="large-8 columns">

===Getting Help with the Nexus Client===

The Iron Realms Nexus client is designed to be user-friendly and intuitive, but sometimes, you might need assistance or encounter a problem that needs resolving. Here are several ways to seek help: via Discord, submitting a bug report, or sending an email to our support team.

====1. Seek Assistance on Discord====

Iron Realms has a vibrant Discord community where you can seek immediate assistance. If you have a question or encounter an issue, feel free to post it on the appropriate channel in the Discord server. Fellow players and staff members are typically online and ready to help.

Please remember to be clear and concise when describing your problem to enable others to understand and respond effectively.

If you are not yet a member, you can join the Iron Realms Discord server by clicking the invitation link on the official Iron Realms website or from within the Nexus client itself.

'''Discord Server Link''': [https://discord.gg/Tz7t5SaD4q Nexus Discord]

====2. Submitting a Bug Report====

If you encounter a bug in the Nexus client, it is highly recommended that you report it through the bug tracker. This helps our development team to identify, investigate, and fix issues more efficiently.

You can submit a bug report by following these steps:

1. Access the bug tracker for the appropriate game by using the corresponding URL:

* [https://client.achaea.com/bugs Submit a bug for Achaea]
* [https://client.aetolia.com/bugs Submit a bug for Aetolia]
* [https://client.imperian.com/bugs Submit a bug for Imperian]
* [https://client.lusternia.com/bugs Submit a bug for Lusternia]
* [https://client.starmourn.com/bugs Submit a bug for Starmourn]

2. Login using your character name and password.

3. Click on "Report Issue".

4. Fill in the necessary details about the bug, including a clear summary and a detailed description of the problem, the steps to reproduce it, and any additional information that may help the development team.

5. Submit the bug report.

Your report will be reviewed, and our team will work to resolve the issue.

'''Also See''': [[How To Submit Bugs]]

====3. Emailing Support====

If you're having technical issues or other problems that can't be solved through Discord or by submitting a bug report, you can reach out to the Iron Realms support team directly by sending an email to support@ironrealms.com.

When emailing, please provide as much detail as possible about the issue you're experiencing, including any error messages you've received and the steps you've already taken to try to resolve the issue. This will help our support team to understand your problem and provide a suitable solution.

Remember, our team is here to help ensure your gaming experience is enjoyable and smooth. Don't hesitate to reach out if you need assistance.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 General Functions

2026-05-19T19:36:04Z

Jeremy: Convert bare URLs to named links (5 URLs)

<table>
<div class="row">
<div class="large-8 columns">

==== Backup Current Client Settings ====
If you wish to create a backup for your current settings and triggers, follow these instructions:

# Access the settings window by clicking the gears icon located in the lower-right corner.
# Select 'Import/Export' from the Settings Menu.
# Click on 'Save Settings to Disk'. This will save your current settings on your computer as a .nxs file (Nexus Settings).

==== Restore Client Settings ====
If you need to revert to older settings that you've previously saved, follow these steps:

# Open the settings window by clicking the gears icon in the lower-right corner.
# Choose 'Import/Export' from the Settings Menu.
# Either drag your Nexus Settings File (.nxs) to the Import Settings box or click the box to load your settings file.

Please note that Nexus automatically saves older versions of your settings from the past few weeks, as a safety net if you've made a serious error and need to restore your settings. You can retrieve these from the 'Restore older settings' section under the 'Import/Export' tab in the Nexus settings menu.

==== Modify Music Volume or Mute It ====
Simply use the control that resembles a speaker in the lower right. Click and adjust the slider to modify the volume or mute.

==== Tab Targeting - Select Targets Using Tab Key ====
You can cycle through denizen/NPC/mob targets (excluding players) in your room by simply pressing the tab button on your keyboard. You will notice the target change at the bottom of the client, directly underneath the input box. If the room info window is active, the target text will be highlighted in yellow.

Keep in mind that tab targeting usually avoids selecting pets, guards, and a few other creature types that you typically wouldn't want to attack unintentionally.

'''PvP Tab Targeting''': To tab-target players, use tab-space to cycle through players.

==== Command Completion ====
For command completion, use shift-tab to finish a partially-typed command from your buffer of past commands. This might not work with certain Chrome installs, as some of them use shift-tab.

==== Zoom In/Out on the Map ====
Place the cursor over the map and gently use the mouse wheel to zoom in or out.

==== Redirect Command Output to a Floating Window ====
Simply type WINDOW <command>, and the output of whatever <command> contains will be redirected to a floating window. This feature is quite useful for tasks such as reading long letters, logs, etc.

==== Enable/Disable Logging ====
Click the paper & pen icon in the lower right to start a log. When you click it again to stop it, you'll be given the option to save the log.

==== Enable/Disable Scripts ====
You can turn your scripts on or off using the lightning bolt icon, located on the Nexus footer bar, in the lower right.

==== Provide Feedback on the Client ====
The preferred method to report bugs is through the following URLs. We utilize Mantis Bug Tracker for tracking bugs in Nexus 3.0. You need to log in to report bugs using your character name and password on the corresponding game website for your character. For example, if your character is in Aetolia, you should use the Aetolia link below.

* [https://client.achaea.com/bugs Submit a bug for Achaea]
* [https://client.aetolia.com/bugs Submit a bug for Aetolia]
* [https://client.imperian.com/bugs Submit a bug for Imperian]
* [https://client.lusternia.com/bugs Submit a bug for Lusternia]
* [https://client.starmourn.com/bugs Submit a bug for Starmourn]

Please remember to log in using your character name and password to report a bug.

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Feedback

2026-05-19T19:36:04Z

Jeremy: Convert bare URLs to named links (2 URLs)

<table>
<div class="row">
<div class="large-8 columns">
To access the 'Feedback' area, open the settings menu by clicking on the gear-shaped icon located in the bottom right corner of your Nexus client. Then, click on the 'Feedback' button.

This section is designed for feedback and suggestions.

'''Please refrain from using the 'Feedback' area to report bugs. For bug reporting, please follow the guidelines detailed below.'''

===How to Report Bugs===
For more information on how to report bugs, please visit the following page: [[How To Submit Bugs]]

===Changelog===
For the changelog, visit: [[Nexus 3.0 Changelog]].
</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

3.0 Character Management

2026-05-19T19:36:03Z

Jeremy: Convert bare URLs to named links (1 URL)

<table>
<div class="row">
<div class="large-8 columns">
===Adding Existing Characters===

If you have previously created characters in any of the Iron Realms games, it's effortless to include them in your character list within the Iron Realms Nexus Client.

Follow these steps to add your existing characters to the client:

#'''Login to Your Nexus Account''': Start by logging into your Nexus account using your credentials. This ensures access to the necessary functionality for character management.
#'''Select the Game''': Once logged in, choose the specific Iron Realms game in which your character was originally created. Click on the game from the available options.
#'''Add a Character''': Within the game selection, locate the "Add a Character" option and click on it. You will then be prompted to provide the following details:
#*'''Character Name''': Enter the name of your existing character.
#*'''Password''': Provide the password associated with your character's account.
#'''Character List Update''': After entering the character name and password, click the appropriate confirmation button. Your character will now be added to your character list within the Iron Realms Nexus Client. Each time you log into your Nexus account, the character will be readily accessible.

By following these simple steps, you can easily include your existing Iron Realms game characters in the character list of the Iron Realms Nexus Client. This feature enables convenient access and management of your characters through a centralized platform.

===Creating New Characters===

If you're eager to embark on new adventures within the Iron Realms Nexus Client, follow these steps to create a new character:

#'''Access the Character Creation''': Locate and click on the "Create New Character" button within the Nexus Client. This will initiate the character creation process, which may vary slightly depending on the specific Iron Realms game you choose.

#'''Follow the Creation Process''': As you progress through the character creation process, you will be guided step by step. Pay attention to the prompts provided by the game, as they will assist you in crafting your character effectively. While the details may differ for each game, you will eventually be prompted to select a character name and password.

#'''Select a Character Name and Password''': Once prompted, choose a unique and memorable character name that reflects your desired identity within the game. Additionally, select a secure password to protect your character's account. This ensures the confidentiality and safety of your character's information.

#'''Begin the Tutorial''': After completing the character creation process, you will enter the game world and commence the tutorial. This initial phase will familiarize you with the game mechanics, controls, and basic concepts necessary to navigate and immerse yourself in the gameplay.

By following these steps, you can successfully create a new character in the Iron Realms Nexus Client. Enjoy the thrilling experience of bringing your character to life and embarking on epic journeys in the Iron Realms game of your choice.

===Deleting Characters===

To remove a character from your character list within the Iron Realms Nexus Client, follow these steps:

#'''Locate the Character''': Find the character you wish to remove from the character list. Look for the character's name within the list displayed in the Iron Realms Nexus Client.
#'''Click the Trash Can Icon''': Next to the character's name, you will see a trash can icon on the far right. Click on this icon to initiate the removal process. Please note that removing the character from the list will not delete the character in the actual game; it simply removes it from your character list within the client.

If you desire to permanently delete your character from the game, follow these additional steps:

#'''Access the Game''': Launch the game and enter the game world where your character is located.
#'''Issue the Command''': While playing the game, enter the command "HELP DELETE" to obtain specific instructions on how to proceed with permanently deleting your character. The game will provide you with the necessary guidance to carry out the deletion process effectively.

Please exercise caution when deleting characters, as the action is irreversible. Make sure you truly intend to delete the character before proceeding.

Remember, removing a character from the character list within the Iron Realms Nexus Client is separate from deleting the character in the game. Choose the appropriate action based on your specific needs and preferences.

If you encounter any difficulties or have further questions, our support team is available to assist you. Feel free to reach out for any necessary clarification or additional guidance regarding character removal.

===Character Settings===

To conveniently edit character settings within the Iron Realms Nexus Client, without being logged into the game, follow these steps:

#'''Access the Character List''': Locate the character you wish to edit within the character list displayed in the Iron Realms Nexus Client.
#'''Click the Gear Icon''': On the far right side of the character name, you will find a gear icon. Click on this icon to initiate the editing process. By doing so, you can modify the character settings without the need to be logged into the game.

This feature allows you to conveniently customize and adjust various settings to enhance your gameplay experience.

===Other Games===

The Iron Realms Nexus Client empowers users to connect to various MUD games. To seamlessly connect to another game, follow these simple steps:

#'''Access Game Addition''': Within the Iron Realms Nexus Client, locate and click the "Add Game" button. This action will initiate the process of adding a new game to your client.
#'''Provide Game Information''': Enter the necessary details to connect to the desired game:
#*'''Game Name: Specify the name of the game you wish to connect to.
#*'''Game Server IP or Domain Name''': Input the IP address or domain name of the game server.
#*'''Port''': Enter the specific port number used by the game for connection.
By following these steps, you can expand your gaming experience by connecting to additional MUD games through the Iron Realms Nexus Client.

Kindly note that while we offer the capability to connect to other games, our support is primarily focused on resolving bugs and issues pertaining to the Nexus client itself. We may not be able to provide support for external games beyond ensuring the smooth functioning of the Nexus client.

If you encounter any difficulties during the game addition process or have further inquiries, our support team is available to assist you. Feel free to reach out for any necessary guidance or clarification. In addition, our Discord is a great place to get help: [https://discord.gg/Tz7t5SaD4q Nexus Discord]

Enjoy the versatility and convenience offered by the Iron Realms Nexus Client as you explore and connect to a wide array of MUD games. Immerse yourself in captivating virtual worlds and embark on thrilling adventures!

</div>
<div class="large-4 columns">
{{Nexus_3_Sidebar}}
</div>
</div>
</table>

Nexus 3.0

2026-05-19T19:31:33Z

Jeremy: Collapse redirect chain: previously chained through Main; now redirects directly to Main Page

#REDIRECT [[Main Page]]

BasicScripting

2026-05-19T19:31:33Z

Jeremy: Retarget redirect: previous target Reflexes was semantically wrong (basic scripting = Simplified Scripting, not Reflexes)

#REDIRECT [[3.0 Simplified Scripting]]

Basic Targeting Alias

2026-05-19T18:46:10Z