SD-UnitXP 1.00
by Stone-D ( Laga Mahesa )
For Civilization IV
Compatibility : 1.00+
Data Source   : 1.09
New Game Req  : NO
Requires      : sdToolKit 1.22+ (1.22 is included)


Introduction
=-=-=-=-=-=-=
So what is this then?

First, this began life as SD-StackXP, which is probably not going to be updated anymore. This combination mod serves the same purpose, plus more.

Initially, I started this because I found myself micromanaging unit stacks. I'd monitor who's got the least experience and try to focus on that unit in combat. Sometimes I would forfeit a higher level unit's combat round so that he wouldn't get too far ahead with XP.

This mod does away with that. At the end of a combat round, the winner's experience is shared with other units of the same type who have lower experience.

Additionally, and possibly of more interest to you, is that upgraded units are no longer set to 10 XP - they keep their original experience.

Note that some battles will be a bit harder as a result of all this.

Some of you will no doubt hate one of these features. Because of this, I have provided two switches. You can find them near the top of sdUnitXP.py - open it with notepad.

These are what are called 'Boolean' values - they are either True or False.


bUpgradeXP     = Default is True. Protect your upgraded units' experience levels. Set to 'False' in order to disable.
bShareXP       = Default is True. Share the combat round winner's XP with the lower rank plebians.  Set to 'False' in order to disable.


History
=-=-=-=

v1.00 - Initial Release, name change from SD-StackXP.


About sdToolKit
=-=-=-=-=-=-=-=
sdToolKit is a python module I developed which contains a number of functions that are commonly used, in particular a method of saving a mod's data to a savegame without compromising the data belonging to other mods.

One minor feature is an enhanced logging tool which can output debug data to the usual pythondbg.log file AND to the screen. These functions can be toggled by editing sdToolKit.py and finding the following section near the top :


################# BASIC UTILITIES ###################
def sdEcho(echoString):
	printToScr = True
	printToLog = True
	message = "%s" %(echoString)
	if (printToScr):
		CyInterface().addImmediateMessage(message,"")
	if (printToLog):
		CvUtil.pyPrint(message)
	return 0


printToScr : Set to FALSE to disable on-screen logging.
printToLog : Set to FALSE to disable pythondbg.log logging.


Compatibility
=-=-=-=-=-=-=
This mod, on its own, should be compatible with all versions of Civilization IV, up to and including version 1.09. As it features python elements, I cannot guarantee compatibility with future versions.

This mod stores data in the savegame. It is fully compatible with other mods that do the same, but only if they are also using sdToolKit for their saving routines.


Merging with existing MODs
=-=-=-=-=-=-=-=-=-=-=-=-=-=
Wanna use this data in your MOD? Credit me prominently in your docs and any internal credit screens, that's it.

If you're a newbie (no offense intended) end user and want to mix and match various mods, I strongly suggest that you first download and install WinMerge. Find it on Sourceforge.net.


Contacting Me
=-=-=-=-=-=-=
Contact me at :  laga@tbi.co.id

I also have email addresses at yahoo, hotmail and gmail under the user lmahesa. However, I rarely remember to check them, so be prepared for a reply well after you've solved your issues yourself or no replies at all.

Also I occasionally dabble in the dark arts of Internet chatting. Usually Yahoo or MSN, mostly Yahoo.

Note though, I don't even vaguely understand German, Russian, Polynesian or Hindustani, so contact me in English please.  :)

Or Indonesian.  =|;'D


The Obligatory Disclaimer
=-=-=-=-=-=-=-=-=-=-=-=-=
Life being what it is at the moment for me, something is bound to happen. So :

You downloaded this.  You opened the zip.  You extracted the files.

You, and you alone are responsible.

If anything goes wrong, please tell me but in no way can you possibly consider me responsible.

I'm not MacDonalds you know.  ;)

Nor, for that matter, am I American, so you can't summarily sue me for ruining your gaming session. Nerrr!
