GOLD BOX COMPANION
==================
 
Version 2.65 (10-Jun-2021)

Homepage:
http://gbc.zorbus.net

Mail feedback, questions, bug reports to:
joonas.hirvonen@pp.inet.fi


INTRODUCTION
============

In short, GBC is a tool to ease playing AD&D Gold Box games.

Features:
- HUD above DOSBox window with hit points, character icons, XP meters and effects. 
  Shows good effects in green, bad in red. Also shows if a character is level drained.
- Fix-command for Pool of Radiance. Works with the other games as well. Instantly heals the characters. 
  Optionally also fixes level drained characters. Can not be used while in combat.
- Temporarily change demihuman race to human to avoid experience level limits.
- Optional level up without visiting training halls and without race-/game-related level limits.
- Store the list of memorized spells and restore the spells with a single click. Can not be used while in combat.
- Automap with party location. Notes can be added to the map.
- World map view. Shows party location in some games.
- Combat view. Shows character / monster locations. Shows if character/monster is held or helpless.
- Journal entries.
- Optional auto-identify of items.
- Optional auto-ammo increases the amount of arrows/bolts/darts to a wanted level.
- Autodisable quickfight after combat. Some of the older games didn't disable quickfight between fights so 
  you could enter a dangerous fight with quickfight on.
- Character editor. Reads/modifies memory so it's instant compared to save file editors. Can not be used while in combat.
- Teleporting. You can teleport to a chosen location on the map. You can also teleport on the world map in some of the games.
- Save Game Editor also included. You can edit party composition (swap members in/out), edit inventories and effects. 
  You can also copy full inventories from one save slot to another so you can use this to keep your items in 
  Pools of Darkness where most magical items get destroyed when moving through the Limbo.
- Some modding tools for changing the font and editing game data.
- Lists saved games chronologically with a description of the location (map name).
- Able to backup to latest save game with a description.
- Playing paladin or ranger in Pool of Radiance. Can be exported to Curse of the Azure Bonds.
- Very experimental monk class for Pool of Radiance. Can be exported to Curse of the Azure Bonds.

GBC does not modify the game executables in any way.

Also check out SGE, Save Game Editor, located in the same folder as GBC. With SGE you can swap party members in/out, 
even increase party size to 8 (without NPCs) and edit inventories and effects.

There are also some modding tools included. You may want to replace the font in the older games with a newer one 
with FontMod or browser monster stats with MonsterMod.


WHAT'S NEW
==========

Version 2.65 (10-Jun-2021):
- Better handling of party composition changes. Adding or removing characters or NPCs should no longer cause an error during gameplay.
  GBC now also updates its HUD when a member is added or removed, or when the order of party members has changed.
  - This hopefully fixed some related glitches when using GBC with The Dark Queen of Krynn:
    The HUD wasn't updated properly when certain NPCs left the party, combat map monsters seemed to be invisible or on your side, etc.
- New tool, ECL-monitor, which can live monitor the current ECL script and flags when a game is running.

Version 2.60 (06-August-2020):
- Settings file has changed so it's best to completely remove an existing version of GBC.
- Music version of GBC included (GBC_Audio.exe). Plays external sound files. See GBC_Audio.txt for more info. No sound files are 
  included, but the downloads section has a package of sounds. Also check https://tabletopaudio.com for downloadable ambient tracks.
