DO/Modding
From Dark Omen Wiki
Contents |
Modifying and Editing Dark Omen
Overview
| Name | Description | Developer | Language | Binary | Source |
|---|---|---|---|---|---|
| WARTBED | Code name for a regimental tactical real-time wargame engine, in which Bright Prospects will be implemented. | Community | C++ | ||
| Bright Portents | Code name for the Dark Omen 3D editor (and possible game engine) project. Well underway and currently capable of loading and rendering an entire Dark Omen level. Not yet publicly available. | Community | C++ |
Data Formats
Dark Omen consists of battles and campaign flow. The campaign flow is not yet understood, though we suspect it is largely hard-coded into the executable itself. The design of battles, however, is almost completely understood.
Each battle is located in its own folder under the gamedata/1pbat path. Using the first battle "B1_01" (Defending the Trading Post) as an example. the principal files are
Dark Omen battle folder principal files
| Filename | Description | Edit tools |
| B1_01.PRJ | Battleground layout file. | Mikademus' CLI Editor (PRJ section). |
| B1_01.BTB | Battle zone definitions; f.i. deployment zones and map boundaries. | Rob's BTB Editor; CLI Editor (BTB section) |
| B1_01.ARM | Army definitions. After the first battle, only the opposing side army is used. The players' is overwritten from the save file. | Both ARM and save files can be edited with Mikademus' (old) WH2EDIT and Ghabry's new Wh32Edit. |
| B1_01.SHD | Contains a heightmap with vegetation. Initially thought to be a shadow map for the terrain, now thought to be either used for path finding costs, or a useless vestigal. You can extract these as .TGA images by the "export shadow" command from the CLI Editor. | Currently not editable (no real reason to). |
| B1_01.LIT | Light sources for the map. These are only used fully when running in hardware acceleration, which in turn only works on genuine 3dfx cards under DirectX6 on Windows98, which makes them difficult to test. The data format is cracked, though. | Currently not editable (low priority, doesn't influence battles). |
| B101.CTL | Battle scripts are stored in this file. This controls events that occur in game. | Viewable in CLI Editor (CTL section) and Rob's specialised BTB Editor. |
| *.M3D | All the 3D models used for and on the map in this battle | Rob's M3D <--> 3DS converter |
| TEXTURES/*.BMP | All the textures used by the M3D models. | Use any image editor, 8 bit 256 colours only. |
Tools
Transcluded from DO/Modding/Tools
Tools for editing and modding Dark Omen currently being developed and in a more-or-less working state:
| Name | Description | Developer | Language | Binary | Source |
|---|---|---|---|---|---|
| WH2EDIT | The original army file editor, written in 1998 in Borland Pascal by Mikademus. Allows editing virtually every aspect of an army, but is relatively buggy. Supplanted by Ghabry's editor (see below). | Mikademus | Pascal | Download | - |
| Wh32Edit | The new and shiny army file editor written by Ghabry in WXWidgets/C++ and runs both under Win32 and Linux. Like WH2EDIT allows editing virtually every aspect of an army, but is relatively not buggy :). | Ghabry | C++ | Download | Download |
| CLI Editor | All of Dark Omen's data can be accessed and edited through the source base's parser classes. These include a PRJParser, BTBParser, CTLParser, SHDParser and LITParser classes. The Currenty front-end is a CLI (text mode) editor using literal expressions for commands, but the final version will be a 3D map editor (the parser classes are fully independent and decoupled from platform and front end). Allows editing most aspects of every existing map. Also includes functionality to view data of .M3D files. Developed in C++ by Mikademus. | Mikademus | C++ | - | - |
| BTB Editor | Parser and editor for the .BTB battle boundaries and special regions file format. Written in C# by Rob. | Rob | C# | Download | - |
| DOT-Editor | A program to modify the path of the dots on the overworld | Ghabry | Java | Download | Download |
| MDose SPR Editor | The original .SPR sprite file editor. Function-complete but buggy. Written in Delphi in 1998 by Mikademus. To be supplanted by Rob's C# editor. | Mikademus | Delphi | - | - |
| RDose (Rob's SPR editor) | A newer and improved editor incorporating new information about the .SPR format. Written in C# by Rob. | Rob | C# | Download | - |
| .M3D-to-Blender Model Converter | Tool to import and export DO's .M3D models to the Blender 3D editor. | Rob | Blender API (Python) | Download | Download |
| 3D Editor | 3D editor for Dark Omen levels. Currently is in alpha state, level viewing only. | Mikademus | C++ using WARTBED. |
