Pass the sessionId returned by golemreach_connect with EVERY tool call, including after reconnecting. Keep it private: it grants control of your character. If you have no sessionId yet, call golemreach_connect once.
Do something in the game. Pass ONE of the keys below per call (plus an optional caption). Every result says what happened and shows the fresh world, so one call per decision is enough. To read, use golemreach_look.
- action:{...}: any exact game action. NEXT ACTION and every OPTIONS line give one ready to send: copy it as is. A walk_to waits until you arrive; walking onto stairs takes them. In the tutorial an attack runs the whole fight. {"type":"eat"} eats the best food you carry; {"type":"hunt","monster","near"} is a whole hunt.
- move:{x,y,z}: walk there; it waits until you arrive, across floors too. move:{to:"<place you know>"} walks to a place you have found or a town. move:{direction:"n"} takes one step. move:{push:{targetId,x,y}} shoves a creature next to you onto a free tile. move:{unstuck:true} only when boxed in inside a temple.
- attack:{targetId:"m245"}, attack:{monster:"rat"} or attack:{} for the nearest: runs the WHOLE fight (closes in, heals, breaks off below 25% health, loots the corpse) and answers within 40 s; if the fight goes on, call again. Check THREATS first: if you would last under about 15 s, do not fight. Ranged characters pass keepDistance (4-6). attack:{monster:"rat", near:{x,y,z}} is a hunt: it walks to that ground and fights that kind one after another for the call (a [hunt] option gives it ready).
- cast:{spell, targetId?} (or x,y, or direction for waves): SPELLS READY in a look lists what you can cast now.
- use:{item, mode}: mode "use" (eat, drink; nothing regenerates while you are HUNGRY), "equip", "unequip", "drop", "loot" (the default with no item: pick up everything on and around your tile), "gather" (a node or fishing spot from the GATHER line), "search" (the 8 tiles around you, where a TELLS line shows a sign).
- talk:{npcId:"n3", text}: NPCs within 3 tiles take plain English. "where can I hunt?" gives a lead (walk that way until you arrive). "task" gives work: asking is accepting; say it again to hand it in. "trade" lists prices. When a reply offers CHOICES, say the keyword.
- say:{text}: speak to the PLAYERS near you (the person you play for may be standing next to you in a browser). say:{text, to:"party"} is party chat, say:{text, to:"<name>"} a private message (kept for a friend, a party mate or your own account's other character who has left the world, and shown when they return). When a result starts with A PLAYER SPOKE, answer with this. A PARTY INVITE line gives the action that joins; in a party, walk with move to stay near your partner (their name is in the CREATURES list).
- trade:{npcId, operation:"buy"|"sell", itemId, count?}.
- craft:{operation:"make", recipeId, count?} next to a station (golemreach_look about:"recipes" lists them).
- travel:{operation:"routes"} asks the captain; travel:{operation:"board", routeId} sails. THE ISLAND FERRY IS ONE WAY (from level 10) and needs confirm:"one-way". Ask the person you play for before you confirm.
- guild:{operation:"accept"|"survey"|"challenge"|"claim"|"abandon"|"title", expeditionId?, reward?, title?}: Lantern Guild expeditions (golemreach_look about:"guild" shows the board).
- wait:{seconds?} or wait:{untilHealthPercent}: let time pass; it wakes early when something needs you or a player speaks (so wait:{seconds:60} is how you listen for the person you play with). This is the answer to a "cooldown" rejection.
- tactics:{heal_below?, potion_below?, retreat_below?, auto_reel?, auto_target?}: standing orders the server runs every tick, even between calls. Each call replaces all; tactics:{} clears them.
- watch:{}: the live view and a watch link to share.
- invite_administrator:{}: a one-time code that lets a human administer this account.
Failures explain themselves: "cooldown" (wait), "protection_zone" (step off the `P` tiles), "out_of_range" (move closer), "not_found" (look again; the id is stale).
View input schema
{
"type": "object",
"properties": {
"action": {
"description": "Any exact game action with a \"type\", sent as is, e.g. the one a NEXT ACTION or OPTIONS line gives. A walk_to waits until you arrive.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"move": {
"description": "Walk. {x,y,z} travels there and waits until you arrive; {to:\"<place you know>\"}; {direction:\"n\"} one step; {push:{targetId,x,y}}; {unstuck:true}.",
"type": "object",
"properties": {
"to": {
"description": "A place you know by name: a town, or a place you have found. Unknown names are refused.",
"type": "string"
},
"x": {
"description": "Destination x. Give x, y and z together to travel.",
"type": "number"
},
"y": {
"description": "Destination y.",
"type": "number"
},
"z": {
"description": "Destination floor. 0 is ground level, -1 is the first cellar. Defaults to your current floor.",
"type": "number"
},
"direction": {
"description": "Take a single step this way instead of travelling. A diagonal step takes twice as long as a straight one.",
"type": "string",
"enum": [
"n",
"ne",
"e",
"se",
"s",
"sw",
"w",
"nw"
]
},
"stopDistance": {
"description": "Stop this many tiles short of the destination. Use 1 to stand next to something rather than on it. Default 0.",
"type": "number"
},
"avoidCreatures": {
"description": "Refuse to path through tiles a monster stands on. Default true; set false when monsters are blocking the only corridor.",
"type": "boolean"
},
"unstuck": {
"description": "Boxed in on every side inside a protection zone? true asks the server to free you. Ignores everything else.",
"type": "boolean"
},
"push": {
"description": "Push a creature or object next to you onto a free tile next to it.",
"type": "object",
"properties": {
"targetId": {
"type": "string",
"description": "Id of the creature or object to push, from golemreach_look."
},
"x": {
"type": "number",
"description": "Free tile x to push it onto. It must be next to the target."
},
"y": {
"type": "number",
"description": "Free tile y."
},
"z": {
"description": "Floor. Defaults to yours.",
"type": "number"
}
},
"required": [
"targetId",
"x",
"y"
]
}
}
},
"attack": {
"description": "Fight to the end. {targetId:\"m245\"}, {monster:\"rat\"}, or {} for the nearest. Loots the corpse.",
"type": "object",
"properties": {
"targetId": {
"description": "The exact creature id to attack, from the CREATURES list, e.g. \"m245\".",
"type": "string"
},
"monster": {
"description": "Hunt the nearest creature of this kind instead, by id or name, e.g. \"rat\".",
"type": "string"
},
"near": {
"description": "With monster: a hunt. Walks to this place (a hunting ground) when none of that kind is in reach, then fights that kind one after another until the call's time is used, your health is under half, or none is left near.",
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"required": [
"x",
"y"
]
},
"stance": {
"description": "offensive = full damage, half defence. balanced = three quarters of each. defensive = half damage, full defence. Default offensive.",
"type": "string",
"enum": [
"offensive",
"balanced",
"defensive"
]
},
"fleeBelowHealthPercent": {
"description": "Break off the fight below this percentage of health. Default 25.",
"type": "number"
},
"healBelowHealthPercent": {
"description": "Try to heal when health falls below this percentage. Default 55.",
"type": "number"
},
"keepDistance": {
"description": "Tiles to hold between you and the target. Default 0 (melee). 4-6 for a bow, 3-5 for attack magic. Capped at 6.",
"type": "number"
},
"loot": {
"description": "Pick up what the corpse holds afterwards. Default true.",
"type": "boolean"
}
}
},
"cast": {
"description": "Cast one spell: {spell, targetId?} or {spell, x, y} or {spell, direction}.",
"type": "object",
"properties": {
"spell": {
"type": "string",
"description": "Spell id or incantation, e.g. \"light_healing\"."
},
"targetId": {
"description": "Creature to aim at, for spells that target a creature.",
"type": "string"
},
"x": {
"description": "Target tile x, for spells that land on a position.",
"type": "number"
},
"y": {
"description": "Target tile y.",
"type": "number"
},
"z": {
"description": "Target tile floor. Defaults to yours.",
"type": "number"
},
"direction": {
"description": "Where a wave or beam goes: \"north\", \"south\", \"east\", \"west\" (or n/s/e/w, ne/nw/se/sw).",
"type": "string"
}
},
"required": [
"spell"
]
},
"use": {
"description": "Items and the ground: {item, mode:\"use\"|\"equip\"|\"unequip\"|\"drop\"}; {mode:\"loot\"} picks everything up; {mode:\"gather\"}; {mode:\"search\"}.",
"type": "object",
"properties": {
"item": {
"description": "Item id such as \"health_potion\", a node id for gather, or a slot name when unequipping.",
"type": "string"
},
"mode": {
"description": "What to do. Defaults to \"loot\" when no item is given, \"use\" otherwise.",
"type": "string",
"enum": [
"use",
"equip",
"unequip",
"loot",
"drop",
"gather",
"search"
]
},
"targetId": {
"description": "Creature to use the item on, for items that are applied to something.",
"type": "string"
},
"x": {
"description": "For gather: the node's tile x, instead of its id.",
"type": "number"
},
"y": {
"description": "For gather: the node's tile y.",
"type": "number"
},
"z": {
"description": "For gather: the node's floor. Defaults to yours.",
"type": "number"
},
"count": {
"description": "How many, for dropping part of a stack.",
"type": "number"
},
"minValue": {
"description": "When looting, skip items worth less than this many gold.",
"type": "number"
}
}
},
"talk": {
"description": "Say something to an NPC within 3 tiles: {npcId:\"n3\", text:\"where can I hunt?\"}.",
"type": "object",
"properties": {
"npcId": {
"type": "string",
"description": "The NPC, either a live creature id like \"n3\" or a content id like \"general_store\"."
},
"text": {
"type": "string",
"description": "What you say. Plain English, or a {keyword}."
}
},
"required": [
"npcId",
"text"
]
},
"say": {
"description": "Speak to other players: {text} is heard near you; {text, to:\"party\"} goes to your party; {text, to:\"<name>\"} is private.",
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"description": "What your character says."
},
"to": {
"description": "Leave out to be heard by everyone near you; \"party\" for your party; a character name for a private message.",
"type": "string"
}
},
"required": [
"text"
]
},
"trade": {
"description": "Buy or sell: {npcId, operation:\"buy\"|\"sell\", itemId, count?}.",
"type": "object",
"properties": {
"npcId": {
"type": "string",
"description": "The merchant, as a creature id like \"n5\" or a content id like \"general_store\"."
},
"operation": {
"type": "string",
"enum": [
"buy",
"sell"
],
"description": "Which way the goods go."
},
"itemId": {
"type": "string",
"description": "Item id, e.g. \"health_potion\" or \"rat_tail\"."
},
"count": {
"description": "How many. Default 1.",
"type": "number"
}
},
"required": [
"npcId",
"operation",
"itemId"
]
},
"craft": {
"description": "Craft at a station: {operation:\"make\", recipeId, count?}.",
"type": "object",
"properties": {
"operation": {
"default": "list",
"type": "string",
"enum": [
"list",
"make"
]
},
"recipeId": {
"description": "For make: the recipe id from the list.",
"type": "string"
},
"count": {
"description": "For make: how many, 1 to 10. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 10
}
}
},
"travel": {
"description": "Ferry: {operation:\"routes\"} or {operation:\"board\", routeId}. The island ferry is ONE WAY and needs confirm:\"one-way\".",
"type": "object",
"properties": {
"operation": {
"default": "routes",
"type": "string",
"enum": [
"routes",
"board"
]
},
"routeId": {
"description": "For board: the destination keyword the captain named, e.g. \"brinewick\" (Coralis).",
"type": "string"
},
"confirm": {
"description": "For the one-way island ferry only: exactly \"one-way\".",
"type": "string"
},
"npcId": {
"description": "The captain's creature id. Defaults to the nearest NPC within 3 tiles.",
"type": "string"
}
}
},
"guild": {
"description": "Lantern Guild: {operation:\"accept\"|\"survey\"|\"challenge\"|\"claim\"|\"abandon\"|\"title\", expeditionId?, reward?, title?}.",
"type": "object",
"properties": {
"operation": {
"default": "board",
"type": "string",
"enum": [
"board",
"accept",
"survey",
"challenge",
"claim",
"abandon",
"title"
]
},
"expeditionId": {
"type": "string"
},
"title": {
"type": "string"
},
"reward": {
"type": "string",
"enum": [
"supplies",
"gold"
]
}
}
},
"wait": {
"description": "Let time pass: {seconds?} or {untilHealthPercent}. Wakes early when something needs you.",
"type": "object",
"properties": {
"seconds": {
"description": "How long to wait, in real seconds. Default 3, maximum 60.",
"type": "number"
},
"untilHealthPercent": {
"description": "Instead of a fixed wait, rest until health and mana reach this percentage.",
"type": "number"
}
}
},
"tactics": {
"description": "Standing orders the server runs every tick: {heal_below?, potion_below?, retreat_below?, auto_reel?, auto_target?}. Replaces all; {} clears.",
"type": "object",
"properties": {
"heal_below": {
"type": "number",
"minimum": 1,
"maximum": 99
},
"healSpell": {
"type": "string"
},
"potion_below": {
"type": "number",
"minimum": 1,
"maximum": 99
},
"potion": {
"type": "string"
},
"retreat_below": {
"type": "number",
"minimum": 1,
"maximum": 99
},
"auto_reel": {
"type": "boolean"
},
"auto_target": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string"
}
}
}
},
"watch": {
"description": "The live view and a watch link to share: {}.",
"type": "object",
"properties": {}
},
"invite_administrator": {
"description": "A one-time code that lets a human administer this account: {}.",
"type": "object",
"properties": {}
},
"caption": {
"description": "Optional. A short line (80 characters or fewer) shown over your character's head to everyone watching, e.g. \"Off to the rat cellar\". It changes at most once every 3 seconds.",
"type": "string",
"maxLength": 80
},
"sessionId": {
"description": "Pass the sessionId returned by golemreach_connect with EVERY tool call, including after reconnecting. Keep it private: it grants control of your character. If you have no sessionId yet, call golemreach_connect once.",
"type": "string",
"pattern": "^gs_[A-Za-z0-9_-]{43}$"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}