-------------------------------------------------------------------------------
Character Randomizer by TacoMagic
-------------------------------------------------------------------------------
Version 0.02
Release date: 06/20/2014
-------------------------------------------------------------------------------
Project state:
Alpha
-------------------------------------------------------------------------------
Legal:

State of Decay is Copyright UndeadLabs
-------------------------------------------------------------------------------
Project description:

A python tool to randomize the traits of State of Decay Characters
-------------------------------------------------------------------------------
Dependencies:

Python 3.2 or greater
-------------------------------------------------------------------------------
Documentation
-------------------------------------------------------------------------------
Installation instructions:

Copy the charrand.py file into the same directory as the characters.xml
file you want to randomize.
-------------------------------------------------------------------------------
Use:

To use, open up a command window and navigate to the folder where
charrand.py is. If not already, temporarily add your python 3.x directory
to your PATH

Use command > python charrand.py to create the randomized file based on the
output.ini file

Traits.xml:
Traits XML is organized into several groups which exist under the "Traits" root
Groups are rolled one at a time based on the following criteria found within
the group attributes:
Min: This is the minimum number of traits that will be assigned from the group
Max: This is the maximum number of traits that will be assinged from the group
Percent: This is the percentage that after each trait is added, another will be
added. If 100, a random number of traits between min and max will be rolled.


For instance, the default Min:2 Max:5 Percent:100 will roll a random number
between 2 and 5 and assign that many stats from the group.

An alternate setup would be Min:0 Max:1 Percent: 50. This would give a 50%
chance of assigning 1 skill from the group.

A stranger setup would be Min:2 Max:5 Percent:50. In this case 2 traits are
assigned from the group, then there is a 50% chance that a 3rd trait is
assigned. If that happens, there is a 50% chance that a 4th trait is assigned.
If that happens, there is a 50% chance that a 5th trait is assinged.

Essentially, this weights the odds of a certain number of skills. In this case
3+ skills happen at least 50% of the time, 4+ traits happen 25% of the time, and
5 skills happen 12% of the time.

characters_rand.xml
This XML will need to be comverted into a .win.bmd file. You can get it here:
http://rghost.ru/51370738

The resulting file will need to be renamed to characters.win.bmd

Credit to dude1234 for the XML2BMD.exe program

-------------------------------------------------------------------------------
Additional Notes:

Output.ini contains settings the tool uses for determining randomization. See
the file for more information

Traits.xml contains a list of all the traits the random generator picks from.
Currently this is all Story, Personality, Job, Hobby, and Tallent groups.

This file was constructed from Breakdown, so it may not work in Story or
Lifeline.

-------------------------------------------------------------------------------
Comming in Version 0.03:

Add support for SilentResident style "Stay at home"
Cleanup of XML file to be pretty

-------------------------------------------------------------------------------
Comming eventually:

Add an ability to cap the maximum number of traits that a person is assigned
Detect traits that do the exact same thing and reroll them
Randomization of inventories
Compile to an exe for easy windows integration
Other weighting options
More traits and a way to inject them into characters.xml

-------------------------------------------------------------------------------
Current issues:

Output xml files are missing the XML version and encoding header and the output
is not properly indented. These are aesthetic only and do not prevent the new
character file from working.

===============================================================================
Changelog:

V0.01
-First Version

V0.02
-Changed traits list file to be an XML
-Support for trait groups were added
-Groups support minimum, maximum, and percent settings