- Lots of effect name corrections (thanks to Stephen S. Lee and Null Null for these).
- Fixed a bug where known/memorized spells were wiped out if the FIX STATS option was on in Dark Queen or FRUA.
- Fixed a bug in Dark Queen where auto-identify corrupted scrolls imported from Death Knights.
- You can press "T" on the map window to toggle world map location titles.
- Item editor support for Dark Queen / FRUA.
- ECL Tool (bytecode script viewer) enhanced with map display, global search, flag list, flag comments. 
  Lots of memory addresses in PoR / CotAB commented (thanks to Stephen S. Lee's FAQs for these).

Version 2.50 (03-August-2019):
- Support for cloud saves folders of the GOG-versions. There is a checkbox to check if you want to use them.
  If you configure the games with the "Setup GOG" button then it's set on in those games but can be disabled later if wanted.
  Note that GBC only sees saves from one folder while the game seems to see saves from both cloud folder and normal save folder.
- "Setup GOG" button now also configures FRUA. 
- You no longer set the FRUA folder to a design subfolder but instead set it normally as the other games and then a design is 
  selected from a dropdownlist.
- "GOG Settings" button should now work again.
- Lots of previously unknown effects identified (thanks to Null Null and others).
- Pool of Radiance's "two-handed sword +1, +3 vs undead" effect description corrected.
- Monster manuals for all games included in the Resources-folder but can also be launched from GBC's main window or from the homepage.

Version 2.34 (15-August-2017):
- New optional feature: auto-ammo. This will automatically keep the amount of arrows, bolts and darts at a certain configurable
  level if you have at least one item of the type in your inventory. May please those who don't like to micromanage 
  the ammunition after combats or buy them at small amounts at a time from shops. 
  Does not work while in combat. You can configure the max plus level of ammunition to be affected. See below for more info.
- ECL-Tool which can browse and edit the parameters of commands in the ECL.DAX files (script files for Gold Box games).

Version 2.33 (22-July-2017):
- New feature: quick menu. Pressing Control + the "½/§" key opens a quick menu where you can encamp-fix, restore/store spells,
  read journal entries or start the level up. The menu can be fully used by the arrow keys and enter so you don't have to use
  the mouse. The key combination for opening the menu can be configured. See below for more information.
- Searching for characters tweaked and the default address range increased. 
  If you previously had problems with GBC not finding the characters, this version may fix that.
- Different Pools of Darkness world maps (Realms, Moander, Web) are recognized and the party location is shown.
- World map teleport in Pools of Darkness and Champions of Krynn.
- The auto-identify was bugged as it was always on regardless of the setting. Fixed. Also fixed auto-identifying of scrolls
  in the Krynn-games.

Version 2.32 (15-February-2017):
- SETUP GOG button for quickly setting the game folders for GOG-installed Gold Box games.
- When the GBC level up is used, character names are no longer colored as to able to level up in game.
  Note that you have to somehow refresh the DOSBox screen (going into a menu etc.) for the color to return to normal.
- Party location arrow was previously drawn with the Wingdings font. On some Windows country/region settings the 
  glyph could be wrong. The arrow is now drawn as a polygon.
- Hopefully better indoors / world map identification.

Version 2.31 (01-February-2017):
- Hopefully fixed a bug where the HUD and map windows were not shown on multi-monitor setups.
- Setting for the HUD window to stay on top. Off by default.
- Added a hack for paladins and rangers in Pool of Radiance to get fighter-levels during combat so that they get the
  sweep-ability. These levels are removed after combat.

Version 2.30 (18-December-2016):
- Optional level up from the HUD. Also adds some modding options for the classes. For more info check the end of this file.
- Encamp-fix optionally fixes level drain.
- Optional auto-identify of items. Identified when put in a character's inventory. 
  You still need to cast detect magic to detect magical items in loot.
- Paladins and rangers in Pool of Radiance. For more info check the end of this file.
- Monk in Pool of Radiance / Curse of the Azure Bonds. For more info check the end of this file.
- XP tables as text files (can be opened from the search wizard and editor windows).


ABOUT GAME VERSIONS
===================

I suggest using the GOG.com (Good Old Games) versions or at least these versions of the games:

- Pool of Radiance                  1.3
  - Note that in the GOG-version of Pool of Radiance, you'll have to select the POOLRAD-folder as the game folder!
- Curse of the Azure Bonds          1.3
  - GOG.com also has v1.2 which GBC does NOT work with!
- Secret of the Silver Blades       1.3
- Pools of Darkness                 1.1
- Champions of Krynn                1.2
- Death Knights of Krynn            1.1
- The Dark Queen of Krynn           1.1
- Gateway to the Savage Frontier    1.2
  - The Weekend Waste Monster / CRPG Directory version of the game is not compatible with this version of GBC!
- Treasures of the Savage Frontier  1.0   
- Unlimited Adventures              1.2
  - Select the design you're playing from the dropdown-list.
  - Also works with UAShell.
- Countdown to Doomsday             1.0
- Matrix Cubed                      1.0

Note that even in GOG.com there exists several game versions: 
On the GOG website and on a game's page, the latest version is downloaded by clicking the game's name under 
"Classic game installers" but there are also other/older versions under "Game goodies".


ABOUT DOSBOX VERSIONS
=====================

With this version of Gold Box Companion you have to use the plain/vanilla DOSBox 0.74 if you're not using
the GOG-versions of the games. The used DOSBox version is even more important than the versions of the games.

If you change DOSBox's soundcard settings, the memory footprint might change so that GBC no longer finds data in
expected locations. It's best to stick to the default GOG audio settings.


GENERAL TROUBLESHOOTING
=======================

If you have problems...
- Try to run GBC as an administrator.
- Try placing the files outside the "Program Files"-folder, instead to a folder like "C:\GBC".
- If you're using the GOG-versions, mail me and I'll try to help you out.
  - If not, try using the older version of GBC found from the homepage.
- Although GBC does not connect to the internet, certain firewalls may prevent it from reading DOSBox's memory.
- See the FAQ at the end of this document.


STARTING DOSBOX AND A GAME
==========================

I won't give instructions here how to use DOSBox or how to start Gold Box games as there is plenty of information for that
already around the internet. 

You probably want to scale the DOSBox window to 2x or 3x depending on your display size and resolution.

It's best to have the game running before starting GBC. Also, if you create a party from scratch or add/remove characters,
I'd advice to save the game, restart DOSBox and the game and load the game. This ensures that the characters are found 
in correct order in the memory.


SEARCH WIZARD
=============

When you start GBC you'll see a search wizard. 

- Select a game and set the game folder. 
  ! For Unlimited Adventures, select the design you're playing from the dropdown-list.
  ! The save game files have to be in the selected game folder or in SAVE-subfolder.
    - Pool of Radiance usually has the save files in the same folder as the game's data files.
      ! Note that in the GOG-version of Pool of Radiance, you'll have to select the POOLRAD-folder as the game folder.
- Start DOSBox and the game (for GOG-versions you can use the START GAME button).
- Load the saved game.
! Begin the game. This is important!
- Select the save game slot (A-J). GBC loads save game data.
- Click SEARCH and GBC searches for the character/map info.
  If all goes well, the search wizard is closed and the HUD screen is displayed on top of the DOSBox window.

In ADDRESS RANGE you need to put a memory address range for searching. In most cases you don't need to touch these.

In WINDOW TITLE enter a part of DOSBox's window title. It doesn't have to be the whole title just enought that 
the window is recognized. Note: in some cases the window title is "SDL_app".

Troubleshooting if search is not successful:
- Save the game, click on the save slot and search again.
- Always remember to "begin the game" from the menu in the game.
- Increase the latter search range value.
- Enable debug-mode by pressing Control + D for more in-depth logging.
- Try to run GBC as an administrator.
- Use GOG's default DOSBox settings. Changing soundcard settings might change the memory footprint so that GBC no longer 
  finds data in expected locations.
- Press Control + R for a read test to read memory at various addresses from DOSBox's memory. 
  - If a read test at an address is successful, the test returns "-> read 4 bytes". 
  - If a read test fails, the test returns "-> read 0 bytes".
  - It's ok that some/most of the test reads fail, GBC just can not access that memory area.
    But at least some of the the test reads should return "-> read 4 bytes".
  - If all test reads fail, GBC can not access DOSBox's memory.

OPEN FOLDER opens the game folder.

CLEAR EXPLORED clears all explored maps for the current game.

GOG SETTINGS opens GOG's settings program for the game (for GOG-versions).

DOSBOX SETTINGS opens the configuration file for DOSBox (for GOG-versions).

START GAME starts the game (for GOG-versions). The game path has to be set first for this to be clickable.

SETUP GOG button for quickly setting the game folders for GOG-installed Gold Box games. You don't have to use this, you can set the game folders
manually as well.

SEARCH starts the search.

MANUAL / JOURNAL / CLUEBOOK opens the corresponding pdf-file. These have to be located in the corresponding game folder and named as:
Adventurers Journal.pdf
Cluebook.pdf
Manual.pdf

PASSWORDS displays a list of passwords for the game.

RANDOM NAMES creates a list of random male/female names if you have trouble of naming your characters.

XP TABLES open a text file listing the experience tables for the current game.

HELP displays this help.


HUD
===

The HUD attaches itself on top of the DOSBox window. It shows character's name, XP bar and a health bar. The HUD might be 
little cramped if you don't scale the DOSBox window to at least 2x.

At the moment the XP bar doesn't take game or demihuman level limits into account.

Move mouse over the HUD to open up menu. Move mouse from the HUD to close it.

You can use custom combat icons by putting them into the corresponding game's data folder found under the GBC-folder. 
For example, for a character named Wulfgar, create two 24x24 bitmaps named "Wulfgar_1.bmp" and "Wulfgar_2.bmp".

MAP toggles map window on/off.

EXPLORE MAP / UNEXPLORE MAP reveals/unreveals the current map.

EDITOR opens character editor.

SETTINGS opens the Settings-menu.

SAVE MAP saves the current map as a png-file under (GBC-folder)\Screenshots.

BACKUP SAVE copies the last saved game to (game folder)\SAVE STORAGE. These can be then copied back to the save-folder by hand
or with the Save Game Editor.

QUIT closes GBC.

JOURNALS opens the journal-menu where you can select journal entries or open cluebooks.

ENCAMP-FIX heals the characters. Not usable in combat.

STORE SPELLS stores currently memorized spells for all characters. The spells are automatically stored after a successful
search for characters has been done. Not usable in combat.

RESTORE SPELLS restores memorized spells. Not usable in combat.

RACE HACK changes the race of all characters to human. This enabled demihumans to gain levels past racial level limits. 
Not usable in combat.

RESTORE RACES restores the race of the characters.

LEVEL UP opens a dialog for a level up without visiting training hall. See below for more info.

SEARCH WIZARD closes the HUD/map/editor-windows and goes back to the search wizard.


SETTINGS
========

ICONS toggles character combat icons in the HUD on/off.

XP-METER toggles the experience needed - meter in the HUD on/off.

TITLE HACK moves the HUD window on top of the DOSBox window so that the DOSBox window title is hidden.
Set the HUD ON TOP setting to ON as otherwise the DOSBox window obscures part of the HUD.

EFFECT toggles display of the effects in the HUD on/off.

DOCK MAP / DECREASE MAP / INCREASE MAP / RESTORE MAP changes / restores the map window docking and size.

DEBUG DUMP opens a text file containing the memory addresses of characters, inventory etc. 

HUD ON TOP = ON / OFF toggles whether the HUD window should stay on top of all other windows or not.

AUTO ID = ON / OFF toggles item auto-identification on/off. Items are automatically identified when the number of items
in any character's inventory changes. Note that only items in character inventories are identified! You still have to cast 
"Detect Magic" to detect magical items in the loot list after combat. 
Note: If you want all items to be identified (also in the loot lists), see the ItemMod-tool.

FIX DRAIN = ON / OFF toggles whether to fix level drained characters when ENCAMP-FIX is used. 
In Pool of Radiance, this works only if you use fix in the same game session where the characters were drained.

FIX STATS = ON / OFF sets the THAC0, saving throws, spells per level etc. according to their experience level. 
If FIX STATS is on, the characters are automatically stat fixed after they're found in memory. 
You can also fix characters by toggling this temporarily ON and then turning it OFF.
This needs to be used if you level up your characters beyond the game limits, use ranger/paladin in Pool of Radiance or 
use the experimental monk class. 

AUTO-AMMO = ON / OFF toggles the auto-ammo feature.

LOAD LEVELS opens Levels.txt which contains the level up -information which GBC uses.

RELOAD LEVELS needs to be clicked after editing Levels.txt for the changes to take effect.


JOURNALS
========

From here you can browse journal entries. The journal entry is opened on top of the DOSBox window. Click on it to close it.

Passwords opens the passwords list.

PDF cluebooks, manuals etc. can also be opened from here. These have to be located in the corresponding game folder and named as:
Adventurers Journal.pdf
Cluebook.pdf
Manual.pdf

(These are the default names for the GOG-releases but the files need to be copied/moved to the game folder.)


MAP
===

Map window attachment and size can be changed from the Settings (see above). 

Left click on the map to enter a note. You'll be asked for a max 3 character ID (you could use for example numbers, letters or
abbreviations) and then a longer description. If you enter an empty ID, the note will be cleared.

