Wizard and Debug mode

Wizard mode

[describe wizard mode here]

Debug mode

[describe debug mode]

Debug commands are entered as an "underlying command" (a single key) plus a variety of optional or required arguments.

The debug commands are used for debugging and experimenting. The game will not be scored if you use debug commands.

Command List Summary

a

Autorestore

A

show All stats

b

teleport to target

B

possess Body

c

Create object

C

Create artifact

d

Detect all

D

teleport to Dungeon

e

Edit character attributes

E

change grid's mana

f

*Identify*

F

change Feature

g

create Good items

G

(unused)

h

change Hitpoints

H

monster Horde creation

i

Identify

I

(unused)

j

Jump to other level

J

(unused)

k

self Knowledge

K

(unused)

l

Learn about objects

L

(unused)

m

Magic mapping

M

gain corruption (Mutation)

n

summon Named monster

N

summon friendly Named monster

o

edit Object attributes

O

(unused)

p

Phase door

P

Panic save

q

get a Quest

Q

(unused)

r

gain Reward

R

create a trap

s

Summon monster

S

change the Special field

t

Teleport

T

Teleport to a town

u

complete map

U

become Undead

v

create Very good items

V

(unused)

w

Wizard light the level

W

Wish

x

eXperience boost

X

(unused)

y

(unused)

Y

(unused)

z

Zap monsters

Z

(unused)

[add the remaining commands]

Command Descriptions

The following command descriptions are listed as the command name plus the "underlying command" key. Then comes a brief description of the command. Some commands use the "repeat count" to automatically repeat the command several times, while others use the "repeat count" as an "argument", for example, commands which need a "quantity" will use the "repeat count" instead of asking for a quantity, allowing the use of "0d" for "drop all". Commands which ask for a quantity will convert any "letters" into the maximal legal value.

Autorestore (a)

Cure everything. This includes hit points, sanity, spell points, hunger, drained stats, lost levels, etc.

Show all stats (A)

This brings up the Character status menu, where you can view all the stats about your character.

Teleport to target (b)

You first need to have a monster targeted (e.g. with the '*' command), then you can use this command to teleport next to the monster.

Possess body (B)

Possess the body of the monster with the number from r_info.txt defined by the command count. If called without a command count, you change back to the normal 'Player' body with 0 hit points.

You still need the Possession skill to be able to use the racial powers of the possessed body.

For example : 0517^AB let you possess the Watcher in the Water.

Create object (c)

Allows you to select and create a new object where you stand. This brings up a menu where you can choose what type of object you want created, then a menu where you select the specific object.

Some items that cannot be distinguished in this way (e.g. mimic cloaks, random spellbooks) are displayed with a '#' in the name. Their type can be set with the o - edit object command.

Create artifact (C)

Allows you to select and create a new artifact where you stand. Unlike other commands, you are prompted to type the number from a_info.txt of the artifact that should be created. Normal artifacts defined in k_info.txt cannot be created in this way.

For example : ^AC3\r will create the Arkenstone of Thrain.

Detect all (d)

Sense ways out/monsters/objects/treasure/traps in the default radius of 25.

Teleport to dungeon (D)

Teleports you to the first level of the dungeon specified by the command count. If used without command count, you are teleported back to a new level of the wilderness (i.e. level 0 of dungeon 0).

For example : 019^AD brings you to level 10 of the Orc Cave.

Edit character attributes (e)

Edit character statistics (Str, Int, Wis, Dex, Con, Chr), gold, experience, and luck.

Change grid's mana (E)

Alter how much mana a grid has. Use the command count to specify the amount of mana that you want. Without command count the mana is set to 0.

*IDENTIFY* (f)

Fully *Identify* an object, like a Scroll of *Identify*.

Change feature (F)

Use the command count to specify a number from f_info.txt to put a feature on the ground where you are standing. Without command count the feature 0 (unknown grid) is used.

Create good items (g)

Uses the command count to create that many random items of good or better quality where you are standing. Without command count only one item is created.

Change hit points (h)

Rerolls all your hitpoints and displays a number indicating how they compare to the average, the so-called life rating. It's like quaffing a Potion of New Life.

Create monster horde (H)

Summons a pack of creatures of the same kind. Will only work if MONSTER_HORDES has been defined at compile time.

Identify (i)

Identifies an object, like a Scroll of Identify.

Jump to other level (j)

Jump to another dungeon level in the same dungeon. You may use the command count to specify the dungeon level, otherwise you are queried to enter the new dungeon level. If the level is lesser than the minimum level of the dungeon, the dungeon is left and the wilderness is reached instead, and if it is greater than the maximum level, this maximum level is reached.

Self knowledge (k)

Displays your characters attributes, like a Potion of Self Knowledge.

Learn about objects (l)

Learn about all objects with a generation level less than or equal to the command count.

Magic Mapping (m)

Magically maps the local area, like a Scroll of Magic Mapping.

Gain corruption (M)

Allows your character to gain a random corruption.

Summon named monster (n)

Summon a monster that will appear next to you. Use the command count to specify the index from r_info.txt that represent the creature.

Summon ''friendly'' named monster (N)

The same as "n" but the creature will be your pet. Try this with number 861, and Darkgod will be your pet for one turn.

Edit object attributes (o)

Allows you to alter the attributes of any object that you have in your backpack. [to be expanded]

