Properties for new actor definitions 'Base' Class and 'Nazi' Class:

'Nazi' Class Only:

These actors spawn enemies when activated, and maintain a set number of those enemies alive (1 by default). Actors will not be spawned if a player can see the spawn point or if a player is within a defined minimum spawn distance from the spawner (default 512 units).

By default, the spawner will spawn a single guard. Once that guard is killed, the spawner will spawn another guard, and so on. This can replace situations where an ACS script might mindlessly spam a huge flood enemies, regardless of how many are being killed or not, by metering how many enemies are active at once.

Spawned actors can be given a TID and can be set to navigate to a specific PatrolPoint TID after spawn as well.

11519 - ActorSpawner

Custom UDMF Attributes

There are three main actors that should be configured together to make realistic alarm scenarios.

Alarms and Alarm Spawners must be given the same TID as an Alarm Panel that will control them, otherwise they will not function unless activated via ACS. You can have multiple Alarm Panels with the same TID (e.g., so that the player can turn of alarms from a side office after the alarms are turned on by a guard in a main area).

11516 - Alarm

11517 - AlarmSpawner

11518 - AlarmPanel

Color Grading in Scripts

For transitioning to a color grading directly in a script, the following two scripts can be used:

   ScriptCall("ColorGradeThinker", "TransitionTo", 0, 1, 140);
   ScriptCall("ColorGradeThinker", "TransitionTo", 0, 2, 700);

The first one makes a seamless transition to the color grade with the index number 1 in 140 tics, the second one a very slow transition to index number 15 (max) in 700 tics (which is about 10 seconds)

   ScriptCall("ColorGradeThinker", "Set", 0, 1);

Instead of transitioning to a color grading in a certain amount of time, you can also directly set it in a script. The above line sets the color grading instantly to the look-up table index 1.

Color Grading on Lines

ColorGradeSet immediately sets the supplied LUT index on the player who called the script.

   ACS_NamedAlwaysExecute("ColorGradeSet", 0, 9); // Instantly sets to index 9

ColorGradeTo transitions to the supplied LUT index over the course of the specified number of tics. If a transition is already taking place, the LUT is queued to transition to after the current transition is done.

   ACS_NamedAlwaysExecute("ColorGradeTo", 0, 4, 70); // Index 4, in 70 tics (what is standard if set to 0)

ColorGradeBetween is meant to be used as a linedef action. It will transition to a LUT depending on which side the line is triggered from. This is useful to mark a LUT "boundary" between two areas without having to use two linedefs with a ColorGradeTo call. 

   ACS_NamedAlwaysExecute("ColorGradeBetween", 0, 0, 4, 70); // Repeatable and player walkover

Color Grading Types

The textures/pplut.png look-up table has a wide variety of different color gradings for different situations.

More Grading Types will be added soon.

These actor types will show up on the player's compass automatically when they are placed in the map. A good reference map for how these should be implemented is C3M2.

As a general rule, Primary Objective Markers (red) should be used to mark mission-critical areas that must be visited, and Secondary Markers (orange) should be used to indicate necessary specific actions/conversations/pickups.

Additionally, any other actors that are tagged with a specific TID can be made to show up as a grey dot on the compass via ACS by calling the "BoA_CompassQueue" script.

   ACS_NamedExecuteAlways("BoA_CompassQueue", 0, thingTID);

Or, you can specify a specific image ("ICON", here) to be used as the icon.

   ACS_NamedExecuteAlways("BoA_CompassAddIcon", 0, "ICON", thingTID);

Note that calling this script will add all actors with the matching TID to the compass.

Primary Objective Markers

These actors are used to indicate the general area of a primary objective or significant waypoint in the map. They should be used sparingly, so that seeing a red exclamation pointon the compass doesn't lose importance; only major mission-related locations should have a red marker.

These actors can be spawned as DORMANT, then activated via "Thing_Activate" in ACS, or they can be spawned normally and hidden or removed later using "Thing_Deactivate" or "Thing_Remove".

