Full Specfication for:
Zoner's Half-Life Compilation Tools 2.5.3, Custom Build 1.6
Generally, only Fatal errors are written to the mapname.err file. The
presence of this file will stop the complation of hlbsp, hlvis and
hlrad.
Note; that this error table is only applicable to Custom Build 1.6. The
normal ZHLT differs slightly from this table.
| Error |
Description |
HowToFix |
| invalid assume message |
This is a message should never be printed. |
contact merlinis@bigpond.net.au concerning this issue. |
| Memory allocation failure |
The program failled to allocate a block of memory. |
Likely causes are (in order of likeliness) : the partition holding
the swapfile is full; swapfile size is smaller than required; memory
fragmentation; heap corruption |
| NULL Pointer |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Bad Thread Workcount |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Unable to create thread |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_PLANES |
The maximum number of plane definitions has been reached |
The map has grown too complex |
| Exceeded MAX_MAP_TEXTURES |
The maximum number of textures for a map has been reached |
selfexplanitory |
| Exceeded MAX_MAP_MIPTEX |
Texture memory usage on the map has exceeded the limit |
Merge similar textures, remove unused textures from the map |
| Exceeded MAX_MAP_TEXINFO |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_SIDES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_BRUSHES |
The maximum number of brushes for a map has been reached |
selfexplanitory |
| Exceeded MAX_MAP_ENTITIES |
The maximum number of entities for the compile tools has been reached |
selfexplanitory |
| Exceeded MAX_ENGINE_ENTITIES |
The maximum number of entities for the half-life engine has been reached |
selfexplanitory |
| Exceeded MAX_MAP_MODELS |
The maximum number of brush based entities has been reached |
Remove unnecessary brush entities, consolidate similar entities into a single entity |
| Exceeded MAX_MAP_VERTS |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_EDGES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_CLIPNODES |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Exceeded MAX_MAP_MARKSURFACES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_FACES |
The maximum number of faces for a map has been reached |
This error is typically caused by having a large face with a small texture scale on it, or overly complex maps. |
| Exceeded MAX_MAP_SURFEDGES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_NODES |
The maximum number of nodes for a map has been reached |
The map is too complex for the game engine/compile tools to handle. Simplify |
| CompressVis Overflow |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| DecompressVis Overflow |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Execution Cancelled |
Tool execution was cancelled either by the user or due to a fatal compile setting |
selfexplanitory |
| Internal Error |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Error |
Description |
HowToFix |
| Missing '[' in texturedef (U) |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| plane with no normal |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| brush with coplanar faces |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| brush outside world |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| mixed face contents |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Brush type not allowed in world |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Brush type not allowed in entity |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| No visibile brushes |
All brushes are CLIP or ORIGIN (at least one must be normal/visible) |
selfexplanitory |
| Entity with ONLY an ORIGIN brush |
All entities need at least one visible brush to function properly.
CLIP, HINT, ORIGIN, do not count as visible brushes. |
selfexplanitory |
| Could not find WAD file |
The compile tools could not locate a wad file that the map was
referencing. |
Make sure the wad's listed in the level editor actually all exist |
| Exceeded MAX_TRIANGLES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_SWITCHED_LIGHTS |
The maximum number of switchable light entities has been reached |
selfexplanitory |
| Exceeded MAX_TEXFILES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Error |
Description |
HowToFix |
| LEAK in the map |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Exceeded MAX_LEAF_FACES |
This error is almost always caused by an invalid brush,
by having huge rooms, or scaling a texture down to extremely small values (between -1 and 1) |
Find the invalid brush. Any imported prefabs, carved brushes, or vertex manipulated brushes should be suspect |
| Exceeded MAX_WEDGES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_WVERTS |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_SUPERFACEEDGES |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |
| Empty Solid Entity |
A solid entity in the map (func_wall for example) has no brushes. |
If using Worldcraft, do a check for problems and fix any occurences of 'Empty solid' |
| Error |
Description |
HowToFix |
| Exceeded MAX_TEXLIGHTS |
The maximum number of texture lights in use by a single map has been reached |
Use fewer texture lights. |
| Exceeded MAX_PATCHES |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Transfer < 0 |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Bad Surface Extents |
The map has a problem which must be fixed |
Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Malformed face normal |
The texture alignment of a visible face is unusable |
If using Worldcraft, do a check for problems and fix any occurences of 'Texture axis perpindicular to face' |
| No Lights! |
lighting of map halted (I assume you do not want a pitch black map!) |
Put some lights in the map. |
| Bad Light Type |
The compiler tool had an internal error |
contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_SINGLEMAP |
The compiler tool hit an internal limit |
contact merlinis@bigpond.net.au concerning this issue. |