________________________________________________________________________________

                                necropolis
                             city of the dead
                                v 09.06.06

                         a gta iv mod by veaudaux
                            veaudaux@gmail.com


===============================FOR END USERS====================================

INSTALLATION:
Copy the following 8 Necropolis lua scripts into your \GTAIV\Alice folder:
	necropolis-car.lua
	necropolis-main.lua
	necropolis-amb.lua
	necropolis-police.lua
	necropolis-scriptkill.lua
	necropolis-mission.lua
	necropolis-nofly.lua

necropolis-car2.lua.disabled is included. It seems to cause crashes, which is
why it's disabled. If you'd like to try playing with it on, just rename it to

	necropolis-car2.lua


GAMEPLAY:
The islands of Liberty City are under quarantine. Anyone caught attempting to
leave the islands will be executed on sight. Use boats or helicopters at your
own risk. In addition to the zombie hordes, there are some additional challenges
to face. The gun stores are closed and most of the weapons, armor, and med kits
scattered around the city have already been taken by evacuating citizens. And
I'll promise you the Burger Shot employees haven't stuck around. You'll have to
make do with a limited arsenal, and less options for restoring your health.
However, a safe house stay will refill your ammo and some of your health.

There is a rudimentary set of missions, that alternate between gathering
supplies and searching for other survivors. The survivors you rescue will
accompany you as body guards, and a few of them even have special abilities
that can help you (for instance, the mechanic will repair your car during
safe house stays).

NOTES:
I don't particularly recommend running other mods alongside this one. They might
work, but I won't be able to offer any help if there's conflicts.


UNINSTALLATION:
This modification is entirely non-destructive. All you need to do to uninstall
it is to remove the previously listed lua files.



=================================FOR DEVELOPERS=================================

What's not done:
	- I'd like the zombies to look more dead. This could probably be
	  accomplished through the visible damage natives that makes players
	  look bloody when they're shot, but I haven't figured it out.
	- Zombies don't box. I'd prefer if they used different animations, but
	  even if I could find some suitable in the game files, I can't seem
	  to figure out how to set/limit combat animations.
	- Occasionally, even with GET_GROUND_Z_FOR_3D_COORDS, zombies spawn
	  too high/too low. If someone knows a better method, let me know!
	- Sometimes zombies fight eachother, sometimes they "run" (hobble) away
	  from the player. 80% of the time they work fine.
	- I'd like the burnt-out husks from necropolis-car to not be immovable
	  walls. Unfortunately, if I turn off FREEZE_OBJECT_POSITION, they start
	  falling through the ground.
	- WHY THE HELL DOES NECROPOLIS-CAR2 CRASH THE GAME SOMETIMES?!
	- If there's a way to turn the lights off around the city without
	  editing the game files, I'm all ears.
	- The prison door doesn't open right - it clips the wall.

	- MORE ZOMBIES. I've set a hard limit of 30, which would be plenty,
	  except most of the time it can't spawn fast enough to make that many.
	  However, I think that's related to:
	- OPTIMIZATION, OPTIMIZATION, OPTIMIZATION. I've coded everything to run
	  as quickly as I can, but with something this complex and so many Alice
	  scripts running at once, it's slooooow sometimes (there's a good 5-10
	  seconds sometimes before it realizes you're at the safehouse door or
	  standing next to a survivor). 

________________________________________________________________________________