ModKeen

From KeenWiki
Jump to: navigation, search
Viva
ModKeen
File:ModKeen.png
There is no picture of this program's main window or product logo - upload one!
Original developerAndrew Durdin
Current maintainerShadow Master (?)
Last stable release2.0.1
Last preview releaseLModKeen 2a
OSDOS (DPMI), Win32, GNU/Linux
LicenseBSD-style
WebsiteKeen: Modding forums

ModKeen is a Keen graphics importing/exporting utility written by Andrew Durdin. Each version has been released under the terms of the GNU General Public License (GPL). The official releases are written for the DOS platform, using the DOS 32-bit Protected Mode programming Interface (DPMI).

Its first version, 1.0, was an enhancement of the earlier ModLatch utility by Andrew Durdin. This first version was capable of importing and exporting Keen 1–3 graphics, including the tileset bitmap, all the sprite animation frames, and miscellaneous bitmaps used by the engine, including the character set. All those are exported to the Windows Bitmap (BMP) format.

Its second version, ModKeen 2.0, released in March 2004, added functionality for Keen 4–6 graphics and miscellaneous data importing/exporting. A revision, ModKeen 2.0.1, was released at the end of the same month, fixing several bugs in the Keen 1–3 data manipulation routines. Later, a unofficial revision with the same version number was released by MultiMania in January 2005, adding support for Keen Dreams graphics and data importing/exporting. [1]

An unofficial Win32 port of ModKeen version 1.0 was released in March 2006 by z-1. [2]

LModKeen running in a Linux console.

In March 13, 2007, Shadow Master released the first version of LModKeen, also known as LModKeen I, which is his unofficial ModKeen 2.0.1 port for GNU/Linux. The port added only one new feature (also called by him a "workaround"), which was the -nowait command line parameter. The application uses the ncurses library for console input/output operations.

Several days later, he released the first beta to LModKeen II, which integrated Fin2Bmp code in the Keen 1–3 importing/exporting routines. It also included Keen Dreams importing/exporting code written by MultiMania, although not working. The second beta was the first to actually use the Fin2Bmp code when importing and exporting to and from Keens 1–3.

Using Modkeen

To use Modkeen 2.0.1, unzip the files into the directory where your Keen files are located. You will then need to UNLZEXE the Keen executable you wish to mod (to do this, drag and drop the Keen executable onto unlzexe.exe). You will likely want a folder to keep the graphic files separate from the game files; create a folder and title it 'graphics'. You will then need to navigate to the folder with the command prompt.

To export graphics, type: modkeen -episode=X -export -bmpdir="graphics".

To import graphics, type: modkeen -episode=X -import -bmpdir="graphics".

Note: X is the episode number of the original Keen game you want to edit. For Keen Dreams editing, the number is 7.

for extracting and re-importing graphics

See Also

  • KeenGraph for extracting and reimporting graphics
  • KeenGrout for adding/removing a grid to the Keen graphics tileset

References

  1. Modkeen 2.0.1 Keen Dreams Edition on Keen Modding Forum
  2. A 32-bit version of ModKeen on Keen Modding forum

External links