Right-click on the map window to toggle between: own notes / event numbers / nothing. Event numbers are the game's scripted events.

By Control + left click you can teleport around the map. Note that teleporting to a certain place may not run the event tied to 
the location and may cause problems.

By Control + right click you can set an event to a location. Event setting not currently usable in FRUA.

Press "T" on the map window to toggle world map titles.


WORLD MAP
=========

GBC detects when a game is in world map mode and tries to display the world map and possibly party location.

- Curse of the Azure Bonds displays only static world map pictures with location captions. No world map teleporting.
- Control + left click world map teleporting is available in the Krynn- and Savage Frontier- games.


COMBAT MAP
==========

Move mouse over creatures to see some of their stats and effects. Click on a creature to open it in the Editor.

Note: parts of the stats window may be overlapped by the DOSBox window so left click on the map window to set it active.


EDITOR
======

Before doing any changes to characters, you should check out that all character data seem ok. If there's odd values in stats,
the search wizard hasn't probably found the right character locations.

If you edit abilities, first unready (in the game) all equipment that affects that ability. 

REFRESH updates the character data from memory.

APPLY CHANGES or Control + S saves the changes.

If you hover the mouse cursor over the current level of a certain class, you'll see needed experience for the next level.

To see applied changes taking effect visually in the game, update the game screen somehow by going into a menu or 
viewing character record sheet etc.

