DCS hook onPlayerTryChangeSlot

Envrioment:	Server
Function:	onPlayerTryChangeSlot		Added with: 2.5.0
Member Of:	hook
Syntax:	nothing hook.onPlayerTryChangeSlot(number playerId, number side, string slotId )
Description:	Occurs when a player clicks on a new slot to try and enter a given aircraft. Can be used for slot blocking purposes within a mission or to force players access to one team or the other. playerId is who is attempting to join a slot side is the coalition the aircraft belongs to slotId is an identifier for the slot the player is trying to join. The identifier is based on the unitID for a given aircraft. However with multicrew seats the slotId has an additional "_x" added to the unitId to specify which seat it is. IMPORTANT: If any value is returned with this function then any other callback that uses it will be ignored. If no choice is to be made, then do NOT return any value. DCS itself uses this callback as part of the multicrew slot interface. By returning true the pilot will not get the prompt or have any choice in allowing another player from entering their aircraft.
Return Value:	nothing
Return Actions:	Value 1: boolean True: Allows the user into the slot False prevents the user from entering the slot. nil: Does nothing. Will allow additional hooks using this callback to be checked.
Examples:	Checks a list of players indexed by UCID to see if they have a coalition value assigned to them. If they do and the side is not the same then it denies the request. Otherwise it creates the entry with the specified side and does not return the function as to allow any other callback that might check for onPlayerTryChangeSlot to do its code. function myCall.onPlayerTryChangeSlot(playerId, side, slotId) local ucid = net.get_player_info(id, 'ucid') if someList[ucid] and someList[ucid].coa ~= side then return false else someList[ucid] = {coa = side} end end
Related Functions:	List of Callbacks: onMissionLoadBegin, onMissionLoadProgress, onMissionLoadEnd, onSimulationStart, onSimulationStop, onSimulationFrame, onSimulationPause, onSimulationResume, onGameEvent, onNetConnect, onNetMissionChanged, onNetConnect, onNetDisconnect, onPlayerConnect, onPlayerDisconnect, onPlayerStart, onPlayerStop, onPlayerChangeSlot, onPlayerTryConnect, onPlayerTrySendChat, onPlayerTryChangeSlot
Notes: