Wolfling Monitor V1.03 by Tina Hirsch

 * Copyright (C) 2000 by Tina Hirsch
 *
 * Please don't make it available for download without my permission.
 * However you may give a copy to any friend, provided that the above copyright 
 * notice appears unchanged in all copies and that both the above copyright notice and 
 * this permission notice appear also unchanged in supporting documentation.
 * This software is made available "as is", and
 * I DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD TO THIS SOFTWARE, 
 * INCLUDING WITHOUT LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND 
 * FITNESS FOR A PARTICULAR PURPOSE, AND IN NO EVENT SHALL I BE LIABLE FOR ANY SPECIAL,
 * INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT
 * (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN CONNECTION
 * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.


Latest Changes:
Added now *real* Docking Station compability. See Functions for more details.
Changed the catalogue files. If you have a previous version installed please read
the installation carefully!

Installation:
With a previous version of Wolfmon installed:
1. Start the game(s) and remove the agents with the remove buttons on the creators.
2. Quit the game(s).
3. Remove the wolfmon*.catalogue files in every Catalogue directory.
4. If you want to use the same chemical classes for every world remove all
   wolfmon.ini files (See 'chemical classes' in functions and the rest of the
   installation for more details).
5. Follow the usual installation.

Usual installation:
The wolfmon.ini file is not necessary to use the full functionality of this agent!
However if you want to tweak the chemical classes for a special world then place
the wolfmon.ini file in the journal directory of this world and change the values.
The other worlds will still use the values from the catalogue file. (see below under
'chemical classes' in functions for more information about these values)


Place the wolfmon.agents file in 'My Agents' folder of
1. C3 if C3 and DS installed 
         or, of course, C3 only
2. DS if DS only is installed

For Linux users:
The same as above but the 'My Agents' folder in the installation directory if
you want that every user has access to the agent or .dockingstation respectively
.creatures3 if just for you.


!!!Attention!!!: If you are playing DS - no matter whether docked or not - NEVER
inject the C3 version of Wolfmon, i. e. choose the one named 
Wolfling Monitor V1.03 DS!!!!!!!!!!!!!


Description:
Prints statistics about your creatures into wolfmon.html in the current
worlds journal directory and exports creatures only with some adjustments.
The export function is fully compatible with the DS one, i. e. you are 
able to reimport those creatures *without* cloning.


Functions:
You can enter 15 different chemicals by number in the outer circle to 
monitor their concentration percentage in the creatures blood stream. 
The chemicals name are displayed below 'Chemicals'. Type '0' to delete 
a certain chemical of monitoring.

If export and/or statistic is activated unnamed Creatures will be named
as followed: GenusGenerationGenderBirthtime, f.e. N010F01h24m for a female
10th generation Norn born at 1:24 o'clock

If the maximum number of norns (for a C3 only world) or the 
population limit (not breeding limit!) (in a docked/undocked DS world)
is reached, extremely slow aging, olds and ancients and creatures with 
less than 10% of AIR and ATP will be exported first. If there are none 
of these, creatures older than 2.5h will be exported until 2/3 remain. 

Additional to the max. number are four ettins/grendels allowed to live
in a C3 only world. 
In DS worlds the max. number sets the breeding limit and the 
population limit is set to ten more. If you want to use this function
make sure that you first set the breeding limit in the options menu of 
DS to the desired value AND the population limit to ten more and *after* 
that change the value in the Wolfling Monitor. This is necessary since
I don't want to change the script of a foreign agent.
Type '0' to switch off this export function.

Each chemical percentage will be converted in points by a different 
weighting. 
There are five classes : Really good			5
			 Good				4
			 Nor good nor bad or both	3
			 Bad				2
			 Really bad			1
1: percentage counts twice, 2: percentage counts once, 3: no count, 
4: 100% minus percentage once, 5: (100% - percentage)*2 

A little example:
Let's say a creature has 60% Starch, 60% Histamin A and 60% Antigen 5
in its bloodstream. Starch has class 4, Histamin A 3 and Antigen 5 1.
Calculation of the points: Starch: 100-60=40; Histamin A: 0;
Antigen 5: 60*2=120. (Total points: 40+0+120=160)
This means your creatures is a rather good starch eater, but could
be better, Histamin A is actually neither good nor bad (or both) for it
and it got infected with real nasty Antigen 5.

I used the list from CDN but if you want to change something just 
change the number under the chemical-number in the wolfmon.ini.

The more points the worse for your creatures. 
If chemicalpoints are over the given value the creature 
will be exported.

Creatures older than the given amount of minutes will be exported.


Genus: Only export (n)orns or (g)rendels or (e)ttins.


Before using export with chemicalpoints please make some statistics
that you have a guideline.

Creatures won't be exported if
- there are two or less of this gender
- female is pregnant
- if the creature, or if pregnant any of its offspring, is already
  on disk in some form (standard from the game)



Reporting bugs, other problems or suggestions?
Please email tehirsch@nexgo.de

For updates look at http://home.nexgo.de/tehirsch/c3