In the spellbook, 0 indicates that the character knows that spell. Any other number means that that many spells 
are memorized. The +/- buttons adjust memorized spells. L-button learns all suitable spells, C-button clears all memorized spells.

Do not to edit inventories where there are bundles of scrolls!

Editing effects might crash the game!


PALADINS / RANGERS / MONKS IN POOL OF RADIANCE
==============================================

In the character editor (HUD -> EDITOR) there are buttons to convert a character to one of these classes.

Important note:
Do not use Restoration scrolls on these hacked classes! This will corrupt the character data. 
Instead use FIX DRAIN from the GBC HUD to fix if hacked classes get drained.

CONVERT TO PALADIN / RANGER converts a 1st level fighter to a paladin or a ranger in Pool of Radiance. These characters can not
be leveled in training halls in Pool of Radiance but GBC's level up dialog has to be used. They can be imported to 
Curse of the Azure Bonds where they should work normally. You probably need to add the effects.
- Paladin: You have to manually add the "protected from evil" effect ($08) to the character with the Save Game Editor.
- Ranger: The effect "ranger bonus damage" is still unknown and possibly not implemented in Pool of Radiance.
          Can be added in Curse of the Azure Bonds with the Save Game Editor (effect $86).
To add an effect in the Save Game Editor:
- Select the game, save slot and character. 
- In the effects-area, select "$08  008  protected from evil" from the dropdown list.
- In the parameters, there should be one "255" (for permanent effect) and the other parameters zeros.
- Click add.
          