Phase door (p)

Teleports you a short distance away, like a Scroll of Phase Door.

Panic save (P)

Saves the current game in a panic savefile (*.pnc) and quit the game. This file is loaded automatically instead of the proper savefile and deleted if it could be loaded successfully. If the panic savefile cannot be loaded, you need to delete it manually.

Get a quest (q)

Use the command count to specify a quest number from 1 to 25, as defined in defines.h (the QUEST_XXX items), and mark the quest as taken. Random quests (5) cannot be started in this way.

For example : 04^Aq will get you the thieves quest.

Gain reward (r)

Receive a reward or punishment, a left-over from ZAngband. A command count may be used to specify which gift you wish to receive (see REW_XXX in defines.h).

For example, 05^Ar gives you a Chaotic blade.

Create a trap (R)

Uses the command count to specify a number from tr_info.txt to put a trap of this type on the ground where you are standing.

For example, 0125^AR creates a Seeker Bolt Trap.

Summon monster (s)

Use the command count to try to summon that many random monsters or monster groups, next to where you stand. If no command count is used, only one monster (group) will be summoned.

Change the special field (S)

This allows you to change the "special" field of the current grid. This special field is used to store things like quest numbers, dungeon entries, and so on, not to be used unless one knows what it's doing.

Teleport (t)

Teleports you a long distance away. Unlike a Scroll of Teleport, it bypass any restriction, i.e. it works even on special levels.

Teleport to a town (T)

Teleports you to a non-random town. Use the command count to specify a number from wf_info.txt for where you want to go. The towns in ToME are Bree (1), Gondolin (2), Minas Anor (3), Lothlorien (4), and Khazad-dum (5).

For example : 02^AT will teleport you to Gondolin.

Complete map (u)

Mark and illuminate every dungeon grid and wizard-light the level, independently of the used options, like a Potion of *Enlightment*.

Become undead (U)

This is supposed to make you undead (as in the Necromantic power). A wild rabbit is also summoned near you, and you only need one kill to return to life.

Create very good items (random artifacts/ego items) (v)

Uses the command count to create that many random items of excellent or better quality where you are standing. Without command count only one item is created.

Wizard light the level (w)

Fully wizard-light the level, respecting the used lighting options, like a Potion of Enlightment.

Wish (W)

Makes all your wishes come true. Read the wishing spoiler to see how these work.

Experience boost (x)

Add the command count to the current experience points. If you do not specify a parameter it doubles your current amount and add one.

Zap monsters (z)

All monsters in sight range vanish like Mass Genocide, only with no HP price.

Create spoiler (")

Brings up a menu that allows you to create some spoiler files. This will only work if ALLOW_SPOILERS has been defined at compile time (default).

The spoilers available (with the corresponding file) are:

  1. Brief Object Info (obj-desc.spo)
  2. Full Artifact Info (artifact.spo)
  3. Brief Monster Info (mon-desc.spo)
  4. Full Monster Info (mon-info.spo)
  5. Full Essences Info (ess-info.spo)
    • Note: The first part is available as ./lib/help/essences.txt.
  6. Spell Info (spell.spo)

These files are stored in the user directory, by default ./lib/user.

[To be checked]

~~~~~55 [[[[[GIncrement monster level (@)]

~~~~~61 [[[[[GChange mimic form (*)] Change to mimic form defined with command count. Without command count:

~~~~~67 [[[[[GCreate object (-)]

~~~~~69 [[[[[GThe path to the god dark (_)]

~~~~~71 [[[[[GGain a fate (+)] Unearth more of your prophecy. Uses a command count to determine the fate type.

For example, 06^A+ gives you a death fate.

~~~~~73 [[[[[GAlign monster (=)]

~~~~~81 [[[[[GLua script (>)]

~~~~~91 [[[[[GSummon monster (/)]

~~~~~91 [[[[[GHelp (?)]

Chatter

MayLith: What is the difference (if any) between wizard mode and debug mode?

MassimilianoMarangio: I meant the difference between the commands ^W (wizard mode) and ^A (enter debug command).

MayLith: ctrl-w enters wizard mode (and exits it too???) and you use ctrl-a to enter a specific command while in wizard mode, no?

MassimilianoMarangio: Well, it's a little confusing. Both commands mark the save file, but in a different manner, and both commands are only available if ALLOW_WIZARD was defined in the code, but they could be used independently with the change of one line of code.

With wizard mode I meant only the abilities available while [WIZARD] is on the screen: Telepathy, display of the coordinates in the wilderness, improving and decreasing skills and abilities, be able to create a help-file screendump, peeking in the level generation and cheating death (and perhaps something I forgot).

The second section, debug mode, should only contain the debug commands.

MayLith: BTW, look out for the caret. You have to escape it ^ or it starts doing superscript stuff. (I found that out while working on Documentation/List of commands.) There may be a more correct way to escape it, I'm not sure. ^test <- hmmm, that's probably the better way to do it.

MassimilianoMarangio: I like two backticks better.

MayLith: *sigh* This is one of the things that drives me nuts about wiki. Are all the assorted escaping mechanisms documented on this wiki anywhere? I don't see them on SyntaxReference. It'd be great to see them grouped in one place along with the explanation(s) on why one method is better than another...

MassimilianoMarangio/debug.txt (last edited 2004-09-27 20:34:39 by MayLith)