Differences

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

--- using_acsutils [2017/06/24 21:45] – korshun
+++ using_acsutils [2017/07/14 16:55] – korshun
@@ Line 1: / Line 1: @@
+====== Using ACSUtils ======
 ===== Upgrading the compiler =====
-You **must** upgrade your ACS compiler to use ACSUtils as the official ACC 1.55 release can't compile files with more than 256 functions (ACSUtils has 400). Use one of the following:
+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.
-==== ACC (with 255 function limit lifted) ====
+Upgrade to one of the following compilers:
-  * **Homepage**: https://github.com/Korshun/acsutils_acc
+  * **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.
-  * **[[https://github.com/Korshun/acsutils_acc/releases/download/v1%2C5.5-r2/acsutils_acc-1.5.5-r2.zip|DOWNLOAD]]**)
+  * **[[BCC]]**
+  * **[[GDCC]]**
-<note important>
+===== Adding ACSUtils to your project =====
-If you get an error about "zcommon.acs", add the compiler directory to "**Include Paths**" in Edit -> Preferences -> Scripting -> ACS.
-</note>
-==== GDCC-ACC ====
+  - Download [[https://github.com/Korshun/acsutils/releases/download/1.6/acsutils-1.6.0.zip|the latest release]].
+  - Add ''acsutils.acs'' to your project.
+  - Include ''acsutils.acs'' after ''zcommon.acs'':
-  * **Homepage**: http://forum.zdoom.org/viewtopic.php?f=19&t=32078
+<code>
-  * **Github**: https://github.com/DavidPH/GDCC
+#include "zcommon.acs"
-  * **[[https://www.dropbox.com/sh/e4msp35vxp61ztg/AACi9gkSHBKE25Uikv6DUFFUa/gdcc_latest_win32.txt?dl=0|DOWNLOAD]]**
+#include "acsutils.acs"
+</code>
-===== Using ACSUtils =====
+===== Things to note =====
-  - Download [[https://github.com/Korshun/acsutils/releases|the latest release]].
+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.
-  - Add ''acsutils.acs'' to your project.
-  - Use the code below to include ACSUtils into your project:
-<code>
+===== Optional enhancements =====
-#library "project"
-// ACSUtils settings:
+  - Copy ''decorate/changeflag.txt'' to your decorate and ''#include'' it to make [[functions:ChangeFlag]] and [[functions:ChangeActorFlag]] work.
-#define ACSUTILS_HUDLIB_SAVEDSTATES 16
+  - 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).
-#define TIDALLOCSTART 15000
-// Includes:
+===== BCC enhancements =====
-#include "zcommon.acs"
-#include "acsutils.acs"
-// Your project's error handler (you can put it anywhere you want, in a different file, even):
+If you are using [[BCC]], try [[BCSUtils]] -- a BCC-enhanced version of ACSUtils with the same functions!
-function void ACSUtilsErrorHandler(int type, int message)
-{
-	Log(s:"error: ", s:message);
-	printbold(s:"error: ", s:message);
-}
-// Your project's code follows.
-</code>
-If you are making a mod for Zandronum, don't forget that you can [[.namedscripts|name your scripts too]].

ACSUtils Wiki

User Tools

Site Tools

Differences

Page Tools