------------------------------------------------------------------------------- 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