Difference between revisions of "Manual:Migrating"

From Mudlet
Jump to navigation Jump to search
(→‎From MUSHclient: added a point)
m (→‎From ZMUD: Link to CMUD)
 
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{TOC right}}
 
{{TOC right}}
 
=From Nexus=
 
=From Nexus=
 +
 +
{{note}} The Nexus information seems a bit out of date. Please feel free to add or update with more current instructions.
 +
 
'''Trigger patterns'''
 
'''Trigger patterns'''
<br>
+
 
 
Lets start with triggers. For translating Nexus patterns into Mudlet, use the following table below. Make sure to set the pattern type in Mudlet to be perl regex, because the default substring works differently.
 
Lets start with triggers. For translating Nexus patterns into Mudlet, use the following table below. Make sure to set the pattern type in Mudlet to be perl regex, because the default substring works differently.
 
<table border="1" width="100%">
 
<table border="1" width="100%">
Line 47: Line 50:
 
<td>If you just have a pattern with a {<} and {>} and nothing else, copy the pattern over without the {<}{>} and select the exact match pattern type. For example {<}You sit down.{>} in Nexus would become '''You sit down.''' in Mudlet with the pattern type of exact match. This is easier to read and matches way faster!</td>
 
<td>If you just have a pattern with a {<} and {>} and nothing else, copy the pattern over without the {<}{>} and select the exact match pattern type. For example {<}You sit down.{>} in Nexus would become '''You sit down.''' in Mudlet with the pattern type of exact match. This is easier to read and matches way faster!</td>
 
</table>
 
</table>
 +
  
 
'''Basic scripting'''
 
'''Basic scripting'''
<br>
+
 
 
The Nexus way of doing a function is like this: #function stuff it does. In Mudlet, it’s function(stuff it does). Note that if you’d like to give text to a function, you put it inside double or single quotes.
 
The Nexus way of doing a function is like this: #function stuff it does. In Mudlet, it’s function(stuff it does). Note that if you’d like to give text to a function, you put it inside double or single quotes.
  
Line 59: Line 63:
 
<tr>
 
<tr>
 
<td>
 
<td>
<lua>
+
<syntaxhighlight lang="lua">
 
send("hi")
 
send("hi")
 
echo("Hello to me!")
 
echo("Hello to me!")
</lua>
+
</syntaxhighlight>
 
</td>
 
</td>
 
<td>
 
<td>
Line 86: Line 90:
 
<tr>
 
<tr>
 
<td>
 
<td>
<lua>
+
<syntaxhighlight lang="lua">
 
number = 1234
 
number = 1234
 
echo("My number is: " .. number.. "\n")
 
echo("My number is: " .. number.. "\n")
 
echo("the " .. number .. " is in the middle of my text\n")
 
echo("the " .. number .. " is in the middle of my text\n")
 
echo(string.format("And here's another - %s - way to format things\n", number))
 
echo(string.format("And here's another - %s - way to format things\n", number))
</lua>
+
</syntaxhighlight>
 
<td>
 
<td>
 
<code>
 
<code>
Line 103: Line 107:
  
 
'''Wildcards'''
 
'''Wildcards'''
<br>
+
 
 
To use the wildcard variable in Nexus, you’d use $1 for the first match, $2 for the second and so on. In Mudlet, the matches[] table contains the matches - and it starts placing the matches from 2. So the Nexus $1 would be matches[2], $2 would be matches[3].
 
To use the wildcard variable in Nexus, you’d use $1 for the first match, $2 for the second and so on. In Mudlet, the matches[] table contains the matches - and it starts placing the matches from 2. So the Nexus $1 would be matches[2], $2 would be matches[3].
  
Line 111: Line 115:
 
<tr>
 
<tr>
 
<td>
 
<td>
<lua>
+
<syntaxhighlight lang="lua">
 
(\w+) kicks you\.
 
(\w+) kicks you\.
 
badguy = matches[2]
 
badguy = matches[2]
 
echo(badguy .. " kicked me!")
 
echo(badguy .. " kicked me!")
</lua>
+
</syntaxhighlight>
 
</td>
 
</td>
 
<td>
 
<td>
Line 127: Line 131:
 
<tr>
 
<tr>
 
<td>
 
<td>
<lua>
+
<syntaxhighlight lang="lua">
 
alias pattern: ^t (.*)$
 
alias pattern: ^t (.*)$
 
alias script: target = matches[2]
 
alias script: target = matches[2]
</lua>
+
</syntaxhighlight>
 
</td>
 
</td>
 
<td>
 
<td>
Line 148: Line 152:
  
 
'''#wait'''
 
'''#wait'''
<br>
+
 
 
In Nexus, a #wait will freeze the script while it’s executing - such that commands after it are delayed. In Mudlet, we use tempTimer which that works a bit differently - it doesn’t freeze the script, but instead makes it so commands a tempTimer is asked to do will get done in the future.
 
In Nexus, a #wait will freeze the script while it’s executing - such that commands after it are delayed. In Mudlet, we use tempTimer which that works a bit differently - it doesn’t freeze the script, but instead makes it so commands a tempTimer is asked to do will get done in the future.
  
Line 157: Line 161:
 
<tr>
 
<tr>
 
<td>
 
<td>
<lua>
+
<syntaxhighlight lang="lua">
 
send("hello")
 
send("hello")
 
tempTimer(1, [[send("hi")]])
 