CONVERT TO MONK converts a 1st level thief to monk in Pool of Radiance. Monks can not be leveled in training halls in any
of the games but GBC's level up dialog has to be used. 

Click XP TABLES from the search wizard or editor window when Pool/Curse is selected as a game and you'll see how the monk advances.
Currenly the class is mostly a gimmick. Item limits are set to zero so the class can not use ANY items. 


LEVEL UP WITHOUT TRAINING HALL
==============================

GBC can be used to level up characters without visiting a training hall. 

- The level up isn't limited by demihuman level limits.
- Does not cost anything.
- You can level up several experience levels. Experience points are not wasted.
- Max hit points are automatically rolled.
 - Constitution-bonus to HP is handled up to CON 25.
- Wisdom gives bonus spells as in the game.
- Intelligence determines max spell level for mages.
- The best values for stats are used when multi- or dual-classing.
- When dual-classing, former class abilities are restored when former class level is exceeded.
- In Dark Queen of Krynn, crown/sword knights can be leveled past level 18 if you edit Levels.txt (see below).
- Not usable in the Buck-games.

Two cases where normal level up in a training hall should be used:
- A level up where a dual-classed character gains his former paladin-class abilities back. 
  GBC can not add the "protected from evil" effect ($08).
  You can opt to level up with GBC and then use Save Game Editor to add the effect.
