The script must be executable (e.g. chmod +x with an appropriate shebang). For some languages, it may be necessary to write a wrapper script to start the program. Additionally, on Windows systems where the shebang is not supported, the player must provide a means of running such a script. For example script python <path-to-script> if you are using python.

All newline characters used in the scripting interface consist of the singular “\n” (decimal 10, hexadecimal 0x0a) character, aka Unix-style newlines. No other newline schemes are supported by the interface. A note to Windows users: Simple printline code or a .bat file echo command will not work.

* Request Commands *

VERIFIED Send: “request flags” Format: request flags <firing> <running> <obsolete-ignore> - : Verify obsolesence Note: Values are integers 1 and 0 for true and false, respectively, and indicate whether or not a player is currently firing or running.

VERIFIED Send: “request player” Returns: “request player <name> <title>” Note: <name> contains no spaces whereas <title> may contain several as the field ends at the newline.

VERIFIED Send: “request range” Depending on what your Range slot contains, this function may return data in several formats. * If nothing is equipped: “request range Range: nothing” * If an item was equipped automatically due to the invocation of a spell or prayer: “request range Skill: holy symbol” or “request range Skill: talisman” without the details of which holy symbol or talisman was equipped. * Bows/Crossbows: “request range Range: <rangedname> (<ammunition>)”, e.g. “elven bow (arrows)” * Spells: “request range Range: spell (<spell name>)”, e.g. “request range Range: spell (meteor swarm)” * Everything else: “request range Skill: <skillname>”, which is whatever you skill is required to use the weapon you equipped last; invoking a spell or prayer may automatically equip a talisman or a holy symbol and return that literally as a skill.

Send: “request weight” Returns: “request <maxweight> <carryingweight>” Note: Both values returned are integer grams.

The “request stat <x>” is a command with several types and is documented seperately here:

VERIFIED Send: “request stat cmbt” Returns: “request stat cmbt <wc> <ac> <dam> <speed> <weaponspeed>” Note: All returned values are integers; wc and ac may be negative. To convert the speed values into fractional ones seen in the clients, divide them by 100000.

VERIFIED Send: “request stat hp” Returns “request stat hp <hp> <maxhp> <sp> <maxsp> <gr> <maxgr> <food>” Note: All returned values are integers. The sp and gr values may exceed the corresponding maxsp and maxgr values in certain situations (e.g. praying over an altar of your deity will eventually raise your gr to maxgr x 2 and may also raise your sp over maxsp depending on deity).

VERIFIED Send: “request stat paths” Returns: “request stat paths <attuned> <repelled> <denied>” Note: All returned values are integers and are at present undefined. : Define

TODO: Verify Command: “request stat resists” Returns: “request stat resists <physical> <magic> <fire> <electricity> <cold> <confusion> <acid> <drain> <ghosthit> <poison> <slow> <paralyzation> <turn> <fear> <depletion> <death> <holy-word> <blindness>” All values are signed integers.

VERIFIED Command: request stat stats Returns: All your stats including all positive and negative effects due to equipment and spells. : Verify spells Format: “request stat stats <str> <con> <dex> <int> <wis> <pow> <cha>” All returned values are integers.

VERIFIED Command: request stat stats_applied Returns: request stat stats_race <str> <con> <dex> <int> <wis> <pow> <cha> Note: All values are integer zeroes. TODO: Sort out why command is borked.

VERIFIED Command: request stat stats_base Returns: request stat stats_base <str> <con> <dex> <int> <wis> <pow> <cha> Note: All values are integer zeroes. TODO: Sort out why command is borked.

VERIFIED Command: request stat stats_race Returns: request stat stats_race <str> <con> <dex> <int> <wis> <pow> <cha> Note: All returned values are integers and represent the base stats for your race.

* Multi-line output request commands *

VERIFIED Command: request items inv Returns: * Zero or more of “request item inv <tag> <count> <weight> <flags> <type> <title>” lines followed by “request items inv end”.

Return values:

  <tag>    - server-internal identifier for the item
  <count>  - the number of items
  <weight> - the weight of the item(s) in grams (divide by 1000 to get kgs as displayed in the clients)
  <flags>  - see below for valid flag values
  <type>   - server-internal item type
  <title>  - description of the item(s); encompasses the rest of the line

The flags value:

  This is an integer using individual bits to designate whether or not a property applies to an item. For simplicity, decimal and hexadecimal values are given:

Open 0x04 Applied 0x08 Locked 0x10 Unpaid 0x20 Damned 0x40 Cursed 0x80 Magic 0x100

Command: request items actv This command is functionally equivalent to “request items inv” returning only items with the Applied flag set. The line prefix is “request items actv” however, and the termination string is “request items actv end”.

* Map Commands *

Commands: request map all Repeats: request map all <x> <y> <darkness> <smooth1> <smooth2> <smooth3> <fog-of-war> heads <heads1> <heads2> <heads3> tails <tails1> <tails2> <tails3> Values: * x and y, integers: the coordinates of the tile; arbitrary (and may be negative), but relative to one another * darkness, integer: the darkness of the tile; arbitrary byte value - : Verify Note: Contrary to the command name, this command returns an arbitrary number of tiles surrounding you, not the entire map. The size of the map returned is server-specific. * all smooth values: the character “y” or “n” * fog-of-war, character: “y” or “n” indicating the presence of fog of war on the tile * heads and tails values: server-specific types for the appearance of the tile Quirks: heads and tails values will change with 1) tile animation and 2) the presence of a town portal on a tile

Commands: request map near Repeats: request map near <x> <y> <darkness> <smooth1> <smooth2> <smooth3> <fog-of-war> heads <heads1> <heads2> <heads3> tails <tails1> <tails2> <tails3> Terminates with: “request map near end” Note: The values returned are as “request map all” in every respect except that the tiles returned are of the spot on which you are standing and those immediately adjacent, nine in total.

Note: The title result terminates at newline and may include the number of that item you are carrying Note: All returned values are integers.

Send: request stat xp XXX Returns “request stat xp <level> <xp> <sp> <maxsp> <gr> <maxgr> <food>” Note: All returned values are integers.