ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools


using_acsutils

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
using_acsutils [2017/07/13 17:42] korshunusing_acsutils [2017/07/14 20:50] (current) korshun
Line 1: Line 1:
 +====== 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. 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.
  
Line 7: Line 11:
   * **[[GDCC]]**   * **[[GDCC]]**
  
-===== Using ACSUtils =====+===== Adding ACSUtils to your project =====
  
-  - Download [[https://github.com/Korshun/acsutils/releases|the latest release]].+  - 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.   - Add ''acsutils.acs'' to your project.
-  - Use the code below to include ACSUtils into your project:+  - Include ''acsutils.acs'' after ''zcommon.acs'':
  
 <code> <code>
Line 18: Line 22:
 </code> </code>
  
-If you are making a mod for Zandronumdon'forget that you can [[.namedscripts|name your scripts too]].+===== Things to note ===== 
 + 
 +If your project has functions (or variables, if you are using [[ACC]]) with the same names as ACSUtils functionsit won'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! 
  
using_acsutils.1499956969.txt.gz · Last modified: 2017/07/13 17:42 by korshun