Troubleshooting

Error Messages

There are several error levels that are handled differently in the plugin. Fatal errors will stop the plugin, errors might disable features, and warnings will usually fall back to a default action.

Error Messages

Module:	Type:	Message:
-	fatal	Unexpected error encountered loading: <file>
Description: Something wrong happened when trying to parse/open a configuration file. Cause: File does not exist, file permissions, or (for developers:) that invalid file structure were specified when loading.
account	fatal	Offset "CCSPlayer::m_iAccount" was not found.
Description: The required offset for accessing players' money value wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
config	error	Invalid reload function for config: <module config>
Description: Couldn't get the function for reloading the specified module. This should never happend, unless someone tampered with the code. For developers: If you're doing modifications/additions in the config system make sure you "register" the module as described in top of config.inc.
downloads	fatal	Missing downloads file: <file>
Description: Startup validation failed because the list of downloads could not be found.
downloads	error	Missing file <file>
Description: Couldn't find the specified file during validation of download list content. Verify that the path is correct (path is relative to the cstrike folder). Check for typos.
hitgroups	fatal	Missing hitgroups file: <file>
Cause:Startup validation failed because the hit groups file could not be found.
hitgroups	error	No usable data found in hitgroups config file: <file>
Cause: The hit groups file is empty, - or there's a typo so the parser think it's empty. Check for missing quotes (") or brackets ({ }).
hitgroups	error	Unexpected error caching data from hitgroups config file: <file>
Description: Something wrong happened when trying to parse/open a configuration file. Cause: Usually file permissions, or (for developers:) that invalid file structure were specified when loading.
hitgroups	error	Couldn't cache hitgroup data for: <hit group name>
Description: Couldn't find the specified hit group name in the configuration file. Cause: A quote is missing somewhere, or the hit group section is actually missing.
models	fatal	Missing model list: <file>
Description: Startup validation failed because the list of models could not be found.
models	fatal	Can't find any models in<file>
Description: The model file is empty or corrupt. Check for missing quotes, etc.
models	warning	Warning: Maximum number of models reached (<max models>). Skipping other models.
Description: There's too many models in the model list, and the rest of the list is ignored.
models	warning	Warning: Invalid model name/path setting at index <index>. File not found: <model file>.
Description: The specified model file could not be found, verify path and name attributes. Path must end with "/".
models	warning	Warning: Invalid model team setting at index <index>: <attribute value>.
Description: Model team attribute failed validation. Check for typos and that it has a valid value.
models	warning	Warning: Invalid model access setting at index <index>: <attribute value>.
Description: Model access attribute failed validation. Check for typos and that it has a valid value.
models	warning	Warning: Invalid model group setting at index <index>. Couldn't find SourceMod group <group name>.
Description: The specified group name does not exist in the SourceMod group list.
models	error	Error opening directory: <directory>
Description: Couldn't open the directory specified in path attribute. Verify that the game server has read access, and access to list files in that directory.
models	error	Couldn't find any model files for <model name>. Check name and path.
Description: Files starting with the model name could not be found in the specified path. Verify that the name attribute only contains the model name, and not the path.
models	fatal	Missing public model in <model list file>. There must be at least one public model.
Description: There's no public models to be assigned either/both zombies and humans. Verify that access attribute is "public" on at least one model per team.
offsets	fatal	Offset "CBaseEntity::m_nWaterLevel" was not found.
Description: The required offset for getting players' water level wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Offset "CBasePlayer::m_vecVelocity[0]" was not found.
Description: The required offset for getting players' velocity wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Offset "CCSPlayer::m_flLaggedMovementValue" was not found.
Description: The required offset for getting players' speed/movement wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Offset "CCSPlayer::m_bHasNightVision" was not found.
Description: The required offset for getting players' night vision settings wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Offset "CCSPlayer::m_bNightVisionOn" was not found.
Description: The required offset for getting players' night vision setttings wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Offset "CBasePlayer::m_iFOV" was not found.
Description: The required offset for getting players' field of view setting wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Can't load game config file (plugin.zombiereloaded.txt) from the gamedata directory.
Description: The required configuration file with offsets and function signatures wasn't found, or couldn't be loaded. Cause: Usually file permissions.
offsets	fatal	Signature "CGameRules::TerminateRound" was not found.
Description: The required function signature for terminating the round wasn't found Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
offsets	fatal	Signature "CBasePlaye::CSWeaponDrop" was not found.
Description: The required function signature for dropping players' weapons wasn't found Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
playerclasses	warning	Failed to set <class name> as default spawn class for team <team id>. The class doesn't exist or the team IDs doesn't match. Falling back to the first class in the team.
Description: Couldn't find the specified class name, or there's no class with that name and team id. Default class in class configuration will be used. Cause: Typo in plugin configuration or class configuration, the specified class is a human class while it expected a zombie class (or oposite), - or the class has wrong team id set.
playerclasses	fatal	Missing playerclasses config file <file>
Description: Couldn't find the specified class configuration file. Verify that the zr_config_path_playerclasses console variable is correct.
playerclasses	fatal	Can't find any classes in <file>
Description: There's no classes. Cause: Usually a missing quote (") or bracket ({ }).
playerclasses	warning	Warning: Maximum classes reached (<max classes>). Skipping other classes.
Description: Maximum number of classes reached during parsing. Additional classes are skipped.
playerclasses	warning	Warning: Invalid class at index <class index>, disabled class. Class error flags: <flags>.
Description: The specified class has one or more invalid attribute values. Class will be disabled. Check the flag value to find out what attributes that are invalid.
playerclasses	fatal	The class configuration doesn't match the team requirements.
Description: Class requirement conditions not met. See Class Requirements (3.7.3) for details. Zombie:Reloaded will not start without valid classes.
playerclasses	fatal	Couldn't find a default class for one or more teams. At least one class per team must be marked as default.
Description: Missing a default class for humans or zombies. See Class Requirements (3.7.3) for details. Zombie:Reloaded will not start without valid classes.
playerclasses	warning	Warning: Failed to get the specified zombie class, falling back to default class in class config. Check spelling in "zr_classes_default_zombie".
Description: Couldn't find the class specified in zr_classes_default_zombie. Check for typos.
playerclasses	warning	Warning: Failed to get the specified human class, falling back to default class in class config. Check spelling in "zr_classes_default_human".
Description: Couldn't find the class specified in zr_classes_default_human. Check for typos.
soundeffects	error	Invalid sound file specified in "zr_ambientsounds_file": <file>
Description: Couldn't find the sound file. The path is relative to the cstrike/sound folder. Check for typos.
soundeffects	error	Ambient sound volume specified in "zr_ambientsounds_volume" is either muted or invalid.
Description: Volume has a invalid value (zero or negative). Valid range is from 0.1 to 1.0.
soundeffects	error	Ambient sound length specified in "zr_ambientsounds_length" is invalid.
Description: The specified sound file length is zero or negative. Must be positive.
visualeffects	fatal	Offset "CCSPlayer::m_hRagdoll" was not found.
Description: The required offset for getting players' ragdoll wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
visualeffects	error	Couldn't find handle to cvar: "sv_skyname"
Description: Couldn't find cvar sv_skyname. Cause: This is most likely caused by running Zombie:Reloaded on another mod than it's made for. Counter-Strike: Source is required.
volfeatures	warning	Warning: Invalid interval <interval> in anticamp volume <id>.
Description: Invalid attribute value. Must be positive and non-zero. Volume will be disabled.
volfeatures	warning	Warning: Console variable "zr_vol_update_interval" is zero or negative. Must be positive. Volumetric Features will be disabled.
Description: Invalid value. Must be positive and non-zero.
volfeatures	warning	Warning: Console variable "zr_vol_trigger_interval" is zero or negative. Must be positive. Volumetric Features will be disabled.
Description: Invalid value. Must be positive and non-zero.
weapons	fatal	Offset "CBaseCombatWeapon::m_iClip1" was not found.
Description: The required offset for getting players' primary ammo value wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
weapons	fatal	Offset "CBaseCombatWeapon::m_iClip2" was not found.
Description: The required offset for getting players' secondary ammo value wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
weapons	fatal	Offset "CBasePlayer::m_iAmmo" was not found.
Description: The required offset for getting players' reserve ammo value wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
weapons	fatal	Offset "CBasePlayer::m_hActiveWeapon" was not found.
Description: The required offset for getting players' active weapon index wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
weapons	error	Missing weapons config file: <file>
Description: Could not find the weapons configuration file. Check for typos in console variable zr_config_path_weapons.
weapons	error	No usable data found in weapons config file: <file>
Cause: The weapon config file is empty, - or there's a typo so the parser think it's empty. Check for missing quotes (") or brackets ({ }).
weapons	error	Couldn't cache weapon data for: <weapon name> (check weapons config)
Description: The specified weapon name wasn't found in weapon configuration file.
weapons	fatal	Offset "CCSPlayer::m_bInBuyZone" was not found.
Description: The required offset for getting players' buy zone state wasn't found. Cause: Usually a update by Valve. Report to a Zombie:Reloaded developer.
weapons	error	Invalid weapon (<weapon name>) selected from the ZMarket menu.
Description: Something went wrong when converting a weapon name to a weapon index. This should never happend, and if so it's a bug.
weapons	error	Client <player name> attempted to buy weapon entity <weapon name> marked as a projectile. Check your weapon config.
Description: The weapon is probably not a grenade type. Check the weapontype attribute of that weapon.

Common Problems

Unable to load extension "zrtools.ext.so": Could not find interface: IPlayerManager

ZR Tools in beta 1 was compiled based on a development snapshot of SourceMod so it requred a newer version of SourceMod than the latest stable release at that time. It's now compiled based on SourceMod 1.2.

Solution: Update SourceMod.

"ERROR" models or pink (checkerboard) models

Big "ERROR" models on zombies/humans is usually caused by missing files. Common causes are:

• Model files missing in download list
• Model files missing on server
• Typo in model list
• Typo in class configuration ("model_path" attribute)
• Missing or incorrect whitelist settings on pure servers

Model not precached

This is usually caused by classes that specify models that isn't added to the model list.

The model list is limited and models after that limit is ignored. Check error logs for warnings about full model list.

Freeze/lag on infection

When a human get infected the server freeze for a short amount of time. This might be caused by too detailed models, or a cache problem.

Solution: Try "sv_forcepreload 1" in the server's configuration file. "cl_forcepreload 1" on the client might help too, but servers can't set that console variable on clients.

Bouncing props

This is bug in the Source engine and we can't do anything about it, but avoid stuff that is known to trigger this bug.

Anti-Stick might trigger this bug in some cases, but it also might depend on the map.

More info: Engine Bug: "Physical Mayhem" Discussion

Compatibility problems with Duke Hacks

This is not confirmed, but ZR Tools and Duke Hacks might not work well together on the same server. Try disable plugins that use Duke Hacks if wierd problems show up.

Deleting/removing all main plugin configuration files solved random crashes

We got reports about random crashes and one discovered that deleting main plugin configuration files so they are regenerated stopped random crashes. This might work because some configs might have invalid values that could crash some plugins.

Instead of deleting configuration files, they can be moved outside the mods root folder so they're not loaded. Don't move all files at once, move one by one so it's possible to figure out what plugin that is causing random crashes.

Server is crashing on certain maps after a few seconds

We've seen servers that crash only on certain maps. The map is loaded but after a few seconds the server crash (probably when a mother zombie is infected).

The problem was a typo in the map config file for that map (a missing quote (") in this case). Rename the map config so it's not executed and try again. If the crash disappeared look for typos.

Problem with big config files

The main plugin configuration file is sometimes executed late, after map configs. This is caused by a bug in SourceMod where commands are executed late. The bug is already fixed, but in the 1.3 branch.

Because of this bug map configs might be useless to change settings (cvars), but some commands still work (like setting multipliers and adding volumes).

Zombie:Reloaded conflicts with plugins that change player model/skin and speed

Other mods and plugins that change player models (like Mani Admin Pugin) is conflicting with Zombie:Reloaded because of the class system.

A possible solution is to use "no_change" in the model_path class attribute on all human classes. Then human players' model control will be released to other plugins.

Do not run ESTools, it's not compatible with SourceMod

ESTools is causing wierd problems when running along with SourceMod.