Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:CryEngine CGF chunk files

From ReverseEngineering.wiki
Format
Magic "CryTek" (3.5 and older), "CrCh" (3.6+), "#ivo" (newer compiled files)
Extensions .cgf .cga .chr .skin .caf .cgam .dba
Endianness little (see Unverified note)
License n/a (format); reader: Cryengine-Converter GPL-2.0
On this wiki Facts · Code · Notes · Topics

The chunked model and animation files of CryEngine and its derivatives (.cgf, .cga, .chr, .skin, .caf, .anm and the newer .cgam/.dba): a header with a signature ("CryTek", "CrCh" or "#ivo"), a version, and a chunk table pointing at typed chunks.

Overview

CryEngine geometry (.cgf static, .cga animated objects), characters (.chr, .skin) and animations (.caf, .dba) are chunk files: a small file header, a chunk table, then chunks identified by a type id and a version. The reference reader used here is the C# project Markemp/Cryengine-Converter (GPL-2.0); only layouts it parses are listed, read from source at commit 7b951dbb254ab99f560e8ffbf64a771c70ccef74 (path CgfConverter/CryEngineCore/Model.cs, Enums/Enums.cs, Chunks/ChunkHeader_*.cs).

File header

The reader first reads 4 bytes. CrCh (CryEngine 3.6+) is followed by uint32 file version (0x746), uint32 chunk count, int32 chunk table offset. #ivo is followed by the same three fields (version 0x900). Otherwise it re-reads 8 bytes and expects CryTek (3.5 and older): uint32 file type (0xFFFF0000 geometry, 0xFFFF0001 animation), uint32 version (0x744 or 0x745), int32 table offset (the reader adds 4), uint32 chunk count. Known file versions: 0x744, 0x745, 0x746, 0x900.

Chunk table

Seek to the table offset and read one header per chunk. Header size depends on the file version: 0x744 and 0x900 headers carry no size (chunk size = next offset minus this offset, chunks are stored in offset order); 0x745 and 0x746 carry type, version, offset, id and size. Version 0x900 headers hold type, version and a 64-bit offset and no chunk id. For 0x744 .caf files the header chunk count is unreliable (the reader divides the remaining bytes by 16).

Chunk types

Classic ids: Mesh 0xCCCC0000, Helper 0xCCCC0001, Node 0xCCCC000B, Mtl 0xCCCC000C, Controller 0xCCCC000D, MtlName 0xCCCC0014, DataStream 0xCCCC0016, MeshSubsets 0xCCCC0017, MeshPhysicsData 0xCCCC0018, CompiledBones 0xACDC0000 (CompiledPhysicalBones ..01, MorphTargets ..02, PhysicalProxies ..03, IntFaces ..04, IntSkinVertices ..05, Ext2IntMap ..06). The #ivo files use different, hash-like ids (for example NodeMeshCombo 0x70697FDA, MeshInfo 0x92914444, IvoSkin 0xB875B2D9, CompiledBones_Ivo 0xC201973C, IvoCAFData 0xA9496CB5, IvoDBAData 0x194FBC50). Each chunk also has its own version, so a reader dispatches on (type, version).

Code & repositories

  • https://github.com/Markemp/Cryengine-Converter @ 7b951dbb254ab99f560e8ffbf64a771c70ccef74 · license: GPL-2.0 (declared by the contributor; GitHub's detector did not recognize LICENSE)
    C# CGF/CHR/SKIN/CAF reader and Collada/glTF exporter; reads CrCh, CryTek and #ivo chunk files
    Tested on: source read, not run: source only · checked 2026-10-18

Pitfalls

  • The enum comments name Star Citizen as the source of the #ivo ids and of the 0xCCCC1000 range; Unverified: other games using #ivo files may use further ids.
  • Unverified: byte order is little endian in all files read (the reader class is called EndiannessChangeableBinaryReader, so some platform files may be big endian).

Related

Library:CryEngine, Library:O3DE (does not use this format; its meshes are its own asset types).