JToMESpoiler v0.99.5

  1. The Configuration tab
  2. The Skill allocation tab
  3. The Spoilers tab
  4. The Vaults tab
  5. The Find quest tab
  6. Changelog and credits

The JToMESpoiler program combines several informational utilities for use with ToME. If this is the first time you've run this program, you will probably need to configure it first.

The Configuration tab

JToMESpoiler reads and parses ToME's data files to get the information it needs, so naturally it needs to know where these files live. Future versions will (we hope) be able to detect this automatically in some cases; for now, you'll need to specify this by way of the "Browse" button. The directory you'll need should be near where the ToME executable itself is installed, and should be named "edit".

If you have more than one version of ToME installed, you can use "Browse" repeatedly to select the info-file locations for all of them. They will all be placed in the drop-down menu shown above, and you can switch between them as needed. The contents of this list, and the current selection, will be saved between program invocations.

The Skill allocation tab

The Skill allocation tab allows you to experiment with skill point allocations for various character types. First, you'll need to specify what type of character you want to work with:

The "Edit" and "Load character sheet" buttons take you to the skill table:

The skill table shows all the skills available to your selected character type, the number of skill points allocated to each,¹ and the resulting skill levels. Both the Points and the Level cell for a skill can be edited by clicking on it; the Points cell allows you to set the number of skill points allocated to this skill, while the Level cell allows you to set a "target" level for the skill—the allocator will assign just enough points to the skill to get it to the desired level (subject to skill point availability, of course). If you selected the "Expose quest reward skills" checkbox on the character-selection screen, checkboxs will be available next to skills that can be gained via random quests; selecting one of these checkboxes will make the corresponding skill available with a multiplier of 0.500 (or increase its multiplier to 0.500 if it's already available with a lower multiplier).

Similarly, the ability table shows all the available purchasable abilities and allows you to select them. You will only be able to select abilities for which you have satisfied all of the skill and ability prerequisites. Abilities that are missing prerequisites are shown in grey and cannot be selected; you can find out which prerequisites you haven't satisfied yet by hovering the mouse pointer over the corresponding cell. Some abilities may be shown in green; these are abilities that your chosen character combination gains automatically at a certain level (you can find out what level by hovering the mouse pointer over the corresponding cell), and cannot be selected, on the premise that it would be a waste of skill points in the long run.

At the top is displayed the character combination you've chosen, the total number of skill points you've allocated, and the character level required for the current allocation. This reflects both the level required to accumulate the number of skill points you've allocated and the level required to be able to raise the skills to their current levels; if you're using a character sheet that reflects skill boosts gained from a lost-sword quest, the level displayed may be wrong. The "Reset allocation" button will set all your skill allocations back to zero.

At the bottom, the "Change Settings" button will take you back to the character-selection screen, the "Export as formatted text" button will write your current skill point allocation to the selected file as pretty-printed text, and the "Export as CSV button" will write your allocation to the selected file as comma-separated values suitable for import by most spreadsheet programs.


¹ Note that if you're working from a character sheet, the skill points you've already spent are considered "sunk", and aren't reflected in the Points column; a zero point allocation to a given skill sets it to its level at the time of the character sheet, and increasing the allocation increases the skill level from that base level in the usual manner. Similarly, the number of available skill points listed at the top reflects only skill points that were unspent (or not yet gained by character level) at the time of the character sheet.

The Spoilers tab

The Spoiler tab displays detailed information about objects and monsters in the game.

The radio buttons at the top select which category of items you want information about: ordinary objects, monsters, ego items, artifacts, alchemy recipes (not currently implemented), or player races, subraces or classes. To select items within this category, you can enter search keys in the "Search keys:" field; the matches list above it will be populated with an entry for every item in the category that matches any of your search keys. Search keys can have the following forms:

text
This search key matches any item whose name contains the specified (case-insensitive) text. If the text you wish to match contains spaces, you will need to enclose it in single or double quotes, like the 'death sword' search key shown in the example above.
flags:FLAG[,FLAG[,…]]
This search key matches items that have all of the specified flags. Flags are case-sensitive, and must appear exactly as they are specified in the corresponding information files; see the list of recognized flags. Each flag may be preceded with a '!', which matches items that do not have the flag.
'char:C'
This search key matches objects or monsters that are displayed on-screen with the specified character.
'tval:T'
This search key matches objects and artifacts that have the specified tval. The search key 'tval:23', for instance, matches swords. [In future versions, a list of suitable tvals may be included.]
'tsval:T:S[:S2]'
This search key matches objects and artifacts that have the specified tval and sval. If two svals are specified, items with the specified tval and an sval between the specified svals (inclusive) will match.

Once you have a list of matching items, you can select one to display its information in the bottom text area. The checkboxes above this text area modify the information that's displayed:

Show in-game description
Includes the in-game description shown when 'I'nspecting objects or 'r'ecalling monster information
Show possessor info
For monsters, shows extra information of interest to Possessors attempting to possess a corpse of this monster.
Show artifact set info
For artifacts that are members of artifact sets, shows the name of the set and the extra bonuses that are conferred if two or more members of the set are wielded.
Show tval/sval
For objects and artifacts, show the tval and sval of the selected item.

The Vaults tab

The Vaults pane displays maps of vaults.

To display a vault map, select its name in the list. The description below the list will show the width and height of the vault in map squares and the vault's "rating", a rough indication of its difficulty. Clicking on a symbol in the map will show the monster, item and/or feature that will be placed at that point in the vault; in addition, if the feature is a void gate, both connected gates will be highlighted.

The Find quest tab

The Find quest tab helps you find a relic quest temple according to the instructions given to you by your god:

Simply adjust the four drop-down lists to conform to your god's instructions; the area you'll need to search is highlighted on the map in green, and the two "reference" towns are highlighted in yellow. For Melkor relic quests, you'll need to select the "Melkor-based" checkbox to reset the reference points appropriately.

Changelog and credits

2007-04-28
  • Add some simple terrain coloring to the map in the Find quest pane, to make it easier to orient oneself.
  • Beta release 0.99.5
2007-01-18
  • Fix skill table update in Skill allocation pane to track properly as allocation is changed with the spinner.
  • Added documention note about loading character sheets into the Skill allocation tab.
  • Bugfix release 0.99.4a.
2007-01-17
  • Added Vaults tab.
  • Correct computation of skill level for quest reward skills.
  • Fixed some rendering glitches.
  • Beta release 0.99.4.
2007-01-01
  • Added export-as-CSV functionality and random quest simulation to the Skill allocation pane.
  • Beta release 0.99.3.
2006-12-12
  • Add a list of spoiler search flags to the Help tab.
  • Fixed some rendering and editing bugs in the skill table.
  • Bugfix release 0.99.2a.
2006-12-09
  • Move the user configuration file to a more suitable system-specific place.
  • Try to find the needed information files in likely system-specific places if we don't have any locations configured.
  • Beta release 0.99.2.
2006-12-06
  • Alchemy radio button on Spoilers tab is disabled pending actual implementation.
  • New "Reset allocation" button on the Skill allocation pane, to clear all skill point allocations.
2006-11-30
  • Some layout fixes. The window size should be under control now.
  • Bugfix release 0.99.1a.
2006-11-29
Initial beta release 0.99.1.