Andrew Branscom: /* Debug Modes */

2025-03-26T16:25:36Z

Debug Modes

← Older revision		Revision as of 12:25, 26 March 2025
Line 104:		Line 104:
	The "magic" script is 98, which has been disabled in the game, along with removal of the debug build of the interpreter. The attached contains the debug handler script and other debug files, a debug build of the interpreter with debug help files. Just extract and drop into the base directory of the game and start the game in DOSBox for full debug options.		The "magic" script is 98, which has been disabled in the game, along with removal of the debug build of the interpreter. The attached contains the debug handler script and other debug files, a debug build of the interpreter with debug help files. Just extract and drop into the base directory of the game and start the game in DOSBox for full debug options.

	* [[Media:~~EQ2Debug~~.zip\|EQ2 Debug Files]]<!--<ref>See included README.txt for a list of files and all commands.</ref>-->		* [[Media:EcoQuest 2Debug.zip\|EQ2 Debug Files]]<!--<ref>See included README.txt for a list of files and all commands.</ref>-->

	Credit for fixing the debug handler script goes to [[doomlazer]]<ref>https://sciprogramming.com/community/index.php?topic=9150.0</ref> of the SCIprogramming community. Credit for the debug build of the SCI1.1 interpreter goes to "[[scipprofile:1512\|Kawa]]" of the SCIprogramming community.		Credit for fixing the debug handler script goes to [[doomlazer]]<ref>https://sciprogramming.com/community/index.php?topic=9150.0</ref> of the SCIprogramming community. Credit for the debug build of the SCI1.1 interpreter goes to "[[scipprofile:1512\|Kawa]]" of the SCIprogramming community.

Andrew Branscom: 2 revisions imported

2025-02-16T19:32:46Z

2 revisions imported

← Older revision	Revision as of 15:32, 16 February 2025
(No difference)

Andrew Branscom: 1 revision imported

2024-06-03T04:55:28Z

1 revision imported

← Older revision	Revision as of 00:55, 3 June 2024
(No difference)

Andrew Branscom: /* Debug Modes */

2023-09-13T04:10:25Z

Debug Modes

New page

{{TechSubpageLinks}}
{{TechStub}}

== General Information ==

<blockquote>


=== Graphics ===

<blockquote>

</blockquote>

=== Sound ===

<blockquote>

</blockquote>

=== Requirements ===

<blockquote>

==== PC ====

<blockquote>
{|
|- valign="top"
| width="200" | '''Minimum OS:''' ||
|- valign="top"
| '''Minimum CPU:''' || Intel i286
|- valign="top"
| '''Minimum RAM:''' || 4 MB
|- valign="top"
| '''Minimum Video RAM:''' || N/A
|- valign="top"
| '''Graphics Modes:''' || EGA, VGA, MCGA
|- valign="top"
| '''Audio Hardware:''' || PC Speaker,AdLib,Roland MT-32,Sound Blaster,Pro Audio Spectrum,PS/1 Audio Card,General MIDI,Thunderboard,Disney Sound Source,Microsoft Sound SystemPC Speaker, AdLib, Roland MT-32, Sound Blaster, Pro Audio Spectrum, PS/1 Audio Card, General MIDI, Thunderboard, Disney Sound Source, Microsoft Sound System
|- valign="top"
| '''Input Devices:''' || Keyboard, Mouse, Analog Joystick
|- valign="top"
| '''Media:''' || 4 3½" floppy diskettes
|}
</blockquote>
</blockquote>
</blockquote>

== Exploring Game Resources ==

<blockquote>


=== Resources Used ===

