=============
Smooth Keen 1
=============

A Keen Day 2026 hack by MultiMania.

What is it?
-----------

A modified version of Commander Keen 1 (Marooned on Mars) with the framerate
jacked right up to maximum! Play Keen at 70 FPS, not 24! Experience a large
number of strange bugs. Enjoy some smooth VGA palette fades. Have your muscle
memory betray you!

How was is made?
----------------

It's based off K1n9_Duk3's keensource123 decompilation, with the 'MINTICS'
variable in KEENDEF.H modified. A few other minor changes were then made,
including:
- All of the recommended changes to build it with Borland C++ 3
- A number of small physics changes to make Keen's jump and pogo height more
  consistent with the original game.
- Better framerate-independence for the world map movement.
- A fix for the behaviour of doors, in order to make them less flickery.
- VGA palette fading.

That being said, the new physics is not identical to the old physics, and there
are several things which may move further, or faster, or slower, or differently.

Also unchanged is the VBlank handling. Maybe CRT Terminator support will come in
the next version.

Changelog:
----------

2026-03-28:
 - Rebase on top of latest keensource123
 - Include Keen 2 & 3 binaries

2026-03-14:
- Keen Day 2026: Initial Release

Special Thanks
--------------

This couldn't have been done without K1n9_Duk3's decompilation work:
https://pckf.com/viewtopic.php?t=18248

I just did some quick hacks to it.
Also thanks to the following patches, which paved the way:
- adurdin's "Keen won't 'bounce' off doors" patch:
	https://keenmodding.org/viewtopic.php?t=447
- lemm's original "Change framerate" patch:
	https://keenmodding.org/viewtopic.php?t=1319
- Dr Kylstein's palette patch:
	https://keenmodding.org/viewtopic.php?t=1376

And also some inspiration from the Foray in the Forest palette code, again by
K1n9_Duk3, and Chocolate Keen, by NY00123 and lemm. Thanks all!

Extra Special Thanks must also go to the whole original crew at id and Apogee
who brought us the game. Thanks all!

Now go play Commander Keen!
