Global Methods

echo "Starting hunting routine"
echo "Health: #{Char.health}", "Mana: #{Char.mana}"

# Output: [script_name: Starting hunting routine]
#         [script_name: Health: 100]
#         [script_name: Mana: 50]

respond "=" * 40
respond "Status Report"
respond "Health: #{Char.health}"
respond "=" * 40

# Disable echo output
echo_off
toggle_echo

# Re-enable echo output
echo_on

script = Script.current
script.no_echo = true  # Suppress echo output

# Single command
put "look"

# Multiple commands
put "north", "look", "south"

# Variable command
command = "attack #{target}"
put command

# Automatically handles roundtime, stun, etc.
fput "attack troll"

# Wait for specific response
result = fput "search", "You search", "You find nothing"
if result =~ /find nothing/
  echo "Nothing found"
end

multifput "stand", "north", "look"
# Equivalent to:
# fput "stand"
# fput "north" 
# fput "look"

# Wait for single string
waitfor "Obvious exits"

# Wait for any of multiple strings
line = waitfor "You attack", "You miss", "You fumble"

if line =~ /attack/
  echo "Hit!"
else
  echo "Missed"
end

# Wait for pattern
match = waitforre /You (?:hit|strike|slash) the (\w+)/

creature = match[1]
echo "Hit the #{creature}!"

match "success", "You succeed"
match "failure", "You fail" 
match "retry", "Try again"
result = matchwait

case result
when /You succeed/
  goto :success
when /You fail/
  goto :failure
when /Try again/
  goto :retry
end

result = matchtimeout(5, "You succeed", "You fail")

if result == false
  echo "Timed out after 5 seconds"
else
  echo "Got result: #{result}"
end

# Blocking get (waits for line)
line = get
echo "Received: #{line}"

# Non-blocking get (returns nil if empty)
line = get?
if line
  echo "Got: #{line}"
else
  echo "Buffer is empty"
end

put "inventory"
pause 0.5

lines = clear
lines.each { |line| echo line }

# Get last 10 lines
recent = reget(10)

# Get lines matching pattern
matches = reget(50, "monster", "creature")

# Get all history including wrapped lines
all_history = regetall(100)

# Seconds
pause 5

# Minutes
pause "2m"

# Hours
pause "1h"

# Days  
pause "1d"

# Decimal values
pause 0.5  # Half second

# Wait while condition is true
wait_while { stunned? }
wait_while { Char.mana < 50 }

# Wait until condition is true
wait_until { Char.health > 80 }
wait_until { !checkwebbed }

# With message
wait_until("Waiting for health...") { Char.health > 80 }

# Wait for roundtime to expire
waitrt

# Check and wait, returns true if there was RT
if waitrt?
  echo "Had roundtime"
end

# Check remaining roundtime
remaining = checkrt
echo "#{remaining} seconds remaining"

# Wait for cast roundtime
waitcastrt

# Check and wait
if waitcastrt?
  echo "Had cast RT"
end

# Check remaining
remaining = checkcastrt

# Basic movement
move "north"

# Returns true on success, false/nil on failure
if move "go door"
  echo "Moved successfully"
else
  echo "Movement failed"
end

# Handles:
# - Climbing
# - Swimming  
# - Roundtime
# - Stun
# - Web
# - Locked/closed doors

multimove "north", "north", "east", "up"
# Or
multimove n, n, e, u

# Short direction methods
n    # "north"
s    # "south"
e    # "east"
w    # "west"
ne   # "northeast"
se   # "southeast"
sw   # "southwest"
nw   # "northwest"
u    # "up"
d    # "down"
o    # "out"

# Usage
move n
multimove n, n, e, u

# Status indicators
checkstunned      # Stunned?
checkwebbed       # Webbed?
checkdead         # Dead?
checkbleeding     # Bleeding?
checkprone        # Lying down?
checkstanding     # Standing?
checksitting      # Sitting?
checkkneeling     # Kneeling?
checkhidden       # Hidden?
checkinvisible    # Invisible?

# Combined checks
muckled?          # Dead, stunned, or webbed?

# Room information
checkroom         # Room title
checkarea         # Area name
checkroomdescrip  # Room description
checkpaths        # Available exits

# Examples
if checkroom("Town Square")
  echo "In town square"
end

exits = checkpaths
echo "Exits: #{exits.join(', ')}"

# Check for creatures
creatures = checknpcs
if creatures
  echo "Found: #{creatures.join(', ')}"
end

# Check for players
players = checkpcs
if players
  echo "Players here: #{players.join(', ')}"
end

# Check for specific creature
if checknpcs("troll", "ogre")
  echo "Dangerous creature present!"
end

# Check hands
right = checkright
left = checkleft

echo "Right hand: #{right || 'empty'}"
echo "Left hand: #{left || 'empty'}"

# Check for specific item
if checkright("sword")
  echo "Holding sword"
end

# Get script arguments
vars = variable
echo "Args: #{vars.inspect}"

# Equivalent to
script = Script.current
echo "Args: #{script.vars.inspect}"

# Send to another script
send_to_script("other_script", "message1", "message2")

# In other_script:
line = unique_get      # Blocking
line = unique_get?     # Non-blocking

# Wait for specific message
result = unique_waitfor("ready", "done")

# Enable upstream capture
toggle_upstream

loop do
  user_input = upstream_get
  echo "User typed: #{user_input}"
  
  # Process and optionally modify
  if user_input =~ /^attack/
    echo "Intercepted attack command"
  end
end

# Make script completely silent
silence_me

# Toggle back
silence_me

script = Script.current
script.silent = true

loop do
  waitrt?
  target = checknpcs("troll", "ogre")
  
  if target
    fput "attack #{target}"
  else
    echo "No targets, waiting..."
    pause 2
  end
end

loop do
  if Char.health < 50
    echo "Health low, healing..."
    fput "drink my potion"
    waitfor "You feel better"
  end
  
  pause 5
end

target_room = "Bank"

loop do
  current = checkroom
  echo "Currently in: #{current}"
  
  if current =~ /#{target_room}/
    echo "Arrived!"
    break
  end
  
  # Smart room navigation logic here
  pause 1
end