Quest Loading¶
Info
This page outlines how quests are loaded by the server
NPC¶
In order of operations, an npc's script will be dictated by the first script that it finds below. The [ext] refers to file extension--either .pl or .lua. It should be noted that a .lua file takes precedence over a .pl file of the same name.
These scripts run in a context based on NPCID. All npcs with the same NPCID can see variables, modify them, and see changes made by the others. If you need variables that are specific to each instance of an NPCID, data buckets or entity variables can be used.
| Hierarchy | Example |
|---|---|
| quests/zoneshortname/id.[ext] | quests/qeynos/1173.lua |
| quests/zoneshortname/npc_name.[ext] | quests/qeynos/Trumpy_Irontoe.pl |
| quests/global/npcid.[ext] | quests/global/1234.pl |
| quests/global/npc_name.[ext] | quests/global/Nexus_Scion.lua |
| quests/zoneshortname/default.[ext] | quests/tutorialb/default.pl |
| quests/global/default.[ext] | quests/global/default.lua |
Player¶
In order of operations, a player's script will be dictated by the first script that it finds below. The [ext] refers to file extension--either .pl or .lua. It should be noted that a .lua file takes precedence over a .pl file of the same name.
| Hierarchy | Example |
|---|---|
| quests/zoneshortname/player_v[instance_version].[ext] | quests/qeynos/player_v1.pl |
| quests/zoneshortname/player.[ext] | quests/qeynos/player.lua |
| quests/global/player.[ext] | quests/global/player.pl |
Global Scripts¶
Global scripts were designed to run on top of the scripts mentioned above, meaning if you have a player script in a zone directory and a global player script, they will both execute and not interfere with each other
Player¶
- quests/global/global_player.ext
NPC¶
- quests/global/global_npc.ext
The global_npc.ext scripts run in a zone wide context. All npcs in the same zone can see variables, modify them, and see changes made by the others.
Item¶
Item Scripts are quest scripts attached to Items. Items will load a script on the first event that triggers them and will load one and only one from the following location. Which ever it finds first in the following order:
| Hierarchy | Example |
|---|---|
| quests/zone/items/item_script.[ext] | quests/qeynos/items/script_30057.pl |
| quests/global/items/item_script.[ext] | quests/global/items/script_30057.lua |
| quests/zone/items/default.[ext] | quests/qeynos/items/default.lua |
| quests/global/items/default.[ext] | quests/global/items/default.pl |
Spell Scripts¶
Spell Scripts are quest scripts attached to Spells. Spells will load a script on the first event that triggers them and will load one and only one from the following location. Which ever it finds first in the following order:
| Hierarchy | Example |
|---|---|
| quests/zone/spells/spell_id.[ext] | quests/qeynos/spells/1234.pl |
| quests/global/spells/spell_id.[ext] | quests/global/spells/1234.lua |
| quests/zone/spells/default.[ext] | quests/qeynos/spells/default.lua |
| quests/global/spells/default.[ext] | quests/global/spells/default.pl |