Adding New Icons

From Divinity Engine Wiki
Jump to: navigation, search

Adding new icons requires a bit of preparation, but once the initial setup is complete, adding additional icons is quick and easy.

Preparing Your Icon Images

  1. Save your individual icons in a size and format supported by the Texture Atlas Editor.
    1. Support sizes are 16x16, 32x32, 64x64, 128x128, 256x256.
    2. Supported formats are .png, .tga, and .dds.
  2. Place your images in a directory you'll have easy access to later.
  3. In the Resource Manager, create a package to add your texture atlas/icons to later (click the Add Package button, next to the Add and Remove Folder buttons, in the upper-left of the Resource Editor and name it however you like).
Using the resource manager.

Preparing the Texture Atlas file:

  1. Open the Texture Atlas Editor.
  2. Click File -> New.
  3. Select "Public/MyModName_GUID/GUI" as the location for your .lsx file (create the GUI folder if it doesn't exist).
  4. Create a name for your texture file (something like, and select an ideal location inside your mod's Assets folder (i.e. "Data/Public/MyModName_GUID/Assets/Textures").
  5. Select the size of the individual icons (for skills: 64x64) and the size of the image.
  6. Select the package you created previously, then click Save.
  7. The Texture Atlas Editor should create a blank texture (.dds) file at the path specified previously.

Adding Atlas Entries:

  1. Go to Edit -> Add Entries, or simply click the 'Add Entries' button (next to the Remove Entries X button) in the upper-left of the Texture Atlas Editor.
  2. Navigate to where you placed your individual icon images (anywhere on your computer).
  3. Select your icon and add it (repeat as needed). All of the new icon entries should be automatically added to your texture file.
  4. Save.
Multiple atlas entries may be added at once.


  • This same process can be used to add custom portraits (recommended size: 80px wide by 100px tall).
  • The icon names you use are the entry names in your texture atlas sheet. Within the texture atlas editor, you can right click on an entry and select "Copy name to clipboard" to make the process easier.
  • Skills and statuses are assigned icons in the stats editor (there's a column specifically for the icon name). Root templates can also be assigned an icon.


Texture files can be manually packed and created. Possible software for doing that is: