WRL files are created by Tool when it encounters fatal or warning-level geometry issues during model compilation and lightmapping (e.g. open edges, nearly coplanar faces). These files can be reimported back into the user's 3D software to visualize where problematic edges or faces are present and correct them before reattempting model compilation.

When compiling a BSP, the file will be named after the JMS file being compiled (e.g. yourmap.wrl in H1CE or yourmap_errors.wrl in H1A). When geometry errors are found during radiosity, Tool will instead output a debug.wrl.

The location of the generated WRL file depends on the Tool version:

  • H1CE Tool saves to the command prompt's current working directory.
  • H1A Tool saves the file adjacent to the source JMS file, e.g. data\levels\example\models\example_errors.wrl

Compatibility

Some versions of 3ds Max (at least 2010) require the 32-bit version in order to import WRL files. Blender is not able to import Halo's WRL files natively since it supports VRML 2.0, not 1.0, but the Halo Asset Blender Development Toolset addon does.

Acknowledgements

Thanks to the following individuals for their research or contributions to this topic:

  • Conscars (WRL format research)
  • stunt_man (WRL compatibility and usage notes)