Mudlet To Nexus
From Iron Realms Nexus Client Documentation
Revision as of 18:17, 2 November 2015 by Joshua
While there will be visual references and comparisons between the two client UI's, this documentation is intended to show the comparison of scripting and not be a full user interface guide. For more help and an introduction on how to add, edit and remove these scripts in the Nexus client please refer to the BasicScripting and ClientBasics sections.
- 1 Basic Comparisons
- 1.1 Aliases
- 1.1.1 Creating an Alias
- 1.1.2 Scripting Examples
- 1.2 Keybinds
- 1.3 Triggers
- 1.4 Variables
- 1.1 Aliases
- 2 Advanced Comparisons
Creating an Alias
Creating an alias in Mudlet: Enter the scripting library, use the left-hand navigation buttons to select "Aliases", then select the "Add Item" button.
Creating an alias in Nexus: Select the settings button in the lower right hand corner of the client, navigate to the "Reflexes" tab, click the "+Add" button, select "Add an Alias" from the drop-down menu. (Aliases)
A detailed explanation of the Nexus client matching and action options can be found in the BasicScripting section under Aliases. For the purpose of this Mudlet to Nexus section, we will be comparing specific situations as opposed to giving definitions of the options in both clients. Each of these situations will require using advanced features of the Mudlet and Nexus clients.
Advanced Target Matching Alias
In this example we are going to examine an alias that will ATTACK either my target or a matched name that follows my alias text. This example involves checking against a variable, using logic to decide on an action, then sending that command back to the server. We are going to view an image of both completed aliases, then discuss each one.
Completed Scripts: Side by Side Comparison
Completed Scripts: Translation
The first thing to note is that both scripts are using a regular expression to find a matched text. There is no difference in how a regular expression is evaluated other than how their matches are indexed.
As an example to how the regular expression is being evaluated, lets pretend we added this alias to our set of reflexes then went hunting and entered ATK ANIMAL as our input.
The LUA scripting engine behind mudlet is going to store the matches of our regular expression as an array called MATCHES, from there we call the matches by index by using MATCHES MATCHES and so on. Notice that we start at MATCHES, as MATCHES is going to take the entire line.
In the Nexus JS engine, we have exactly the same matching process. In Nexus the matches are stored as native variables called @1, @2, @3 and so on. Whereas in Mudlet, MATCHES is the entire line, Nexus renames an entire line match simply as @line.
While we can use client.get_variable('@1') and so on while within the advanced scripting and function features of the Nexus JS client, it is important to point out that @1, @2, @suffix, @prefix, so on are all renamed for convenience and ease of use from the original native variables of match.match, match.line, match.suffix, match.prefix, and if it's a regex string, match.backrefs. match.backrefs, match.backrefs and so on. In our visual example above we specifically used our native un-renamed variable to show you that either will work. It's important to note however that if you are using logic to organize regular expressions or test against an undefined or null type, using the original match.backrefs seems to have more consistency. This is a rare case, but worth mentioning.
In Nexus, what our logic is saying is: if the match.backrefs which stores our regular expression matches is undefined, or not available, we move on to our fallback option of attacking our target variable. This works, because if we do not find a match after the set string portion of our regular expression (atk), then the matches will remain in their original state of undefined.
In Mudlet, we are doing the same thing by checking if matches, or the first match we get by backreferencing the index, is TRUE. We do this in LUA because we can ask in simple syntax either IF or IF NOT to determine a true or false state. If the matches is TRUE, that means we found a match following our set string of ATK, and we continue on to expand and attack that match. If not, we fall back on our option of attacking the target variable value.
Advanced Variable Setting Alias
This example is going to cover a very common action of setting a number of variables when an alias is executed. We are going to reset many different target status variables when we use an alias to reset our target. What we want to accomplish is each time we change targets we want to change the status of the targets shield, aura, and affliction count.
While we could use the execute script feature of the Nexus client to replicate the LUA from Mudlet, we are instead going to use the UI and the native functions of the Nexus client to do all the heavy lifting for us. As with before, first we will look at the completed scripts from both Mudlet and Nexus, then discuss how they translate to one another.