Difference between revisions of "LUA:SpawnScripts"
| Line 2: | Line 2: | ||
Spawn Scripts are used to bring a spawn to life, the most common use is to add dialog but it is possible to write your own custom AI completely overriding the default behavior provided in the server core. | Spawn Scripts are used to bring a spawn to life, the most common use is to add dialog but it is possible to write your own custom AI completely overriding the default behavior provided in the server core. | ||
| − | + | {{Header|Aggro|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Aggro is called when the spawn aggros a player due to faction | Aggro is called when the spawn aggros a player due to faction | ||
| Line 9: | Line 9: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Attacked|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Attacked is called when the spawn enters combat | Attacked is called when the spawn enters combat | ||
| Line 16: | Line 16: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Auto Attack Tick|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Auto Attack Tick is called when the spawn makes an attack with the primary weapon | Auto Attack Tick is called when the spawn makes an attack with the primary weapon | ||
| Line 23: | Line 23: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Can Use Command|BackgroundColor=3d78b4|FontColor=ffffff}} | |
can_use_command is called when an entity command is used on a spawn. Return true to allow the command to be used, false to not. This check only applies if this function is in the script. The third parameter is the name of the spell/entity command. | can_use_command is called when an entity command is used on a spawn. Return true to allow the command to be used, false to not. This check only applies if this function is in the script. The third parameter is the name of the spell/entity command. | ||
| Line 30: | Line 30: | ||
return true | return true | ||
end</pre> | end</pre> | ||
| − | + | {{Header|Casted On|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Casted On is called when a spell is casted on the spawn, the third parameter is the name of the spell/entity command | Casted On is called when a spell is casted on the spawn, the third parameter is the name of the spell/entity command | ||
| Line 37: | Line 37: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Combat Reset|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Combat Reset is called when the spawn leaves combat | Combat Reset is called when the spawn leaves combat | ||
| Line 44: | Line 44: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Death|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Death is called when the spawn dies | Death is called when the spawn dies | ||
| Line 51: | Line 51: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Group Dead|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Group dead is called when the last member of a spawn group is killed | Group dead is called when the last member of a spawn group is killed | ||
| Line 58: | Line 58: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Hailed|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Hailed is called when a player hails the spawn | Hailed is called when a player hails the spawn | ||
| Line 65: | Line 65: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Hailed Busy|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Hailed Busy is called when a player hails the spawn while it is in combat | Hailed Busy is called when a player hails the spawn while it is in combat | ||
| Line 72: | Line 72: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Health Changed|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Health Changed is called whenever the spawns health changes in either direction | Health Changed is called whenever the spawns health changes in either direction | ||
| Line 79: | Line 79: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Killed|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Killed is called whenever the spawn kills something | Killed is called whenever the spawn kills something | ||
| Line 86: | Line 86: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Random Chat|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Random Chat is never called and its purpose is lost, code for it still remains so it is listed here just for reference | Random Chat is never called and its purpose is lost, code for it still remains so it is listed here just for reference | ||
| Line 93: | Line 93: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Respawn|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Respawn is called when the spawn respawns | Respawn is called when the spawn respawns | ||
| Line 100: | Line 100: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Spawn|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Spawn is called when the spawn spawns for the first time | Spawn is called when the spawn spawns for the first time | ||
| Line 107: | Line 107: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Targeted|BackgroundColor=3d78b4|FontColor=ffffff}} | |
Targeted is called whenever a player targets the spawn | Targeted is called whenever a player targets the spawn | ||
| Line 114: | Line 114: | ||
end | end | ||
</pre> | </pre> | ||
| − | + | {{Header|Think|BackgroundColor=3d78b4|FontColor=ffffff}} | |
| − | |||
Think is used to override AI and is called every time the AI needs to run | Think is used to override AI and is called every time the AI needs to run | ||
| Line 122: | Line 121: | ||
end | end | ||
</pre> | </pre> | ||
| − | |||
| − | |||
| − | |||
Revision as of 16:27, 14 June 2016
LUA - Spawn Scripts
Return to: LUA | Tutorials | Portal | Forum | Project Manager | Bug Tracker
Spawn Scripts are used to bring a spawn to life, the most common use is to add dialog but it is possible to write your own custom AI completely overriding the default behavior provided in the server core.
Aggro is called when the spawn aggros a player due to faction
function aggro(Spawn, Spawn) end
Attacked is called when the spawn enters combat
function attacked(Spawn, Spawn) end
Auto Attack Tick is called when the spawn makes an attack with the primary weapon
function auto_attack_tick(Spawn, Spawn) end
can_use_command is called when an entity command is used on a spawn. Return true to allow the command to be used, false to not. This check only applies if this function is in the script. The third parameter is the name of the spell/entity command.
function can_use_command(NPC, Spawn, String)
return true
end
Casted On is called when a spell is casted on the spawn, the third parameter is the name of the spell/entity command
function casted_on(Spawn, Spawn, String) end
Combat Reset is called when the spawn leaves combat
function CombatReset(Spawn) end
Death is called when the spawn dies
function death(Spawn, Spawn) end
Group dead is called when the last member of a spawn group is killed
function group_dead(Spawn, Spawn) end
Hailed is called when a player hails the spawn
function hailed(Spawn, Spawn) end
Hailed Busy is called when a player hails the spawn while it is in combat
function hailed_busy(Spawn, Spawn) end
Health Changed is called whenever the spawns health changes in either direction
function healthchanged(Spawn, Spawn) end
Killed is called whenever the spawn kills something
function killed(Spawn, Spawn) end
Random Chat is never called and its purpose is lost, code for it still remains so it is listed here just for reference
function randomchat(Spawn, String) end
Respawn is called when the spawn respawns
function respawn(Spawn) end
Spawn is called when the spawn spawns for the first time
function spawn(Spawn) end
Targeted is called whenever a player targets the spawn
function targeted(Spawn, Spawn) end
Think is used to override AI and is called every time the AI needs to run
function Think(Spawn, Spawn) end