bw logo

Chapter 20. material_kinds.xml

Defines material kinds to be displayed in Model Editor's Materials Settings panel's Material Kind drop-down list box — for details, see the Content Tools Reference Guide, section Panel summary, Materials Settings panel.

Located under bigworld/res/system/data, the grammar is listed below:

<root>

  *<kind>
      <id>      integer  </id>
      <desc>    string   </desc>
      <sound>    string   </sound>
      <help>    string   </help>
      <sfx>     file     </sfx>
      <weight>  weight   </weight>
     *<terrain> file     </terrain>
   </kind>

</root>

Grammar of bigworld/res/system/data/material_kinds.xml

The list below describes the tags in bigworld/res/system/data/material_kinds.xml:

  • desc

    Name to be displayed for the material kind.

  • sound

    Name of the sound tag to be triggered by footsteps.

  • help

    Help text to be displayed for the material kind.

  • id

    Unique numeric identifier for the material kind.

  • weight

    Weight for all of this material kind's terrain texture maps. When the dominant terrain texture is calculated for any XZ position in a terrain, the associated weighting for textures are taken into account. This influences which material kind is returned for a given location, and also influences the flora that grows at a given location. The material kind weight can be overridden on a per-terrain texture basis, see the terrain section below. If the weight is not specifies, it defaults to 1.0

  • sfx

    Special effect file associated with the material.

    This is currently not implemented.

  • terrain

    Textures associated with this type of material.

    It is given by the texture file path, without extension.

    Additionally, each terrain texture may have an associated weight. This overrides the material kind's weight (see above.) If the weight is not specified, it defaults to the material kind's weight.