ArmA: Armed Assault: Server Side Scripting

The server has a separate Virtual Machine (VM) running administration scripts. This VM is completely independent on the game scripting environment and is designed to automate some administration tasks related to player administration and cheat detection. The basic way how scripts are executed is via event handlers reacting to some typical events, server admin can also execute individual commands using a chat command #exec.

Event handlers are defined in server.cfg file.

The scripting language shares the core (overall structure and syntax, arithmetic operations, control structures) with the scripting used in the game. There are a few commands specific to Server Side Scripting:

command	description
users	list of users, each user is described as [id,name] array
ban id (sometext)	add given user id into the ban list, with an optional text
kick id (sometext)	kick off given user id from the server, with an optional text
level checkFile [id,file index]	check signature for a file with given index on given user computer, level determines test depth (0 = default, 1 = deep. Note: deep can be very slow)
numberOfFiles id	number of addons files used for given player - can be used to determine suitable values for checkFile

Following event handlers are executed:

event	description	handler parameters
doubleIdDetected	2nd user with the same ID detected	user id
onUserConnected	user has connected	user id
onUserDisconnected	user has disconnected	user id
onHackedData	modification of signed pbo detected	user id, file name
onDifferentData	signed pbo detected with a valid signature, but a different version than a server has (very strict test, use sparingly, no longer supported in Arma 2 OA 95232)	user id, file name
onUnsignedData	unsigned data detected	user id, file name
onUserKicked	if a user is kicked	user id, kick type ID, reason
regularCheck	called time by time for each user, test index is growing, example: 0 checkFile _this	user id, test index

⚠

NOTE: Be careful with onDifferentData. This "kick (_this select 0)"; will also kick players with only a different, but valid, version of a PBO than the server. (See also)