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.
  
== Aggro ==
+
{{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>
== Attacked ==
+
{{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>
== Auto Attack Tick ==
+
{{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>
== Can Use Command ==
+
{{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>
== Casted On ==
+
{{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>
== Combat Reset ==
+
{{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>
== Death ==
+
{{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>
== Group Dead ==
+
{{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>
== Hailed ==
+
{{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>
== Hailed Busy ==
+
{{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>
== Health Changed ==
+
{{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>
== Killed ==
+
{{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>
== Random Chat ==
+
{{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>
== Respawn ==
+
{{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>
== Spawn ==
+
{{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>
== Targeted ==
+
{{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 ==
 
 
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>
 
 
[[LUA|Back to LUA]]
 

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

Aggro is called when the spawn aggros a player due to faction

function aggro(Spawn, Spawn)
end
Attacked

Attacked is called when the spawn enters combat

function attacked(Spawn, Spawn)
end
Auto Attack Tick

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

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

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

Combat Reset is called when the spawn leaves combat

function CombatReset(Spawn)
end
Death

Death is called when the spawn dies

function death(Spawn, Spawn)
end
Group Dead

Group dead is called when the last member of a spawn group is killed

function group_dead(Spawn, Spawn)
end
Hailed

Hailed is called when a player hails the spawn

function hailed(Spawn, Spawn)
end
Hailed Busy

Hailed Busy is called when a player hails the spawn while it is in combat

function hailed_busy(Spawn, Spawn)
end
Health Changed

Health Changed is called whenever the spawns health changes in either direction

function healthchanged(Spawn, Spawn)
end
Killed

Killed is called whenever the spawn kills something

function killed(Spawn, Spawn)
end
Random Chat

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

Respawn is called when the spawn respawns

function respawn(Spawn)
end
Spawn

Spawn is called when the spawn spawns for the first time

function spawn(Spawn)
end
Targeted

Targeted is called whenever a player targets the spawn

function targeted(Spawn, Spawn)
end
Think

Think is used to override AI and is called every time the AI needs to run

function Think(Spawn, Spawn)
end