Pillars of Eternity

Custom Player Portraits


George Wong

Date, Revisions

Created on 28 March, 2015


This is a guide to create custom player portraits for the game Pillars of Eternity.

Document Status, Version

Version 1.0


Pillars of Eternity (Windows OS / Steam)

Adobe Photoshop

Art assets (optional)

POE Title


This is a guide to create custom player portraits for the game Pillars of Eternity (POE). I generally forget the file paths and modding processes if I don't document them so this is a reminder for myself as well as others interested in making some custom player portraits for POE. I would say this is pretty basic modding if you're not familiar with modification of game assets.

Large portrait

POE large portrait

Small portraits

My five femme fatales and one ugly NPC.
POE small portrait


So the first thing you'll need is the game POE. I'm currently using the Windows OS / Steam copy, version 1.002. Although non-DRM copies should also work. The game assets are located in your game installation directory.

Install directory

Next you need to lookup the location of your game files

For Windows/Steam:

	C:\[Where your programs are installed]\steam\steamapps\common\Pillars of Eternity

For MacOS:

	Suckers! Figure it out yourself!

Art assets

The portraits are located deep in the game directory. The male/female player portraits are in separate folders. This is where art assets need to go:

	C:\[Where your programs are installed]\steam\steamapps\common\Pillars of Eternity\PillarsOfEternity_Data\data\art\gui\portraits\player\male
	C:\[Where your programs are installed]\steam\steamapps\common\Pillars of Eternity\PillarsOfEternity_Data\data\art\gui\portraits\player\female

File names & synxtax

By default there should already be built-in player art assets in these folders. IMPORTANT: Take note of the file naming syntax as you'll need to replicate it.

art assets

Generally each player portrait consists of two image files: A small image "filename_sm.png" and a large image "filename_lg.png".

Make sure the prefix is the same for both image files. In the female example below, the prefix is designated "female_custom001" and suffix is "_sm" or "_lg".
The male examples are also shown below. The game doesn't really care what you name the prefixes as long as each set of images have the same prefix and the relevant suffix.

Image Example Syntax
Large large female_custom001_lg.png
Small small female_custom001_sm.png
Large large male_knight_lg.png
Small small male_knight_sm.png


The exact pixel dimensions are below:

Image Width Height Description
Half body or full length portrait. Use high resolution image if you don't want a blurry mess.
Headshot only.


The quickest way to create multiple custom portraits was to open two separate Adobe PSD files. Then create Photoshop macros to save the files somewhere, and rename it manually.

1. Position images with template

psd large
psd small

2. Export files with macro

psd macro

3. Rename files

rename files

Additional files

Custom player portraits PSD template (zip)

Female Fantasy Pack (zip)

back to