MUD Interaction

send(command)

-- Send a simple command
send("look")
 
-- Send movement commands
send("north")
send("go north")
 
-- Send commands with arguments
send("say Hello, everyone!")
send("tell bob How are you?")

executeCommand(command)

echo(text, color?)

-- Prefer print() or utilprint() for output:
print("Plugin loaded successfully!")
utilprint("$GSuccess: $wPlugin loaded!")  -- Green "Success:" with white text
 
-- echo() still works for backwards compatibility:
echo("Legacy message", "#ff0000")

print(message)

print("Debug: Current HP = " .. hp)
print("Processing trigger...")

utilprint(message)

-- Basic colors
utilprint("$RError: $wConnection failed")
utilprint("$GSuccess: $wOperation complete")
utilprint("$YWarning: $wLow health!")
 
-- xterm 256 colors (for more color options)
utilprint("$x092Fancy $x091colored $x090text")
 
-- True color RGB hex
utilprint("$XFF0000Red $X00FF00Green $X0000FFBlue")
 
-- Status messages
utilprint("$C[Info] $wPlayer joined the game")
utilprint("$M[System] $wSaving data...")

tprint(table, indent?, done?)

local player = {
  name = "Hero",
  level = 10,
  stats = {
    hp = 100,
    mp = 50
  }
}
 
tprint(player)
-- Output:
-- "name" = "Hero"
-- "level" = 10
-- "stats":
--   "hp" = 100
--   "mp" = 50

colourNote(foreground, background, text)

-- Red text on default background
colourNote("red", "", "DANGER: Low health!")
 
-- Green text on black background
colourNote("green", "black", "You found 100 gold!")
 
-- Yellow warning
colourNote("yellow", "", "Warning: Player approaching")

Note(text)

Note("This is displayed in the terminal")

registerCommand(commandName, handler, description?)

-- Register a simple command
registerCommand("hello", function(args)
  print("Hello, " .. (args or "world") .. "!")
  utilprint("$G[Greeting] $wHello, " .. (args or "world") .. "!")
end, "Say hello to someone")
 
-- Register a status command
registerCommand("status", function()
  print("HP: " .. getVariable("hp") .. "/" .. getVariable("maxhp"))
  print("MP: " .. getVariable("mp") .. "/" .. getVariable("maxmp"))
  utilprint("$RHP: $w" .. getVariable("hp") .. "/" .. getVariable("maxhp"))
  utilprint("$BMP: $w" .. getVariable("mp") .. "/" .. getVariable("maxmp"))
end, "Show character status")
 
-- Register a command with arguments
registerCommand("goto", function(args)
  if args then
    send("speedwalk " .. args)
  else
    print("Usage: /goto <destination>")
    utilprint("$YUsage: $w/goto <destination>")
  end
end, "Go to a named location")

/hello World
/status
/goto tavern

DoAfter(seconds, command)

-- Send "look" after 2 seconds
DoAfter(2, "look")
 
-- Chain delayed commands
DoAfter(1, "drink potion")
DoAfter(2, "cast heal")
DoAfter(3, "attack")

DoAfterSpecial(seconds, code, sendto)

-- Send to MUD after delay
DoAfterSpecial(5, "drink potion", sendto.world)
 
-- Echo message after delay
DoAfterSpecial(10, "Timer expired!", sendto.output)
 
-- Execute script after delay
DoAfterSpecial(3, "healIfLow()", sendto.script)

-- Combat helper plugin
print("Combat plugin loading...")
 
local combatActive = false
local targetName = nil
 
registerCommand("attack", function(args)
  local target = args[1]
  if target then
    targetName = target
    combatActive = true
    send("kill " .. target)
    print("Starting combat with " .. target)
    utilprint("$R[Combat] $wTargeting: " .. target)
  else
    print("Usage: /attack <target>")
    utilprint("$RUsage: $w/attack <target>")
  end
end, "Start combat with a target")
 
registerCommand("flee", function()
  if combatActive then
    combatActive = false
    send("flee")
    print("Fleeing from combat!")
    utilprint("$Y[Flee] $wEscaping combat!")
  else
    print("Not in combat")
    utilprint("$w[Info] Not in combat")
  end
end, "Flee from combat")
 
-- Low health warning
addTrigger("Your health is critical", function()
  colourNote("red", "", "!!! CRITICAL HEALTH !!!")
  DoAfter(0.5, "drink healing potion")
end)
 
-- Combat end detection
addTrigger("is DEAD", function(line)
  if combatActive then
    combatActive = false
    print("Combat ended - " .. targetName .. " defeated!")
    utilprint("$G[Victory] $w" .. targetName .. " defeated!")
    targetName = nil
  end
end)
 
print("Combat plugin loaded!")