Game icons: The inkatlas file
Apart has prepared a reference project with an import-ready inkatlas. You can download it here.
This page explains the .inkatlas
file and its logic.
Wait, this is not what I want!
Learn how to make Your own inventory preview icons
Make a custom Atelier icon
Find templates (by Apart) in the wiki github's file section
Make your own inkatlas with Python: find the script on The Magnificent Doctor Presto's github. Check Running Python Scripts if you don't know how to use this.
Make your own inkatlas with Photoshop CC (Adobe Creative Suite required): find the plugin on deadlymustard's github
Summary
The .inkatlas is a map file that slices textures into sprites (slots), which are then used by the game for pretty much everything that is a picture - from your HUD to peoples' phone avatars to item preview icons in shops or custom atelier images.
Unlike other games, Inkatlas files don't slice by pixel coordinates but by percentage as a float value between 0 and 1 . The starting point is the TOPLEFT corner, the ending point is the BOTTOMRIGHT corner.
Each slot (inkTextureAtlasMapper
) has four coordinates. This is a single slot across the entire inkatlas:
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FGkCcHmlsn1BEm7tDgOcj%252Finkatlas_coordinates.png%3Falt%3Dmedia%26token%3Dc7004d58-72ad-40ab-9225-c8ba956cc447&width=768&dpr=4&quality=100&sign=5485401c&sv=1)
For example: two sprites in column will be written as: (y 0,5; x 0) X (x 1; y 0) for upper sprite and (y 1; x0) X (x 1; y 0,5) for lower
inkTextureSlot
s
inkTextureSlot
sEach inkatlasa has three different inkTextureSlots, which support different texture resolutions. For the purpose of modding, it is enough if you work with inkTextureSlot 0 (the first one in the list).
If an existing xbm is hooked up, the Part Mapping
tab will appear, where you can check which parts of your image correspond to each slot name.
As of Wolvenkit 8.11.1, this requires reopening the file.
Inkatlas: Slot names
You target sprites (slots in the inkatlas) via the atlasPartName
property:
Any atlasPartName in the yaml
must correspond with the name of a part in the inkTextureAtlasMapper. If the corresponding entry can't be found, an empty icon will be displayed.
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FldOcPF9d2utlbwgpgHyL%252Finkatlas_slot_names.png%3Falt%3Dmedia%26token%3D07171126-b0d8-4ff3-bc1a-5fda1299c33e&width=768&dpr=4&quality=100&sign=f1010d0a&sv=1)
You can see which sprite is targeted by any given entry in the Part Mapping:
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FAgfPCgyhBdAcmWpSjoqI%252Finkatlas%2520partsMapping.png%3Falt%3Dmedia%26token%3Db682dd01-e988-4060-817e-47d49501f52b&width=768&dpr=4&quality=100&sign=e826aac7&sv=1)
Last updated