* [[VIEW Resource (SCI)#V56|*.V56]] — 256 color VIEW resources; sprite graphics. Location: RESOURCE.00*, patchDir.
* [[Picture Resource (SCI)#P56|*.P56]] — 256 color Picture resources; background graphics. Location: RESOURCE.00*, patchDir.
* [[Script Resource (SCI)#SCR|*.SCR]] — Script resources; static logic data. Location: RESOURCE.00*, patchDir.
* [[Text Resource (SCI)#TEX|*.TEX]] — Text Resources.<ref>Texts deprecated in favor of messages</ref> Location: RESOURCE.00*, patchDir.
* [[Sound Resource (SCI)#SND|*.SND]] — Sound resources; MIDI music and some sound effects. Location: RESOURCE.00*, patchDir.
* [[VOCAB_Resource (SCI)#VOC|*.VOC]] — Vocab (not used).<ref>Type 0x85 resources are 'memory' resources, which are only used internally.</ref> Location: RESOURCE.00*, patchDir.
* [[Font Resource (SCI)#FON|*.FON]] — Font resources; graphics to display text. Location: RESOURCE.00*, patchDir.
* [[CURSOR Resource (SCI)#CUR|*.CUR]] — Cursor resources; mouse cursors (deprecated in favor of v56-based cursors). Location: RESOURCE.00*, patchDir.
* [[Patch Resource (SCI)#PAT|*.PAT]] — Patch resources; audio patch files. Location: RESOURCE.00*, patchDir.
* [[Palette Resource (SCI)#PAL|*.PAL]] — Palette Resource; 256 color palette files. Location: RESOURCE.00*, patchDir.
* [[Audio Resource (SCI)#AUD|*.AUD]] — Audio resources; voice and digital sound effects. Location: RESOURCE.00*, patchDir.
* [[Audio Resource (SCI)#SYNG|*.SYN]] — Audio synchronization. Location: RESOURCE.00*, patchDir.
* [[Message Resource (SCI)#MSG|*.MSG]] — Message resources; text plus metadata. Location: RESOURCE.00*, patchDir.
* [[HEAP Resource (SCI)|*.HEP]] — Heap resources; dynamic script data.<ref>The script resource split introduced in SCI01 was incorporated into the actual resource layout in SCI1</ref> Location: RESOURCE.00*, patchDir.
* [[Audio Resource (SCI)#Audio36|Audio36]] — Audio36 resource;
* [[Audio Resource (SCI)#Sync36|Sync36]] — Audio36 resource; Audio36 synchronization

==== External Resources ====

* [[Map Resource (SCI)#MAP|*.MAP]] — Map resources; lookup tables for the individual resources. Location: External, patchDir.

==== Resource Tools ====

* [[Sierra Resource Viewer]] - Opens, views, and exports [[AGI]] and [[SCI]] game resources
</blockquote>

== Patches ==

<blockquote>

</blockquote>
* [[File:ZIPInactive.png]] No Official Patch

== New Installer ==

* [[File:Setup.png]] [[SHPBin:NewInstallers/EcoQuest2ForDOSBox.zip|SHP New EcoQuest 2 for DOSBox Installer]] Setup File [993 KB] 
::Works for both 3.5" and 5.25" versions. If you do not have DOSBox installed, you must be online to when you install the game to allow the installer to download and install DOSBox for you or the audio file will not be decompressed. To accommodate PCs without a floppy drive, for the floppy version this installer is designed to work by using the files from the original media copied to the harddrive. Because some files are named the same, the files from multiple disks often need to be kept separate to avoid overwriting each other. To install these games:

::* Create a temporary folder on the hard drive.
::* Inside this folder, create a numbered folder for each disk, i.e. "1" for disk 1, "2" for disk 2, etc. one for each disk.
::* Copy the contents (files and folders) of each disk into its appropriately numbered folder,
::* Copy DOSBox installer for the game into the same temporary folder.
::* Run the installer from this same folder.

== Debug Modes ==

<blockquote>
The "magic" script is 98, which has been disabled in the game, along with removal of the debug build of the interpreter. The attached contains the debug handler script and other debug files, a debug build of the interpreter with debug help files. Just extract and drop into the base directory of the game and start the game in DOSBox for full debug options.

* [[Media:EQ2Debug.zip|EQ2 Debug Files]]

Credit for fixing the debug handler script goes to [[doomlazer]]<ref>https://sciprogramming.com/community/index.php?topic=9150.0</ref> of the SCIprogramming community. Credit for the debug build of the SCI1.1 interpreter goes to "[[scipprofile:1512|Kawa]]" of the SCIprogramming community.

Upon launch with these files in the game's base directory you should see a "Where to, Mac?" prompt immediately.

<blockquote>[[File:EQ2-WhereToMac.png|320px]]</blockquote>

Besides giving you the "Where to, Mac?" dialog at the beginning, the following options are available:

'?' will list the below debug commands available with the script debugger:

<blockquote>[[File:EQ2DebugCommands.png|320px]]</blockquote>

{| class="wikitable sortable"
! width="210" | Command !! width="250" | Action !! width="300" |Notes
|- valign="top"
| [ALT + A] || Show cast || Information about all objects on screen
|- valign="top"
| [ALT + B] || Show flag value ||
|- valign="top"
| [ALT + C] || Show control screen ||
|- valign="top"
| [ALT + E] || Show ego information & free memory ||
|- valign="top"
| [ALT + F] || Show Features || Displays name of current feature under cursor
|- valign="top"
| [ALT + G] || Set Global ||
|- valign="top"
| [ALT + I] || Get inventory item || Allow selection of inventory item from list
|- valign="top"
| [ALT + J] || Note Logger for QA || Does not work
|- valign="top"
| [ALT + K] || Set Flag ||
|- valign="top"
| [ALT + L] || Clear Flag ||
|- valign="top"
| [ALT + M] || Show Memory ||
|- valign="top"
| [ALT + O] || Create Obstacles || Causes out of heap error
|- valign="top"
| [ALT + U] || Return user control || Does not work
|- valign="top"
| [ALT + P] || Show Priority screen ||
|- valign="top"
| [ALT + R] || Show Room info ||
|- valign="top"
| [ALT + S] || Switch mouse actor || ???
|- valign="top"
| [ALT + T] || Teleport || Change room/scene/script
|- valign="top"
| [ALT + U] || HandsOn || Return user control
|- valign="top"
| [ALT + V] || Show Visual screen ||
|- valign="top"
| [ALT + W] || Write Features ||
|- valign="top"
| [ALT + X] || Exit the game ||
|- valign="top"
| [ALT + Y] || Show pallet ||
|- valign="top"
| [ALT + Left Mouse Button] || Instant movement/placement || If walking
|- valign="top"
| [CTRL + ALT + Left Mouse Button] || Print mouse X/Y ||
|- valign="top"
| ? || Help || List debug commands
|}

To invoke the interpreter debugger press the grave accent (`) or [Shift + Shift + Number pad '-']. Note, if you have not started the game with the included debug build of the interpreter (SCI.EXE) the game will crash. Pressing "?" while debug is active will display interpreter debug commends.

<blockquote>[[File:EQ2InterpDebug.png|320px]]</blockquote> 

<blockquote>[[File:EQ2DBGHELP_000.png|320px]]</blockquote> 

<blockquote>[[File:EQ2DBGHELP_001.png|320px]]</blockquote>
</blockquote>

== References ==

<references />

== Related Links ==

* [[EcoQuest Series]]
* [[Adam Greene]]


 

[[Category:Technical Pages]]


[[Category:Patch Pages]]

EcoQuest 2: Lost Secret of the Rainforest Technical - Revision history

Andrew Branscom: /* Debug Modes */

Andrew Branscom: 2 revisions imported

Andrew Branscom: 1 revision imported

Andrew Branscom: /* Debug Modes */