- A level up where a dual-classed character gains his former ranger-class abilites back.
  GBC can not add the "ranger bonus damage" effect (Curse/Gateway: $86, other games: $69).

There are several level up related bugs and oddities in the games. Some of these are taken care when GBC level up is used
and some left untouched:

- Secret of the Silver Blades:
  - According to the manual and all other games, a paladin needs 2,450,001 xp for level 15. In Secret, you need 2,460,001.

- The Dark Queen of Krynn:
  - When a character reaches level 19 or higher, all saving throws are set to zero!
    -> GBC level up sets level 18 saving throw values for level 19 and higher.
  - Paladin does not get more than 1 level 4 cleric spell.
    -> GBC sets this to 2 at level 19 and to 3 at level 20 and higher.

- Krynn-games in general:
  - Cleric and mage spells per day values in the games differ from what's stated in the manuals.
    -> Not changed in GBC level up.

- Gateway to the Savage Frontier:
  - Thief skill values are odd (most over 200). Not sure if this a bug or not.
    -> GBC sets these to those of the other games. 

- Unlimited Adventures:
  - Thief saving throws are all zeros for all experience levels.
    -> GBC level up fixes these (saves are set the same as in Pools of Darkness).
  
---

The changes between experience levels are set in a text file called Levels.txt. Located in "\(GBC-folder)\Games\(xx. Game)\".

You can open this file in a text editor or click HUD -> SETTINGS -> LOAD LEVELS to open it.
If you make any changes to the file, click HUD -> SETTINGS - RELOAD LEVELS for the changes to take effect. 

The files were generated by automatically leveling characters in the games from level 1 to max level and saving 
the character data from memory after each level up. Then the data were compared and the stat lists generated
based on differences between level ups.

Editing the Levels.txt enables you to mod the games slightly. Note that the values in the file only affect the level up
via GBC. Normal in-game level up in training halls is not affected but remains as it is.


---

The first row lists max levels for classes in a game:

  @ max levels
  cleric = 6,   fighter = 20,   mage = 9,   monk = 40,   paladin = 8,   ranger = 8,   thief = 9

You can change these limits higher than a game supports:
- The games probably use some kind of lookup-tables for values so over-leveling characters may lead to crashes.
- Max level is 40. For every game there's a Levels.txt that has levels listed all the way up to 40. 
- Spellcasters can not get spells higher than the game supports. 
  If you export an over-leveled character to a next game, you'll have to add the missing spells with the GBC editor.
- You have to turn the FIX STATS option ON (in HUD -> SETTINGS). 
  Otherwise THAC0, saving throws etc. are not correct for the experience level.
- In Dark Queen of Krynn, you can adjust the max levels of crown and sword knights to 40 so that they don't have
  to make the change to a rose knight.

After that every class / level is listed with corresponding changes to stats:

Example: cleric stats for level 2

  @ cleric 02
  hp_add = 1d8,   thac0_base = 40,   attacks = 2,   save_1 = 10,   save_2 = 13,   save_3 = 14,   save_4 = 16,   save_5 = 15,   cleric_spells_1 = 2

Example: monk stats for level 9

  @ monk 09
  hp_add = 1d8,   thac0_base = 48,   attacks = 4,   save_1 = 11,   save_2 = 10,   save_3 = 10,   save_4 = 14,   save_5 = 11,   ac_base = 58,   unarmed_rolls = 1,   unarmed_dice = 8,   unarmed_modifier = 4,   movement_base = 20

- THAC0 = 60 - value.
- Attacks = value per 2 rounds.


QUICK MENU
==========

If you don't like to use the mouse to access some of the HUD features you can instead use the quick menu.

The menu has encamp-fix, store/restore spells, read numbered journal entry and level-up. Use arrow keys to navigate and
enter to select a command. You can also use the first letter of the command, e.g. "j" for Journal Entry, to jump to wanted row and then
press enter to select. The menu can be closed with Esc or selecting Close.

If you select the journal entry command, you'll be asked for a journal entry number.

