ModdingWiki - User contributions [en-gb]

User talk:Malvineous

2010-12-12T20:43:53Z

Calvero: /* Dangerous Dave */ VGA is RLE, enemies unknown

== Wolfenstein 3D -> Wolfenstein 3-D ==
I've corrected the infamous 3D tyop in the names of several Wolf3D-related pages; can you please delete the following ones?

[[:Category:Wolfenstein 3D]] -> Superseded by [[:Category:Wolfenstein 3-D]] 
[[:Image:Wolfenstein_3D.png]] -> Superseded by [[:Image:Wolfenstein_3-D.png]]

Thanks :) --De Zeurkous (zeurkous@zeurcomp.nichten.info), Thu Nov 22 08:18:42 UTC 2007

:Haha, you've certainly been busy. Don't forget that this wiki isn't meant to be an encyclopaedia of the games, its main purpose is documenting the file formats and editing tools that can be used with the games, as opposed to how the games behave without any mods, or what they might be called if you forget to change the title screen :-) -- [[User:Malvineous|Malvineous]] 11:14, 22 November 2007 (GMT)

::Nah, I haven't forgotten. As we're reinventing the wheel for a semi-virgin wiki, the naming and something static like the cheats seemed like a good place to start :) --De Zeurkous (zeurkous@nichten.info), Thu Nov 22 12:20:04 UTC 2007

== Jill of the Jungle palette ==

Hi, I'm currently working on a level viewer for [[Jill of the Jungle]] (maybe an editor later on). Some of the information I found here has been very useful, but there's one thing I'm a bit stuck on. On the [[SHA Format]] page it says:
:''Each array item contains 4 unsigned bytes, representing CGA, EGA and VGA, respectivley, and then a null value. [...] Each byte maps to the index of a colour in the palette. If there are no colours required, the tile set uses the default colours.''
However, it doesn't say anywhere where the palette can be found. Is it stored in the EXE file? I hope you can help me on this :)

Regards, [[User:Spinal|Spinal]] 13:00, 2 March 2008 (GMT)

:Unfortunately I didn't write the JotJ SHA page, and I haven't yet had the time to figure this out. For Xargon I've taken the quick and dirty route and used a screenshot from within DOSBox as the source of the palette, until I can figure out where the palette is located. If you find this out, don't forget to update the page! :-) -- [[User:Malvineous|Malvineous]] 22:02, 2 March 2008 (GMT)

