Home

t4modules-debugging

Debugging: Figuring out what went wrong

t4modules t4modules t4modules module howto guides

Updating your configuration

Enabling cheat/development mode will grant you access to the internal Lua console and some additional dialogs/options useful for debugging. It will stop you from uploading characters online, though, but you can always turn this mode off.

  • Navigate to the corresponding configuration directory (replace HOME with your home directory).
Operating System Configuration Directory
Windows HOME\T-Engine\4.0\settings
Linux HOME/.t-egine/4.0/settings
Mac OSX HOME\Library\Application Support\T-Engine\4.0\settings
  • Create a file called cheat.cfg in that directory, and put the following text in that file.
cheat = true
  • To turn cheat/development mode off, just change true to false or delete the cheat.cfg file.

Inside of ToME

Key Shortcut Result
Ctrl+L Lua console
Ctrl+A Debug dialog

NOTE: The keybinding may not be set, in this case you have to bind it yourself first.

Lua console

Summary of features:

  • Inspect values and execute code
  • Cursor positioning
  • Tab auto-completion
  • Copy and paste with system clipboard

The Lua console drops you into the global namespace and gives you access to the engine. If you want to inspect values, start the line with an equal sign. For example, say you want to inspect the player:

=game.player

The console has cursor positioning so you can use the Left and Right arrows, as well as Home and End to move to the beginning and end of the current line, respectively. You can paste the clipboard's contents to the cursor position with Ctrl+V (note, not Apple+V on Mac). The current line can be copied to the clipboard with Ctrl+C (again, not Apple+C).

Here are some useful commands to know.
If you want to get to level 50 use:

game.player:forceLevelup(50)

Remove godmode invulnerability:
game.player.invulnerable=0

Change your damage bonus:
game.player.inc_damage.all=

Learn a new talent (1 level in Slash in the example):
game.player:learnTalent(game.player.T_SLASH, true, 1)

Change your max HP:
game.player.max_life=1

game.player:resetToFull()

Teleport (to the Assassin Lord):
game:changeLevel(2,"thieves-tunnels")

Add 5000 gold:
game.player:incMoney(5000)

Give yourself 10 unassigned class skills:
game.player.unused_talents=10

Give yourself 10 unused stat points:
game.player.unused_stats=10

Give yourself 10 unused generic points:
game.player.unused_generics=10

Give yourself 10 unused category points:
game.player.unused_talents_types=10

Give yourself 10 lives:
game.player.easy_mode_lifes=10

Windows and Mac: Output log text to file immediately

1) Create a shortcut to t-engine.exe
2) Rightclick the shortcut, select Properties
3) Add the command to the end of the "Target" line

--flush-stdout

The end of the Target line should look like this then: \t-engine.exe --flush-stdout

This can be used in combination with a Tail program that shows the content of the log file in realtime.

Load Module and create Character on startup

Ask Darkgod and write it down here. ;)