DARK CRAWLER version 1.3
========================
Last update: 2020/07/31


0. WTF
------
Dark Crawler is one screen level labyrinth game, done in ASCII "graphics".
You can run it with the following command line options:
  /nologo      - don't show LastofAvari logo on start
  /nosound     - mute all sound effects
  /li:filename - load a custom level index file

You'll need a DOS compatible PC or emulator like DOSBOX to run it.
286/12 AT with 640k of memory and VGA graphics adapter should be enough.
I would be thankfull for testing this game on the real DOS-capable hardware.

1. WHAT'S NEW
-------------
+ UI/GAMEPLAY: Simple top score value replaced with the new top score table
  that stores 10 records of both points and player names.
* LEVELS: Level size expanded from 20 to 22 lines.
* LEVELS: All 16 levels are rewritten to better utilize larger playable area.
* UI: Statbar rearranged to make more space for the levels.
+ UI: New menu system instead of simple title screen.
+ UI: Added frames for end level extra bonus information and player name input.

+ new feature    * change    x bug fix

2. HOW
------
To pass through the level you should collect all the stars "*". Some stars can
be locked behind doors "D", which can be unlocked with keys "k", scattered
across the level. Proceed to the next level by going through the level exit "L"
when you will acquire all the stars. The player can destroy barriers "~" by
smashing into them. Enemy, chasing the player, is also able to destroy barrier
blocks. Coins "$" will raise your score, but they are entirely optional.
Bumping into traps "%" and enemies "&" is lethal and costs 1 life.

The enemy has 2 movement behaviours:
  * scouting when the player is out of reach
  * the hunt when the player is close enough

During gameplay use [ESC] to go back to the title and [R] to restart the level
for one life.

The game ends with either you successfully completing all the levels or wasting
all your lives. If you have enough points to enter the top score table, you'll
be asked to enter your name, with its length being  up to 16 charcters (Aa-Zz,
0-9, space) long.

3. LEVELS
---------
"DCLEVELS.LI" is a level index file, which sets the amount of levels to load
and stores their file names and paths. DCL files are Dark Crawler levels
themselves.

Each level file includes:
  * Level world data (22 lines x 40 characters in quotation marks).
  * Level name (up to about 25 characters).
  * Start coordinates for the player (Y, X).
  * Start coordinates for the enemy (Y, X).
  * Number of stars, required to pass through the level exit.

4. FEEDBACK
-----------
You can send your feedback as well as you own levels for the game to
lastofavari@lastofavari.com, mark your letter with "DARK CRAWLER // User
levels". Use "DARK CRAWLER // Suggestions" subject for you suggestions.

5. DISTRIBUTION
---------------
You may freely distribute this version of the game, considering:
 * you'll keep all files unmodified in the package
 * you'll link my website https://www.lastofavari.com and YouTube channel
   https://www.youtube.com/lastofavari

The source code is available under the terms of CC-BY-SA 4.0 license.
Read the full terms here - https://creativecommons.org/licenses/by-sa/4.0/

BMP Image Reader code used w/ the permission from Pete's QBASIC/QuickBasic Site 
http://petesqbsite.com/sections/tutorials/tuts/loading_bmps.html

Eugene "LastofAvari"
2020/07/31