Month: June 2011

Okay, that was quick. Haven’t happened before when swapping a HD from one laptop to another that everything goes so smoothly that you don’t have to reconfigure anything at all on the software level (some kind of Celeron -> Pentium 2 and a modular precompiled Debian kernel).

Unfortunately I have also lost interest in continuing working on my project due to slight instability of mind, so I am quitting.

For anyone who might want to continue this project, it would be helpful to merge the “agi” branch of my github scummvm-tools repository to master. It contains two finished extraction tools and a disassembler that should work with any V2 logic resources and also with the V1 logic resources found in Black Cauldron. I just wrote a simple command line parser for it so that anyone can readily try it without modifying the source.

Work on my scummvm “booters” branch is incomplete but as far as I know it shouldn’t break anything with any V2 games, so I think this would also be useful to merge. Of course it could take some additional testing before the next release.

Finally I added the partly reverse-engineered disassembly files of the three games with my few comments. These are all produced by running the games in DOSBox and using its debugger to dump the code and data segments while AGI is running, then disassembling the binaries with ndisasm (shipped with nasm). I added the MD5 sums of the disk images to the corresponding files. The repository is just a handy place to store them temporarily so there they are.

Personally I think it was an interesting ride, I have even considered buying some games for trying them after seeing cool things like the Dreamweb asm->C++ converter. I part from IRC but you can of course still contact me by email (pitkajus, paju.oulu.fi) if you have any questions about the code I have produced.

Bye and have fun.

Power supply of my laptop accidentally broke down (hope it didn’t break anything else), and after talking to my mentor, I decided to take a short break and to try to come back up with some kind of development environment after the next week or so.

EXTRACTION TOOLS: There are two extraction utilities that are finished, one for Black Cauldron booter and another for DDP booter. These extract the game resources from the disk images to the common VOL, LOGDIR, PICDIR, VIEWDIR, SNDDIR, OBJECT, WORDS.TOK files that are found in all AGI v2 games. The DDP extraction utility does not extract OBJECT or WORDS.TOK files because these do not exist or serve any function in the game.

V1 DISASSEMBLER: I wrote a disassembler for V1 logic scripts based on the game resources of Black Cauldron. Actually I first wrote a V2 disassembler taking the instruction tables from ScummVM, and then added another instruction table for V1. Both V1 and V2 handle the IF (FF … FF) and ELSE (or GOTO; FE) constructs in the same way. The disassembler tries to detect IF-ELSE constructs in one pass and indents the code based on the output of this detection. To correctly detect them in all cases would need another pass through the code, which is not difficult to add, but is currently left undone. In the case of incorrect detection only the indentation of the output gets wrong because I decided to always output GOTO statements even though they would be detected as ELSE. In the output the current offset is written to the left of the code and to the right into a comment the bytes that were matched as the instruction. The output could be made more C-like by translating instructions like assign(a,b) to a = b, and increment(a) to a++, and the same for some condition commands in IF expressions (this is what the V2 disassembler from Sarien does). The V1 disassembler translates the logic scripts of Black Cauldron mostly correctly. Many of the instructions are identical to their V2 counterpart, some have a somewhat different functionality (program control instructions), some have different number of arguments (random comes to mind), and a few others do not exist in V2 anymore. To make it more friendly a few command line options could be added, that is, to select between V1 and V2, and to control output formatting (this is taken in account in the design, but the few lines of code for parsing the command line are not written, so that you currently need to recompile for changing these).

AGI ENGINE IN SCUMMVM: I have refactored the AGI engine so that another instruction table for V1 has been added. Also the disk image detection code and game resource loaders (based on the extraction tools) are written for BC and DDP. It turned out the program control is handled differently in V1, that is, how different logic scripts get executed from the logic.0 base script. I have an experimental implementation in my local branch, but there are still some details to be worked out, involving a few internally changed variables that are used by the scripts (I estimate one or two days of work to get it about right). I actually got the intro running by fiddling with some of the variables in the debugger. 🙂 After this it should be mostly fixing a correct implementation for a few instructions that behave differently in V1, since all other game resources are identical to V2 and the code for them is thus already written (with the exception of SOUND resources, but I have already implemented a player for those, one that could maybe still be cleaned up a bit).

DOCUMENTATION: I have written something about how game resources are organized in DDP. This still needs to be done for BC as well (see the extraction tools). Then maybe the V1 instruction table could be written down, along with the differences to V2 and information how the internal variables are handled. Also I fixed the information about V1 SOUND format.

KING’S QUEST: The interpreter in this game seems to be different, but I haven’t delved into the details yet. I guess all other game resources have identical formats to V1 and/or V2.

Now that I am more familiar with Donald Duck’s Playground, I can tell you my honest personal opinion about it. In short: it is the worst game I have ever played, not less because it is supposed to be an educational game for children. The only thing it does is to teach your children to become the worst kind of brainless consumer robots on planet Earth by insisting the player to iterate through the most dull game mechanics I have seen, that is, by having Donald Duck to work odd jobs to earn money in order to buy uninteresting toys from a few stores for his nephews. The only good thing about this game is that the player cannot die in it, unlike many other Sierra games where the player infamously dies around every corner unless you magically know the exact sequence of correct steps to proceed.

If my job here was to redesign the game the first thing I would change would be to make Donald have to take his nephews, along with a few bottles of milk prepared by their loving mother, and make an idyllic trip to local landfill to collect useful items from the dump.  These items would then be brought to Gyro Gearloose  who would help the nephews in building a space rocket out of the recycled parts. The rocket would then be launched to space in order to go teach manners to three-headed negro monkeys of developing planets.

Those items from the dump that couldn’t be used for building the rocket could be used for positive terrorism and thrown against the windows of the now-useless stores. Maybe it would be even better if the stores were replaced by only one store with coffee and alcohol in millions of kinds of bottles and packages. Special coupons for use in this store would then be distributed for everybody, and the actual use of these coupons  would be closely observed by all goodwilling, respectable citizens, and if even one unused coupon was found the co-citizen in question would have to face a year-long correction camp for his own good. Yeah, the nephews, being technologically advanced citizens, could use the extracted alcohol as fuel for their space rocket.