tempTimer(1, [[send("hi")]])
 
tempTimer(1.5, [[send("bye")]])
 
tempTimer(1.5, [[send("bye")]])
</lua>
+
</syntaxhighlight>
 
</td>
 
</td>
 
<td>
 
<td>
Line 176: Line 180:
  
 
'''ifs in Mudlet'''
 
'''ifs in Mudlet'''
<br>
+
 
 
Next are the #if statements. Here’s a table comparing the syntaxes of Nexus and Mudlet:
 
Next are the #if statements. Here’s a table comparing the syntaxes of Nexus and Mudlet:
 
<table border="1" width="100%">
 
<table border="1" width="100%">
Line 224: Line 228:
 
<tr>
 
<tr>
 
<td>
 
<td>
<lua>
+
<syntaxhighlight lang="lua">
 
-- If foo is true, echo that fact.
 
-- If foo is true, echo that fact.
 
   if foo then echo ("Foo is true!") end -- If foo is true, echo that fact.
 
   if foo then echo ("Foo is true!") end -- If foo is true, echo that fact.
Line 262: Line 266:
 
     end
 
     end
 
   end
 
   end
</lua>
+
</syntaxhighlight>
 
</td>
 
</td>
 
<td>
 
<td>
Line 309: Line 313:
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
 
'''Mudlet equivalents of Nexus functions'''
 
'''Mudlet equivalents of Nexus functions'''
  
Line 368: Line 373:
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td>tempTimer(<time in s>, [[ <nowiki><lua code to do once time is up></nowiki> ]])</td>
+
<td>tempTimer(<nowiki><time in s></nowiki>, [[ <nowiki><lua code to do once time is up></nowiki> ]])</td>
 
<td><nowiki>#wait <milliseconds></nowiki></td>
 
<td><nowiki>#wait <milliseconds></nowiki></td>
 
</tr>
 
</tr>
Line 374: Line 379:
  
 
'''How to call aliases in Mudlet'''
 
'''How to call aliases in Mudlet'''
<br>
+
 
 
The typical workflow in Nexus is that you’d define the aliases for yourself to use, and also use aliases for system-related things (things like checking if you’d need to eat a herb, etc).
 
The typical workflow in Nexus is that you’d define the aliases for yourself to use, and also use aliases for system-related things (things like checking if you’d need to eat a herb, etc).
  
Line 382: Line 387:
  
 
To make a function, you go to the Scripts section, create a new script, and write in your function:
 
To make a function, you go to the Scripts section, create a new script, and write in your function:
<lua>
+
<syntaxhighlight lang="lua">
 
   function <name> ()
 
   function <name> ()
 
     <stuff it does>
 
     <stuff it does>
 
   end
 
   end
</lua>
+
</syntaxhighlight>
 
For example, if we want to make a function that does two things for us at once, we’d do this:
 
For example, if we want to make a function that does two things for us at once, we’d do this:
<lua>
+
<syntaxhighlight lang="lua">
 
   function eat_bloodroot()
 
   function eat_bloodroot()
 
     send ("outr bloodroot")
 
     send ("outr bloodroot")
 
     send ("eat bloodroot")
 
     send ("eat bloodroot")
 
   end
 
   end
</lua>
+
</syntaxhighlight>
 
Then just do this in our alias or trigger to outr and eat bloodroot:
 
Then just do this in our alias or trigger to outr and eat bloodroot:
<lua>
+
<syntaxhighlight lang="lua">
 
   eat_bloodroot()
 
   eat_bloodroot()
</lua>
+
</syntaxhighlight>
 
As mentioned, you can also give things to functions - in this case lets expand the function to eat any herb for us we tell it:
 
As mentioned, you can also give things to functions - in this case lets expand the function to eat any herb for us we tell it:
<lua>
+
<syntaxhighlight lang="lua">
 
   function eat (what)
 
   function eat (what)
 
     send ("outr " .. what)
 
     send ("outr " .. what)
Line 408: Line 413:
 
   eat ("kelp")
 
   eat ("kelp")
 
   eat ("ginseng")
 
   eat ("ginseng")
</lua>
+
</syntaxhighlight>
 
Lastly, functions can also give you data back. One useful example for this is to break down tasks into functions, which will help your code readability:
 
Lastly, functions can also give you data back. One useful example for this is to break down tasks into functions, which will help your code readability:
<lua>
+
<syntaxhighlight lang="lua">
 
   function can_i_stand()
 
   function can_i_stand()
 
     if not paralyzed and not prone and not stunned then
 
     if not paralyzed and not prone and not stunned then
Line 421: Line 426:
 
     send ("stand")
 
     send ("stand")
 
   end
 
   end
</lua>
+
</syntaxhighlight>
 
==Notes to be aware of==
 
==Notes to be aware of==
  
Line 428: Line 433:
 
*  Mudlet can import and export xml
 
*  Mudlet can import and export xml
 
*  Mudlet and Nexus xml formats aren’t compatible
 
