ACS Source listings

[Russel]

ACS (or Action Command Script) is a coding tool used by more advanced modders (ie. coders) to allow for more powerful modification of the game. However, ACS, whether in Zandronum or in Skulltag, is limited to only 999 scripts, numbered from 1-1000. Usually scripts 1-100 are restricted to mappers and overlapping scripts can cause issues with certain features of the mod (or mods) in question. Overlapping script numbers can also be an issue with compatibility, as it causes certain things to not function properly. An example would be trying to run CSCC with Roboenza, (Rage or not) when these two mods are both loaded, the scripts for Beed's missile lock-on and certain scripts that get the mode started in (Rage)Robo clash, causing either one to not function properly. So, I have compiled a list of ACS Script numbers from core 8BDMv3a, as well as of YD Classes; I would do the same for KY classes, but the ACS there is closed source.

Core v3a: (Listed numerically backwards...Mostly...)

(click to show/hide)

[GLOBAL.acs]
999 - clear fadeouts; unknown execution
997 - Sets your TID, team colors, instagib, and certain bot functions; called on ENTER
996 - executes script 997 and 188; called on RESPAWN
995 - Sets specific console variables to the server; called on OPEN
994 - forces bots to not use weapons/forces weapons that break modes to not work; execution unknown
991 - silent color swap; execution on all charge weapons
990 - power stone/top spin rotation script; execution none (deprecated for A_SetAngle)
989 - none, empty script: execution: none
987 - failsafe for timestopper; executed on death
986 - time stopper hud script; executed on Time Stopper
985 - none, empty script: execution: none
984 - buster check script; exection unknown
983 - bot helper part 1; executed on enter
982 - executed script 983; executed on respawn
981 - LMS rotation gives; executed by the buster weapons
980 - LMS RNG; executed on OPEN
979 - empty script; executed by all weapons (no ammo state)
978 - forces bot to use the buster; execution unknown
977 - jump cancel script; executed on enter (not reexecuted by RESPAWN)
976 - screen flash; executed by ScreenFlash, Flash Stopper, and Centaur Flash
975 - mode check scripts; various
974 - freese/unfreeze bots so charge weapons are used
973 - turns off show weapon names on client; executed on enter
205 - beat call; executed by most pits
204 - set low/normal gravity; executed by the lowgravity and normalgravity
203 - boss music - executed by killedme
202 - flame blast oil burning script (deprecated)
200 - unlocks secrets; executed by campaign
199 - return the unlocked secret in an argument; executed by the campaign
198 - locks all secrets; executed by campaign
197 - gives killer weapons from campaign; executed on enter
196 - executes 197; executed on respawn
195 - bot jump; executed by CreateBotBuddy
194 - bot select buster; execution unknown
193 - Timestopper failsafe
192 - time stopper failsafe (disconnection); called on disconnect
191 - scorch wheel speed modifyer; executed by scorch wheel
190 - tire bounce script; called by tires in turboman/lights lab
300 - beat support shooting; called by beat support
257 - script that returns the player number or the thingid of the target of the script caller; unknown execution
254 - Returns 1 if the activator of the script is a bot; execution unknown
253 - Platform carry script; executed by Moby and the Gutslifts
252 - bot help part 2 (Beed's part); executed on enter
251 - executes script 252; executed on respawn
250 - water check script; execution on Oil Slider
249 - Flash Stopper blindness; called my the player when hit by flash stopper
248 - Thunder claw peg pulling script; executed by thunder claw peg
447 - Push pull script; unused
188 - Possession issue prevention; executed on enter
[WCOLORS.acs]
998 - sets colors to the player based on the weapon; executed by every weapon
255 - sets colors to the weapon capsules on the clientside; executed on enter and every match start (reexecuted if ConsolePlayerNumber!=PlayerNumber)
993 - color definitions; executed on OPEN
992 - ammo give script; executed on capsule pickup
[SINGLEP.acs]
187 - campaign saving; executed on ENTER

Classes v6c (not compatible with v3a; no real organization)

(click to show/hide)

[BUGFIX.acs]
187 - none; compatability with old classes mods?
137 - the same
139 - the same
144 - the same
188 - the same
140 - the same
141 - team colors fix; executed on enter
142 - executes sript 141; executed on respawn
143 - returns the team of the target if in a team game
210 - nothing; empty script
147 - returns the thingID of the actor's target
500 - Alternate gamemode helpers to keep things balanced; executed on enter
501 - executes script 500; executed on respawn
159 - sets the calling actor to the angle of its target; execution unknown
160 - wall jump script; execution on Cutman and Slashman
647 - removes a disconnecting player's "corpse" if it left one
648 - adds class-based variation to abilities
207 - push script; executed by Knightman and Magnetman
208 - *cough* artihealingradius*cough*; executed by plantman
209 - dustman suction; executed by dustman
148 - dustman suction continued (dust particles); executed by dustman
149 - gemini clone spawner; executed by geminiman
150 - reposition syncronization for clone; executed by geminiman
151 - another empty
206 - gravity script; executed by gravityman
211 - wily burning; executed by wily's victim
212 - gravity script; apparently various (too lazy to look at DECORATE)
146 - ...Returns the current jump value of the calling actor time 4.2?; execution unknown
649 - Returns whether or not the calling actor's target is Ringman/Crashman;
   executed by...I'm assuming their respective projectiles
[UNDRWTR.acs]
250 - Determines whether the calling actor is under water (and in bubbleman/diveman); called by oil slider, oilman, and bubbleman
[WCOLORS.acs]
993 - Creates all translations used in the mod; executed on OPEN
422 - energy balancer; executed by script 992
423 - doc robot ammo divider;
992 - energy balancer weapon energy; executed by weapon energy
      There's even still credit to Messatsu in these...lol...
[GLOBAL.acs]
991 - silent color switch; various
984 - weapon capsule checks; executed by weapon energy
983 - Bot adaptation, makes bots work with special ammo, as well as built in bot AI in the DECORATE; executed on enter
977 - jump cancel script, with added wall jumping abilities; executed by enter
191 - Speed Adjustment script; various executions

A note to non-coders, using GLOBAL.acs in a mod just replaces the normal one, so there will not be any overlap of script numbers; this rule applies to all replaced ACS files. The example about RageRobo and CSCC was concerning scripts 700 onwards.

I plan on updating this in the future with updated numbers and more mods with ACS.

[Laggy Blazko]

Thanks for the list. I hope Zandronum implements named scripts soon (though I've heard they only work in certain cases I can't remember).

[Beed28]

Someone's submitted a ticket on the tracker. I hope they'll add it soon.

[Stardust]

Ah, thanks, Lego for listing these ACS. I won't get into ACS creation now, through I can have a better view of the slots used.
Because, it's true : I don't know at all why did they used the script 251 and the script 999, while they could have make the things clearer by using the scripts 1 and 2. The same goes for the actors, through they are more homogeneous, their numbers are around the 10.000~11.000...
wait there is 1000 between 10.000 and 11.000 !?

[Russel]

Well, Stardust, scripts 1-100 are supposed to be reserved to mappers; maybe going down from 999, and the script numbers (without optimization) would easily still be less than 100 total, freeing up everything from 101-801 to modders. As for DoomEd numbers, they are all occupied below a certain threshold by native ones.

[mrjnumber1]

what insane moron came up with that convention.. and how has it gone unchanged until, apparently, recently?

[Russel]

Apologies for the rather massive bump.
Anyhow.
I figured out how different scopes work in ACS...specifically world and global scope variables.

To experiment, I created two mods. One that printed the variable and one that modified it. Normally, the variable would always be shown as 0 on the mod that printed it, but I found that if you created a variable in one mod under the world or global scope and another variable in a different mod under the same scope and index and then modified it, this new value would be present in all mods that call that variable for values.

In code, it would look similar to this:

(click to show/hide)

Code: [Select]

world int 30: worldinit;

script 40 OPEN
{
Printbold(i:worldinit);
Delay(35);
PrintBold(i:worldinit);
}


Code: [Select]

world int 30: globalinit;

script 41 OPEN
{
Delay(16);
globalinit = 30;
printbold(s:"Setting globalinit to 30");
}


Note how the first block first prints the value as it started out, waits 1 second, then prints the updated value.
The second script waits about half a second and then modifies the variable established.
Also note how the variable names are different while the indexes and scopes are the same.

This use of world/global scoped variables would enable users to transfer information across multiple mods, which would enable things like compatibility between them regarding silly things like damagetypes and LMS loadouts...it could even allow modders to add special features within their mods that are designed specifically to work with a different mod. The only issues I see with this method are the limit of global and world scope variables to 50 different values...which could potentially cause some interesting errors if everyone decides to use the same index for their mods, it would cause some serious compatibility issues...almost worse than what we have now.

I received most of my information of this from here. I mainly wanted to point out that values established on world and global scope variables with the same indexes are transferred across all mods. However, both mods would have to establish the variable before they could call it.