Take special care to properly activated/deactivated/removed markers via ACS as the mission progresses in order to keep the path of progression clearly indicated on the compass... In other words, as the path to a specific objective becomes available to the player, the marker for that objective should become active, then, once the objective is reached, the marker should be deactivated or removed.

These don't have to correspond perfectly to the listed objectives - For example, most maps essentially have a final objective of "Find Douglas/Ryan/Asher in order to return to HQ" upon completion of all of the primary objectives; even though "Finish the map" is not a listed objective, there should probably still be a red marker placed once that becomes the player's next goal. As another example, if a single objective requires multiple similar actions across the map to complete (like placing Comp B charges), each of those locations should be marked with a red marker.

Secondary Objective Markers

These actors are typically used to mark NPCs that can be talked to, switches that should be activated, etc. These markers will not be added to the player's compass until the player is within 2048 units and has a line of sight to the marker.

Mission/Quest Item Markers

All items which inherit from the 'CompassItem' class, as well as any disguise/uniform pickups, will automatically be added to the player's compass. These actors will use their inventory icon as their compass icon; if one is not set, they will use their spawn state sprite as their icon.

   Akten         AktenEisenmann      AktenV2
   AktenDream      AktenDreamClue      ArtifactAstrostrein
   ArtifactAstrostreinIM   ArtifactEgyptian   ArtifactEgyptian_H1
   ArtifactEgyptian_H2   SpearOfDestiny      Cartridge51
   Cartridge52      Cartridge53      RepairKit
   Crank         RadioPickup      Kennkarte
   GrapplingHook      ChutePickup      ScientistUniform
   SSBJUniform      CCBJUniform      ZombieArmClue
   ZombieHeadClue      MineralClue

Base- and Nazi-class Enemies

By setting the 'user_oncompass' UDMF attribute of an enemy actor to 1, that actor will be added to the player's compass automatically. These actors will use a grey dot as their compass icon. The icon for actors that are also tagged with the 'user_drawhealthbar' UDMF property will be tinted with color to indicate the health level of that actor.

ActorSpawner-Spawned Enemies

By setting the 'user_oncompass' UDMF attribute of an ActorSpawner actor to 1, all enemies spawned by that actor will be added to the player's compass automatically. These actors will use a grey dot as their compass icon. See the initial machine-gun turret fight in C3M2 for a working example.

The player's crosshair can be set via ACS or by setting the user_crosshair UDMF property on a linedef that the player is directly looking at.

"Hold-to-activate" lines

Within Blade of Agony, player control handling has been altered so that holding down the 'use' button while facing a 'repeatable' activation line will cause that line's special to be run once per tick for as long as the 'use' button is held (and not just once per 'use' press, as is normal). In most cases, this change doesn't alter gameplay at all, however, scripts can be written to take advantage of this implementation.

An actor that will stand dormant until it sees a player, then will follow that player. The actor can be set to carry a specific weapon.

If a playerfollower has no weapon, and falls significantly far behind the player, when he re-appears, he will have gained a pistol.

Custom Properties

PWEAP_None
PWEAP_Melee
PWEAP_Luger
PWEAP_MP40
PWEAP_Rifle
PWEAP_Grenade

Useful Variables

SetActorFlag(tid, "NOBLOCKMONST", 0);

There are various post-processing shaders for the player screen that can be used at any time as effects to support certain situations. Just give or take the corresponding tokens to the player inventory to activate or deactivate time ingame.

A derivative of the skybox viewpoint actor that moves in relation to the player's movement, giving the illusion that the skybox is a part of normal level geometry.

The map author can specify the amount that the skybox's movement is scaled relative to the player's motion, allowing for a very small skybox to appear much larger and closer in relation to the player.

By default, the "anchor", or the neutral origin point of the skybox view, will be the player's spawn location. Alternatively, the viewpoint can also be "anchored" to a map actor by specifying the TID of the actor to use as the anchor.

19990 - SkyViewpointStatic - The viewpoint actor for use in static skyboxes

Editor Arguments

19991 - SkyViewpointAnchor - A generic mapspot that can be assigned a TID and used as an anchor for static skybox viewpoints