Présentation

GDC_fnc_chooseSpawnPos est une fonction qui permet de laisser les joueurs choisir leur zone d'insertion selon certains critères.
Pendant le briefing, les joueurs peuvent déplacer un marqueur au moyen du bouton gauche souris (comme dans les missions cache cash) et au lancement de la mission, tous les joueurs sont déplacés à proximité du marqueur.
Il est possible de modifier l'effet de la fonction au moyen de plusieurs paramètres.

Function Header

Author: Sparfell
Description:
this function will allow the players to choose their spawn position during the briefing by moving a marker on the map using leftmousebutton

Parameter(s):
	0 : STRING - name of the marker that will be moved, the marker defines the spawn position
	1 (Optional): ARRAY - array fo objects that will be moved on selected position (default: []) if [] all playableunits will be moved
	2 (Optional): STRING - rank required in order to be able to move the marker (default: "SERGEANT")
	3 (Optional): STRING or ARRAY[string] - list of marker names or trigger names defining blacklisted areas (default: [])
	4 (Optional): NUMBER - 0: land only, 1: land and water, 2: water only (default: 1)
	5 (Optional): NUMBER - max spawn distance from marker (default: 30)
	6 (Optional): NUMBER - min spawn distance from terrain object (default: 4)
	7 (Optional): STRING or ARRAY[string] - area where the user can move the marker, if nothing passed, the whole map is allowed (default: [])
Returns:
nothing

Utilisation

A lancer depuis le init.sqf
Seul le premier paramètre est obligatoire, tous les autres sont optionnels.

Paramètres

0. STRING - Nom du marqueur qui pourra être déplacé par les joueurs pendant le briefing. Ce marqueur définit ensuite la position de spawn des joueurs.
1. (optionnel) ARRAY - Entre crochets la liste des objets qui seront déplacés sur la position choisie au début de la mission. Si vous laissez la liste vide [], toutes les unités jouables sont déplacées. (default: [])
2. (optionnel) STRING - Grade requis pour pouvoir déplacer le marqueur sur la carte du briefing (voir: https://community.bistudio.com/wiki/rank ). (default: "SERGEANT")
3. (optionnel) ARRAY de STRING et/ou d'OBJECT - Zones blacklistées (le joueur ne peut pas mettre le marqueur dans ces zones). Peut être un nom de marqueur (entre "") ou un nom de trigger. (default: [])
4. (optionnel) NUMBER - 0 = seulement sur la terre, 1 = sur la terre et sur la mer, 2 = seulement sur la mer. (default: 1)
5. (optionnel) NUMBER - Distance max entre la position sélectionnée pour un objet déplacé et la position du marqueur (plus le chiffre est élevé plus les éléments déplacés sont dispersés). (default: 30)
6. (optionnel) NUMBER - Distance min entre la position sélectionnée pour un objet déplacé et les objets du terrain à proximité (permet de sécuriser les éléments déplacés afin qu'il ne soient pas dans des objets). (default: 4)
7. (optionnel) ARRAY de STRING et/ou d'OBJECT - Zones whitelistées (le joueur ne peut mettre le marqueur que dans ces zones). (default: [])

Exemples

La fonction avec les paramètres optionnels par défaut donne ça :
["mk_spawn",[],"SERGEANT",[],1,30,4,[]] call GDC_fnc_chooseSpawnPos;
Ce qui revient donc à écrire ça :
["mk_spawn"] call GDC_fnc_chooseSpawnPos;

Si je veux définir juste le 4e paramètres (zones blacklistées), j'écris ça :
["mk_spawn",[],"SERGEANT",["mk_airport",trg_ville]] call GDC_fnc_chooseSpawnPos;

Dans le cas ci-dessous, les joueurs sont dans des bateaux donc seuls les bateaux sont déplacés, il n'y a pas de zones blacklistées mais le marqueur ne peut être placé que sur la mer :
["mk_spawn",[boat_1,boat_2],"SERGEANT",[],2] call GDC_fnc_chooseSpawnPos;