VOXELDEF

(development version r3086+ only)

The VOXELDEF lump allows to provide additional information when voxel models are used to replace sprites.

The general syntax of a VOXELDEF lump uses blocks of this sort:

<spritename>[, <spritename2>[, <spritename3>[, ...]]] =  <voxelname>
{
    <Property1> = <value>
    <Property2> = <value>
    <Property3> = <value>
    ...
}

By default, a voxel will replace sprites of the same name. For example, the voxel AMMOA will replace sprites AMMOA0, AMMOA1-AMMOA8, or AMMOA1-AMMOAF, depending on the number of rotations. A VOXELDEF block can therefore allow to replace sprites with different names, including several different sprites with a single voxel model.

Omitting the frame character part of the sprite name (e.g., using "AMMO" instead of "AMMOA") will replace all sprites using that name, regardless of frame. This goes for a voxel name as well, the voxel "AMMO" will replace sprites AMMOAr, AMMOBr, AMMOCr, etc.

Existing properties include:

AngleOffset

A floating point value in degrees corresponding to the angle difference between the front of the voxel model and the front of the actor. (development version r3060+ only)

Scale

A floating point scale factor for the voxel model, allowing hi-res voxels.

Spin

Since objects without rotations, such as decorations and item pickups, are rarely given an angle in the map editor, they may sometimes be oddly positioned, such as facing a wall, when replaced by voxels or models. The simplest workaround is to make them spin in place, which is frequently used for pickups to make them more visible. The value is an integer corresponding to the number of degrees per second.

DroppedSpin

As Spin, but only for items that have been dropped during the game, not placed in a map editor.

PlacedSpin

As Spin, but only for items that have been placed in a map editor, not dropped during the game.