mirror of
https://github.com/acemod/ACE3.git
synced 2024-08-30 18:23:18 +00:00
86 lines
2.8 KiB
Plaintext
86 lines
2.8 KiB
Plaintext
/*
|
|
* Author: esteldunedain
|
|
* Change the value of an existing setting if it was not previously forced. Force if neccesary.
|
|
* If executed on clients it has local effect.
|
|
* If executed on server it can have global effect if the last parameter is set to true.
|
|
*
|
|
* Arguments:
|
|
* 0: Setting name <STRING>
|
|
* 1: Value <ANY>
|
|
* 2: Force it? (default: false) <BOOL>
|
|
* 3: Broadcast the change to all clients (default: false) <BOOL>
|
|
*
|
|
* Return Value:
|
|
* None
|
|
*
|
|
* Example:
|
|
* ["ace_map_gestures_enabled", true, false, true] call ace_common_fnc_setSetting
|
|
*
|
|
* Public: No
|
|
*/
|
|
#include "script_component.hpp"
|
|
|
|
params ["_name", "_value", ["_force", false], ["_broadcastChanges", false]];
|
|
|
|
private _settingData = [_name] call FUNC(getSettingData);
|
|
|
|
// Exit if the setting does not exist
|
|
if (_settingData isEqualTo []) exitWith {
|
|
ACE_LOGERROR_1("SetSetting [%1] setting does not exist", _name);
|
|
};
|
|
|
|
_settingData params ["", "_typeName", "_isClientSetable", "", "", "", "_isForced"];
|
|
|
|
// Exit if the setting is already forced
|
|
if (_isForced) exitWith {
|
|
ACE_LOGINFO_1("SetSetting [%1] Trying to set forced setting", _name);
|
|
};
|
|
|
|
//This does NOT broadcast changes to GVAR(settings), so clients would not get updated force status
|
|
if ((missionNamespace getVariable [QEGVAR(modules,serverModulesRead), false]) && {!(_isForced isEqualTo _force)}) then {
|
|
ACE_LOGWARNING_3("SetSetting [%1] attempting to broadcast a change to force (%2 to %3)", _name, _isForced, _force);
|
|
};
|
|
|
|
// If the type is not equal, try to cast it
|
|
private _failed = false;
|
|
if (typeName _value != _settingData select 1) then {
|
|
_failed = true;
|
|
if ((_typeName == "BOOL") && {_value isEqualType 0}) then {
|
|
// If value is not 0 or 1 consider it invalid and don't set anything
|
|
if (_value isEqualTo 0) then {
|
|
_value = false;
|
|
_failed = false;
|
|
};
|
|
if (_value isEqualTo 1) then {
|
|
_value = true;
|
|
_failed = false;
|
|
};
|
|
};
|
|
if ((_typeName == "COLOR") && {_value isEqualType []}) then {
|
|
_failed = false;
|
|
};
|
|
};
|
|
|
|
if (_failed) exitWith {ACE_LOGERROR_3("SetSetting [%1] bad data type expected %2 got %3", _name, _typeName, typeName _value);};
|
|
|
|
// Force it if it was required
|
|
_settingData set [6, _force];
|
|
|
|
// Exit if the value didn't change
|
|
if (_value isEqualTo (missionNamespace getVariable _name)) exitWith {};
|
|
|
|
// Update the variable
|
|
TRACE_2("Variable Updated",_name,_value);
|
|
missionNamespace setVariable [_name, _value];
|
|
|
|
if (isServer && {_broadcastChanges}) then {
|
|
// Publicize the new value
|
|
publicVariable _name;
|
|
|
|
// Raise event globally, this publicizes eventual changes in _force status so clients can update it locally
|
|
["SettingChanged", [_name, _value, _force]] call FUNC(globalEvent);
|
|
} else {
|
|
// Raise event locally
|
|
["SettingChanged", [_name, _value, _force]] call FUNC(localEvent);
|
|
};
|