🚩Missions Model
Register New Mission
RegisterMission(missionData)MissionData:
objectId:
stringCustom ID (Cannot be same as other missions)
Name:
stringCustom Mission Name
Description:
stringCustom Mission Description
Options:
objectConditions:
objectAccessJobs:
tableA list of authorized Jobs
GameHour:
objectHourMin:
numberHourMax:
numberMinuteMin:
numberMinuteMax:
number
PreCondition:
functionMust be return
TRUEorFALSEExample:
return IsPedArmer() and true or false
Rewards:
tableCustom:
functionThis is a
SERVERfunction, so you can use xPlayer or QbPlayer, etc.
GameVariables:
objectA custom mission variables
INFO: This variables can be modified in live game
Example:
GameVariables = { StartPosition = vec3(100, 100, 50) }So in the game mission you can call GameVariables.StartPosition
Objetives:
tableDescription:
stringStages:
tableonFinish:
functiononStart:
function
onStageComplete:
functionWhen stage is complete
Preload:
functionPreload functions before objetive start
onComplete:
functionWhen objetive ends
onStart:
functionWhen the mission start
onComplete:
functionWhen the mission ends
as parameters you get:
isForced: Indicate if the mission has been forced to finish (for example: admin canceled the mission)reason: Receive an end reason.
Empty Model
RegisterMission({
Id = "",
Name = "",
Description = "",
Options = {
Conditions = {
AccessJobs = { "any" },
PreCondition = function(gameVariables)
return true
end,
},
Rewards = {
Custom = function(playerId)
end
},
GameVariables = { }
},
Objectives = {
[1] = {
Description = "",
Stages = {
[1] = {
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
},
onStageComplete = function(stageId)
end,
Preload = function(startStage)
return startStage
end,
onComplete = function(isForced, reason)
end,
isComplete = false -- Internal variable, dont touch.
}
},
onStart = function(startObjective)
return startObjective
end,
onComplete = function(isForced, reason)
print("Mission is finished: ", reason)
end
})Start Logic
PMM is responsible for initiating a mission within the system. This function performs various checks and conditions before starting the mission, and sets the data for the current mission, current objective, and current stage.
Functioning
First, the mission data corresponding to the provided missionId is obtained.
Destroy any previous game or activity in progress should be terminated.
A series of checks and conditions are then performed before starting the mission, such as checking the player's access to the required job and game time. These checks are based on mission options and conditions.
If all the conditions are true, some additional actions are executed, such as checking the server preconditions and conditions.
If all checks and conditions are passed, the data for the current mission, current objective, and current stage are set.
The variables and effects necessary to start the mission are established.
The Preload and onStart functions of the current target and the current stage are executed respectively.
Finally, the callback function is called with a success boolean and a reason string to indicate whether the mission started successfully and provide additional information about the result.
It is important to note that this function is designed to be used within the PMM system and is expected to be called from internal system components or from resources integrated with PMM.
Start Logic (Simple)
Check if any game is running and destroy it.
Check pre-conditions to start game.
Start missions effects (Some internal logic)
Execute Mission.onStart().
Execute Objetive.Preload().
Execute Stage[1].onStart().
The game start!
Mission Structure
The logical order of the PMM is:
Stage 1, Stage 2... etc. If there are no more stages they will continue to the next objective, if there are no more objectives, they will end the mission successfully.
Buuut! You can also create cause-and-effect missions, where when making decisions you can skip stages or objectives. (Game variables can help a lot in this)
Can you imagine a mission where you have to decide which path to take to save your life?
You have to understand the following:
A mission fits one or more objectives, objectives that have one or more stages to complete.
Important: It is recommended to follow the order of the delivered structure, however, it is not mandatory if you want to do your mission in a single objective with a single stage.
Important 2: The FULL mission works within a loop, so you should only use the return from the end of each stage / objective and not add additional returns ones.
Example: (Robbery Mission)
Objective 1: "Get into the bank"
Stage 1: Break the door
Stage 2: Enter the center of the bank
Objective 2: Extract money
Stage 1: Install drill
Stage 2: Wait (waves of enemies)
Stage 3: The security door opens and they must enter
Stage 4: Steal 1000 dollars
Objective 3: Flee
Stage 1: Get out of the bank
Stage 2: Move 200 meters away.
Or a simpler mission could be:
Example 2: (Robbery Mission):
Objective 1: Steal and escape
Stage 1: Steal 5 boxes of chocolates and then run away
In fact, you can do everything in one stage or expand neatly to continue through each stage and break up your code.
Objectives
If you want generate more objectives, simply copy and paste after [1] = {}
Remember to replace [X] for the next objective id.
[x] = { ------- REPLACE ME | REPLACE ME | REPLACE ME | REPLACE ME
Description = "",
Stages = {
[1] = { -- BUSCAR VEHICULO
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
},
onStageComplete = function(stageId)
end,
Preload = function(startStage)
return startStage
end,
onComplete = function(isForced, reason)
end,
isComplete = false -- Internal variable, dont touch.
} Stages
Same as objectives, make sure replace X and add before [1] = {} in stages.
[X] = { ------- REPLACE ME | REPLACE ME | REPLACE ME | REPLACE ME
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},Example Advanced Mission
Meta:
Objective 1:
Stage 1
Stage 2
Stage 3
Objective 2:
Stage 1
Stage 2
RegisterMission({
Id = "",
Name = "",
Description = "",
Options = {
Conditions = {
AccessJobs = { "any" },
PreCondition = function(gameVariables)
return true
end,
},
Rewards = {
Custom = function(playerId)
end
},
GameVariables = { }
},
Objectives = {
[1] = {
Description = "",
Stages = {
[1] = {
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
[2] = {
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
[3] = {
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
},
onStageComplete = function(stageId)
end,
Preload = function(startStage)
return startStage
end,
onComplete = function(isForced, reason)
end,
isComplete = false -- Internal variable, dont touch.
},
[2] = {
Description = "",
Stages = {
[1] = {
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
[2] = {
onFinish = function()
end,
onStart = function()
return GM().NextStage(true)
end,
isComplete = false, -- Internal variable, dont touch.
},
},
onStageComplete = function(stageId)
end,
Preload = function(startStage)
return startStage
end,
onComplete = function(isForced, reason)
end,
isComplete = false -- Internal variable, dont touch.
}
},
onStart = function(startObjective)
return startObjective
end,
onComplete = function(isForced, reason)
print("Mission is finished: ", reason)
end
})Last updated
Was this helpful?