Entities are Missing in Exported Scene

Solutions on missing entities in exported game level

Posted Aug 29, 2016
Last Updated Jun 18, 2018

There are a few reasons why your entities are not exporting. Below are the main reasons:

Scene Manager Out-of-Synch

Wall Worm has a scene manager that tracks various types of objects in the scene. Sometimes that manager's data can get out-of-synch with the scene nodes. This isn't common, but when it does happen, you can re-synch the scene with the manager by clicking Wall Worm > Wall Worm Utilities > Classify Scene Nodes. This will force Wall Worm to rebuild it's list of object typse like entities, displacements, etc.

  • Right-clicking the Export Scene as Game Level button in the VMF Exporter will reclassify the scene before exporting.

Object Setting to Exclude

Some objects (including WallWormMDL) have native properties to control whether it will be exported or not. Such objects will not export if it has a property labeled "VMF Exclude" which is turned on.

Some objects (like WallWormDetailProp) have a reverse setting called "Export in VMF". Such objects will not export if this option is turned off.

Also, for other types of objects, there is a custom user property called "wallworm_exclude_vmf" that, when set to false, will exclude the object. You can include/exclude objects via these commands in the Wall Worm > Level Design menus when you have some objects selected:

  • Include in VMF
  • Exclude From VMF

Note that these two functions will use native properties or the user property depending on the type of objects selected.

VMF Exporter Settings

The VMF Exporter will skip most entities if you do not have the Brush Entities and Point Entities options turned on in the VMF Exporter dialog. Also, if the entities are hidden and the Hidden Objects option is turned off, the entities will fail to export.

Excluded Layer

Wall Worm does not export objects that are in a layer named "VMF_Exclude".

Old Scene Created with Convexity or Early Wall Worm

Early in the Wall Worm project, the intent for the level design pipeline was to use Convexity as the primary method of managing and working with the level design tools. This is why, initially, many of the functions in Wall Worm stored data in the Convexity format (as UserProperty values in scene nodes for entities, for example).

When Convexity stopped development, Wall Worm moved to its own storage using custom attributes. For a long time, Wall Worm always checked for Convexity properties on objects to decide if they were entities; eventually, that was no longer turned on by default to optimize scene export times.

If you have a very old Wall Worm scene or a Convexity scene with entities, the latest version of Wall Worm will not export those entities by default. This includes several old sample scenes from the WW website. To get them to export with the Wall Worm VMF Exporter, you need to take these steps:

  1. Open your scene
  2. Click Wall Worm > Wall Worm Level Design > Anvil
  3. Open the World tab
  4. Scroll to the Map Properties Rollout
  5. Turn on the Legacy Entities setting