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

tweak(docs/native): Update Task Native Enums & Params #1130

Open
wants to merge 18 commits into
base: master
Choose a base branch
from

Conversation

DonHulieo
Copy link
Contributor

Changed TaskHeliMission & TaskVehicleMission parameters and enums, as well as updating their descriptions and styling to be in-line with PR #1128. Also fixed some minor typos in TaskBoatMission related in the styling of the first two 'Task_Mission' natives.

Added a small description and the driving style flag enum (see here and here). This could be used as reference to the description of drivingStyle to the 'Task_Mission' natives.

Updated parameters and description to be styled as PR [citizenfx#1128](citizenfx#1128).

All previous unk params now labelled, and added MissionFlag enums for respective functions.
Changed wording of 'except driver and boat' to 'except ped and boat' to reflect parameter names and updated parameter descriptions to end in periods as per the first two descriptions.
Updated with enum for driving flag values, possibly for reference from other natives which utilise driving flags (ie. `TaskBoatMission`, `TaskVehicleMission` etc.).
TASK/SetDriveTaskDrivingStyle.md Outdated Show resolved Hide resolved
TASK/TaskVehicleMission.md Outdated Show resolved Hide resolved
TASK/TaskVehicleMission.md Outdated Show resolved Hide resolved
TASK/TaskHeliMission.md Outdated Show resolved Hide resolved
TASK/TaskHeliMission.md Outdated Show resolved Hide resolved
DonHulieo and others added 13 commits June 13, 2024 15:08
Removed the native docs codeblock, and added a bit of extra info from the link housed there to ensure it's not lost. Minor wording changes around parameter descriptions to shorten them.
As per other commits, removing old code block, added a working lua example and referenced other natives in relevant parameters.
Co-authored-by: Dillon Skaggs <dillskaggs@gmail.com>
Co-authored-by: Dillon Skaggs <dillskaggs@gmail.com>
In testing the example, I found speed was not an optional param; updated accordingly.
When testing this example as well, confirmed task won't execute if target entity isn't a vehicle as well as speed is not an optional param and updated accordingly.

I find this strange when it definitely is optional for `TaskBoatMission` but alas.
@DonHulieo
Copy link
Contributor Author

This should be all suggested changes (so far) implemented.
Also updated all references to drivingStyle/driveMode with link back to function with enum.
Added lua examples in functions where I removed native docs as I felt that info was necessary before removing.

@DonHulieo
Copy link
Contributor Author

I've pushed requested changes to the examples, is there anything else you'd like me to update?

Is it also worth updating TaskPlaneMission in the same vein?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants