Added in ACE3 v3.0.0

Dragging/Carrying Framework

1. Config Values

class CfgVehicles {
    class MyVehicle {
        // Dragging
        ace_dragging_canDrag = 1;  // Can be dragged (0-no, 1-yes)
        ace_dragging_dragPosition[] = {0, 1.2, 0};  // Offset of the model from the body while dragging (same as attachTo) (default: [0, 1.5, 0])
        ace_dragging_dragDirection = 0;  // Model direction while dragging (same as setDir after attachTo) (default: 0)
        ace_dragging_ignoreWeight = 1; // Ignore weight limitation for dragging (0-no, 1-yes)

        // Carrying
        ace_dragging_canCarry = 1;  // Can be carried (0-no, 1-yes)
        ace_dragging_carryPosition[] = {0, 1.2, 0};  // Offset of the model from the body while dragging (same as attachTo) (default: [0, 1, 1])
        ace_dragging_carryDirection = 0;  // Model direction while dragging (same as setDir after attachTo) (default: 0)
        ace_dragging_ignoreWeightCarry = 1; // Ignore weight limitation for carrying (0-no, 1-yes)
    };
};

2. Functions

Note:

The following functions are NOT public and are likely to change in the future!

You will not be able to carry / drag objects that are too heavy, the mass is also affected by what is inside the object. To bypass this empty the object. You can change the weight limits by setting ACE_maxWeightDrag (default 800) and ACE_maxWeightCarry (default 600).

2.1 Enabling / disabling dragging

ace_dragging_fnc_setDraggable

Arguments Type Optional (default value)  
0 Any object Object Required
1 Enable dragging, true to enable, false to disable Boolean Required
2 Position to offset the object from player Array Optional (default: [0, 1.5, 0])
3 Direction in degree to rotate the object Number Optional (default: 0)
4 Ignore weight limitation for dragging Boolean Optional (default: false)
R None None Return value

2.1.1 Example 1

[foo, true, [0, 2, 0], 45] call ace_dragging_fnc_setDraggable;

Arguments Explanation  
0 foo My object
1 true Dragging is enabled
2 [0,2,0] 0 meters sideways, 2 meters forward, 0 meters upwards
3 45 Rotated by 45°

2.1.2 Example 2

[bar, false, [3, -2, 2], 20] call ace_dragging_fnc_setDraggable;

Arguments Explanation  
0 bar My object
1 false Dragging is disabled
2 [3, -2, 2] 3 meters sideways, 2 meters backwards, 2 meters upwards
3 20 Rotated by 20°

2.2 Enabling / disabling carrying

ace_dragging_fnc_setCarryable

Arguments Type Optional (default value)  
0 Any object Object Required
1 Enable carrying, true to enable, false to disable Boolean Required
2 Position to offset the object from player Array Optional (default: [0, 1, 1])
3 Direction in degree to rotate the object Number Optional (default: 0)
4 Ignore weight limitation for carrying Boolean Optional (default: false)
R None None Return value

2.2.1 Example

[foo, true, [0, 3, 1], 10] call ace_dragging_fnc_setCarryable;

Arguments Explanation  
0 foo My object
1 true Carrying is enabled
2 [0,2,0] 0 meters sideways, 3 meters forward, 1 meter upwards
3 10 Rotated by 10°