*  Mudlet and Nexus xml formats aren’t compatible
*  Mudlet can do nexus graphics, here is a package for - [[http://forums.mudlet.org/viewtopic.php?f=6&t=981 Achaea]], [[http://forums.lusternia.com/lofiversion/index.php/t18507.html Lusternia]]
+
*  Mudlet can do nexus graphics, here is a package for - [https://forums.mudlet.org/viewtopic.php?f=6&t=981 Achaea], [https://www.lusternia.com/node/28106 Lusternia]
 
*  Mudlet has a ton more features such as more speed, less bugs, copy from the normal window, replay logging, color html logging, more powerful scripting, and the list goes on.
 
*  Mudlet has a ton more features such as more speed, less bugs, copy from the normal window, replay logging, color html logging, more powerful scripting, and the list goes on.
  
Line 435: Line 440:
 
* Mudlet doesn't use %#'s - uses matches[] instead. "%1" or %1 would be matches[2], "%2" or %2 would be matches[3] and so on
 
* Mudlet doesn't use %#'s - uses matches[] instead. "%1" or %1 would be matches[2], "%2" or %2 would be matches[3] and so on
 
* No variables in trigger patterns - but you can check against your variables in scripts, or lua function pattern types
 
* No variables in trigger patterns - but you can check against your variables in scripts, or lua function pattern types
* <code>Send()</code> in MUSHclient is <code>send()</code> in Mudlet - in Lua, capitalization matters! To send a command without echoing it on the screen, use:
+
* <code>Send()</code> in MUSHclient is called [[Manual:Lua Functions#send|send()]] with a lower S in Mudlet - in Lua, capitalization matters! To send a command without echoing it on the screen, use:
   <lua>send("my text", false)</lua>
+
   <syntaxhighlight lang="lua">send("my text", false)</syntaxhighlight>
 +
* While MUSHclient uses [https://www.gammon.com.au/scripts/doc.php?function=AnsiNote AnsiNote] to write colorful text, Mudlet offers different ways as well: [[Manual:Lua Functions#cecho|cecho()]] works with the name of a color. You can find lots of predefined colors with [[Manual:Lua Functions#showColors|showColors()]]. You can also style foreground and background seperately with [[Manual:Lua Functions#fg|fg()]] and [[Manual:Lua Functions#bg|bg()]]. To keep your original ANSI colors, use [[Manual:Lua Functions#ansi2decho|ansi2decho()]]. If you need more colors, [[Manual:Lua Functions#decho|decho()]] will take rgb numbers, [[Manual:Lua Functions#hecho|hecho()]] uses hex codes.
 +
* Mudlet does not offer 'GetConnectDuration()' but you could create a script to connect to the [[Manual:Event_Engine#sysConnectionEvent|connection event]] (and maybe sysDisconnectionEvent) and in that function [[Manual:Mudlet_Object_Functions#createStopWatch|start a stopwatch]] to keep count of how long you've been connected for. See [[Manual:Event Engine]] on how to use events in Mudlet.
 +
* Mudlet does not have lpeg built-in but you can include the lpeg library installed on your system in your lua code. On Windows, you can choose to put the lpeg.dll file into Mudlet's install folder. On macOS that is not possible due to restrictions placed by Apple.
 +
* If you used OnPluginPartialLine to match "partial lines" such as prompts, please note that any type of Mudlet triggers should work with such lines so you can just use them for your purpose. For prompts specifically, try tempPromptTrigger.
 +
* If you used OnPluginTick, you can use a GUI timer in Mudlet for essentially the same functionality.
 +
* If you used OnPluginCommandEntered, you can use a "catch all" alias (with a pattern like "^.+") to send all user commands to your script.
 +
* If you have an existing database you'd like to use and don't want to put it into the profile folder, you can use the standard luaSQL interface to load and use it. Some basic examples can be found at https://keplerproject.github.io/luasql/examples.html
 +
* Line numbers in Mudlet are absolute - lines will not get renumbered when they start getting deleted from the buffer.
 +
 
 +
'''Converting MUSHclient triggers into Mudlet triggers'''
 +
 
 +
The following scripts by Discord user Buck allow you to paste a MUSHclient trigger and automatically have a corresponding Mudlet trigger created.
 +
 
 +
First, create a new script with this:
 +
<syntaxhighlight lang="lua">
 +
TRIGGER_GROUP_NAME = "mushtriggers"
 +
MUSHTRIGGER_PREFIX = "mt_"
 +
 
 +
function getAvailableMushTriggerID()
 +
  local n=1
 +
 
 +
  while exists( MUSHTRIGGER_PREFIX..tostring( n), 'trigger')>0 do
 +
    n=n+1
 +
  end
 +
 
 +
  return MUSHTRIGGER_PREFIX..tostring( n)
 +
end
 +
 
 +
function addMushTrigger( pattern, actions)
 +
  pattern = string.gsub( pattern, '%.', '\\.')
 +
  pattern = string.gsub( pattern, '*', '(.+)')
 +
  actions_regex = string.gsub( actions, '%%(%d)', function(x) return ']]..matches['..tostring(x+1)..']..[[' end)
 +
 
 +
  local id = getAvailableMushTriggerID()
 +
 
 +
  createTriggerGroup( TRIGGER_GROUP_NAME)
 +
  permRegexTrigger(
 +
    id,
 +
    TRIGGER_GROUP_NAME,
 +
    {pattern},
 +
    'for _, cmd in ipairs( splitCommands( [['..actions_regex..']])) do expandAlias( cmd) end')
 +
end
 +
</syntaxhighlight>
 +
 
 +
Also create an alias with this:
 +
 
 +
<syntaxhighlight lang="lua">
 +
-- ^/trigger '([^']+)' (.+)$
 +
local pattern = matches[2]
 +
local actions = matches[3]
 +
 
 +
addMushTrigger(pattern, actions)
 +
 
 +
cecho("<green>New trigger added")
 +
</syntaxhighlight>
 +
 
 +
Now you can transfer your MUSH triggers like so:
 +
 
 +
<syntaxhighlight lang="lua">
 +
/trigger 'A wild * enters the room' hit %1
 +
 
 +
/trigger '%d/%dhp %d/%dmn' /checkhealth %1
 +
</syntaxhighlight>
  
 
=From CMUD=
 
=From CMUD=
Line 445: Line 513:
 
'''Example #1 - Using a variable and a temp trigger'''
 
'''Example #1 - Using a variable and a temp trigger'''
 
'''Cmud:'''
 
'''Cmud:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:
 
Pattern:
 
^A (.*) shard appears and clatters to the ground\.$
 
^A (.*) shard appears and clatters to the ground\.$
Line 454: Line 522:
 
{get shard}
 
{get shard}
 
}  
 
}  
</lua>
+
</syntaxhighlight>
  
 
'''Mudlet Example:'''
 
'''Mudlet Example:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:  
 
Pattern:  
 
^A (.*) shard appears and clatters to the ground\.$
 
^A (.*) shard appears and clatters to the ground\.$
Line 465: Line 533:
 
shardtrigger = tempTrigger("You have recovered balance on all limbs.", [[send("get shard") killTrigger(shardtrigger)]])
 
shardtrigger = tempTrigger("You have recovered balance on all limbs.", [[send("get shard") killTrigger(shardtrigger)]])
 
end
 
end
</lua>
+
</syntaxhighlight>
  
 
'''Example #2 - Doing Math:'''
 
'''Example #2 - Doing Math:'''
 
'''Cmud:'''
 
'''Cmud:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:
 
Pattern:
 
^You put (\d+) gold sovereigns in (.*)\.$
 
^You put (\d+) gold sovereigns in (.*)\.$
Line 475: Line 543:
 
Code:
 
Code:
 
#ADD goldcounter %1
 
#ADD goldcounter %1
</lua>
+
</syntaxhighlight>
 
'''Mudlet:'''
 
'''Mudlet:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:  
 
Pattern:  
 
^You put (\d+) gold sovereigns in (.*)\.$
 
^You put (\d+) gold sovereigns in (.*)\.$
Line 483: Line 551:
 
Code:
 
Code:
 
goldcounter = goldcounter + tonumber(matches[2])
 
goldcounter = goldcounter + tonumber(matches[2])
</lua>
+
</syntaxhighlight>
  
 
'''Example #3 - Replacing Text'''
 
'''Example #3 - Replacing Text'''
 
'''Cmud'''
 
'''Cmud'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:
 
Pattern:
 
^You raze (\w+) magical shield with (.*)\.$
 
^You raze (\w+) magical shield with (.*)\.$
Line 493: Line 561:
 
Code:
 
Code:
 
#sub {%ansi(yellow,cyan,bold)(*X*)%ansi(white) RAZED %ansi(red)%1's %ansi(white)Shield %ansi(yellow,cyan,bold)(*X*)}
 
#sub {%ansi(yellow,cyan,bold)(*X*)%ansi(white) RAZED %ansi(red)%1's %ansi(white)Shield %ansi(yellow,cyan,bold)(*X*)}
</lua>
+
</syntaxhighlight>
 
'''Mudlet'''
 
'''Mudlet'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:
 
Pattern:
 
^You raze (\w+) magical shield with (.*)\.$
 
^You raze (\w+) magical shield with (.*)\.$
Line 502: Line 570:
 
deleteLine()
 
deleteLine()
 
cecho("<yellow:cyan>You RAZED " .. matches[2] .. " shield")
 
cecho("<yellow:cyan>You RAZED " .. matches[2] .. " shield")
</lua>
+
</syntaxhighlight>
  
 
'''Example #4 - Enable/Disable Classes'''
 
'''Example #4 - Enable/Disable Classes'''
  
 
'''Cmud:'''
 
'''Cmud:'''
<lua>
+
<syntaxhighlight lang="lua">
 
#T+ ClassFolderName
 
#T+ ClassFolderName
</lua>
+
</syntaxhighlight>
  
 
'''Mudlet:'''  
 
'''Mudlet:'''  
<lua>
+
<syntaxhighlight lang="lua">
 
enableAlias("ClassFolderName")
 
enableAlias("ClassFolderName")
  
 
-- Note: Alias can be an alias, trigger (enableTrigger), timer (enableTimer), key (enableKey), etc.  
 
-- Note: Alias can be an alias, trigger (enableTrigger), timer (enableTimer), key (enableKey), etc.  
 
-- You can disable entire classes or just single triggers.
 
-- You can disable entire classes or just single triggers.
</lua>
+
</syntaxhighlight>
  
 
'''Example 5 - Multi-action Commands
 
'''Example 5 - Multi-action Commands
Line 523: Line 591:
  
 
Cmud:'''
 
Cmud:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:  
 
Pattern:  
 
sillyAction
 
sillyAction
Line 533: Line 601:
 
-- we would just call sillyAction
 
-- we would just call sillyAction
  
</lua>
+
</syntaxhighlight>
 
'''
 
'''
 
Mudlet:'''
 
Mudlet:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:  
 
Pattern:  
 
sillyAction
 
sillyAction
Line 542: Line 610:
 
Code:
 
Code:
 
sendAll("look","ct Hello City","pt Hello Party", "laugh")  
 
sendAll("look","ct Hello City","pt Hello Party", "laugh")  
</lua>
+
</syntaxhighlight>
  
 
-- Now, in mudlet, if we want to call on that alias, we need to tell mudlet that we want to execute the alias sillyAction rather than sending "sillyAction" directly to the mud. To do that we would do:
 
-- Now, in mudlet, if we want to call on that alias, we need to tell mudlet that we want to execute the alias sillyAction rather than sending "sillyAction" directly to the mud. To do that we would do:
  
<lua>
+
<syntaxhighlight lang="lua">
 
expandAlias("sillyAction")
 
expandAlias("sillyAction")
</lua>
+
</syntaxhighlight>
  
 
'''Example 6 - Using if statements with and, or and nil.'''
 
'''Example 6 - Using if statements with and, or and nil.'''
  
 
'''Cmud Code:'''
 
'''Cmud Code:'''
<lua>
+
<syntaxhighlight lang="lua">
 
#IF (@myclass="knight" & !(@pets))
 
#IF (@myclass="knight" & !(@pets))
 
{
 
{
 
say cool
 
say cool
 
}
 
}
</lua>
+
</syntaxhighlight>
 
'''
 
'''
 
Mudlet Code:'''
 
Mudlet Code:'''
<lua>
+
<syntaxhighlight lang="lua">
 
if myclass == "knight" and not pets then
 
if myclass == "knight" and not pets then
 
   send("say cool")
 
   send("say cool")
 
end
 
end
</lua>
+
</syntaxhighlight>
  
 
'''Example 7 - Hitting your target OR your first argument.'''
 
'''Example 7 - Hitting your target OR your first argument.'''
Line 576: Line 644:
  
 
'''Cmud:'''
 
'''Cmud:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern: ^kk ?(\w+)?$
 
Pattern: ^kk ?(\w+)?$
 
#VAR target Das
 
#VAR target Das
Line 585: Line 653:
 
kick %1
 
kick %1
 
}
 
}
</lua>
+
</syntaxhighlight>
  
 
'''Mudlet:'''
 
'''Mudlet:'''
<lua>
+
<syntaxhighlight lang="lua">
 
Pattern:  
 
Pattern:  
 
^kk ?(\w+)?$
 
^kk ?(\w+)?$
Line 595: Line 663:
 
target = "Das"
 
target = "Das"
 
send("kick "..(matches[2] or target))
 
send("kick "..(matches[2] or target))
</lua>
+
</syntaxhighlight>
 
'''
 
'''
 
Example #7 - Two Pattern Examples'''
 
Example #7 - Two Pattern Examples'''
<lua>^rz(?:(.*)|)$   
+
<syntaxhighlight lang="lua">^rz(?:(.*)|)$   
 
-- This would let you do rzDas to raze Das for example.
 
-- This would let you do rzDas to raze Das for example.
</lua>
+
</syntaxhighlight>
 
Versus:
 
Versus:
<lua>
+
<syntaxhighlight lang="lua">
 
^rz ?(\w+)?$  
 
^rz ?(\w+)?$  
 
-- This would require you to do rz Das with a space between rz and Das.
 
-- This would require you to do rz Das with a space between rz and Das.
</lua>
+
</syntaxhighlight>
 +
 
 +
'''Example #8 - Repeat Commands a number of times''' with %i functionality, i.e., #12 kill bug %i will send "kill bug 1", "kill bug 2", "kill bug 3"...etc
 +
<syntaxhighlight lang="lua">
 +
--Pattern: ^\#(\d+)\s(.+)$
 +
 
 +
local cmd = matches[3]
 +
for i=1, tonumber(matches[2]) do 
 +
  local tempCMD = string.gsub(cmd, "%%i", i)
 +
  expandAlias(tempCMD)
 +
end
 +
 
 +
-- We have to store the initial matches table in a variable because each loop might change the current matches table.
 +
 
 +
</syntaxhighlight>
 +
 
 +
'''#Example #9 - controlling many characters at once'''
 +
Check out [https://forums.mudlet.org/viewtopic.php?f=6&t=23023 this premade package] that helps you with this.
  
 
=From zMUD=
 
=From zMUD=
 +
Pretty similar to migrating [[#From CMUD]] - see above.

Latest revision as of 16:48, 18 January 2024

From Nexus

Note Note: The Nexus information seems a bit out of date. Please feel free to add or update with more current instructions.

Trigger patterns

Lets start with triggers. For translating Nexus patterns into Mudlet, use the following table below. Make sure to set the pattern type in Mudlet to be perl regex, because the default substring works differently.

Mudlet Nexus What it does
(\w+) {w} Match one or more non-whitespace characters (a 'word')
(\d+) {d} Match one or more numeric digits (a number)
([abc]) {[abc]} Match one or more of either 'a', 'b' or 'c'. (a character class)
([^abc]) {[^abc]} Match one or more of anything EXCEPT 'a', 'b', or 'c'
(.*) {*} Match zero or more characters (anything)
^ {<} Match the beginning of a line (not the actual newline character)
$ {>} Match the end of a line (not the actual newline character)
Note:
If you just have a pattern with a {<} and {>} and nothing else, copy the pattern over without the {<}{>} and select the exact match pattern type. For example {<}You sit down.{>} in Nexus would become You sit down. in Mudlet with the pattern type of exact match. This is easier to read and matches way faster!


Basic scripting

The Nexus way of doing a function is like this: #function stuff it does. In Mudlet, it’s function(stuff it does). Note that if you’d like to give text to a function, you put it inside double or single quotes.

Calling functions

Calling functions
Mudlet Nexus
send("hi")
echo("Hello to me!")

#send hi
#echo Hello to me!

Note:

If you’d like to use a variable inside text, you’d put it outside the quotes and glue it together with two dots.

Setting variables

Setting variables
Mudlet Nexus
number = 1234
echo("My number is: " .. number.. "\n")
echo("the " .. number .. " is in the middle of my text\n")
echo(string.format("And here's another - %s - way to format things\n", number))

#set number 1234
#echo My number is: $number
#echo the $number is in the middle of my text

Wildcards To use the wildcard variable in Nexus, you’d use $1 for the first match, $2 for the second and so on. In Mudlet, the matches[] table contains the matches - and it starts placing the matches from 2. So the Nexus $1 would be matches[2], $2 would be matches[3].
Mudlet Nexus
(\w+) kicks you\.
badguy = matches[2]
echo(badguy .. " kicked me!")

{w} kicks you.
#set badguy $1
#echo $badguy kicked me!

alias pattern: ^t (.*)$
alias script: target = matches[2]

alias name: t
alias script: #set target $1

Note:

The reason the first match goes into matches[2] and not matches[1] is because matches[1] contains the part of the line that matched your trigger / alias.

#wait In Nexus, a #wait will freeze the script while it’s executing - such that commands after it are delayed. In Mudlet, we use tempTimer which that works a bit differently - it doesn’t freeze the script, but instead makes it so commands a tempTimer is asked to do will get done in the future. So the difference is that a tempTimer doesn’t freeze the commands following it at all, everything gets done at once as usual. Just things a tempTimer was asked to do get done in the future.
Mudlet Nexus
send("hello")
tempTimer(1, [[send("hi")]])
tempTimer(1.5, [[send("bye")]])

#send hello
#wait 1000
#send hi
#wait 500
#send bye

ifs in Mudlet

Next are the #if statements. Here’s a table comparing the syntaxes of Nexus and Mudlet:

Mudlet Nexus

if <condition> then <text> end

#if <condition> <text> #if <condition> { <script> }

if <condition> then <script> else <script> end

#if <condition> { <script> } else { <script> } #if <condition> { <script> } { <script> }

if <condition> then <script> elseif <condition> then <script> end

#if <condition> { <script> } elsif <condition> { <script> }

if <condition> then <script> elseif <condition> then <script> else <script> end

#if <condition> { <script> } elsif <condition> { <script> } else { <script> }


Here is the sample side-by-side comparison of how you’d use it:

Mudlet Nexus
-- If foo is true, echo that fact.
  if foo then echo ("Foo is true!") end -- If foo is true, echo that fact.

-- A slight modification of the above that illustrates an 'else' clause.
-- Note that the 'then' is always necessary to avoid confusion.
  if foo then echo ("Foo is true!") else echo ("Foo is false!") end

-- Illustration of putting more than one statement in a block (also
-- spans lines here). Note the if doesn't end until the last 'end' is
-- encountered.
-- We also add a \n at the end of multiple echos so each one is on it's own line.
  if foo then
    echo ("Foo is true!\n")
    echo ("Isn't it grand?\n")
    echo ("These commands are all on separate lines too!\n")
  end

-- This shows how ifs continue (on 'logical' lines) even though the
-- blocks in its constituent clauses may have multiple lines. The
-- following lines are all _one_ single if statement.
  if foo > 50 then
    echo ("Foo is big!\nYes it is.")
  elseif foo > 10 then
    echo ("Foo is pretty big...\n")
    echo ("I've seen bigger.")
  else
    echo ("Foo is actually kind of small.")
  end

-- Ifs can be nested too.
  if foo then
    if bar then
      echo ("Both foo and bar are true.")
    else
      echo ("Foo's true, but bar isn't.")
    end
  end


// If $foo is true, echo that fact.

 #if $foo #echo Foo is true!     // If $foo is true, echo that fact.


// A slight modification of the above that illustrates an 'else' clause.
// The second form shows that the word 'else' is actually optional too.
// (The two lines are functionally the same.)

 #if $foo { #echo Foo is true! } else { #echo Foo is false! }
 #if $foo { #echo Foo is true! } { #echo Foo is false! }


// Illustration of putting more than one statement in a block (also
// spans lines here). Note the if doesn't end until the last '}' is
// encountered.

 #if $foo {
   #echo Foo is true!
   #echo Isn't it grand?
   #echo These commands are all on separate lines too!
 }


// This shows how ifs continue (on 'logical' lines) even though the
// blocks in its constituent clauses may have multiple lines. The
// following lines are all _one_ single if statement.

 #if $foo > 50 {
   #echo Foo is big!
   #echo Yes it is.
 } elsif $foo > 10 {
   #echo Foo is pretty big...
   #echo I've seen bigger.
 } else {
   #echo Foo is actually kind of small.
 }

// Ifs can be nested too.

 #if $foo {
   #if $bar {
     #echo Both foo and bar are true.
   } else {
     #echo Foo's true, but bar isn't.
   }
 }

Mudlet equivalents of Nexus functions

Now that we got the ifs covered, lets go over the Mudlet equivalents of other Nexus functions. Note that this is a direct Nexus→Mudlet comparison; certain functions in Mudlet have much more capability.

Mudlet Nexus
<variable name> = "<text value>" #set <variable name> <text value>
<variable name> = <expression> #set <variable name> = <expression>
<variable name> = nil #unset <variable name>
<variable> = <variablename> <+ - / *> <number or variable> #add <variablename> <expression>
echo "text\n" or echo("text\n") #echo <text>
echo "text" or echo("text") #echo_ <text>
enableAlias("<group name>")/enableTrigger()/enableKey()/enableTimer() #groupon <group name>
disableAlias("<group name>")disableTrigger()disableKey()disableTimer() #groupoff <group name>
selectString (line, 1) bg("<color>") resetFormat() #highlight <color>
deleteLine() #gag
openUrl("<url>") #openurl <url>
send("<stuff>") #send <text>
sendAll("hi", "hello", "bye") #send_ hi #send_ hello #send bye
tempTimer(<time in s>, [[ <lua code to do once time is up> ]]) #wait <milliseconds>

How to call aliases in Mudlet

The typical workflow in Nexus is that you’d define the aliases for yourself to use, and also use aliases for system-related things (things like checking if you’d need to eat a herb, etc).

While the first use is good, the second isn’t - because the user can also run this alias at an inopportune time, because if you want to call an alias it has to match all alises again, and so on.

Now, while in Mudlet you can call another alias with the expandAlias() function, this is strongly discouraged. What you do instead if create a function (for example, send() and echo() are functions) that you can then call from your alias or trigger. This has many advantages - it’s faster, you can easily give your function values, and your function can return you values, too.

To make a function, you go to the Scripts section, create a new script, and write in your function:

  function <name> ()
    <stuff it does>
  end

For example, if we want to make a function that does two things for us at once, we’d do this:

  function eat_bloodroot()
    send ("outr bloodroot")
    send ("eat bloodroot")
  end

Then just do this in our alias or trigger to outr and eat bloodroot:

  eat_bloodroot()

As mentioned, you can also give things to functions - in this case lets expand the function to eat any herb for us we tell it:

  function eat (what)
    send ("outr " .. what)
    send ("eat " .. what)
  end
  [...]
  eat ("bloodroot")
  eat ("kelp")
  eat ("ginseng")

Lastly, functions can also give you data back. One useful example for this is to break down tasks into functions, which will help your code readability:

  function can_i_stand()
    if not paralyzed and not prone and not stunned then
      return true
    else
      return false
  end
  [...]
  if can_i_stand() and have_balance and have_equilibrium then
    send ("stand")
  end

Notes to be aware of

To finish off, a couple of points that should be remembered:

  • Mudlet does profile snapshots (nexus archives) automatically - to load a different one, select it from the list when connecting
  • Mudlet can import and export xml
  • Mudlet and Nexus xml formats aren’t compatible
  • Mudlet can do nexus graphics, here is a package for - Achaea, Lusternia
  • Mudlet has a ton more features such as more speed, less bugs, copy from the normal window, replay logging, color html logging, more powerful scripting, and the list goes on.

From MUSHclient

  • Mudlet doesn't use %#'s - uses matches[] instead. "%1" or %1 would be matches[2], "%2" or %2 would be matches[3] and so on
  • No variables in trigger patterns - but you can check against your variables in scripts, or lua function pattern types
  • Send() in MUSHclient is called send() with a lower S in Mudlet - in Lua, capitalization matters! To send a command without echoing it on the screen, use:
send("my text", false)
  • While MUSHclient uses AnsiNote to write colorful text, Mudlet offers different ways as well: cecho() works with the name of a color. You can find lots of predefined colors with showColors(). You can also style foreground and background seperately with fg() and bg(). To keep your original ANSI colors, use ansi2decho(). If you need more colors, decho() will take rgb numbers, hecho() uses hex codes.
  • Mudlet does not offer 'GetConnectDuration()' but you could create a script to connect to the connection event (and maybe sysDisconnectionEvent) and in that function start a stopwatch to keep count of how long you've been connected for. See Manual:Event Engine on how to use events in Mudlet.
  • Mudlet does not have lpeg built-in but you can include the lpeg library installed on your system in your lua code. On Windows, you can choose to put the lpeg.dll file into Mudlet's install folder. On macOS that is not possible due to restrictions placed by Apple.
  • If you used OnPluginPartialLine to match "partial lines" such as prompts, please note that any type of Mudlet triggers should work with such lines so you can just use them for your purpose. For prompts specifically, try tempPromptTrigger.
  • If you used OnPluginTick, you can use a GUI timer in Mudlet for essentially the same functionality.
  • If you used OnPluginCommandEntered, you can use a "catch all" alias (with a pattern like "^.+") to send all user commands to your script.
  • If you have an existing database you'd like to use and don't want to put it into the profile folder, you can use the standard luaSQL interface to load and use it. Some basic examples can be found at https://keplerproject.github.io/luasql/examples.html
  • Line numbers in Mudlet are absolute - lines will not get renumbered when they start getting deleted from the buffer.

Converting MUSHclient triggers into Mudlet triggers

The following scripts by Discord user Buck allow you to paste a MUSHclient trigger and automatically have a corresponding Mudlet trigger created.

First, create a new script with this:

TRIGGER_GROUP_NAME = "mushtriggers"
MUSHTRIGGER_PREFIX = "mt_"

function getAvailableMushTriggerID()
  local n=1

  while exists( MUSHTRIGGER_PREFIX..tostring( n), 'trigger')>0 do
    n=n+1
  end

  return MUSHTRIGGER_PREFIX..tostring( n)
end

function addMushTrigger( pattern, actions)
  pattern = string.gsub( pattern, '%.', '\\.')
  pattern = string.gsub( pattern, '*', '(.+)')
  actions_regex = string.gsub( actions, '%%(%d)', function(x) return ']]..matches['..tostring(x+1)..']..[[' end)

  local id = getAvailableMushTriggerID()

  createTriggerGroup( TRIGGER_GROUP_NAME)
  permRegexTrigger(
    id,
    TRIGGER_GROUP_NAME,
    {pattern},
    'for _, cmd in ipairs( splitCommands( [['..actions_regex..']])) do expandAlias( cmd) end')
end

Also create an alias with this:

-- ^/trigger '([^']+)' (.+)$
local pattern = matches[2]
local actions = matches[3]

addMushTrigger(pattern, actions)

cecho("<green>New trigger added")

Now you can transfer your MUSH triggers like so:

/trigger 'A wild * enters the room' hit %1 

/trigger '%d/%dhp %d/%dmn' /checkhealth %1

From CMUD

Changing over to Mudlet requires learning some simple syntax changes and some general concept changes:

In a mudlet trigger for example: Name is just the name you want to use to label the trigger. It doesn't effect the actual firing of the trigger. The trigger fires based on the "pattern" and you can have multiple patterns for a single piece of code. You can also have a multi-line trigger, where the entire trigger must see all the patterns to fire. Example #1 - Using a variable and a temp trigger Cmud:

Pattern:
^A (.*) shard appears and clatters to the ground\.$

Code:
#IF (@autogold) {
#temp {You have recovered balance on all limbs.} 
{get shard}
}

Mudlet Example:

Pattern: 
^A (.*) shard appears and clatters to the ground\.$

Code:
if autogold then
shardtrigger = tempTrigger("You have recovered balance on all limbs.", [[send("get shard") killTrigger(shardtrigger)]])
end

Example #2 - Doing Math: Cmud:

Pattern:
^You put (\d+) gold sovereigns in (.*)\.$

Code:
#ADD goldcounter %1

Mudlet:

Pattern: 
^You put (\d+) gold sovereigns in (.*)\.$

Code:
goldcounter = goldcounter + tonumber(matches[2])

Example #3 - Replacing Text Cmud

Pattern:
^You raze (\w+) magical shield with (.*)\.$

Code:
#sub {%ansi(yellow,cyan,bold)(*X*)%ansi(white) RAZED %ansi(red)%1's %ansi(white)Shield %ansi(yellow,cyan,bold)(*X*)}

Mudlet

Pattern:
^You raze (\w+) magical shield with (.*)\.$

Code:
deleteLine()
cecho("<yellow:cyan>You RAZED " .. matches[2] .. " shield")

Example #4 - Enable/Disable Classes

Cmud:

#T+ ClassFolderName

Mudlet:

enableAlias("ClassFolderName")

-- Note: Alias can be an alias, trigger (enableTrigger), timer (enableTimer), key (enableKey), etc. 
-- You can disable entire classes or just single triggers.

Example 5 - Multi-action Commands Let's say we create an alias called silly

Cmud:

Pattern: 
sillyAction

Code:
look;ct Hello City;pt Hello Party;laugh

-- Now in cmud if we called this alias from a trigger or another alias,
-- we would just call sillyAction

Mudlet:

Pattern: 
sillyAction

Code:
sendAll("look","ct Hello City","pt Hello Party", "laugh")

-- Now, in mudlet, if we want to call on that alias, we need to tell mudlet that we want to execute the alias sillyAction rather than sending "sillyAction" directly to the mud. To do that we would do:

expandAlias("sillyAction")

Example 6 - Using if statements with and, or and nil.

Cmud Code:

#IF (@myclass="knight" & !(@pets))
{
say cool
}

Mudlet Code:

if myclass == "knight" and not pets then
  send("say cool")
end

Example 7 - Hitting your target OR your first argument. This is for when you want to either hit the person you have targeted, or the name you type.

For example, to kick Das you'd type: kk Das

Or if Das is your target, just typing kk

Cmud:

Pattern: ^kk ?(\w+)?$
#VAR target Das
if (@target) {
kick @target
}
if (%1) {
kick %1
}

Mudlet:

Pattern: 
^kk ?(\w+)?$

Code:
target = "Das"
send("kick "..(matches[2] or target))

Example #7 - Two Pattern Examples

^rz(?:(.*)|)$  
-- This would let you do rzDas to raze Das for example.

Versus:

^rz ?(\w+)?$ 
-- This would require you to do rz Das with a space between rz and Das.

Example #8 - Repeat Commands a number of times with %i functionality, i.e., #12 kill bug %i will send "kill bug 1", "kill bug 2", "kill bug 3"...etc

--Pattern: ^\#(\d+)\s(.+)$

local cmd = matches[3]
for i=1, tonumber(matches[2]) do  
  local tempCMD = string.gsub(cmd, "%%i", i)
  expandAlias(tempCMD)
end

-- We have to store the initial matches table in a variable because each loop might change the current matches table.

#Example #9 - controlling many characters at once Check out this premade package that helps you with this.

From zMUD

Pretty similar to migrating #From CMUD - see above.