Quest steps
id
id
required
A unique identifier for the quest step. Ensure that these id only exists one time only.
Important: Only
a-zA-Z0-9
and-_
are allowed.
name
name
required
The name of the quest step. It will be shown in the quest dialog.
description
description
default
nil
An internal description for the quest step, e.g. like notes for the quest writers. It is currently not used and shown anywhere.
btn_text
btn_text
required
The text for the button in the prompt. It will be shown in the prompt.
location
location
required
Contains the coords
and radius
for the quest step triggering point.
Example:
Attributes | Type | Optional | Default | Description |
---|---|---|---|---|
| required | - | A table of the | |
| number (float) | required | - | The radius around the |
quest_text
quest_text
required
The text for the quest dialog. It will be shown in the quest dialog. Can contain HTML tags.
callback
callback
default
nil
A function that is called when the quest step is started/accepted. It can be used to add custom logic like spawning a vehicle or giving weapons to the player.
Important: The callback will be executed on server side.
Example:
requires
requires
default
nil
A table of requirements for the quest step.
The requirements are checked before the quest step is started/accepted.
See the following attributes for more information:
items
of requires
items
of requires
default
nil
A table of items that are required for the quest step.
If remove
is set to true
, the item will be removed from the player inventory if the quest step starts/ends.
label
is optional and can be used to overwrite the item label in the quest dialog.
Important: The item must exists in the database of the supported framework.
Example:
money
of requires
money
of requires
default
nil
A table of money that are required for the quest step.
If remove
is set to true
, the money will be removed from the player inventory if the quest step starts/ends.
Example:
gold
of requires
gold
of requires
default
nil
A table of gold that are required for the quest step.
If remove
is set to true
, the gold will be removed from the player inventory if the quest step starts/ends.
Example:
completed_quests
of requires
completed_quests
of requires
default
nil
A list of quests that are required for the quest step.
Example:
rewards
rewards
default
nil
A table of rewards for the quest step.
See the following attributes for more information:
items
of rewards
items
of rewards
default
nil
A table of rewards for the quest step.
label
is optional and can be used to overwrite the item label in the quest dialog.
Important: The item must exists in the database of the supported framework.
Example:
weapons
of rewards
weapons
of rewards
default
nil
A table of rewards for the quest step.
label
, desc
and serial
are optional and can be used to overwrite the weapon defaults.
Important: The weapon must exist in the game, see weapon list.
Example:
money
of rewards
money
of rewards
default
nil
A table of money as rewards for the quest step.
Example:
gold
of rewards
gold
of rewards
default
nil
A table of gold as rewards for the quest step.
Example:
background_filename
background_filename
default
nil
The filename of the background image for the quest dialog. The image must be located in the html_quest/img
folder.
padding_left
, padding_top
, padding_right
, padding_bottom
padding_left
, padding_top
, padding_right
, padding_bottom
default
nil
The padding for the quest dialog. The padding is used to move the quest content inside the quest dialog, e.g. if you use your own background image.
title_color
title_color
default is black
The color for the quest title in the quest dialog. The color must be a valid CSS color, like #ff0000
or red
.
text_color
text_color
default is black
The color for the quest text in the quest dialog. The color must be a valid CSS color, like #ff0000
or red
.
shadow_color
shadow_color
default is
nil
The color for the quest text shadow in the quest dialog. The color must be a valid CSS color, like #ff0000
or red
.
marker
marker
default
nil
new since 1.2.0
Defines if a special symbol is shown at the given coordinates so the player can see the location before he arrives.
Example:
Attributes | Type | Optional | Default | Description |
---|---|---|---|---|
| required | - | A table of the | |
| number (float) | required | - | The radius around the |
| required | - | The visible type of the marker. See Marker Types for available types. | |
| required | - | A table of the |
blip
blip
default
nil
new since 1.2.0
Allows to show a blip on the map for the quest step coordinates.
Example:
Attributes | Type | Optional | Default | Description |
---|---|---|---|---|
| required | - | The | |
| required | - | The | |
| required | - | The |
radius_blip
radius_blip
default
nil
new since 1.2.0
Allows to show a radius blip with a defined radius on the map for the quest step coordinates.
Example:
Attributes | Type | Optional | Default | Description |
---|---|---|---|---|
| required | - | The | |
| number (float) | required | - | The |
Last updated