Supported model formats

The following 3D and 2D model formats are supported by Castle Game Engine. They can be loaded e.g. using the TCastleScene.Load method. You can also open them in view3dscene.

1. Best formats to use

1.1. X3D and VRML

X3D and VRML is a flexible and powerful format for 3D models and a basis of our scene graph.

The following extensions are recognized:

  • X3D in classic and XML encoding: .x3d, .x3dz, .x3d.gz, .x3dv, .x3dvz, .x3dv.gz

  • VRML 1.0 and 2.0: .wrl, .wrz and .wrl.gz.

We have a great support for X3D and VRML, and handle rendering, animation, interaction, scripts, shaders and more features of these formats. An entire section of this website, Scene Graph (X3D), documents all the features we support (from the X3D and VRML standard, and many of our own extensions).

1.2. glTF 2.0

An efficient, modern format, developed by Khronos. Resources:

Supported features of glTF models in our engine:

  • Meshes (polygons, lines), transformation hierarchy.

  • Materials using Phong shading, alpha mode, double-sidedness, per-vertex colors.

  • Texturing for base color, normal maps, emissive.

  • Cameras (perspective and orthogonal).

  • Animations of transformations (position, rotation, scale), that can be played using standard CGE PlayAnimation method (or other means, e.g. to play multiple animations from one model simultaneously).

  • Both .glb and .gltf extensions are supported. Textures can be provided in separate files or embedded inside the GLTF stream.

  • It is integrated in our engine as X3D nodes graph. This means that you can include a glTF model inside larger X3D file using the Inline node, you can modify the glTF scene graph at runtime (e.g. modify material color, show/hide something etc.) and you can serialize the scene graph to an X3D file.

  • We use PasGLTF, a great open-source library for reading glTF by Benjamin "Bero" Rosseaux.

Main missing features are PBR (Physical-Based Rendered materials, we are working on it), morph targets and skinned animation.

1.3. Castle Animation Frames (castle-anim-frames) format

Castle Animation Frames (castle-anim-frames) format, formerly known as kanim.

This is a simple format for animations, used to export animated models from Blender. It supports animating of everything in Blender (transformations, skin, shape keys, materials, particles, physics...), although it is somewhat memory-hungry.

1.4. Spine JSON

Spine is a powerful program for 2D game skeletal animations. Dragon Bones can also export to this format.

We have a big support for Spine JSON features, and our friendly game studio Cat-astrophe Games is using Spine for all 2D games.

2. Other formats you can use

  • Collada (.dae extension). We support a lot of Collada features — geometry with materials, textures, cameras, lights. Tested on many Collada examples, like Collada Test Model Bank and Collada models exported from various Blender versions. All modern Collada versions (1.3, 1.4, 1.5) are handled.

    Animations in Collada files are not handled yet. If you need animations, we advise to use glTF instead. glTF is newer and has similar feature set. Khronos provides a converter from Collada to glTF.

  • OpenInventor 1.0 ASCII files (.iv extension) are handled. Inventor 1.0 and VRML 1.0 are very similar formats, we also handle some additional Inventor-specific nodes.

  • 3d Studio 3DS format. We support most important things: meshes, cameras, materials, textures.

  • MD3. This is the format used for models in Quake 3 and derivatives (Tremulous etc.). Almost everything useful from MD3 file is supported: geometry with texture (coordinates, and texture filename from associated file), animation is also read and played.

  • Wavefront OBJ files. We support most important things: geometry (with texture coords, normal vectors), materials (colors, opacity, texture filenames).

  • STL (Standard Triangle Language, aka STereoLithography). STL is a simple popular 3D format used in 3D printing. We support both ASCII and binary formats.

  • Videoscape GEO (.geo extension). Very basic support for this very old 3D format.