client/addons/locker/functions/fnc_equipGear.sqf
Jacob Schmidt 44625a8677
All checks were successful
Build / Build (push) Successful in 27s
feat: Refactor and document client-side functions
This commit refactors and adds documentation to several client-side functions across various addons, including:

- **Task Addon:** Added function headers and descriptions to task-related functions (fnc_destroy, fnc_attack, fnc_defuse, fnc_hostage, fnc_makeIED, fnc_hvt, fnc_heartBeat, fnc_makeTarget, fnc_makeHVT, fnc_makeHostage, fnc_makeObject, fnc_makeShooter, fnc_attackModule, fnc_destroyModule, fnc_hvtModule, fnc_hostageModule, fnc_defuseModule, fnc_protectedModule, fnc_hostagesModule, fnc_explosivesModule, fnc_shootersModule).
- **Org Addon:** Updated author and added function headers/descriptions to organization-related functions (fnc_initOrgStore, fnc_requestServerDB, fnc_addAsset, fnc_addReputation, fnc_create, fnc_removeAsset, fnc_addFunds, fnc_leave, fnc_addMember, fnc_disband, fnc_verifyOrgStore, fnc_handleOrgLoad).
- **Garage Addon:** Added function headers and descriptions to garage-related functions (fnc_openGarage, fnc_fetchNearby, fnc_initGarage, fnc_fetchGarage, fnc_storeVehicle).
- **Locker Addon:** Added function headers and descriptions to locker-related functions (fnc_openLocker, fnc_fetchPlayer, fnc_initLocker, fnc_fetchLocker).
- **Phone Addon:** Added function headers, descriptions, and examples to phone-related functions (fnc_initAction, fnc_showEmail, fnc_showMessage, fnc_delEmail, fnc_delMsg, fnc_showMessageInput, fnc_addContact, fnc_initPhone, fnc_addMsg, fnc_addEmail, fnc_newEmail, fnc_initVar, fnc_addOfflineEmail, fnc_addOfflineMsg, fnc_sendMsg, fnc_sendEmail, fnc_showContact, fnc_newMsg, fnc_dateToHhMm, fnc_initAddAction, fnc_openPhone, fnc_viewSettings, fnc_viewMessages, fnc_viewContacts, fnc_viewEmail, fnc_showDialpad, fnc_showSafari).
- **Admin Addon:** Added function headers and descriptions to admin-related functions (fnc_adminMessage, fnc_printAddonName, fnc_initAdmin, fnc_openAdmin, fnc_adminPromote).
- **Store Addon:** Added function headers and descriptions to store-related functions (fnc_openStore, fnc_initStore, fnc_selectProduct, fnc_changeFilter, fnc_changePayment, fnc_handlePurchase).
- **Medical Addon:** Added function headers, descriptions, and examples to medical-related functions (fnc_saveDroppedWeapons, fnc_moveInventory, fnc_onRespawn, fnc_onKilled, fnc_initMedical, fnc_deductMedicalCost, fnc_heartBeat).
- **Misc Addon:** Added function headers, descriptions, and examples to misc-related functions (fnc_formatNumber, fnc_isAssignableBinocular, fnc_isWeaponType, fnc_cargoToPairs, fnc_serializeString, fnc_deserializeString, fnc_getSystemTime).
- **Init Addon:** Updated author and removed unnecessary copyright information from init-related functions (fnc_initPlayer, fnc_playerDBSave, fnc_playerSaveLoop, fnc_playerDBLoad, fnc_handlePlayerLoad).
- **Money Addon:** Removed unnecessary copyright information from money-related functions (fnc_takeCash, fnc_giveCash, fnc_giveCashSubmit).
- **Interaction Addon:** Removed unnecessary copyright information from interaction-related functions (fnc_initInteraction, fnc_openInteraction, fnc_interactionAction).
- **Ambient Addon:** Removed unnecessary copyright information from ambient-related functions (fnc_ambientSound).
- **Arsenal Addon:** Added function headers, descriptions, and examples to arsenal-related functions (fnc_openArmory, fnc_saveUnlocks, fnc_updateUnlocks, fnc_openGarage, fnc_addGarageVehicle, fnc_addVirtualVehicles, fnc_addVirtualVehicles).
- **Dialogue Addon:** Added function headers and descriptions to dialogue-related functions (fnc_selectAI, fnc_selectDialogue).
- **Service Addon:** Added function headers and descriptions to service-related functions (fnc_initService).
- **Bank Addon:** Added function headers and descriptions to bank-related functions (fnc_initBank, fnc_refresh, fnc_openBank).

