Portrait Specification Framework

If you liked this item, please rate it up on Steam Workshop page.

Author: Android

Last revision: 3 Sep, 2025 at 14:13 UTC (1)

File size: 608.64 KB

On Steam Workshop

Description:

This mod is a framework which extends the ability to specify portraits for individual NPCs based on any combination of Category, Gender, Race, Job, CardID, and age range
You no longer have to see warriors that look like wizards if you don’t want to
This mod also allows you to reroll non-unique character portraits via a talk option if enabled in the config
This is a framework mod, it does not come with a portrait pack and must be linked to existing packs using the in-game UI, or use modpacks which have specially edited filenames

Press ESCAPE, mouse over TOOL, and then click PORTRAIT TOOLS:
How to use:
Portrait Picker Tab

On the top, you can use the two buttons to re-roll the entire map, or the currently selected single portrait
The left side of the screen shows all of the NPCs present on the current map (you can scroll down to see more)
The right side shows all portraits currently loaded into the game

Select an NPC on the left, and then click on a portrait on the right to change its portrait

Portrait Pool Links Tab

At the top is the mod filter, this will determine which portraits are shown based on the selected mod

After loading the game at least twice use the "Portrait Specification Framework Local Settings" Mod to have custom, mod independent settings which aren’t erased by steam with every update

The deselect all button will clear the current portrait selection
On the left side is the list of all portraits loaded by the selected mod, you can click multiple portraits to select sets of them, and click a portrait again to deselect it
On the right are the filters which specify what NPCs this portrait should apply to
The default options are to include the portrait selection for all possible NPCs, this is hardly desirable, filter accordingly

Once satisfied with your filter and portrait selection, click "Add selection to pool"
this will create/add to a pool corresponding to the filter, and now all NPCS matching that filter will have a chance at getting one of the selected portraits

IMPORTANT

: filters are additive, if you have a set of portraits for any eulderna, and a set of portraits for any female, a female eulderna will have a chance to pull a portrait from both of those sets

Once satisfied with your pools, you can save them to file to preserve them for next game load
this will save a PSFLinks.json file into the mod’s directory (workshop or local), and in the case of "vanilla" it will save it into the root directory (where the Elin.exe is)
this file will be loaded automatically next boot, saving your progress
saving multiple times overwrites the file
deleting the file resets work to 0 if you need a nuclear option

Settings

Enable "Reroll Portrait" option, adds a dialog option to reroll an NPCs portrait randomly
Enable vanilla portraits: if you have enough portraits for all possible NPCS, you can turn this off to disable vanilla portraits (they are not very precise atm, i will possibly make better links later)

Changelog:
V0.9

Now can tag portraits by minimum and maximum age
Features should now be significantly easier to add
Stale links where no portraits exist on disk, no longer result in a sprite being assigned and instead fallback to vanilla
Added ability to save local settings into an automatically generated mod so they don’t get wiped out by steam every update
Added ability to add links without a portrait folder to make creation of link only mods easier/allow local links that don’t get wiped

Future Work

Add ability to reroll/specify PCCs

Framework compatible AI generated portraits kindly donated by datse

https://mega.nz/folder/twYiETQR#g_QWftX2Cnck-qi7P5NOLw/folder/s0xCCQQR

Data Dumps for IDs

lists of ids for jobs, races, and cards are available at the following url:
https://mega.nz/folder/0tpkWRaK#zvBNDhNa974WR1JyE2GP2Q

Download
Required items:

Click the title to search on this site.


YK FrameworkSteam Workshop
Revisions:

Old revisions of this mod are available below. Click the link to download.