Various functions can be used incorrectly. When this happens, you can put a print statement into the function. But will that print statement log to the server console in multiplayer? Will you not forget to use PrintBold instead of Print if the error happens with a non-player activator? What if you want to be able to turn error messages off? And finally, how should ACSUtils notify you about errors?

To solve all these problems, ACSUtils provides a standardized error handling mechanism. Errors are triggered through a set of functions that pass them to your project's custom error handler (see Named scripts).

#define ACSUTILS_ERROR_HANDLER myproject_errorhandler
#include "acsutils.acs"

script myproject_errorhandler (int type, int message)
{
	Log(s:"error: ", s:message); // Log to server console.
	printbold(s:"error: ", s:message); // Print to all players.
}