Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

📝 Update TaskGoToCoordAnyMeansExtraParams and TaskGoToCoordAnyMeansExtraParamsWithCruiseSpeed #1089

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
34 changes: 17 additions & 17 deletions TASK/TaskGoToCoordAnyMeansExtraParams.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,24 +5,24 @@ ns: TASK

```c
// 0x1DD45F9ECFDB1BC9 0x094B75EF
void TASK_GO_TO_COORD_ANY_MEANS_EXTRA_PARAMS(Ped ped, float x, float y, float z, float speed, Any p5, BOOL p6, int walkingStyle, float p8, Any p9, Any p10, Any p11);
void TASK_GO_TO_COORD_ANY_MEANS_EXTRA_PARAMS(Ped ped, float x, float y, float z, float fMoveBlendRatio, Vehicle vehicle, BOOL bUseLongRangeVehiclePathing, int drivingFlags, float fMaxRangeToShootTargets, cs_type(Any) float fExtraVehToTargetDistToPreferVeh, cs_type(Any) float fDriveStraightLineDistance, int iExtraFlags);
```

```
NativeDB Added Parameter 13: Any p12
```
Comment on lines -11 to -13
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You cannot add arguments to the function declaration, it will break the ABI. I will fix this for you 🙂

Same as `TASK_GO_TO_COORD_ANY_MEANS` but with extra parameters.

## Parameters
* **ped**:
* **x**:
* **y**:
* **z**:
* **speed**:
* **p5**:
* **p6**:
* **walkingStyle**:
* **p8**:
* **p9**:
* **p10**:
* **p11**:
### Added parameters
* **fWarpTimerMS**: If the ped is stuck for that amount of milliseconds, it gets warped to the targeted position. Doesn't work if the ped is in a aircraft nor a boat.

## Parameters
* **ped**: The `Ped` Handle.
* **x**: The goto target coordinate.
* **y**: The goto target coordinate.
* **z**: The goto target coordinate.
* **fMoveBlendRatio**: 0.0 = still, 1.0 = walk, 2.0 = run, 3.0 = sprint.
* **vehicle**: If defined, the pedestrian will only move if said vehicle exists. If you don't want any sort of association, just set it to `0`.
* **bUseLongRangeVehiclePathing**: Setting to `true` tells the vehicle to use longrange vehicle pathing.
* **drivingFlags**: See `eDrivingMode` enum in the following native [`TASK_GO_TO_COORD_ANY_MEANS`](#_0x5BC448CB78FA3E88).
* **fMaxRangeToShootTargets**: Determines the maximum distance at which the `Ped` will engage in combat with threatening targets.
* **fExtraVehToTargetDistToPreferVeh**:
* **fDriveStraightLineDistance**:
* **iExtraFlags**: See `eTaskGoToCoordAnyMeansFlags` enum located at [`TASK_GO_TO_COORD_ANY_MEANS_EXTRA_PARAMS_WITH_CRUISE_SPEED`](#_0xB8ECD61F531A7B02).
54 changes: 37 additions & 17 deletions TASK/TaskGoToCoordAnyMeansExtraParamsWithCruiseSpeed.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,25 +5,45 @@ ns: TASK

```c
// 0xB8ECD61F531A7B02 0x86DC03F9
void TASK_GO_TO_COORD_ANY_MEANS_EXTRA_PARAMS_WITH_CRUISE_SPEED(Ped ped, float x, float y, float z, float speed, Any p5, BOOL p6, int walkingStyle, float p8, Any p9, Any p10, Any p11, Any p12);
void TASK_GO_TO_COORD_ANY_MEANS_EXTRA_PARAMS_WITH_CRUISE_SPEED(Ped ped, float x, float y, float z, float fMoveBlendRatio, Vehicle vehicle, BOOL bUseLongRangeVehiclePathing, int drivingFlags, float fMaxRangeToShootTargets, cs_type(Any) float fExtraVehToTargetDistToPreferVeh, cs_type(Any) float fDriveStraightLineDistance, int iExtraFlags, cs_type(Any) float fCruiseSpeed);
```

```
NativeDB Added Parameter 14: Any p13
Same as `TASK_GO_TO_COORD_ANY_MEANS` but with cruise speed control and other parameters.

```c
enum eTaskGoToCoordAnyMeansFlags {
TGCAM_DEFAULT = 0,
// Ignore the health of the vehicle (default behaviour is to not use any vehicle with less than 600 health)
TGCAM_IGNORE_VEHICLE_HEALTH = 1,
// Considers all nearby vehicles for suitability (default behaviour is to consider only the vehicle closest to the ped)
TGCAM_CONSIDER_ALL_NEARBY_VEHICLES = 2,
// Performs the same tests as is done in IS_VEHICLE_DRIVEABLE (default behaviour is to just check the vehicle's health)
TGCAM_PROPER_IS_DRIVEABLE_CHECK = 4,
// Instructs the ped to remain in the vehicle at the end, so that multiple tasks can be chained together.
TGCAM_REMAIN_IN_VEHICLE_AT_DESTINATION = 8,
// Ped will never abandon the vehicle it is in.
TGCAM_NEVER_ABANDON_VEHICLE = 16,
// Ped will never abandon the vehicle it is in if vehicle is moving.
TGCAM_NEVER_ABANDON_VEHICLE_IF_MOVING = 32,
// Peds will use the targeting system for threats and register any threats they can attack (rather than just using the closest targetable ped)
TGCAM_USE_AI_TARGETING_FOR_THREATS = 64
};
```

## Parameters
* **ped**:
* **x**:
* **y**:
* **z**:
* **speed**:
* **p5**:
* **p6**:
* **walkingStyle**:
* **p8**:
* **p9**:
* **p10**:
* **p11**:
* **p12**:
### Added parameters
* **fTargetArriveDist**: The distance at which the pedestrian will quit the vehicle (by default 4 meters).

## Parameters
* **ped**: The `Ped` Handle.
* **x**: The goto target coordinate.
* **y**: The goto target coordinate.
* **z**: The goto target coordinate.
* **fMoveBlendRatio**: 0.0 = still, 1.0 = walk, 2.0 = run, 3.0 = sprint.
* **vehicle**: If defined, the pedestrian will only move if said vehicle exists. If you don't want any sort of association, just set it to `0`.
* **bUseLongRangeVehiclePathing**: Setting to `true` tells the vehicle to use longrange vehicle pathing.
* **drivingFlags**: See `eDrivingMode` enum in the following native [`TASK_GO_TO_COORD_ANY_MEANS`](#_0x5BC448CB78FA3E88).
* **fMaxRangeToShootTargets**: Determines the maximum distance at which the `Ped` will engage in combat with threatening targets.
* **fExtraVehToTargetDistToPreferVeh**:
* **fDriveStraightLineDistance**:
* **iExtraFlags**: See `eTaskGoToCoordAnyMeansFlags` enum.
* **fCruiseSpeed**: The initial cruise speed of the vehicle
Loading