KPCHECK ALPHA

KPCheck is meant to check careless mistakes and do all boring tasks for you: it can set surface & content flags depending on the texture name and also repair "mixed face contents" errors in .MAP files. Although I had no corruption issues or screw ups with tested maps (local, general and real-condition test), I'd like you to remember this program is an early ALPHA version, ALWAYS backup your files because the original input map is modified in the process, I'm not responsible for the loss of data and blah blah blah (you get the point, right?).


---- Included files ----
	KPCheck.exe			The main stuff
	KPCheck.ini			Flags naming and texture definitions (for both content and surface)
	exe0_pre.map		The original input test map
	exe0_post.map		Same as above, but after processing
	

---- Options ----
	-nonull (-n)
		Set this option if you don't want KPCHECK to replace "NULL" with "common/0_sky1".
	-nosurf (-s)
		Set this option if you don't want KPCHECK to replace surface flags you already set: when this option is enabled, KPCHECK will only set undefined surfaces.
	-zero (-z)
		If not set, KPCHECK will ignore null content flag when fixing brushes content (for instance, a cube with 5 "default content" faces a one "player_clip" face will become "player_clip" instead of "default content"). Set this option if you want KPCHECK to be able to disable special content flags over "default content".
	-verbose (-v)
		Display processing details.
	-dump (-d)
		Report additional infos such as warning in "kpcheck.log".
	-help (-h)
		Display a short list of options and usage.
	-content (-c)
		Enable brush content assignment based on texture name's (disable by default).


---- Q&A ----

		- I don't want KPCheck to mess with some critical texture, such as "0_clip" or "0_trigger"
			- Simply comment or remove the definitions for those textures in KPCHECK.INI:
			  undefined texture are ALWAYS ignored by KPCheck. To comment a line, simply put
			  a semicolon at the beginning of the line (";")

		- How do I define new textures?
			- All textures definitions must be added under the [TEXTURES] category. Each flag are
			  added one next to the other, separated by a single space. Check the lists under
			  [SURFACE] and [CONTENT] for more info.

		- Should I modify settings under [SURFACE] and [CONTENT]?
			- Nope, you shouldn't, but if you do here are a few advises: do NOT use the same name for
			  different flags. For instance, if you call two flags "water" (a "water surface" and a
			  "water content"), KPCheck will very likely confuses them. Also, if you plan to rename
			  any flag, don't forget to rename the texture settings' flags accordingly.

		- Can't make it run at all.
			- You better try and use it within Windows's command line, this program is a bit touchy with
			  pathnames and such.
			  
		- Why is this program writen in Freebasic?
			- Because it's easy to modify, code and compile (there's a free compiler somewhere around,
			  google "freebasic") AND I don't have the skills to use another language.
		
		- I found a bug or have a request!
			- Aoutch, leave a comment on Kingpin Forevers' forums or send me a mail:
			  aliasconradcoldwood@gmail.com (I know, stupid nickname) and cross your fingers.


			  
[ACC]