mirror of
https://github.com/acemod/ACE3.git
synced 2024-08-30 18:23:18 +00:00
1df3a73461
* Update documentation guidelines * Add version info part 1 * Add version info part 2 * Add removed in version to frontmatter and tag testmissions as removed * Add version info part 3
100 lines
3.2 KiB
Markdown
100 lines
3.2 KiB
Markdown
---
|
|
layout: wiki
|
|
title: Dragging/Carrying Framework
|
|
description: Explains how to set-up dragging and carrying of objects with the ACE3 dragging and carrying system.
|
|
group: framework
|
|
order: 5
|
|
parent: wiki
|
|
mod: ace
|
|
version:
|
|
major: 3
|
|
minor: 0
|
|
patch: 0
|
|
---
|
|
|
|
## 1. Config Values
|
|
|
|
```cpp
|
|
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
|
|
|
|
<div class="panel callout">
|
|
<h5>Note:</h5>
|
|
<p>The following functions are NOT public and are likely to change in the future!</p>
|
|
</div>
|
|
|
|
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, 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°
|