Triggers, Aliases & Timers

local triggerId = addTrigger(pattern, callback, options?)

function(line, wildcards)
  -- line: the full matched line
  -- wildcards: table of captured groups (for regex patterns)
end

-- Simple substring trigger
addTrigger("You are hungry", function()
  send("eat bread")
end)
 
-- Regex trigger with captures
addTrigger("(\\w+) tells you '(.+)'", function(line, matches)
  local sender = matches[1]
  local message = matches[2]
  print("Tell from " .. sender .. ": " .. message)
  utilprint("$G[Tell] $C" .. sender .. "$w: " .. message)  -- Green "[Tell]", Cyan sender
end, { type = "regex" })
 
-- One-shot trigger (removes itself after firing)
addTrigger("Welcome to the game", function()
  send("look")
  print("Auto-looked on login!")
  utilprint("$Y[Login] $wAuto-look triggered")
end, { oneShot = true })
 
-- Priority trigger (fires before others)
addTrigger("DANGER:", function()
  send("flee")
end, { priority = 10 })
 
-- Wildcard trigger (matches * and ? patterns)
addTrigger("* gives you *", function(line, matches)
  local giver = matches[1]
  local item = matches[2]
  print("Received " .. item .. " from " .. giver)
  utilprint("$G[Received] $w" .. item .. " from $C" .. giver)  -- Cyan giver name
end, { type = "wildcard" })
 
-- Regex HP tracking
addTrigger("HP: (\\d+)/(\\d+)", function(line, matches)
  local hp = tonumber(matches[1])
  local maxHp = tonumber(matches[2])
  setVariable("hp", hp)
  setVariable("maxhp", maxHp)
end, { type = "regex" })

removeTrigger(triggerId)

local myTrigger = addTrigger("some pattern", function()
  -- handler
end)
 
-- Later, remove it
removeTrigger(myTrigger)

enableTrigger(triggerId)

enableTrigger(combatTrigger)

disableTrigger(triggerId)

-- Disable during safe areas
disableTrigger(combatTrigger)

local trigger = findTriggerByName(name)

local success = toggleTriggerByName(name, enabled)

local success = toggleTriggerGroup(groupName, enabled)

-- Add triggers to a group
addTrigger("combat pattern 1", handler1, { group = "combat" })
addTrigger("combat pattern 2", handler2, { group = "combat" })
 
-- Disable all combat triggers at once
toggleTriggerGroup("combat", false)
 
-- Re-enable later
toggleTriggerGroup("combat", true)

local aliasId = addAlias(pattern, replacement, callback?)

-- Simple text replacement
addAlias("^nn$", "north;north")  -- "nn" expands to "north;north"
 
-- Alias with wildcards
addAlias("^go (.+)$", "speedwalk $1")  -- "go tavern" becomes "speedwalk tavern"
 
-- Alias with callback
addAlias("^heal (.+)$", "", function(matches)
  local target = matches[1]
  send("cast 'cure light wounds' " .. target)
  print("Healing " .. target .. "...")
  utilprint("$G[Heal] $wCasting on " .. target)
end)

removeAlias(aliasId)

local alias = findAliasByName(name)

local success = toggleAliasByName(name, enabled)

local timerId = addTimer(interval, callback, repeating?)

-- One-shot timer (fires once after 5 seconds)
addTimer(5000, function()
  print("5 seconds have passed!")
  utilprint("$Y[Timer] $w5 seconds elapsed")
end)
 
-- Repeating timer (fires every 10 seconds)
local autoSaveTimer = addTimer(10000, function()
  send("save")
  print("Auto-saved!")
  utilprint("$G[Save] $wAuto-saved!")
end, true)
 
-- Repeating timer for status updates (every minute)
addTimer(60000, function()
  send("score")
end, true)

removeTimer(timerId)

local myTimer = addTimer(5000, callback, true)
 
-- Stop the timer
removeTimer(myTimer)

local timer = findTimerByName(name)

local success = toggleTimerByName(name, enabled)

local timerId = setTimeout(callback, delay)

-- Execute after 2 seconds
setTimeout(function()
  print("Timer fired!")
  utilprint("$Y[Timeout] $wTimer fired!")
end, 2000)
 
-- Store ID for potential cancellation
local timerId = setTimeout(function()
  send("look")
end, 5000)

clearTimeout(timerId)

local timerId = setTimeout(function()
  send("delayed command")
end, 5000)
 
-- Cancel it before it fires
clearTimeout(timerId)

-- Automation plugin
print("Loading automation...")
 
-- Auto-heal when health is low
addTrigger("HP: (\\d+)/(\\d+)", function(line, matches)
  local hp = tonumber(matches[1])
  local maxHp = tonumber(matches[2])
  local percent = (hp / maxHp) * 100
 
  if percent < 30 then
    colourNote("red", "", "!!! LOW HEALTH !!!")
    send("drink healing potion")
  end
end, { type = "regex" })
 
-- Auto-loot after kill
addTrigger("is DEAD", function()
  setTimeout(function()
    send("get all corpse")
  end, 500)
end)
 
-- Combat triggers
local function attackHandler(line)
  print("Under attack!")
  utilprint("$R[Combat] $wUnder attack!")
end
 
addTrigger("attacks you", attackHandler, { group = "combat" })
addTrigger("swings at you", attackHandler, { group = "combat" })
 
-- Quick movement: /run north (runs 5 times)
addAlias("^run (.+)$", "", function(matches)
  local direction = matches[1]
  for i = 1, 5 do
    send(direction)
  end
end)
 
-- Quick attack: /kk goblin
addAlias("^kk (.+)$", "", function(matches)
  toggleTriggerGroup("combat", true)
  send("kill " .. matches[1])
end)
 
-- Auto-save every 5 minutes
addTimer(300000, function()
  send("save")
  print("Auto-saved!")
  utilprint("$w[Save] Auto-saved")
end, true)
 
-- Status check every minute
addTimer(60000, function()
  send("score")
end, true)
 
print("Automation loaded!")