::Hey Spinal, sorry, I wrote the [[SHA Format]] page, so that was probably my bad. I wasn't able to find the palette either. I assume it's in the .EXE, however I spent a fair bit of time manually mapping it using a Wombat tool (http://www.szevvy.com/node/3). I was also writing a level viewer (initally in XHTML which turned out to be too slow, so then I moved to Flash 9). I tried to email you my findings, but the email bounced. I'm not sure if they were 100% accurat, which is why I never added them to the documentation.

::Hey Malvineous, it seems the Jill - [[DMA Format]] page has been removed. Do you have a log of what happened to it? I'm sure it existed at some point.

::- [[User:dheim|Daniel]] 20:00, 5 March 2008

:::I don't ever remember seeing a DMA page - certainly there's nothing in the wiki logs about it being deleted or renamed. Maybe you started working on it but never got around to saving it? Or is it one of the Xargon pages that shares the same format as Jill? (by the way, you can type <nowiki>~~~~</nowiki> to automatically put in the signature in these messages.) -- [[User:Malvineous|Malvineous]] 11:28, 5 March 2008 (GMT)

::::Sorry, it must have been the stuff in the [[SHA Format]] page that I was thinking of. I may have added the link to the [[DMA Format]] page, and never expanded on it. - [[User:Dheim|Daniel]] 02:46, 6 March 2008 (GMT)

:::::Hi guys. Sorry for the mistake, I mixed up the authors of the SHA and level formats. I've written a level viewer in PHP the last week, by using static images instead of getting them from the actual files. This causes some problems for episode 2, which uses a different palette, but besides that it works great :) When everything is done I'll upload the maps to my server and the tile/object lists to this wiki.
:::::@Daniel: strange that it bounced, I confirmed my address so it should be working fine... You can mail it to spinal -at- zanderz -dot- net. Also, I saw on your Wombat page that you "have a vague idea of how to do" [[Hocus Pocus]]. Could you share your findings on this wiki? I'd love to make maps, or even a level viewer/editor for that game :) -- [[User:Spinal|Spinal]] 00:32, 8 March 2008 (GMT)
:Okay, with help of [[User:Dheim|Daniel]] who send me the palette I found it! I'll put my findings on [[Jill of the Jungle palette]]. -- [[User:Spinal|Spinal]] 15:36, 13 March 2008 (GMT)

== Halloween Harry/Alien Carnage ==

Hi Malvineous. Thanks for your edits on the GMF article! I notice you mentioned there exist versions of the game which don't require exploding a BNK to get at the game data. What does the directory structure look like for the version you have? I'm working on a map viewer (which will become a map editor at some point) and would like it to be able to work on whatever versions are out there. Thanks for any info. -[[User:Duckthing|Duckthing]] 04:41, 11 December 2010 (GMT)

: Hi Duckthing - no worries, Halloween Harry has long been an interest of mine, but my map editor sadly needs a lot more work before I can begin reverse engineering more file formats so I'm glad you've made a start! AFAIK technically Halloween Harry has no compression, but for whatever reason (probably listed in the Apogee FAQ) they decided to swap episodes 1 and 3, compress the BNK file and then re-release it under the name Alien Carnage. You can download all available versions (including registered versions since the game was released as freeware in 2007) from [http://www.classicdosgames.com/game/Alien_Carnage.html RGB Classic Games]. BTW not sure if you noticed but I also posted a couple of things on the GMF article's talk/discussion page. -- [[User:Malvineous|Malvineous]] 06:08, 11 December 2010 (GMT)

:: Thank you! Working with the uncompressed version will keep things less complicated. I did notice the GMF discussion you added, but haven't had a chance to really go through it yet. -- [[User:Duckthing|Duckthing]] 06:41, 11 December 2010 (GMT)

::: No worries. If you're running Linux or MacOSX you should be able to compile [[Camoto|libgamearchive]] which will let you copy files in and out of the BNK files. This is a library so it's also possible to use it in your own program for accessing and editing the map files while they're still inside the BNK, for instance. (BTW the 'minor' tickbox should only be used when the edit does not affect the information on the page - e.g. fixing a typo or a broken URL. If you are changing the actual content on a page it is never a minor edit!) -- [[User:Malvineous|Malvineous]] 07:51, 11 December 2010 (GMT)

== Dangerous Dave ==

Working on this, does anyone have any info on the formats? The EGA graphics are 84KB and external, but CGA and VGA graphics unrelated to them are in the 174KB executable, apparently uncompressed, I don't know how this is possible. I've found the levels and partially reverse engineered the format (The first 1000 bytes, a 100x10 array of tiles.) but each level is followed by ~280 bytes of variable and unknown data I assume is sprites. I have a list of internal files in the executable, looks like most of it is non-game code. Any help would be appreciated. -[[User:Levellass|Endian? What are you on about?]] 06:03, 12 December 2010 (GMT)

: Hmm, interesting. All I can suggest for the levels is - as you're probably already familiar with - changing the values in a hex editor then loading the game to see what happens. I would suspect that all the graphics would be in a similar format, so if there are any headers or structures used in the EGA graphics files perhaps they're duplicated for CGA/VGA? Also John Romero seems pretty accessible, perhaps you could ask him directly? Failing that, randomly writing data into the .exe until the images change could be used as a last resort! -- [[User:Malvineous|Malvineous]] 12:09, 12 December 2010 (GMT)

: Ha, that was easier than I expected - uncompressed VGA data is easy to find with a good hex editor ;-) [http://www.shikadi.net/pics/ddave-vga-hexdump.png This looks like it] -- [[User:Malvineous|Malvineous]] 12:17, 12 December 2010 (GMT)

: Ok that was only the menu graphics. At offset 0xC629 there's some sort of offset table which looks very similar to the contents of EGADAVE.DAV but there are extra bytes dotted all over the place - perhaps it's RLE encoded? Actually just before that there's the number 0x6CAA. If you go a bit less than 0x6CAA bytes after this you end up with another table, which to me suggests that 0x6CAA is the decompressed size of that first table. -- [[User:Malvineous|Malvineous]] 13:01, 12 December 2010 (GMT)

:If I remember it correctly, the VGA sprites and tiles are RLE compressed and it's not too hard to decompress them. The positions of the enemies in the levels on the other hand are still a mystery to me. [[User:Calvero|Calvero]] 20:43, 12 December 2010 (GMT)

Jill of the Jungle

2010-07-15T15:44:57Z

Calvero: /* Episode 2: Jill Goes Underground */ fixed a copy-paste typo

{{Stub}}

{{GamePage}}
== File formats ==

This section lists the major file formats used in the game.

* [[CMF Format]] - game music is stored in the <tt>*.DDT</tt> files
* [[CFG Format (Jill of the Jungle)|CFG Format]] - game configuration is stored in <tt>JILL?.CFG</tt>
* [[MAC Format (Jill of the Jungle)|MAC Format]] - macros (level demos)
* [[DMA Format]] - Level tiles
* [[SHA Format]] - Graphics
* [[Jill of the Jungle Map Format]] - Levels are stored in <tt>*.JNx</tt> and <tt>INTRO.JNx</tt>
* Saved games are just dumps of the entire level in its current state (so they're the same format as the [[Jill of the Jungle Map Format|actual levels]], stored in <tt>JN?SAVE.?</tt>)

== Palette ==
[[Image:Jill of the Jungle palette.png|thumb|right|128px|Jill of the Jungle palette]]
The VGA palette can be found inside the .EXE file. The palette is the same in all episodes and versions.

==== Episode 1: Jill of the Jungle ====
{|class="wikitable"
!Version!!CRC32!!Date!!Size!!Palette Offset
|-
|1.0||7899CC28||1992-06-01||216 804 bytes||?
|-
|1.2||51ADAE83||1992-07-30||206 963 bytes||?
|-
|1.2a||171E9EC0||1992-08-21||206 712 bytes||?
|-
|1.2b||C52CA6D9||1993-02-17||206 636 bytes||?
|-
|1.2c||0E7C596F||1993-12-27||219 216 bytes||?
|}

==== Episode 2: Jill Goes Underground ====
{|class="wikitable"
!Version!!CRC32!!Date!!Size!!Palette Offset
|-
|1.0||6064EA0A||1992-06-17||65 166† bytes||?
|-
|1.2||?||1992-07-30||?||?
|-
|1.2a||17477A49||1992-08-21||204 158 bytes||?
|-
|1.2b||75176ED7||1993-02-17||204 096 bytes||?
|}

==== Episode 3: Jill Saves the Prince ====
{|class="wikitable"
!Version!!CRC32!!Date!!Size!!Palette Offset
|-
|1.0||3B4D8C3B||1992-07-07||201 616 bytes||?
|-
|1.2||51ADAE83||1992-07-30||204 425 bytes||?
|-
|1.2a||D5435AFB||1992-08-21||204 174 bytes||?
|-
|1.2b||3FFF0F6C||1993-02-17||204 112 bytes||?
|}

†This version has been packed using [[LZEXE|LZEXE91]].

The palette is in [[VGA Palette|classic VGA format]] (6-bit RGB.) Note that the [[SHA Format]] can override this palette.

== Notes ==
* Since the level files are used for a lot of different things, you can e.g. swap <tt>INTRO.JN1</tt> and <tt>1.JN1</tt> and then when you load the first level you'll be playing the intro screen.

== External links ==
* [http://jillofthejungle.110mb.com/ Unofficial Jill of the Jungle page] ([http://members.tripod.com/classic_roach/id14.html Older version])
*[http://ftp.funet.fi/pub/msdos/games/editors/jilledit.zip JillEdit] [http://www.stuntsillusion.com/download/jilledit.zip (mirror)] - a level editor for Jill of the Jungle created by Rory L. Fisher.

[[Category:Epic Megagames]]
[[Category:Sidescroller]]

Talk:Jill of the Jungle

2010-07-15T15:42:34Z

Calvero: There's a UK version of Jill 1. And not all versions have the references to Keen et al.

In my version of Jill of the Jungle, the palettes were found at these locations:

Jill:

VGA to EGA conversion table @ 0x24964.

VGA palette @ 0x24A64.

Jill2:

VGA to EGA conversion table @ 0x1F5B4.

VGA palette @ 0x1F6B4.

Jill3:

VGA to EGA conversion table @ 0x1F704.

VGA palette @ 0x1F804.

Some of them differ from the posted. Does anyone else have a different version? --[[User:SaxxonPike|SaxxonPike]] 16:10, 12 July 2010 (GMT)
:Not sure - is there an easy way to tell which version a given .exe is? If so we should add a column to the table for the version number, so we can list the offsets for all known versions. Maybe also a signature code so it's easy for a program to identify which version a given file is. -- [[User:Malvineous|Malvineous]] 22:49, 12 July 2010 (GMT)

::I've seen different versions of a couple of Epic games, like Jill of the Jungle, Jazz Jackrabbit, Epic Pinball, Silverball and Extreme Pinball, and I couldn't find a version number inside the .exe files or see a version number when running the game. The only way to see which version number a game has, is to read what the included Helpme.doc file says. And even that is not foolproof as I've seen different .exe files with the same Helpme.doc file. Apogee surely did the version numbering a lot better than Epic :). [[User:Calvero|Calvero]] 11:17, 13 July 2010 (GMT)

:::The HELPME.DOC files can be quite misleading, actually. I've found a bunch of copies of the shareware episodes where the HELPME.DOC claims the game is version 2.0 when the game itself identifies itself by another version number (e.g. Solar Winds, version 2.0 in the .DOC and 1.1 in-game). Regarding Jill of the Jungle, there are "officially" (by officially I mean what they identify themselves as in the documents) only two recognized versions, 1.0 and 1.2. But there are also a number of revisions I've found to version 1.2 which I personally call 1.2, 1.2a, 1.2b and 1.2c. I know for a fact all of these revisions except 1.2c also have matching registered versions (I'm not too convinced that 1.2c actually had anything else than a shareware release). I have made a document some time ago to make it easier to identify these versions and it can be found from [http://aoebeta.110mb.com/Private/jill_versions.txt here] (the data is that of the main game EXE). --[[User:Litude|Litude]] 11:24, 15 July 2010 (GMT)

::::Wow, would you mind including that info on the main Jill page? I'm happy to do it but might be better if you do the first edit so it goes against your name in the edit history. Add an extra column for those palette offsets so we can add them in when we find them out for a particular version. My Jill versions match up well with your list, except my Jill 1 v1.0 (216804) is dated 1992-06-01, one day earlier than in your list. Also not sure if you're recording dates/versions of jjfile0.exe (the episode loader) because I'm not sure where that came from as I didn't find it until relatively recently. -- [[User:Malvineous|Malvineous]] 11:38, 15 July 2010 (GMT)

:::::Alright, I'll try adding the info though I don't really mind having someone else adding them (I don't really care that much about getting credited for stuff). Regarding the modify date of version 1.0, you're absolutely right. It seems my finger slipped when putting together that document. JJFILE0.EXE first appeared in version 1.2a and was also present in version 1.2b, but it was removed in 1.2c (which is why I think its shareware only, can't see any other reason for its removal). I don't record the dates of that file as as far as I know there are only two versions of the file, one of which is present in version 1.2a and the other one which is present in 1.2b.--[[User:Litude|Litude]] 12:43, 15 July 2010 (GMT)

::::::The version that is called version 1.1 of Jill 1 on [http://www.classicdosgames.com/game/Jill_of_the_Jungle.html RGB Classic Games] is called version 1.2a here, but when you run the game it says it's the United kingdom version. It gets this version information from the file INTRO.JN1. So at least one version of the game has in-game version information :). Through my own research I found out that only version 1.0 has the references to Commander Keen, Mario, Duke Nukem and Pac-Man in the map level. Can someone confirm this? It's possible to copy MAP.JN1 of version 1.0 to later versions to restore these references. [[User:Calvero|Calvero]] 15:42, 15 July 2010 (GMT)

Talk:Jill of the Jungle

2010-07-13T11:17:55Z

Calvero: reply - Almost no version information in Epic games :(

Talk:Crystal Caves

2010-07-10T11:48:54Z

Calvero: UNP vs Unlzexe

No modding tools exist for Crystal Caves, correct?

Also, it appears that the levels are located in the UNP'd executable starting at seg000:7332 (or $8C30 in the UNP'd exe). I believe tiles are stored as byte values, in pascal strings. Each row of tiles is 40 long, so there is an array of strings of length 41. Also, just looking at the ASCII representation of the hex values, you can clearly see the outline of the main level. Therefore, this should be easily patchable using a CKPATCH like utility.

(2222222222222222222222222222222222222222
(
( Y ÛÜ
( [A
( nn
(Dddddddddddddddddddddddddddddddddddddddn
( ÛÜ
( Y
( [5
( [B
( nn
(z mN z
(z z
(z un z
(z Y Žn z
(zZZZZZZZ[mZZZZZZZZZZZZZZZZZZnnnZZZZZZZz
(lklklklklklklklklkKlkLKlkLKlkLKlkLKk kLk
(k Õ Õ Õ [d L
(l x x ±±±±± l
(LÕ ±±± H ±±±±±±±±±±±±±±±±± ðn ² k
(K ² ðn x ðn ú ³nx²Æk
(kù ±±± [d ³n ±±±± Õ ³n ±±±±±±± L
(lú ² Õ ³n ðn ³n ðn ² l
(Lùù x²x ³n ³n ù ³n ú ³nx² k
(k±±±±±±±±±±±±±±±±±±±±±± ³n ùùú ³n±±VK
(l ðnÕ Õðn ²Õ ±±±±±±±±±±±± k
(kx ³n ³n x² x ² ðn ðn l
(K±±±±± ±±±±±±± ±±±±±±±±²x ³n ³n K
(k ðnÕ Õðn ² ðn Õ ±±±±±±±±±±±± k
(Lx ³n ³n x²x ù ³n x² K
(l±±±±± V ±±±±±±±±±±±±±±±±±±±±±±±±±±±±± k
(k ðn [4n ðn ðn L
(Kx ³n Õ Õ ³n Õ ³n Õ L
(kK ³n ³n ³n k
(lKkLkKklKLklKLKkKlkLKlkLKlkLKlkLKlkLKlkl
(1111111111111111111111111111111111111111

[[User:Lemm|Lemm]] 13:31, 9 December 2009 (GMT)

Nifty. There are a handful of graphics editors for it, but nothing else. This should help with level editing muchly. -- [[User:Draik|Draik]] 05:33, 10 December 2009 (GMT)

:How many versions of Crystal Caves are there? In my unlzexe'd version the level data starts at 0x8CE0 instead. The levels seem to be of varying height though - the map is 36 rows high, most of the levels are 24 rows high but either e1l6 or e1l7 seems to be only 23 rows high. Maybe there's an array somewhere with all the level heights? -- [[User:Malvineous|Malvineous]] 13:25, 9 July 2010 (GMT)

:: Here are my guesstimations based on the look of each level. Map is 36 tiles high, levels 7, 8 and 14 are 23 tiles high, and the rest are 24 tiles high. -- [[User:Malvineous|Malvineous]] 13:43, 9 July 2010 (GMT)

::Be aware that UNP and Unlzexe don't create the same output on the same input! [[User:Calvero|Calvero]] 11:48, 10 July 2010 (GMT)

== Graphics editors ==

They can be found over at http://spikenexus.toxicsheep.com/pccw/pages/index.php?page=downloads

Secret Agent

2010-07-05T14:02:48Z

Calvero: /* File formats */ MNI link changed to link to Crystal Caves Tileset Format

{{Stub}}

{{GamePage}}

== File formats ==
This section lists the major file formats used in the game.

With the exception of the full screen PCX images, the data files of Secret Agent are encrypted with the [[Secret Agent encryption]]. When the files are decrypted, they are in (almost) the same format as the [[Crystal Caves]] data files.

* [[PCX Format]] - 320×200 16 color full screen images stored in <tt>*.APO</tt>, <tt>*.CRD</tt>, <tt>*.END</tt> and <tt>*.TTL</tt> files.
* [[Crystal Caves Tileset Format]] - 8×8 16 color sprites, like the characters and icons on the status bar, are stored in <tt>SAM?02.GFX</tt> files. The 16×16 16 color sprites stored in <tt>SAM?01.GFX</tt> files are also in this format.
* [[Crystal Caves Sound format|SND Format]] - PC speaker sound effects, a modified form of [[Inverse Frequency Sound format]].
* [[Secret Agent level format]] - the levels are stored in <tt>SAM?03.GFX</tt> files.

[[Category:Apogee]]
[[Category:Sidescroller]]

EPF Format

2010-05-02T14:20:34Z

Calvero: /* File entry */

The EPF file format is used in many games, like:
Alien Breed Tower Assault,
Arcade Pool,
Overdrive,
Project X,
Sensible Golf,
Spirou,
The Jungle Book,
The Lion King,
The Smurfs,
Tin Tin in Tibet and
Universe

Some (all?) of these games are made by East Point Software, so EPF (a shortened version of "EPFS" from the file header) probably stands for East Point File System or something similar.

== File format ==

=== Signature ===

The first four bytes in the file are "EPFS", followed by a UINT32LE offset (so that value must be smaller than the total file size.)

=== Header ===

{|class="wikitable"
!Data type!!Description
|-
|BYTE signature[4]||"EPFS"
|-
|UINT32LE fatOffset||Offset of the FAT
|-
|UINT8 unknown||{{TODO|Unknown, always zero - flags?}}
|-
|UINT16LE numFiles||Number of files
|}

The data for the first file starts immediately after the header (i.e. file offset 11.)

=== File entry ===

At offset <tt>fatOffset</tt> sits a list of file entries. The following structure is repeated until the end of the file.

{|class="wikitable"
!Data type!!Description
|-
|BYTE filename[13]||Filename (NULL-terminated)
|-
|UINT8 compressionFlag||0 for "file is not compressed", 1 for "file is compressed"
|-
|UINT32LE compressedSize||size of the compressed file
|-
|UINT32LE decompressedSize||size of the file after decompression
|}

In order to calculate the offset of each file, a running total is required. It should start at offset 11 (just after the header), then the <tt>compressedSize</tt> should be added to reveal the offset of the next file.

=== Compression ===

The compression scheme in use is currently unknown.

== Tools ==

{{BeginFileFormatTools|Type=group}}
{{FileFormatTool
| Name = [[Camoto]]
| canExtract = Yes
| canDecompress = No
| canCreate = Yes
| canModify = Yes
| canCompress = No
| editHidden = Yes
| editMetadata = N/A
}}
{{EndFileFormatTools}}

[[Category:Group Files]]
[[Category:Group Files supporting compression]]
[[Category:Group Files with trailing FAT]]
[[Category:The Lion King]]

User talk:Calvero

2010-05-01T20:32:35Z

Calvero: /* EPF format */ reply

== EPF format ==

Hi Calvero - on [[EPF Format]] your description differs to the file I have. Do you have a file in the format you described I could examine? Also, did you reverse engineer this format yourself or did it come from elsewhere? Thanks! -- [[User:Malvineous|Malvineous]] 12:41, 25 April 2010 (GMT)

:I reverse engineered this format myself. The main difference between my description of this file format and your description is that, if I understand your description correctly, you're saying the header consists of two fields (BYTE signature[4] and UINT32LE fatOffset) and the first file starts at offset 8, while I'm saying the header consists of
:{|class="wikitable"
!Data type!!Description
|-
|BYTE signature[4]||"EPFS"
|-
|UINT32LE fatOffset||Offset of the FAT
|-
|BYTE zero||this byte is always zero
|-
|UINT16LE iFileCount||number of files
|-
|BYTE unknown[8]||8 bytes with an unknown meaning
|}
:and the first file starts at offset 0x13. I can't remember why I said there are 8 bytes with an unknown meaning in the header and I can't remember why I said UINT16LE iNumberOfFiles is zero based, so I'm probably wrong and you're right :). Do you still want a file in the format I described? I probably investigated the data file of the Smurfs game the most, because in 2008 the Smurfs celebrated their 50th anniversary. [[User:Calvero|Calvero]] 20:32, 1 May 2010 (GMT)

IMF Format

2010-04-11T14:57:31Z

Calvero: /* Use */ The beta version of Realms of Chaos also uses this file format. The released version uses MIDI.

The id Software Music Format (IMF) is a raw music format that stores the actual bytes sent to the Adlib's [[OPL2]] chip. For this reason it is a very simple format to process.

== File format ==

There are two versions of the IMF format. The first two bytes in the file will be zero if it's in Type-0 format, otherwise it will be Type-1 format. In a Type-0 file the two initial zero bytes are skipped, then the rest of the file is Adlib data that is played until the end of the file is reached. In a Type-1 file the two initial bytes contain the size of the Adlib data (not including the two bytes themselves [TODO: Check this]), so only this much data is played. This means it's possible to store arbitrary data in a Type-1 IMF file after the song data (see [[#Tag Data]] below.)

{|class="wikitable"
!Data type!!Name!!Description
|-
|UINT16LE||iLength||Type-1: Song data length (in bytes), Type-0: 0x0000
|-
|BYTE[iLength]||cAdlibData||Song data (see below) - <code>iLength</code> bytes long if Type-1, or until EOF if Type-0
|-
|BYTE[]||cExtraData||Arbitrary data/tags (Type-1 format only, see [[#Tag Data]] below)
|}

Note that for Type-1 files, the initial two bytes (the "song data length") are likely to be the filesize minus two, as the two initial bytes aren't counted. The obvious exception to this is if there is trailing data at the end of the OPL data, such as an info tag.

The song data is composed of four-byte "units":

{|class="wikitable"
!Data type!!Description
|-
|BYTE||Adlib register
|-
|BYTE||Adlib data
|-
|UINT16LE||Delay
|}

The data byte is sent to the specified register on the Adlib card, followed by a delay for the specified number of cycles.

=== Timing ===

IMF files exist at three known speeds. Unfortunately this is determined by the game, not the IMF file, so tempo cannot be determined from the music files alone. Extracted IMFs can be compared to discern their speeds. The known speeds are:

{|class="wikitable"
!Speed!!Game
|-
|280Hz||[[Duke Nukem II]]
|-
|560Hz||[[Bio Menace]], [[Commander Keen]], [[Cosmo's Cosmic Adventures]], [[Monster Bash]]
|-
|700Hz||[[Blake Stone]], [[Major Stryker]], [[Operation Body Count]], [[Wolfenstein 3-D]]
|}

The easiest method to tell the files apart is to treat all files with a .WLF extension as 700Hz and all .IMF files as 560Hz. Since Duke II is the odd one out, it is usually ignored since doubling the value of all the delay bytes conveniently turns it into a 560Hz .IMF.

=== Restrictions ===

As IMF files contain Adlib music for games that may also have Adlib sound effects, care must be taken to ensure that IMF music and any sound effects can share the OPL chip without conflict. This is done by reserving the OPL's first channel for sound effects, leaving eight remaining channels available for use in IMF files. This has been confirmed by automated inspection of the IMF files from the following games, all of which have no data on OPL channel #0 beyond 2-3 initialisation commands: [[Bio Menace]], [[Blake Stone]], [[Commander Keen 4-6]], [[Cosmo's Cosmic Adventures]], [[Duke Nukem II]], [[Major Stryker]], [[Monster Bash]], [[Operation Body Count]], [[Wolfenstein 3-D]].

In situations where channel #0 is not reserved and is used by the IMF file, when it is placed back into the game it interferes with the sound effects causing distortion, transposition, and otherwise resulting in broken sound effects. This can happen when an IMF file is created using a utility that does not take into account the fact that channel #0 must be left unused. See the end of this page for a list of utilities that can create IMF files and whether they treat channel #0 correctly.

It is worth noting that channel #0 is unused even games such as Cosmo and Monster Bash, which do not use Adlib sound effects (Cosmo has PC speaker effects only and Monster Bash has PC speaker and digitised PCM audio.) It is also worth mentioning that none of these games make use of the OPL's rhythm-mode, which would trade three note-producing channels for five percussion channels, even though there is no technical reason why it cannot be done.

=== Tag Data ===

In a Type-1 IMF file it's possible to store data after the end of a song. Some games (such as Wolfenstein 3-D) have extra data stored there, but its purpose is unknown. It is also possible to store tags there, and this simple format is supported by most IMF players:

{|class="wikitable"
!Data type!!Name!!Description
|-
|BYTE||cSignature||0x1A
|-
|ASCIIZ[256]||strTitle||Song title
|-
|ASCIIZ[256]||strComposer||Song composer
|-
|ASCIIZ[256]||strRemarks||Song comment/message
|-
|BYTE[9]||cProg||Name of the first program that added these tags (eight bytes + terminating NULL, pad out with NULLs if necessary.)
|}

Note that the ASCIIZ[256] strings are variable-length NULL-terminated strings. Their maximum length is 256 bytes *including* the terminating NULL, meaning the string will only ever contain 255 characters or less, plus the terminating-NULL. Of course the string will normally be much shorter, and an empty string will consist of a single 0x00 byte.

This tag format is supported by AdPlug when playing IMFs. The tag format can also be used with .raw files, but no players officially support it yet.

Note that the tags should begin directly after the IMF data, so in other words reading in the first two bytes of the file (the "song length") and then seeking forward that many bytes, should put the file pointer at the start of the tag block (so the next byte that will be read in should be 0x1A, if the tags are present.)

[[Category:Adlib]]
[[Category:File Formats]]
[[Category:Music Files]]


[[Category:Commander Keen 4-6]]
[[Category:Cosmo's Cosmic Adventures]]
[[Category:Duke Nukem II]]
[[Category:Major Stryker]]
[[Category:Monster Bash]]
[[Category:Wolfenstein 3-D]]

== Use ==

This format has been used in the following games:

* [[Bio Menace]]
* [[Blake Stone]]
* [[Catacomb 3D]]
* [[Commander Keen 4-6]]
* [[Corridor 7]]
* [[Cosmo's Cosmic Adventures]]
* [[Duke Nukem II]]
* [[Hocus Pocus]]
* [[Major Stryker]]
* [[Monster Bash]]
* [[Operation Body Count]]
* [[Realms of Chaos]] (beta version only)
* [[Wolfenstein 3-D]]

=== Utilities ===
The following utilities work with this file format.

==== Convert other formats to IMF ====

{|class="wikitable"
!Utility/Description!!280Hz DukeII!!560Hz IMF!!700Hz WLF!!Channel #0 left blank for SFX
|-
|[http://winwolf3d.dugtrio17.com/download/IMFCreator IMFCreator] creates IMF files from MIDI files in one step and also includes a preview feature, from the WinWolf3D website
||Yes
||Yes
||Yes
||Yes
|-
|[[MIDI2MUS]] then [[MUS2IMF]] can be used together to make IMF files
||?
||?
||?
||No?
|-
||[http://www.shikadi.net/utils/#dro2midi DRO2IMF] can convert DOSBox OPL captures into IMF files
||Requires recompilation
||Yes
||Requires recompilation
||No
|}

==== Convert IMF to other formats ====
* [[DRO2MIDI]] converts IMF to MIDI files

==== Play this file format ====
* [http://www.winamp.com/player Winamp] with [[AdPlug]] can play IMF and WLF files
* The [http://adplug.sourceforge.net AdPlug] library includes the command-line AdPlay utility

Inverse Frequency Sound format

2010-04-11T14:55:06Z

Calvero: /* Notes */ The beta version of Realms of Chaos also uses this file format. The released version doesn't support PC speaker sound effects.

The inverse frequency sound format is the format used by Apogee\Id Software in many of their games for the PC sounds. It is named because the bulk of the data is stored as 'inverse frequency' values. (The higher the value, the lower the tone it produces.) Most commonly this is stored in a <tt>SOUNDS.xxx</tt> file, though it may be stored internally.

Later games, such as [[Wolfenstein 3D]] use a modified form of this for their (Less important) PC speaker and adlib sounds.

The file is divided into three sections, 16 bytes of header, a list of sound names and the actual sound data. The start of sound data should thus be (Numsnds + 1) * 16 bytes from the file start

==Header==

0 4 Identifier "SND" + $00; indicates the start of a sound file, whereas "SPK" + $00 indicates
the start of the older 'speaker' format, which has very few differences.
4 2 Filesize Size of file
6 2 ??? Usually $3C $00, but doesn't appear to do anything.
8 2 Sndnum Number of sounds in file. For SPK files this is blank as the number of sounds
is always 63
10 6 Spacer Padded with nulls

==Sound names==

SOUND HEADER: (1 per sound, 16 bytes each)
? 2 Location Location of sound start in file
2 1 Priority Whether or not sound will be interrupted by another sound if said sound
starts playing while the first is. Sounds can only be interrupted by sounds
that have an equal or higher value of this. 255 is max, 0 is inadvisable
3 1 Validater If a sound is a 'placeholder' to be ignored, this is 1, if it is a proper
sound it is 8
4 12 Name Sound name, padded with nulls.

==Sound data==

Sound data is divided into words, with the word value being inversely proportional to the sound frequency. Each word is around 1/64th of a second of tone and most files contain a few seconds of sound. The value $FFFF signals the end of a sound and most values are between the range $0100-$5000. $0000 is silence.

Later games use a similar format for PC and Adlib sounds, the sound data is in bytes with values of 0-255, the loss of fine-tuning being attributable to the lesser role of PC sounds and the Adlib format. The [[AudioT Format]] also has a totally different way of reading the sounds, and contains music.

==Notes==

This format has been reverse engineered many times, most often in the [[Commander Keen 1-3]] fan community. Probably first by [http://web.archive.org/web/20000815235203/http://www.dd.chalmers.se/~f98anga/projects/keen/ Anders Gavare].

Games that use this format are [[Catacomb]] 1 and 2, [[Commander Keen 1-3]], [[Cosmo's Cosmic Adventures]], [[Dangerous Dave]], [[Dangerous Dave in Copyright Infringement]], [[Dangerous Dave 2]], [[Duke Nukem]], [[Duke Nukem II]], [[Hovertank 3D]], [[Math Rescue]], [[Major Stryker]], [[Monster Bash]], [[Paragon]] (aka Street Ball), [[Pickle Wars]], [[Realms of Chaos]] (beta version only), [[Rescue Rover]], [[Shadow Knights]], [[Slordax]], [[Word Rescue]] and [[Xenopods]].

[[Category:File Formats]]
[[Category:Audio Files]]

CMP Format

2010-04-10T21:12:47Z

Calvero: /* Utilities */ added WinTExtract

The '''CMP format''' is how most files in the games [[Cosmo's Cosmic Adventures]], [[Duke Nukem II]], and [[Major Stryker]] are stored, albeit with varying file extensions (Cosmo prefers VOL and STN, while Major Stryker uses MS1, MS2 and MS3.)

The games will check the current directory first for files, and fall back to the CMP file if none are found. This means files inside the CMP can be easily overridden by simply placing their replacements as normal files in the game directory.

= File format =

== Signature ==

There is no known signature for this format. One method to identify files is to read in the file entries (as there is a fixed maximum of these, all 4000 bytes must be present for the file to be valid) and confirm that each filename only consists of ASCII characters or nulls, and each file offset plus its size is less than the total size of the CMP file. It is extremely unlikely that this method would incorrectly identify a file.

An additional check may be to examine the offset of the first file. This should always be 0xFA0 (4000), as the FAT is always 4000 bytes. However it is unknown whether this is a requirement of the file format - the games may well work with a smaller FAT.

== File entry ==

The first 4000 bytes of the file consists of file entries, with the remainder containing the data. Each file entry consists of the filename, its offset and its size. This slightly unusual configuration (storing both the offset and the size) means it is possible (in theory) for two different files to share the same data, and to insert "hidden" data between files.

A file entry is laid out as follows.

{|class="wikitable"
!Data type!!Description
|-
|[[char]] cFilename[12]||Filename (8.3 style), only NULL-terminated if there is enough room
|-
|[[UINT32LE]] iOffset||File offset from start of group file
|-
|[[UINT32LE]] iSize||File size
|}

The 4000 bytes available leaves enough room for 200 files. Unused file entries are NULL. The very last file entry seems to contain an ASCII decimal number closely related to the number of files, however its purpose (and whether it is required to be updated after editing) is presently unknown.

= Utilities =

Several programs that edit various games will extract CMP files, but the only two designed solely for this are Frenkel's textract and Adam Biser's WinTExtract.

* [http://www.szevvy.net Wombat]
* [http://www.student.tue.nl/p/f.a.m.smeijers/sfp/games/duke2.htm#extractor textract]
* [http://winwolf3d.dugtrio17.com/downloads.php WinTExtract]

[[Category:Cosmo's Cosmic Adventures]]
[[Category:Duke Nukem II]]
[[Category:Major Stryker]]
[[Category:File Formats]]
[[Category:Group Files]]

Secret Agent encryption

2010-01-11T13:56:28Z

Calvero: I hope this all is clear. The encryption is not hard to understand, but writing it down in natural language is not trivial.

The files of Secret Agent are encrypted, but not compressed: an encrypted file has exactly the same size as its corresponding unencrypted file.

= Key =
Encrypting and decrypting files for Secret Agent depend on a key. The key consists of the string "Copyright 1991 Peder Jungck" followed by a null-character. So the length of the key is 28 characters.
The first time the key is used, it should return the ASCII number of the first character in the string. So, it should return 67, because the 67th entry in the ASCII table is 'C'. The second time it should return 111 ('o'). Etc.
When all 28 characters are used, including the null-character, it should start over at the beginning with 67 ('C').

When encrypting or decrypting a level file (<tt>SAM?03.GFX</tt>), after 42 times, it should start over at the beginning with 67 ('C').
Encrypting and decrypting sprite files should start over after 8064 for <tt>SAM?01.GFX</tt> files and after 2048 times for <tt>SAM?02.GFX</tt> files.

= Decryption =
For all bytes in a file, do:

Read a byte.

Turn the bits in the byte around. For example, 00000001 becomes 10000000, and 10110000 becomes 00001101.

XOR this turned-around-byte with the next key-value.

Return the result

= Encryption =
Encryption is the reverse of decryption. So, after reading a byte, XOR it with the next key-value and then turn the bits around.

= Credits =

This encryption was reverse engineered by [http://www.student.tue.nl/p/f.a.m.smeijers/sfp/games/secretagent.htm Frenkel Smeijers]. If you find this information helpful in a project you're working on, please give credit where credit is due. (A link back to this wiki would be nice too!)

[[Category:Secret Agent]]

Secret Agent

2010-01-11T12:22:38Z

Calvero: added some file format information

{{Stub}}

{{GamePage}}

== File formats ==
This section lists the major file formats used in the game.

With the exception of the full screen PCX images, the data files of Secret Agent are encrypted with the [[Secret Agent encryption]]. When the files are decrypted, they are in (almost) the same format as the [[Crystal Caves]] data files.

* [[PCX Format]] - 320×200 16 color full screen images stored in <tt>*.APO</tt>, <tt>*.CRD</tt>, <tt>*.END</tt> and <tt>*.TTL</tt> files.
* [[MNI Format]] - 8×8 16 color sprites, like the characters and icons on the status bar, are stored in <tt>SAM?02.GFX</tt> files. The 16×16 16 color sprites stored in <tt>SAM?01.GFX</tt> files are also in this format.
* [[Crystal Caves Sound format|SND Format]] - PC speaker sound effects, a modified form of [[Inverse Frequency Sound format]].
* [[Secret Agent level format]] - the levels are stored in <tt>SAM?03.GFX</tt> files.

[[Category:Apogee]]
[[Category:Sidescroller]]

Crystal Caves Sound format

2010-01-11T11:34:49Z

Calvero: typos removed

[[Crystal Caves]] sound format is similar to the [[Inverse Frequency Sound format]] used by many games made by Apogee, id Software and Softdisk, with a few modifications and restrictions. The main difference is that the sound files do not contain a header or sound names, and sounds are of a fixed length. (610 bytes.)

The sounds are stored in the files <tt>CCx-y.SND</tt>; 12 sounds to a file.

The sound data itself is identical in format to that of inverse frequency, two-byte values inversely proportional to the tone frequency they produce. (Larger value, higher pitch.) with a value of -1 ending the sound. (There is one terminator at the sound play end and another at the sound data end, just to be sure.) The actual sound data takes up the last 600 bytes of the sound, the first 10 being a number of attributes as follows:

0 2 Priority Whether or not sound will be interrupted by another sound if said sound
starts playing while the first is. Sounds can only be interrupted by sounds
that have an equal or higher value of this.
2 2 ??? Unknown
4 2 Vibrate A divider for the vibrate; this changes a sound's tone by periodicly switching
off the PC speaker. (But at a more rapid rate than would be achieved by simply
adding silences to the sound data
6 4 ??? Unknown
10 600 Data Inverse frequency sound data

[[Category:File Formats]]
[[Category:Audio Files]]

Talk:SkyRoads

2009-11-22T21:02:26Z

Calvero:

Hey there, does anyone know where I (Levellass) can get this game? The .lzs format it a variety of LZW compression used a lot in Japan and if this is the same, extraction could be quite easy. But I'll need the game files to test this.
::You didn't look really hard, did you? A link is right there on the SkyRoads main page in this wiki. [[User:Calvero|Calvero]] 21:02, 22 November 2009 (GMT)

Talk:Stunts

2009-11-10T12:53:20Z

Calvero: added link to Stunts Wiki

Here's a link to the [http://jonas-baehr.de/stunts/format.php Original Stunts (4D Sports Driving) Track-Format].
:And there's lots of information about the other Stunts files in the [http://wiki.stunts.hu/index.php/Category:Modding Stunts Wiki]. [[User:Calvero|Calvero]] 12:53, 10 November 2009 (GMT)

Inverse Frequency Sound format

2009-03-01T21:34:09Z

Calvero: /* Notes */ added more credits, added more games

The inverse frequency sound format is the format used by Apogee\Id Software in many of their games for the PC sounds. It is named because the bulk of the data is stored as 'inverse frequency' values. (The higher the value, the lower the tone it produces.) Most commonly this is stored in a <tt>SOUNDS.xxx</tt> file, though it may be stored internally.

Later games, such as [[Wolfenstein 3D]] use a modified form of this for their (Less important) PC speaker and adlib sounds.

The file is divided into three sections, 16 bytes of header, a list of sound names and the actual sound data. The start of sound data should thus be (Numsnds + 1) * 16 bytes from the file start

==Header==

0 4 Identifier "SND" + $00; indicates the start of a sound file, whereas "SPK" + $00 indicates
the start of the older 'speaker' format, which has very few differences.
4 2 Filesize Size of file
6 2 ??? Usually $3C $00, but doesn't appear to do anything.
8 2 Sndnum Number of sounds in file. For SPK files this is blank as the number of sounds
is always 63
10 6 Spacer Padded with nulls

==Sound names==

SOUND HEADER: (1 per sound, 16 bytes each)
? 2 Location Location of sound start in file
2 1 Priority Whether or not sound will be interrupted by another sound if said sound
starts playing while the first is. Sounds can only be interrupted by sounds
that have an equal or higher value of this. 255 is max, 0 is inadvisable
3 1 Validater If a sound is a 'placeholder' to be ignored, this is 1, if it is a proper
sound it is 8
4 12 Name Sound name, padded with nulls.

==Sound data==

Sound data is divided into words, with the word value being inversely proportional to the sound frequency. Each word is around 1/64th of a second of tone and most files contain a few seconds of sound. The value $FFFF signals the end of a sound and most values are between the range $0100-$5000. $0000 is silence.

Later games use a similar format for PC and Adlib sounds, the sound data is in bytes with values of 0-255, the loss of fine-tuning being attributable to the lesser role of PC sounds and the Adlib format. The [[AudioT Format]] also has a totally different way of reading the sounds, and contains music.

==Notes==

This format has been reverse engineered many times, most often in the [[Commander Keen 1-3]] fan community. Probably first by [http://web.archive.org/web/20000815235203/http://www.dd.chalmers.se/~f98anga/projects/keen/ Anders Gavare].

Games that use this format are [[Catacomb]] 1 and 2, [[Commander Keen 1-3]], [[Cosmo's Cosmic Adventures]], [[Dangerous Dave]], [[Dangerous Dave in Copyright Infringement]], [[Dangerous Dave 2]], [[Duke Nukem]], [[Duke Nukem II]], [[Hovertank 3D]], [[Math Rescue]], [[Major Stryker]], [[Monster Bash]], [[Paragon]] (aka Street Ball), [[Pickle Wars]], [[Rescue Rover]], [[Shadow Knights]], [[Slordax]], [[Word Rescue]] and [[Xenopods]].

[[Category:File Formats]]
[[Category:Audio Files]]

GameMaps Format

2009-02-19T15:38:26Z

Calvero: /* Notes */ Bio Menace typo fixed

The map data for [[Commander Keen 4-6]] is mainly stored in the <tt>GAMEMAPS.CKx</tt> file. This stores all the maps of the levels used in the game. The GAMEMAPS file is read and decompressed using data stored in the <tt>MAPHEAD.CKx</tt> file. The file's start is easily located as it always begins with the word $ABCD followed by several dwords and a lot of blank space. In the 1.4 versions of Keen 4-6 (Dumped executable) the file starts at the following:

Keen 4: $24830
Keen 5: $25990
Keen 6: $25080
(Keen D: $1FA50)

== Map headers ==

In Keen, as in most games, the <tt>MAPHEAD</tt> file is 402 bytes long, consisting of a word and 100 level dwords.

The first word is the flag for [[RLEW compression]], used to compress the <tt>GAMEMAPS</tt> file. By default this is $ABCD (This can be changed.). The remaining dwords point to the headers of each level in the <tt>GAMEMAPS</tt> file. (Nonexistent levels have a blank dword, so most of the file is empty space.)

== GAMEMAPS Format ==

The structure of the <tt>GAMEMAPS</tt> file is disordered due to the fact that the level headers and level data can be located in any place in any order. The usual structure consists of a variable string of TED settings ('TEDv1.0...') followed by the levels in no particular order. Each level usually consists of the level header followed by three planes of data, though not always.

The TED settings are unimportant and can usually be ignored. (Though in some cases TED may use them.)

=== Levels in GAMEMAPS ===

The header for each level that is pointed to by MAPHEAD is 42 bytes long:

0 4 Offset in GAMEMAPS to beginning of compressed plane 0 data
4 4 Offset in GAMEMAPS to beginning of compressed plane 1 data
8 4 Offset in GAMEMAPS to beginning of compressed plane 2 data
12 2 Length of compressed plane 0 data (in bytes)
14 2 Length of compressed plane 1 data (in bytes)
16 2 Length of compressed plane 2 data (ib bytes)
18 2 Width of level (in tiles)
20 2 Height of level (in tiles)
22 16 Internal name for level (used only by editor, not displayed in-game. null-terminated)
38 4 Signature "!ID!"
42 x Level data, three planes RLEW and Carmack compressed

The presence of the level name and the signature are not required by the Keen engine to play the level. Plane 0 is the 'background' plane, plane 1 is the 'foreground' plane, and plane 2 is the 'info' plane. Each is compressed separately, as described below.

=== Compression in GAMEMAPS ===

Each plane is compressed with two successive compression algorithms. The first is [[RLEW compression]], identical to that used in [[Commander Keen 1-3]], except that the magic word (Flag.) is different. (It is specified in the MAPHEAD file, rather than always being xFEFE.) The second is [[Carmack compression]].

The order of compression is RLEW followed by Carmack. One must also keep in mind that each compression algorithm outputs as its first word the length of the uncompressed data. So in the GAMEMAPS file for a particular plane of a particular level, the first word is the number of bytes in the RLEW-compressed data, and the first word of the RLEW-compressed data is the number of bytes in the uncompressed data.

== Notes ==

This format was reverse engineered by CKGuy

The format is used by other games as well, including [[Bio Menace]], [[Catacomb 3D]], [[Dangerous Dave 3]], [[Dave Goes Nutz]], and [[Wolfenstein 3D]]

Talk:Dangerous Dave 2

2009-01-29T10:37:36Z

Calvero: Dave 2 file format completeness question.

Dangerous Dave 2 is dissected by Gawd on his website: [http://www.megidish.net/museum/ Gawd's Museum of Dissected Games].
I'm a bit lazy now to check for myself, but is everything he found out about the file formats of Dave 2 also on this ModdingWiki?
[[User:Calvero|Calvero]] 10:37, 29 January 2009 (GMT)

God of Thunder

2009-01-17T21:35:43Z

Calvero: added link to unpacker and data converter

{{GamePage}}
All data appears to be stored in the file ''GOTRES.DAT''

== File formats ==

This section lists the major file formats used in the game.

* [[VOC Format]] - audio files

== External links ==
* [http://grompe.org.ru Unpacker and partial data converter]

{{NoModdingInfo}}

[[Category:Overhead]]
[[Category:Puzzle]]

TED5

2008-08-10T15:47:25Z

Calvero: download link added

{{Stub}}

[[Image:TED5-Keen4.png|frame|Editing a [[Commander Keen 4-6|Keen 4]] level with [[TED5]]]]

Tile Editor v5.0 (TED5) is a level editor written by [[:Category:id Software|id Software]] that has been used to create the levels for many of their games.


== Supported Games ==

This is a list of games that have been successfully edited with TED5:

* [[Bio Menace]]
* [[Commander Keen 4-6]]
* [[Rise of the Triad]]

== Download ==

TED5 has been released as open source freeware. TED5 and its source code can be downloaded from [http://www.3drealms.com/downloads.html#rott 3D Realms]. It can be used to edit the levels of Bio Menace and to create new levels for Rise of the Triad. It is also possible to edit the levels of Commander Keen 4-6, but this is a bit harder to [http://www.keenmodding.org/viewtopic.php?t=899 setup].

[[Category:TODO]]
[[Category:Level Editors]]



[[Category:Bio Menace]]
[[Category:Commander Keen 4-6]]
[[Category:Rise of the Triad]]

Wolfenstein 3-D

2008-08-10T15:22:18Z

Calvero: added Wolf3D source code link.

{{Stub}}

{{GamePage|Wolfenstein 3-D}}
== File formats ==

This section lists the major file formats used in the game.

* [[AudioT Format]] - sounds and music are stored in the <tt>AUDIO*.WL?</tt> files
* [[TED5 Gamemaps]] - levels are stored in <tt>GAMEMAPS.WL?</tt>
* WLF Format - identical to the [[IMF Format]] only with a faster tempo

== Tools ==

These tools can be used to edit this game.

* [[TED5]] - the editor used by id Software to create the original levels

== Debugging/testing info ==

* [[Wolfenstein 3-D Cheat Codes]] - including debugging "cheats" useful for modders

== Further information ==

The source code of Wolfenstein 3-D was released by id Software on July 21, 1995. It can be downloaded from id Software's [ftp://ftp.idsoftware.com/idstuff/source/ FTP server].

[[Category:Apogee]]
[[Category:id Software]]
[[Category:3D]]
[[Category:First-Person Shooter]]
[[Category:Wolfenstein 3-D]]

Talk:Hocus Pocus palette

2008-03-20T11:24:02Z

Calvero: a reply

If the palette is located inside the main .DAT file, it's probably better to list the file number rather than (or at least as well as) the offset (e.g. the palette is the 20th file in the .DAT file.) -- [[User:Malvineous|Malvineous]] 09:01, 18 March 2008 (GMT)
:I think even that is too much work. Once a palette file is extracted from the Hocus.dat group file, it's just a palette file in a format that is used in many VGA games. Do all these VGA games need their own palette format page with every time the same information? I think not. [[User:Calvero|Calvero]] 11:24, 20 March 2008 (GMT)

Talk:DAT Format (Hocus Pocus)

2008-03-16T13:45:44Z

Calvero: Beta version question

There's a beta of Hocus Pocus floating around somewhere on the Internet. But I don't know whether it is legal to have it in ones possession. Are we going to support that version on this ModdingWiki? [[User:Calvero|Calvero]] 13:45, 16 March 2008 (GMT)

Talk:Rockford

2008-03-15T14:50:55Z

Calvero: Rockford != Boulder Dash

Wikipedia says Rockford and Boulder Dash are the same game - is that true? -- [[User:Malvineous|Malvineous]] 08:49, 15 March 2008 (GMT)
:Rockford [http://www.mobygames.com/game/rockford-the-arcade-game] is a sequel to Boulder Dash [http://www.mobygames.com/game/boulder-dash]. [[User:Calvero|Calvero]] 14:50, 15 March 2008 (GMT)

Talk:Hocus Pocus

2008-03-09T10:08:11Z

Calvero: 240x60 confirmation

== Levels ==

From [http://www.szevvy.com/node/3 Wombat] it appears the levels are 14400 bytes long, and are stored tile-based like most games in those days. From hex-editing a level exported by Wombat it appears the levels do not store the width and height of the map.
I made crude maps of the first 2 levels by copy-pasting screenshots together, and the first level is at least 188x30 tiles. The second level is at least 236x50 tiles. Given that all levels have the same size, it is likely that they are all 240x60 tiles, which is exactly 14400 bytes.
Wombat also exports files that are twice the size. Maybe they store where enemies, switches and other objects are placed? Or maybe it's the other way around?
This definitely needs more attention. -- [[User:Spinal|Spinal]] 00:16, 9 March 2008 (GMT)
:When you extract a level file with a size of 14400 bytes with Wombat Game Tools and you open it with the command "edit /240 levelfile" in Windows or DOS you get something that looks like a level. So I think the levels are indeed 240×60 tiles. With the level files that are 28800 bytes long it's harder to see a level in it. [[User:Calvero|Calvero]] 10:08, 9 March 2008 (GMT)

Crystal Caves

2008-03-07T20:07:41Z

Calvero: added file formats

{{Stub}}

{{GamePage}}
== File formats ==

This section lists the major file formats used in the game.

* [[PCX Format]] - 320×200 16 color full screen images stored in the <tt>*.APG</tt>, <tt>*.CDT</tt>, <tt>*.END</tt> and <tt>*.TTL</tt> files.
* [[MNI Format]] - 8×8 16 color sprites, like the characters and icons on the status bar. The 16×16 16 color sprites stored in the <tt>*.GFX</tt> files are also in this format.
* [[SND Format (Crystal Caves)|SND Format]] - PC speaker sound effects.

The levels are stored inside the executable.

[[Category:Apogee]]
[[Category:Sidescroller]]

RTL Format

2008-03-02T16:54:42Z

Calvero: added link to the official ROTT Map Specs

{{Stub}}
This is a placeholder for the Rise of the Triad RTL format. This format is known, it just needs to be documented here.

This format is used for storing [[Rise of the Triad]] game levels.

== Related links ==

* [http://www.3drealms.com/stuff/rotspec1.zip ROTT Map Specs] A detailed explanation of the map format for ROTT, written by the developers of ROTT.

[[Category:TODO]]
[[Category:Rise of the Triad]]
[[Category:File Formats]]
[[Category:Group Files]]
[[Category:Map Files]]

ICO Format (Halloween Harry)

2008-03-02T16:47:51Z

Calvero: New page: Alien.ico consists of chunks with the following format. The image date is a standard 256 color bitmap. The palette is stored somewhere else. {|class="wikitable" !Data type!!Description |-...

Alien.ico consists of chunks with the following format. The image date is a standard 256 color bitmap. The palette is stored somewhere else.

{|class="wikitable"
!Data type!!Description
|-
|UINT16LE iWidth||Width of image
|-
|UINT16LE iHeight||Height of image
|-
|BYTE cData[iWidth * iHeight]||Image data
|-
|}

Halloween Harry

2008-03-02T16:37:54Z

Calvero: /* File formats */ ICO is not in the same format as HSB

{{Stub}}

{{GamePage}}
== File formats ==

This section lists the major file formats used in the game.

* [[BNK Format (Halloween Harry)|BNK Format]] - group files storing most of the game data (<tt>HARRY.-0</tt> is also in this format.)
* FAT Format - file allocation table used by [[BNK Format (Halloween Harry)|BNK files]]
* [[4MD Format]] - a variation on the [[MOD Format]] used for game music
* [[TOP Format (Halloween Harry)|TOP Format]] - high scores
* [[ICO Format (Halloween Harry)|ICO Format]] - graphics
* [[HSB Format (Halloween Harry)|HSB Format]] - sprites graphics
* [[CFG Format (Halloween Harry)|CFG Format]] - game configuration
* [[SLOT Format (Halloween Harry)|SLOT Format]] - saved games (<tt>SLOT.1</tt>, <tt>SLOT.2</tt>, etc.)
* <tt>HARRY*.-0</tt> are all [[EXE Format|.exe files]], except for <tt>HARRY.-0</tt> mentioned above.

== Obtaining the game ==

The full version of this game [http://www.3drealms.com/news/2007/05/alien_carnage_freeware.html has been released as freeware]. One notable omission from the freeware release was the inclusion of STUDIO.EXE, a separate 'jukebox' program that could play all the music from the game.

* Four different versions are available from [http://www.classicdosgames.com/apogee.html Classic DOS Games] (listed under "Alien Carnage")

[[Category:Apogee]]
[[Category:Sidescroller]]
[[Category:Freeware]]

EPF Format

2008-03-02T16:33:53Z

Calvero: EPF page started, needs major clean up.

Talk:Stunts

2008-03-02T16:09:55Z

Calvero: link to track format

Here's a link to the [http://jonas-baehr.de/stunts/format.php Original Stunts (4D Sports Driving) Track-Format].

SAV Format (Hocus Pocus)

2008-01-30T13:09:08Z

Calvero: /* Save Game part */ wether -> whether

Information from the shareware episode:

= File format =
The file HOCUS.SAV:

==Save Game part==
{|class="wikitable"
!Offset!!Data type!!Description
|-
|0x1E||SINT16LE valid[9]||field indicating whether the each savegame can be loaded. -1 = no 0 = yes
|-
|0x30||INT16LE level[9]||saved level of each savegame. 0 = first level. 1 = second level etc.
|-
|0x42||INT16LE difficulty[9]||difficulty of each savegame 0 = easy, 1 = moderate, 2 = hard
|-
|0x54||ASCIZ [9][26]||name of each savegame with trailing zero. (maximum 25 characters + trailing zero)
|-
|?||??||some rubbish 9 times 1 and 1 time zero. Episode number ?
|-
|0x148||INT32LE score[9]||score of each savegame.
|}
=== Example ===
Small sample program(C++) to show information about the savegames: (start like this: '''app HOCUS.SAV''')
''int assumed to be 32 bit, short to be 16 bit. Only for little endian machines.''

#include <iostream>
#include <fstream>
using namespace std;

int main(int argc, char* argv[]) {
if(argc != 2) return 1;

ifstream input(argv[1]);
input.seekg(0x1E,ios::beg);
short signed int valid[9];
input.read(reinterpret_cast<char*>(&valid),2*9);
short level[9];
input.read(reinterpret_cast<char*>(&level),2*9);
short difficulty[9];
input.read(reinterpret_cast<char*>(&difficulty),2*9);
char name[9][26];
input.read(&name[0][0],9*26);

input.seekg(0x148,ios::beg);
int score[9];
input.read(reinterpret_cast<char*>(&score),4*9);

for(int i = 0;i < 9;i++) {
cout << "save " << i+1 << " valid " << valid[i]
<< " level " << level[i] << " difficulty " << difficulty[i]
<< " name: "<< name[i] << " score " << score[i] << endl;
}
return 0;
}

==Highscore part==
{|class="wikitable"
!Offset!!Data type!!Description
|-
|0x16C||ASCIZ Name1[5][26]||Names of the people with highscores for episode 1
|-
|0x1EE||ASCIZ Name2[5][26]||Names of the people with highscores for episode 2
|-
|0x270||ASCIZ Name3[5][26]||Names of the people with highscores for episode 3
|-
|0x2F2||ASCIZ Name4[5][26]||Names of the people with highscores for episode 4
|-
|0x374||INT32LE Score[4][5]||Highscores themselves. Listed by episode.
|}

==Sound Configuration==
Stored at the bottom of the file. (less interesting as setup.exe can change those)

= Credits =
[[User:Qbix]]

Talk:CMP Format

2007-08-14T16:06:22Z

Calvero: Forgot to sign, and another link to Lon Matero's Apogee Page.

I'm pretty sure that not only Duke Nukem II, but also Cosmo's Cosmic Adventure and Major Stryker use this file format. [[User:Calvero|Calvero]] 19:22, 2 August 2007 (GMT)

:Yep, they do. Just a matter of getting around to documenting that here :-) They also share graphics and level formats, so it'll probably be a copy and paste job once one of the games has been fully documented. -- [[User:Malvineous|Malvineous]] 11:25, 11 August 2007 (GMT)

::It looks like the file format was first documented in public by someone around July 1998 on [http://web.archive.org/web/20021105125505/www.oakland.edu/~lcmatero/cosmo/cosmo8.html Lon Matero's Apogee Page]. [[User:Calvero|Calvero]]

:::Yeah, I figured it out myself around 1995 so I'll just go from memory when I document it (it's a really trivial format which is why I haven't bothered yet, you can figure it out in under a minute by just loading the file in a hex editor.) -- [[User:Malvineous|Malvineous]] 12:39, 14 August 2007 (GMT)

::::Woops, I forgot to sign my message. And [http://apogeegames.com/cosmo/cosmo8.html Lon Matero's Apogee Page - Cosmo's Cosmic Adventure] page is still available, so the Archive.org link isn't really necessary. [[User:Calvero|Calvero]] 16:06, 14 August 2007 (GMT)

Talk:CMP Format

2007-08-13T22:09:07Z

Calvero: Something for the Credits section

Talk:Zool

2007-08-02T19:25:18Z

Calvero: Zool and Lotus 3 file format similarity

I think Zool's file format is similar to that of Lotus III, because it's made by the same company.
Here's some information about the file format of Lotus III: [http://rewiki.regengedanken.de/wiki/Lotus_III:_The_Ultimate_Challenge]. [[User:Calvero|Calvero]] 19:25, 2 August 2007 (GMT)

Talk:CMP Format

2007-08-02T19:22:17Z

Calvero: DN2, CCA, MS file format

I'm pretty sure that not only Duke Nukem II, but also Cosmo's Cosmic Adventure and Major Stryker use this file format. [[User:Calvero|Calvero]] 19:22, 2 August 2007 (GMT)