CreaturesGenealogyGraph

A genealogy mapper for Creatures 3 / Docking station!

What is this?

This is a set of in-game and OS-terminal scripts to visualize the ancestry of your creatures like so!

Things get much more interesting for longer-running worlds, especially those that export/import creatures or use the warp regularly;

So many colors and shapes!

• Blue, double-circle shapes with names are creatures that are currently alive (and active) in your world!
• Gray, regular-circle shapes with names are the ancestors of those living creatures
• White, regular-circles: Creatures who have passed, but do not have any living descendants
• White, regular-circles (with gray font): Creatures who have passed, but never had any offspring
• Polygons: creatures who are referenced only by their offspring. Typically the genetic ancestor or custom genetic files (eg: dave.gen)
• If a creature's name is colored green on the left, that means it warped in from another world

Poaditucna here stumbled upon this world, and despite her passing, her lineage is still going!

Kialryrfoy here is thriving in this new world, even finding love and having a kid!

• If a creature's name is colored peach on the right, that means it was exported or warped out from the world.

Xoasbacyzu, on the other hand, took a look around, found all this quite silly and strange, and left for new horizons back through the warp

Yaasutbof, an engineered norn of the great dave.gen, found a deep sense of wanderlust, and went to explore the Warp, leaving little behind

Install & Use

0. Make sure you have Python 3 and GraphViz installed
1. Move the Quick_Genealogy.cos file into your \Docking Station\Bootstrap folder or \Creatures 3\Bootstrap folder. a. If you want the script to auto-run every two hours, add the Quick_GenealogyAgent.cos file to
2. Copy the family_tree.py into a folder of your choice
3. Start the world you want a genealogy map of.
4. Select a norn, and open up the script console with CTRL+SHIFT+C
5. Type in ject "Quick_Genealogy.cos" 4
6. The new genealogy file is now generated in the My Worlds\{WorldName}\Journal\{WorldName}.genealogy. Copy this file into where you placed the family_tree.py file.
7. In your console of choice, run python family_tree.py {WorldName}.genealogy, and a new SVG file will be created and run a. In the case you have multiple python installations in Windows, you may need to use py -3.11 family_tree.py {WorldName}.genealogy

The files

Quick_Genealogy.cos

This is the meat of this project; a file that iterates through creature life history, and outputs into a file that can be read and visually mapped. The

Quick_GenealogyAgent.cos

An agent that can be injected into your world to auto-run the same Quick Genealogy exporter, but with a _{datetime} suffix in the file name. This is done to preserve data otherwise purged by the game after a number of generations. All credit to this and the Quick_Genealogy code goes to Verm on the Norn Nebula discord

family_tree.py

This converts the outpute .genealogy files to .dot and .SVG using GraphViz. For now, this is just the MVP/POC of this project, but will likely be maintained/tweaked periodically.