The menu can be shown by pressing Control + the "½/§" key which on the left of the key '1" in most european keyboards.
In some keyboards, the key left of the key "1" is probably "^" or "~" so you the default value may not work for you.

The key can be configured by editing the Configuration.txt file found in the Data-folder.

<hotkey_shift>      0  </hotkey_shift>
<hotkey_alt>        0  </hotkey_alt>
<hotkey_control>    1  </hotkey_control>
<hotkey_vk>       220  </hotkey_vk>

Set at least one of the shift/alt/control hotkeys to 1. Set the wanted virtual keycode number to hotkey_vk.

The key combination has to be something that does not interfere with other software.

There's a tool named VK.exe in the Data-folder. If you start it and press your wanted hotkey (without control, shift etc.),
you'll get the virtual keycode.

If you set 0 to hotkey_vk, the quick menu will be disabled.


AUTO-AMMO
=========

Auto-ammo increases the amount of arrows/bolts/darts in your inventory to a wanted level which may please
those who don't like to micromanage the ammunition after combats or buy them at small amounts at a time from shops.

It does not function while in combat.

Note that you need to have at least 1 item of the type in character's inventory for this to work.

You can configure the amount and the max "plus" of ammunition to be increased.

Remember that this also increases your encumbrance so keep the level relatively small.

Buck Rogers games are not supported.

It can be toggled on/off from the HUD -> SETTINGS menu.

GBC can not detect when you are in the character's inventory screen so if you halve 50 arrows the 25 arrows 
will be automatically increased to 50 if that is what the auto-ammo is configured at.

Auto-ammo is configured by editing the Configuration.txt file found in the Data-folder. 


<auto_ammo_amount>  50  </auto_ammo_amount>

The amount of ammunition to set. If your current amount in inventory is higher, it won't be touched.


<auto_ammo_max_plus_01>     0  </auto_ammo_max_plus_01>   // Pool of Radiance

For every game, there's a line where you enter the max "plus" of ammunition to be automatically set.
Here, for Pool of Radiance, only +0 arrows/bolts/darts will be set.


DEBUG-MODE
==========

If you press Control + D while in the main GBC window or when the HUD window is active (click on it to be active),
debug-mode will be turn on/off.

This is mainly for me for getting map info displayed. 

When in combat, you can also press Control + W when the HUD window is active (again, click on it to be active)
to weaken enemies to 1 HP.


FAQ
===

Q: GBC does not find the characters!
A: Read the search wizard troubleshooting above first.
   If you're using the GOG-versions, mail me and I'll try to help you out.
   If not, try using the older version of GBC found from the homepage.

Q: The mine maps look odd in the Secret of the Silver Blades?
A: All gold box games except The Dark Queen of Krynn and Unlimited Adventures use 16x16 sized maps. Bigger maps are constructed from 
   rooms and corridors fit on a regular 16x16 map and then internally "teleporting" the player around the map. 
   
Q: There are some odd doors in the maps.
A: Some doors in the game data aren't really doors but decorations like rubble and so on. Difficult to get right just by looking at 
   the data. 

Q: Can I add monster effect like dragon breath to my characters?
A: Yes, but the only way to "use" those are to put the character in quickfight-mode as there's no interface to use them directly.
   Many of the effects probably crash the game.

Q: In Pool of Radiance, my character is "paralyzed" and can not move in combat!
   The effects in the games are quite buggy. Probably a duration counter has gone to zero but the effect hasn't been removed.
   In GBC's editor view there's a list of effects. Select the "paralyzed" row and the effect parameters fill in the edit fields
   below. The first number field is duration so put a small number like 3 in it and then click APPLY EFFECT CHANGES.
   In the game, move around so that the duration goes to zero and the effect should go away.
   Or you could delete the effect with the Save Game Editor.

Q: If I minimize the DOSBox window to the taskbar and then restore it, I get an error message dialog "Out of system resources".
A: GBC constantly checks the DOSBox window for its positions and if its minimized or not but if you have window animations enabled in Windows, 
   the error may still occur especially on Windows 7 on slower computers.
   See Control Panel -> System -> Advanced system settings -> Advanced -> Performance -> Settings -> Animate windows when minimizing and maximizing.
   Try unchecking that box.
