Curator – Arma 3

Curator is a technical name for Arma 3 Zeus game master system. Every involved scripting command, event handler or class name contains the name. The reason for it is to have a generic name which can be passed from project to project without any associations.

Setup

The central piece of every curator is Game Master module, otherwise referred to as Curator Logic. It stores every setting, like editing areas, available objects or their costs.

You can find the module in Modules (F7) > Zeus > Game Master

In module arguments, can set the curator unit (either specific unit, player with given UID or server admin) and that's all you need to add game master to your mission. Without any further settings, all objects will be available for free and whole map will be editable.

In every examples on this page, we'll call the module myCurator.

Costs

Mission designer can assign cost to every object curator can interact with. The cost is applied when performing actions like placing, editing or deleting. It affects curator's resources - points - which are in range from 0 (no points) to 1 (full points; can't be larger than this value). The cost can be both negative and positive, so some actions can actually add points (e.g., deleting). Points can be adjusted by addCuratorPoints and returned using curatorPoints, or you can use Manage Resources module.

Points visualized in the curator interface

Assigning

Manual

You can assign individual cost for every object in the game using CuratorObjectRegistered event handler. It's executed when player enters curator interface, so individual values cannot be changed on the fly. However, you can still tweak costs using action coefficients and available objects by unlocking addons.

myCurator addEventHandler ["CuratorObjectRegistered",{...code here, see below...}];

Arguments passed into the handler are:

• curator: Object
• input: Array of Strings - all CfgVehicles classes

Expected returned value is an Array of Arrays of the same size as the input array, with each item belonging to a class with the same array index. Missing or incorrect values will be replaced by default [true,0,0].

• Input: [string1, string2, string3, ... classN]
• Output: [array1, array2, array3, ... arrayN]

Example:

• Input (3 classes): ["B_Soldier_F", "B_MRAP_01_F", "ModuleLightning_F"]
• Output (3 arrays with settings): [[true,0.1], [true,0.5,0.6], [false,0,0]]

Every item in the array is in the following format:

[show, cost, (costWithCrew)]

• show: Boolean - true to let the object appear in the CREATE list, false to hide it (costs will still be accepted if an object of the type is already present in the mission and made editable)
• cost: Number - cost of the object
• costWithCrew (Optional): Number - cost of the object with crew in it (affects only vehicles). When undefined, normal cost is used.

Example of the whole event handler:

myCurator addEventHandler [
	"CuratorObjectRegistered",
	{
		_classes = _this select 1;
		_costs = [];
		{
			_cost = if (_x isKindOf "Man") then {[true,0.1]} else {[false,0]}; // Show only objects of type "Man", hide everything else
			_costs = _costs + [_cost];
		} forEach _classes; // Go through all classes and assign cost for each of them
		_costs
	}
];

Using Cost Tables

Alternatively, you can use scripting functions which will simplify cost settings:

• Set cost of specific objects by BIS_fnc_curatorObjectRegistered, with crew costs calculated automatically based on vehicle cost + cost of all crew members.
• Export object list to a spreadsheet using BIS_fnc_exportCuratorCostTable, set values there and use them in the game again using BIS_fnc_curatorObjectRegisteredTable

Action Coefficients

Once you assigned cost to every object, you can now use it for every action curator can perform.

myCurator setCuratorCoef ["place",-0.2];

If some object, for example BLUFOR soldier "B_Soldier_F" from the previous example, will have assigned cost 0.1, cost for placing will be:

0.1 * -0.2 = -0.02

If curator have full points (value is 1), it means he can build 50 BLUFOR soldiers (-1 * -0.02 = 50). While individual object costs cannot be changed on the fly, coefficient can be easily used to tweak all costs.

Available actions are:

• "place"
• "edit"
• "delete"
• "destroy"
• "group"
• "synchronize"

Additionally, while action can be disabled by assigning large negative coefficient, e.g., -10000. Trying to perform the action will then result in onscreen warning for curator.

Coefficients can be also assigned in Set Editing Costs module.

Unlocking Addons

You can set which objects will be available curator by toggling specific addons. This can be done on the fly, and it's primary way how to unlock content for curator during a mission.

See Arma 3 assets to check which objects belongs to which addon, or use unitAddons to get addons of specific object class.

Initial addons can be adjusted in Game Master module attributes, with available values being:

