Home

Welcome to the Purlovia!

This page tries to be a basic description of how to get started using Purlovia.

Getting Purlovia's livedata installed

This will install the server version of the game and any configured mods into Purlovia's livedata/game folder.

If you need to conserve disk space then comment out some of the entries in the [mods] section of config/config.ini before-hand.

> python -m automate sanity,asb

(this may take over an hour, depending on download speeds, size of mods enabled, etc)

On completion you will find the output directory contains the data extracted for ASB. Other extraction stages exist for the wiki, such as wiki.items but including them all with extend the run time considerably (due to the maps and spawn region stages). See python -m automate --list-stages for a full list.

For future runs you can add --skip-install to avoid updating Ark and its mods for a significantly speed up.

Inspecting an asset

This will open up a GUI showing the internal data tree of an asset:

> python browseasset.py Game/PrimalEarth/CoreBlueprints/Items/Consumables/PrimalItemConsumable_Berry_Mejoberry

In most cases the interesting data is in the exports section with a name beginning with Default__.

Check the inheritance of an asset

The uegrep.py tool can be used for a few things but the most useful is inspecting the inheritance chain of an asset. To find all parents of an asset:

> python uegrep.py --parents Game/PrimalEarth/CoreBlueprints/Items/Consumables/PrimalItemConsumable_Berry_Mejoberry

To find other items that inherit from your asset:

> python uegrep.py --subs Game/PrimalEarth/CoreBlueprints/Items/Consumables/BaseBPs/PrimalItemConsumable_Berry_Base

Run the interactive prompt

If you have ipython installed globally you can use the interactive prompt as a very convenient way to explore and experiment with asset data.

> pipenv run i
>>> gather_properties(loader['/Game/PrimalEarth/Dinos/Dodo/Dodo_Character__BP']).DescriptiveName[0]
'Dodo'