Merge pull request #1 from acemod/add-headless-component

Add headless client component

Author: thojkooi

addons/headless/$PBOPREFIX$

@@ -0,0 +1 @@
+z\acex\addons\headless

addons/headless/ACE_Settings.hpp

@@ -0,0 +1,20 @@
+class ACE_Settings {
+    class GVAR(Enabled) {
+        value = 0;
+        typeName = "BOOL";
+        displayName = ECSTRING(common,Enabled);
+        description = CSTRING(EnabledDesc);
+    };
+    class GVAR(Delay) {
+        value = DELAY_DEFAULT;
+        typeName = "SCALAR";
+        displayName = CSTRING(Delay);
+        description = CSTRING(DelayDesc);
+    };
+    class GVAR(Log) {
+        value = 0;
+        typeName = "BOOL";
+        displayName = CSTRING(Log);
+        description = CSTRING(LogDesc);
+    };
+};

addons/headless/CfgEventHandlers.hpp

@@ -0,0 +1,19 @@
+class Extended_PreInit_EventHandlers {
+    class ADDON {
+        init = QUOTE(call COMPILE_FILE(XEH_preInit));
+    };
+};
+
+class Extended_PostInit_EventHandlers {
+    class ADDON {
+        init = QUOTE(call COMPILE_FILE(XEH_postInit));
+    };
+};
+
+class Extended_InitPost_EventHandlers {
+    class AllVehicles {
+        class ADDON {
+            serverInit = QUOTE(_this call FUNC(handleInitPost));
+        };
+    };
+};

addons/headless/CfgVehicles.hpp

@@ -0,0 +1,37 @@
+class CfgVehicles {
+    class ACE_Module;
+    class GVAR(module): ACE_Module {
+        author = "STR_ACE_common_ACETeam";
+        category = "ACE_missionModules";
+        displayName = CSTRING(Module);
+        function = QFUNC(moduleInit);
+        scope = 2;
+        isGlobal = 1; // Global
+        isTriggerActivated = 0;
+        isDisposable = 0;
+        icon = QUOTE(PATHTOF(UI\Icon_Module_Headless_ca.paa));
+        class Arguments {
+            class Enabled {
+                displayName = ECSTRING(common,Enabled);
+                description = CSTRING(EnabledDesc);
+                typeName = "BOOL";
+                defaultValue = 0;
+            };
+            class Delay {
+                displayName = CSTRING(Delay);
+                description = CSTRING(DelayDesc);
+                typeName = "NUMBER";
+                defaultValue = DELAY_DEFAULT;
+            };
+            class Log {
+                displayName = CSTRING(Log);
+                description = CSTRING(LogDesc);
+                typeName = "BOOL";
+                defaultValue = 0;
+            };
+        };
+        class ModuleDescription {
+            description = CSTRING(ModuleDesc);
+        };
+    };
+};

addons/headless/README.md

@@ -0,0 +1,16 @@
+acex_headless
+============
+
+Adds automatic passing of AI groups to (up to 3) Headless Clients.
+- Automatic Headless Client recognition
+- Event-based transferring (on unit spawn, Headless Client connect and disconnect)
+- Round-robin transferring when more than 1 Headless Client is present
+- Mission makers can use the following to prevent a group from transferring to a Headless Client:
+    `this setVariable ["acex_headless_blacklist", true, true];`
+
+
+## Maintainers
+
+The people responsible for merging changes to this component or answering potential questions.
+
+- [Jonpas](http://github.com/jonpas)

addons/headless/UI/Icon_Module_Headless_ca.paa

@@ -0,0 +1,16 @@
+#include "script_component.hpp"
+
+// Exit on player clients that are not hosts
+if (hasInterface && !isServer) exitWith {};
+
+["SettingsInitialized", {
+    if (isServer) then {
+        // Add disconnect EH if HC transferring enabled
+        if (GVAR(Enabled)) then {
+            addMissionEventHandler ["HandleDisconnect", {_this call FUNC(handleDisconnect)}];
+        };
+    } else {
+        // Register HC (this part happens on HC only)
+        ["ACE_HeadlessClientJoined", [player]] call ace_common_fnc_globalEvent;
+    };
+}] call ace_common_fnc_addEventHandler;

addons/headless/XEH_postInit.sqf

@@ -0,0 +1,18 @@
+#include "script_component.hpp"
+
+ADDON = false;
+
+PREP(handleConnectHC);
+PREP(handleDisconnect);
+PREP(handleInitPost);
+PREP(moduleInit);
+PREP(rebalance);
+PREP(transferGroups);
+
+if (isServer) then {
+    GVAR(headlessClients) = [];
+    GVAR(inRebalance) = false;
+    ["ACE_HeadlessClientJoined", FUNC(handleConnectHC)] call ace_common_fnc_addEventHandler;
+};
+
+ADDON = true;

addons/headless/XEH_preInit.sqf

@@ -0,0 +1,17 @@
+#include "script_component.hpp"
+
+class CfgPatches {
+    class ADDON {
+        units[] = {};
+        weapons[] = {};
+        requiredVersion = REQUIRED_VERSION;
+        requiredAddons[] = {"acex_main"};
+        author[]= {"Jonpas"};
+        authorUrl = "https://github.com/jonpas";
+        VERSION_CONFIG;
+    };
+};
+
+#include "ACE_Settings.hpp"
+#include "CfgEventHandlers.hpp"
+#include "CfgVehicles.hpp"

addons/headless/config.cpp

@@ -0,0 +1,36 @@
+/*
+ * Author: Jonpas
+ * Registers connected Headless Client for use.
+ *
+ * Arguments:
+ * 0: Headless Client <OBJECT>
+ *
+ * Return Value:
+ * None
+ *
+ * Example:
+ * [headlessClient] call ace_headless_fnc_handleConnectHC;
+ *
+ * Public: No
+ */
+#include "script_component.hpp"
+
+params ["_headlessClient"];
+
+// Delay until settings are initialized (for checking if HC trasnferring is enabled)
+if (!(ace_common_settingsInitFinished)) exitWith {
+    (ace_common_runAtSettingsInitialized) pushBack [FUNC(handleConnectHC), _this];
+};
+
+// Exit if HC transferring disabled or HC already registered
+if (!GVAR(Enabled) || {_headlessClient in GVAR(headlessClients)}) exitWith {};
+
+// Register for use
+GVAR(headlessClients) pushBack _headlessClient;
+
+if (GVAR(Log)) then {
+    ACE_LOGINFO_1("Registered HC: %1",_headlessClient);
+};
+
+// Rebalance
+[true] call FUNC(rebalance);