These changes improve code readability, maintainability, and provide better context for developers working with these functions. The author field was updated to `IDSolutions` where appropriate.
2025-04-05 16:12:32 -05:00

173 lines
5.6 KiB
Plaintext

#include "..\script_component.hpp"
/*
* Function: forge_client_locker_fnc_equipGear
* Author: IDSolutions
*
* [Description]
* Equips gear from the locker.
*
* Arguments:
* N/A
*
* Return Value:
* N/A
*
* Examples:
* [] call forge_client_locker_fnc_equipGear;
*
* Public: Yes
*/
private _display = findDisplay IDD_LOCKERDIALOG;
private _playerItems = _display displayCtrl IDC_PLAYEREQUIPMENTLIST;
private _lockerItems = _display displayCtrl IDC_LOCKEREQUIPMENTLIST;
private _selectedItem = lbCurSel _lockerItems;
private _selectedItemData = _lockerItems lbData _selectedItem;
private _data = call compile _selectedItemData;
private _locker = GETVAR(player,FORGE_Locker,[]);
if ((isNil { _data })) exitWith { ctrlEnable [IDC_EQUIPBUTTON, true]; };
private _itemType = _data select 0;
private _item = _data select 1;
private _clear = true;
switch (_itemType) do {
case "backpack": {
if (isNull (unitBackpack player)) then {
player addBackpack _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You already have a backpack equiped!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "facewear": {
if (goggles player == "") then {
player addGoggles _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You already have facewear equiped!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "headgear": {
if (headgear player == "") then {
player addHeadgear _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You already have headgear equiped!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "hmd": {
if (hmd player == "") then {
player linkItem _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You already have a HMD equiped!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "item": {
if (player canAdd _item) then {
player addItem _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You don't have enough space left!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "magazine": {
if (player canAdd (_item select 0)) then {
player addMagazine [(_item select 0), (_item select 1)];
playSound "FD_Finish_F";
} else {
_clear = false;
["You don't have enough space left!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "uniform": {
if (uniform player == "") then {
player forceAddUniform _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You already have a uniform equiped!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "vest": {
if (vest player == "") then {
player addVest _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You already have a vest equiped!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
case "weapon": {
private _weaponType = getNumber (configFile >> "CfgWeapons" >> _item >> "type");
private _hasSpace = switch (_weaponType) do {
case 1: {primaryWeapon player == ""}; // Primary
case 2: {handgunWeapon player == ""}; // Handgun
case 4: {secondaryWeapon player == ""}; // Launcher
case 131072: {false}; // Binoculars
default {true};
};
if (_hasSpace) then {
private _compatibleMags = getArray (configFile >> "CfgWeapons" >> _item >> "magazines");
private _baseType = (_compatibleMags select 0) select [0, (_compatibleMags select 0) find "_Tracer"];
if (_baseType == "") then {_baseType = _compatibleMags select 0};
private _magIndices = [];
{
if ((_x select 0) == "magazine") then {
private _magClass = (_x select 1) select 0;
if ((_magClass in _compatibleMags || {("ACE_" in _magClass) && {_baseType in _magClass}}) &&
{player canAdd _magClass}) then {
player addMagazine [_magClass, (_x select 1) select 1];
_magIndices pushBack _forEachIndex;
};
};
} forEach _locker;
reverse _magIndices;
{_locker deleteAt _x} forEach _magIndices;
player addWeapon _item;
playSound "FD_Finish_F";
} else {
_clear = false;
["You don't have enough space left!", "warning", 3, "right"] call EFUNC(misc,notify);
playSound "FD_CP_Not_Clear_F";
};
};
};
if (_clear) then {
lbClear _lockerItems;
lbClear _playerItems;
_lockerItems lbSetCurSel -1;
_playerItems lbSetCurSel -1;
private _index = _locker findIf { _x isEqualTo _data };
_locker deleteAt _index;
SETPVAR(player,FORGE_Locker,_locker);
[] call FUNC(fetchLocker);
[] call FUNC(fetchPlayer);
ctrlEnable [IDC_EQUIPBUTTON, true];
};