ACSUtils Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Using ACSUtils ======

===== Upgrading the compiler =====

You **must** upgrade your ACS compiler to use ACSUtils because the official ACC 1.55 release can't compile files with more than 256 functions.

Upgrade to one of the following compilers:

  * **ACC 1.56 Beta**: **[[http://acsutils.strangled.net/lib/exe/fetch.php?media=acc-1.56-beta-g3256a3e.zip|DOWNLOAD]]**. This archive also includes the latest Zandronum zcommon from https://github.com/Korshun/zcommon.
  * **[[BCC]]**
  * **[[GDCC]]**

===== Adding ACSUtils to your project =====

  - Download [[https://github.com/Korshun/acsutils/releases/download/1.6.1/acsutils-1.6.1.zip|the latest release]].
  - Add ''acsutils.acs'' to your project.
  - Include ''acsutils.acs'' after ''zcommon.acs'':

<code>
#include "zcommon.acs"
#include "acsutils.acs"
</code>

===== Things to note =====

If your project has functions (or variables, if you are using [[ACC]]) with the same names as ACSUtils functions, it won't compile. Rename the functions in your project to fix it. ACSUtils functions are named to avoid some of the most annoying conflicts, but it still needs several renames in some big projects.

===== Optional enhancements =====

  - Copy ''decorate/changeflag.txt'' to your decorate and ''#include'' it to make [[functions:ChangeFlag]] and [[functions:ChangeActorFlag]] work.
  - Copy ''cvarinfo.acsutils'' to your project root to allow the server to hide ACSUtils errors using the ''acsutils_noerrors'' cvar (it will automatically load and not conflict with your mod's CVARINFO because ZDoom ignores the extension).

===== BCC enhancements =====

If you are using [[BCC]], try [[BCSUtils]] -- a BCC-enhanced version of ACSUtils with the same functions!
ACSUtils Wiki

User Tools

Site Tools

Page Tools