• All official addons - default state, includes all activeted addons
• Addons present in the mission - only addons of objects present in the mission upon mission start. E.g., if you inserted only BLUFOR soldiers and MRAPs in the mission, addons will be ["A3_Characters_F_BLUFOR","A3_Soft_F_MRAP_01"]
• None - no addons are enabled by the module, mission designer has to add them manually.

During the missions, use Manage Addons module or scripting commands to toggle addons:

• addCuratorAddons
• removeCuratorAddons
• removeAllCuratorAddons
• curatorAddons

Example:

myCurator addCuratorAddons ["A3_Armor_F_AMV","A3_Armor_F_Panther"];
myCurator removeCuratorAddons ["A3_Soft_F_MRAP_01"];

Editable Objects

By default, every object placed by curator is immediately made editable. Any other object can be added by Add Editable Objects module or using scripting commands:

• addCuratorEditableObjects
• removeCuratorEditableObjects
• curatorEditableObjects

Editable players are marked by a red color in the EDIT list and by red circle displayed over their icon. They cannot be moved, rotated, deleted or destroyed, but grouping, syncing and setting attributes works. Editable players can also ping their curator by pressing Zeus key ('Y' by default), which results in their name and icon flashing for a short moment. Curator can press 'Space' to quickly move the camera to their location.

Editing Areas

Blue editing area border visible in the background

Editing area is a zone in which curator can modify entities. It's used to limit curator into specific area, or restrict him from other (e.g., around players).

It can be set using Add Editing Area module or by following scripting commands:

• addCuratorEditingArea
• removeCuratorEditingArea
• removeAllCuratorEditingAreas
• curatorEditingArea
• setCuratorEditingAreaType
• allowCuratorLogicIgnoreAreas

Areas can be circle only, and can be composed together to build much larger area. Mission designer can set whether editing is allowed only inside them, or only outside them. For performance reasons, it's not possible to define it per individual area.

For curator, the area is visualized by blue (during day) and green (during night) "walls" in the scene and by black icons in the map. Players can't see it.

Table showing which actions are permitted outside of the editing area for each entity type:

	Place	Edit	Delete	Destroy	Group	Synchronize
Objects	Restricted	Restricted	Restricted	Allowed	Allowed	Allowed
Modules	Based on allowCuratorLogicIgnoreAreas			N/A	N/A	Allowed
Markers	Allowed	Allowed	Allowed	N/A	N/A	N/A
Waypoints	Allowed	Allowed	Allowed	N/A	N/A	N/A

Camera

Camera Area

Camera area defines where can curator move with the camera. It's not visualized in any way, but reaching the border will result in camera "sliding" along it, so it can be felt. As with editing areas, camera ones can also be grouped into larger chunks, and designer can set whether they camera can operate only inside or only outside of them. Additionally, it's possible to set maximal camera altitude.

Use Add Camera Area or following scripting commands to set the area:

• addCuratorCameraArea
• removeCuratorCameraArea
• removeAllCuratorCameraAreas
• curatorCameraArea
• setCuratorCameraAreaCeiling

Camera Position

You can teleport curator camera to specific position using Set Camera Positon. The module can be also use to set default camera position after opening curator interface, when Use as default module attribute is set to Enabled.

In scripts, you can move curatorCamera around like any other object. However, most won't work on it. The camera is local to curator owner, so any changes to it has to be executed locally as well.

Example:

curatorCamera setPos [position player select 0,position player select 1,30];
curatorCamera setVectorDirAndUp [[0,1,-0.5],[0,0,1]];

You can also call BIS_fnc_setCuratorCamera, which will also let you to transition the camera into desired position smoothly.

Attributes

Attribute window of Custom Objective module

Attributes are specific settings available after double-clicking on an entity.

You can set which attributes will be available for entities by Set Attributes modules or using BIS_fnc_setCuratorAttributes. By default, all attributes are shown. Modules are using custom attributes.

Available attributes for each entity type are:

• Object / Player
  • Skill
  • UnitPos
  • Rank
  • Damage
  • Fuel
  • Lock
  • RespawnVehicle
  • RespawnPosition
• Group
  • GroupID
  • Behaviour
  • Formation
• Marker
  • Text
  • Color
• Waypoint
  • Behaviour
  • Formation