THE ALL-SEEING EYE ================== Homepage: http://ase.zorbus.net Mail feedback to: joonas.hirvonen@pp.inet.fi Thanks: - Unkillable Cat for proofreading and editing the hint files and for notes about the script file flags. - Lokadamus for noticing bugs in the hint files and maps. The All-Seeing Eye is an automapper for the PC MS-DOS versions of the first two EOB games, meant to be used with DOSBox on a Windows PC. It shows a real-time updated dungeon map on a separate window. The map is revealed as you explore. To use ASE you need: - Windows XP or newer - DOSBox (tested with 0.74) - Eye of the Beholder 1 (tested with 1.7) - Eye of the Beholder 2 (tested with 1.1) - a saved game How ASE works: - ASE searches for the character names in DOSBox's memory. It then uses offsets from the first character location to get the map layout, monsters and items. Instructions: - Start DOSBox and start EOB. - Load a saved game. - Start ASE and you'll see a search wizard. - Select a game you want to automap. - Set game folder, point it to the folder where you have the game installed. Note: For GOG versions, you can use the "Setup GOG" button. - Select the save game slot number you loaded in the game. - Change the DOSBox-window title if it differs from the preset title. - You probably don't need to touch the address range. - Click "Start search". - If everything goes well and the characters are found in memory, the search wizard closes and the map window is opened. Map view: - Moving mouse around the map view opens a tooltip explaining the contents in that map cell. - Open a popup-menu by right-clicking with the mouse on the map window. You'll see all the available options and their hotkeys. - Pressing A will add a note at the location under the mouse. - Pressing X explores the whole level. - You can use peek to get a quick glimpse at the level map but not fully set it explored. Press Z several times for it to stay longer visible. - Pressing T will teleport your party at the location under the mouse. - "Map window" - submenu: - You can use PAGE UP and PAGE DOWN to resize the window. - Window docking can be toggled by pressing D. It changes from dock to right / dock to left / move freely and then back to dock to right. - The title can be hidden. - "Show" - submenu: - From here you can toggle what you want to be displayed on the map. - Buttons shows/hides all buttons on the map. - Illusionary walls shows/hides illusionary walls until you've discovered them. - Hints means solution notes from the SSI's official clue book. - Notes means displaying your own notes. - "Identify all items" does exactly that. - "Item usability tweaks" enabled every class to use every item and items only require one hand to use. - "Character editor" opens the character / spellbook / inventory - editor. - "Backup save game" makes a backup of your saved game to folder: "(game folder)\Save backups\". - If debug-mode is on, some extra information is shown on map, items, monsters etc. Character editor: - With the top six buttons, select a character to view/modify. - If you edit any of the statistics on the left, click "Save changes to character" to commit the changes. Be careful when editing! - Spells: - Editing spells makes the changes immediately. - 0 means that the character knows a spell. - Any value higher than 0 means that the character has this spell that many times memorized. - The spells in parantheses can not officially be found in the game. Burning Hands works but some of these might crash the game. - There's a fixed number of memorization slots per spell level in the game so you can't memorize 20 Fireballs. - Inventory: - Editing inventory makes the changes immediately. - Click on a item slot to get its item index in the item array. - If you want to set an item into an item slot, first check the item slot then select an item from the item list and click "Set item". - Almost every item in EOB games is unique so the game may crash if you create the same item twice. Especially if you then move / throw the items around the map. General stuff: - If you teleport the party, edit inventory etc. you usually have to "refresh" the game screen to see the changes. Meaning you have to go to a previous menu, turn around after teleporting etc. so that the game redraws its screen. Known bugs: - If you add or remove a party member, you should save the game and restart All-Seeing Eye, otherwise the characters might not be found. - When going up or down the stairs, the game changes the coordinates of the party to those of the next level stairs before the level index changes. This means that some map cells are being tagged as explored on the current level before the level is changed. - Some map elements might be wrong. Especially getting door type right is tricky. A door might be opened with a door button from the other side only and currently I can display only one type of door per map cell. - Some item names might be wrong. EOB games have a fixed array of items but some are generated for starting items for the characters and some during the game. For other developers: - After a succesful search a file called "Log.txt" is created under the ASE folder. It has memory locations to the characters, map, monsters and items. - From the debug-menu you can make memory dumps of all monsters and items. These are saved to ASE folder as "Monsters.txt" and "Items.txt". Here's an example cut from the item dump: item name, unidentified | item name, identified (01 = empty, no identified name) | | bits ($80 = magical, $40 = identified) | | | item type | | | | position on ground | | | | | position on level | | | | | | | level | | | | | | | | plusses or wand/potion/etc. subtype | | | | | | | | | | | | | | | | | | ### Address Hex Item Byte 00 01 02 03 04 05 06 07 08 09 10 11 12 13 Level: XX,YY 001 506BAF0 0000 - 00 01 40 00 00 00 00 00 00 00 00 00 00 00 002 506BAFE 0100 Leather armor 02 01 41 1F 16 00 00 00 00 00 00 00 00 00 003 506BB0C 0200 Robe 03 01 40 20 29 00 00 00 00 00 00 00 00 00 004 506BB1A 0300 Staff 04 01 40 08 0D 00 00 00 00 00 00 00 00 00 005 506BB28 0400 Dagger 05 01 40 0F 05 00 00 00 00 00 00 00 00 00 006 506BB36 0500 Short sword 06 01 40 02 02 02 D5 00 05 00 05 00 09 00 09: 22,07 ...