Portrait Mod Builder 0.0.4

Portrait Mod Builder

Requires ability to run shell scripts

Windows 10:

Linux or Mac:
You may need to make the scripts executable with chmod +x

Usage:

1. Create new mod with PDX launcher.
2. Run run.sh with the location of the mod as an argument.
   • e.g. 

     ./run.sh  /mnt/c/Users/<USER NAME>/Documents/Paradox\ Interactive/Stellaris/mod/my_new_portrait_mod

      

3. Select option 1 to create the basic directory structure.
4. Select option 2 and set the name and species class for each portrait you intend to create.
   • Name will be sanitised (lowercase, non-alphanumeric converted to underscores) to prevent issues.
   • Directory structures will be created for each portrait.
   • Portrait names ending with "_anim" will generate animated portrait phenotypes that require further editing.
5. Fill the directories below with portrait textures (dxt5, no mipmaps, 420x320 for static portraits).

   Tier 1 - always appears:
   /gfx/models/portraits/<PORTRAIT NAME> - Non-gendered or no dimorphism, will always appear e.g. Robots
   
   Tier 2 - gendered:
   /gfx/models/portraits/<PORTRAIT NAME>/masc - Masculine body
   /gfx/models/portraits/<PORTRAIT NAME>/fem - Feminine body
   /gfx/models/portraits/<PORTRAIT NAME>/andro - Androgynous body
   
   Tier 3 - sexed:
   /gfx/models/portraits/<PORTRAIT NAME>/masc/male - Masculine male
   /gfx/models/portraits/<PORTRAIT NAME>/masc/female - Masculine female
   /gfx/models/portraits/<PORTRAIT NAME>/masc/herm - Masculine hermaphrodite
   /gfx/models/portraits/<PORTRAIT NAME>/fem/male - Feminine male
   /gfx/models/portraits/<PORTRAIT NAME>/fem/female - Feminine female
   /gfx/models/portraits/<PORTRAIT NAME>/fem/herm - Feminine hermaphrodite
   /gfx/models/portraits/<PORTRAIT NAME>/andro/male - Androgynous male
   /gfx/models/portraits/<PORTRAIT NAME>/andro/female - Androgynous female
   /gfx/models/portraits/<PORTRAIT NAME>/andro/herm - Androgynous hermaphrodite

   • Name is not important.
   • Having textures present in all directories of an entire tier is recommended.
6. Select option 3 to generate portrait code based on detected textures.
   • Generated code:
     • Scripted triggers
     • Portrait Categories and Sets ("Other" setting will need manual renaming)
     • Phenotypes (animated portraits will need manual editing)
     • Portrait groups
   • Scripted triggers behave differently depending on whether tier 3 is filled:
     • If tier 3 is not filled, special triggers overwritten by other mods will affect tier 2
     • If tier 3 is filled, special triggers overwritten by other mods will not affect tier 2 behaviour but instead affect tier 3