ACE3/documentation/framework/dragging-framework.md

layout	title	description	group	order	parent
wiki	Dragging/Carrying Framework	Explains how to set-up dragging and carrying of objects with the ACE3 dragging and carrying system.	framework	5	wiki

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)
        ace_dragging_dragDirection = 0;  // Model direction while dragging (same as setDir after attachTo)

        // 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)
        ace_dragging_carryDirection = 0;  // Model direction while dragging (same as setDir after attachTo)
    };
};

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 and/or use setMass.

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, 0, 0])
3	Direction in degree to rotate the object	Number	Optional (default: 0)
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)
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°