Textures (PAA)
DayZ does not read PNG files: every texture of a model, an icon or a menu is a PAA file
(some newer ones are EDDS). This page shows what is inside a texture (the game's own or
yours), converts your PNG or TGA images to PAA with the format and mipmaps the engine expects,
and converts a PAA back to PNG so you can paint over it. Its Material button opens an editor
for .rvmat materials, the files that tell the game which textures a surface combines. To look
at the game's textures you need the DayZ folder set in Settings; converting
your own files needs nothing.
The screen
- Header: Open picks a texture on disk (
.paa,.edds,.dds,.png,.tga). Material opens the material editor. - Game textures (left): a search box over the
.paaand.eddsfiles inside the game's PBOs (the packed archives of the game). Type at least 2 characters of a path, such ascanteenorgear\drinks; click a result to open it. Nothing is extracted to disk. - Viewer (middle): the texture on a checkerboard, which shows through transparent areas.
Its bar holds the path, the size of the mipmap shown, the mipmap selector, zoom out / in,
the channel buttons (RGBA, RGB, R, G, B, A: one channel as grey) and Export PNG
(saves the mipmap shown). For a
_smdi,_nohq,_caor_astexture, a line under the bar says what each channel holds. - Info (right, top): format, size, number of mipmaps, alpha, average and max colour, flags, swizzle, TAGGs, file size, then a table of the mipmaps (size, storage, bytes) and the raw header as JSON.
- Convert (right, bottom): input, output, PAA format, Resize to power of two, Convert, Batch folder… and a log of what was written or refused.
- Material editor (a large dialog): the game's materials on the left, the form or the raw text in the middle, a lit preview and the checks on the right.
First steps
- Open Textures in the rail.
- In Game textures, type
canteen. - Click
canteen_co.paa. The viewer shows the canteen's colour texture. - Read Info: DXT1, 512 × 512, 8 mipmaps, no alpha.
- Pick
mip 3in the bar: the same picture at 64 × 64, as the game uses it at a distance. - Click
canteen_nohq.paain the results and compare: DXT5, a normal map.
Take the tour (in the app)
Common tasks
Convert a PNG to PAA
- Name the file by what it is:
myitem_co.pngfor colour,myitem_nohq.pngfor a normal map (see Concepts). Its sides must be powers of two. - In Convert, pick the PNG or TGA as Input. Output becomes the same name with
.paa. - Leave PAA format on Auto unless you know you need another one.
- Press Convert. The log shows the format, size and number of mipmaps written, and the new PAA opens in the viewer.
Convert every texture of a folder
- Press Batch folder… and pick the folder (subfolders are included).
- The dialog counts the PNG / TGA files to convert and those whose
.paais already newer than its source. Tick Force to convert these again. - Press Convert N files. Each file gets a
.paanext to it; errors are listed in the log.
Get a PNG out of a game texture
- Search the texture and open it.
- Choose the mipmap (mip 0 is the full size) and press Export PNG.
- Paint over the PNG, keep the suffix in the name, and convert it back to PAA.
Check why a texture looks wrong in game
- Open your
.paawith Open. - In Info, compare format, size and mipmaps with a game texture of the same kind.
- Use the A button to see the alpha alone: a colour texture that should be opaque but was saved with an alpha channel is a common cause of see-through items.
- Keep the page open while you repaint: the view reloads when the file changes on disk.
Study or copy a game material
- Press Material, search in Game materials and click one. It opens read-only.
- Read the stages: each names a texture; a badge gives its role (normal map, specular…) and says whether the file is found.
- Press Save as… and write it into your mod folder. Change the stage textures to your own (Pick… searches the game or takes a file from disk), then Save.
Tour of the material editor (in the app)
Examples
- A colour map (_co) (in the app): the canteen's colour texture. DXT1, opaque. Step through its mipmaps.
- A normal map (_nohq) (in the app): the same item's normal map, stored as DXT5.
- A specular map (_smdi) (in the app): use the G and B buttons; green is the strength of the shine, blue the glossiness.
- A texture with alpha (_ca) (in the app): bottles with see-through glass. The A button shows the opacity; Info says "Alpha: Yes".
- A material (.rvmat) (in the app): the canteen's material in the material editor,
with stages pointing at the
_nohqand_smditextures above.
Concepts
- PAA: Bohemia's texture format. It holds the picture compressed for the graphics card, its mipmaps, and a few tags (average colour, flags). See https://community.bistudio.com/wiki/PAA_File_Format.
- Suffix: the end of the file name, before the extension, says what the texture is and how
it must be compressed:
_cocolour (DXT1),_cacolour with alpha (DXT5),_nohqnormal map (DXT5),_smdispecular (DXT1),_asambient shadow (DXT1). The converter follows the same table as ImageToPAA of DayZ Tools (TexConvert.cfg). Reference: https://community.bistudio.com/wiki/ArmA:_Texture_Naming_Rules. - DXT1 / DXT5: two compressions. DXT1 has no usable alpha and is half the size; DXT5 keeps a full alpha channel. With Auto and no known suffix, an opaque image becomes DXT1 and an image with alpha DXT5.
- Power of two: the sides of a PAA are 4, 8, … 512, 1024, 2048 pixels. Width and height may differ (1024 × 512). Another size is refused unless Resize to power of two is ticked.
- Mipmaps: smaller copies of the texture (half, quarter…) stored in the file and used when the object is far away. The converter builds them; normal maps get their own filter.
- Channels of
_smdi: green is specular intensity, blue is glossiness, red is unused. - Material (
.rvmat): a small config naming the shader (usuallySuper), the light colours, and numbered stages, each pointing at one texture (normal, specular, ambient shadow…). The colour texture of aSupermaterial comes from the model's face, not from the material; the editor's Colour texture box is only for its preview. - Game paths: inside a material, textures are written as game paths with backslashes and
no drive letter:
MyMod\data\item_nohq.paa.
Pitfalls
- A wrong or missing suffix picks the wrong compression: a normal map saved as
_colooks flat or blotchy in game. Name the file first, then convert. - A size that is not a power of two fails. Fix the picture, or tick Resize to power of two and accept the slight stretch.
- ARGB8888 can be written, but Bohemia's own tools refuse to load it. Use it only when you know why.
- Game textures and game materials open read-only. To change one, export or Save as… a copy into your mod; the game's files are never modified.
- In a material, an absolute path (
C:\…,P:\…) or forward slashes are reported by the checks: the game will not find such a texture once the mod is packed. - Save in the material editor overwrites the file and keeps one
.rvmat.bakof the original; comments of the original file are not kept when the form was edited. - The batch conversion skips files whose
.paais newer than the source. If you changed the format option and want everything redone, tick Force. - The material editor with unsaved edits: Open, New, another game material and Close warn first; the same click again within 10 seconds discards the edits.
For agents
Tools of dzt that do the same work without the window:
texture_info: header of a PAA / EDDS / DDS (file path or game virtual path): format, size, mipmaps, average colour, flags.texture_convert: PNG / TGA / JPG to PAA (format from the suffix unlessformatis given), or PAA / EDDS to PNG / TGA.rvmat_info: parse a.rvmat(text or binarised): colours, shaders, surface, stages; can check that the stage textures exist.rvmat_edit: edit a.rvmatwith a list of operations and write the result.vfs_searchwith"ext":"paa"or"ext":"rvmat": find game textures and materials by virtual path;vfs_readreads a game.rvmatas text.
Files: the page reads .paa, .edds, .dds, .png, .tga from disk or from the game's
PBOs. It writes only the converter's output (.paa or .png), the exported PNG, and in the
material editor the .rvmat you save (plus one .rvmat.bak).
What the page tells the assistant: the open file (prefixed vfs: for a game texture), its size
and mipmap count, the read error if it could not be decoded, the converter's input, and the
errors of the conversion log. The material editor's state is not published.
Anchors for studio_guide: textures-open, textures-material, textures-explorer,
textures-search, textures-results, textures-viewer, textures-toolbar,
textures-channels, textures-export, textures-inspector, textures-info,
textures-convert, textures-convert-run, textures-batch, and in the material editor
textures-rvmat-list, textures-rvmat-form, textures-rvmat-views, textures-rvmat-preview,
textures-rvmat-save, textures-rvmat-save-as.
See also
- Models: where a model's faces name their textures and materials.
- Config (CfgConvert):
hiddenSelectionsTextures[]andhiddenSelectionsMaterials[]swap textures and materials on a class (a retexture). - PBO Packer: packs the converted textures with the mod.
- Getting started