Eventtype: Difference between revisions
m Added SECTOR_LOADED event |
No edit summary |
||
(77 intermediate revisions by 18 users not shown) | |||
Line 1: | Line 1: | ||
== Introduction == | |||
Events are used for communication between different parts of the client. For example the chat log is registered to the CHAT_MSG_CHANNEL event. When the client receives a chat message the event is triggered and the received string passed along with it. | |||
The event callback in the chat log now appends the string to the log. | |||
A very basic example using the TARGET_CHANGED event. It's triggered whenever the target changes. There are three ways to register an object with the event. | |||
A table with OnEvent callback: | |||
<source lang="lua"> | |||
-- define a table. this table is the "object" that gets registered with event | |||
target = {} | |||
-- define a function called OnEvent within this table. It's called when the event is triggered. | |||
-- It has at least one argument, the name of the event that is passed to it | |||
-- the remaining arguments are optional event data | |||
function target:OnEvent(event, data) | |||
-- this way it is possible to handle multiple events with one table | |||
if event == "TARGET_CHANGED" then | |||
-- the only action is to print something | |||
print("Target Changed") | |||
end | |||
end | |||
-- register the table with the event | |||
RegisterEvent(target, "TARGET_CHANGED") | |||
</source> | |||
A table with TARGET_CHANGED callback: | |||
<source lang="lua"> | |||
-- define a table. this table is the "object" that gets registered with event | |||
target = {} | |||
-- define a function called TARGET_CHANGED within this table. It's called when the event is triggered. | |||
-- It has at least one argument, the name of the event that is passed to it | |||
-- the remaining arguments are optional event data | |||
function target:TARGET_CHANGED(event, data) | |||
-- the only action is to print something | |||
print("Target Changed") | |||
end | |||
-- register the table with the event | |||
RegisterEvent(target, "TARGET_CHANGED") | |||
</source> | |||
A callback directly: | |||
<source lang="lua"> | |||
-- define the function that will be registered with the event | |||
-- It has at least one argument, the name of the event that is passed to it | |||
-- the remaining arguments are optional event data | |||
function eventhandler(event, data) | |||
-- this way it is possible to handle multiple events with one function | |||
if event == "TARGET_CHANGED" then | |||
-- the only action is to print something | |||
print("Target Changed") | |||
end | |||
end | |||
-- register the function with the event | |||
RegisterEvent(eventhandler, "TARGET_CHANGED") | |||
</source> | |||
== Triggering Events == | |||
You can trigger an event with the ProcessEvent function. This lets you create your own custom events as well as triggering the standard ones. | |||
<source lang="lua"> | |||
--define some data to send with the event | |||
local data = {} | |||
data.name = "Joe SpaceGuy" | |||
data.energylevel = 9001 | |||
--send the event | |||
ProcessEvent("MY_CUSTOM_EVENT", data) | |||
</source> | |||
== Notes == | |||
Calling RegisterEvent twice with the same arguments will result in the same table receiving an event twice, which is generally not wanted. Use ReloadInterface or UnregisterEvent to get rid previously registered tables before registering new ones. | |||
Passing locally defined tables to RegisterEvent doesn't work. | |||
example: | |||
<source lang="lua"> | |||
do | |||
local tab = {} | |||
function tab:OnEvent() print("this doesn't work") end | |||
RegisterEvent(tab, "MYEVENT") | |||
end | |||
</source> | |||
the table needs a strong reference: | |||
<source lang="lua"> | |||
do | |||
local tab = {} | |||
function tab:OnEvent() print("this does work") end | |||
RegisterEvent(tab, "MYEVENT") | |||
tab_strong = tab | |||
end | |||
</source> | |||
== [[Order of Events]] == | |||
== Eventlist == | |||
The client provides a set of predefined events. | |||
Known events are: | |||
===ACTIVATE_CHAT_CHANNEL=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_GROUP=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_GUILD=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_MISSION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_PRIVATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_SAY=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_SECTOR=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ACTIVATE_CHAT_USER=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ASSIGNOWNERKEY_DIALOG=== | |||
'''Description:''' | |||
<br> | |||
Triggered when the station requests a key assignment | |||
<br> | |||
<br> | |||
===AUTOAIM_MODE_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHANGE_ACTIVE_CHATTAB=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHARINFOMENU_TOGGLE=== | |||
'''Description:'''<br> | |||
Charinfo menu was toggled with /charinfo command or key bind.<br> | |||
'''Arguments:''' None.<br> | |||
<br> | |||
===CHAT_CANCELLED=== | |||
'''Description:'''<br> | |||
Triggered when esc is pressed in chat entry box.<br> | |||
'''Arguments:''' None.<br> | |||
<br> | |||
===CHAT_DONE=== | |||
'''Description:'''<br> | |||
Triggered when enter is pressed in chat entry box.<br> | |||
'''Arguments:''' None.<br> | |||
<br> | |||
===CHAT_ENTERED=== | |||
'''Description:''' | |||
<br> | |||
Triggers after CHAT_DONE and echos back the text entered into the chat bar. | |||
<br> | |||
'''text''' the text entered on the chat bar. | |||
<br/><br/> | |||
===CHAT_MSG_BAR1=== | |||
'''Description:''' | |||
<br> | |||
A message from an Itani in the station bar. | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR2=== | |||
'''Description:''' | |||
<br> | |||
A message from a Serco in the station bar. | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR3=== | |||
'''Description:''' | |||
<br> | |||
A message from a UIT in the station bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_BARENTER=== | |||
'''Description:''' | |||
<br> | |||
A message stating that a player has entered the bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BARLEAVE=== | |||
'''Description:''' | |||
<br> | |||
A message stating that a player has left the bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BARLIST=== | |||
'''Description:''' | |||
<br> | |||
A message listing the players currently in the bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR_EMOTE1=== | |||
'''Description:''' | |||
<br> | |||
An emote (/me) message from an Itani in the station bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR_EMOTE2=== | |||
'''Description:''' | |||
<br> | |||
An emote (/me) message from a Serco in the station bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR_EMOTE3=== | |||
'''Description:''' | |||
<br> | |||
An emote (/me) message from a UIT in the station bar. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_BAR_EMOTE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_BUDDYNOTE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_CHANNEL=== | |||
'''Description:'''<br /> | |||
Message on inactive channel. | |||
<br /> | |||
<br /> | |||
'''Arguments:'''<br /> | |||
'''data''' = {string name, string msg, int faction = factionid, int channelid} | |||
<br /> | |||
===CHAT_MSG_CHANNEL_ACTIVE=== | |||
'''Description:''' | |||
<br> | |||
Message on active channel. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
'''data''' = {string name, string msg, int faction = [[factionid]], int channelid} | |||
<br><br> | |||
===CHAT_MSG_CHANNEL_EMOTE=== | |||
'''Description:''' | |||
An emote (/me) message in channel chat | |||
<br> | |||
<br /> | |||
'''Arguments:''' | |||
'''data''' = {string name, string msg, int faction = factionid, int channelid} | |||
<br> | |||
===CHAT_MSG_CHANNEL_EMOTE_ACTIVE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_CONFIRMATION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_DEATH=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_DISABLED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_ERROR=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_GLOBAL_SERVER=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_GROUP=== | |||
'''Description:''' | |||
<br> | |||
A message from a player in your group. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_GROUP_NOTIFICATION=== | |||
'''Description:''' | |||
<br> | |||
eg. Group death notification | |||
<br> | |||
'''Arguments:'''<br> | |||
'''data''' = {string msg, int location = [[sectorid]]} | |||
===CHAT_MSG_GUIDE=== | |||
'''Description:''' | |||
<br> | |||
A message from a guide. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_GUILD=== | |||
'''Description:''' | |||
<br> | |||
A message from guildmate. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
'''data''' = {string msg, string name, int location = [[sectorid]], int faction = [[factionid]]} | |||
<br><br> | |||
===CHAT_MSG_GUILD_EMOTE=== | |||
'''Description:''' | |||
<br> | |||
An emote (/me) message from a guildmate. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
'''data''' = {string msg, string name, int location = [[sectorid]], int faction = [[factionid]]} | |||
<br><br> | |||
===CHAT_MSG_GUILD_MOTD=== | |||
'''Description:''' | |||
<br> | |||
Not used, instead guild MOTD triggers [[Eventtype#CHAT_MSG_SERVER|CHAT_MSG_SERVER]] event. | |||
<br> | |||
<br> | |||
===CHAT_MSG_INCOMINGBUDDYNOTE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_MISSION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_MOTD=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_NATION=== | |||
'''Description:''' | |||
<br> | |||
A message on nation chat. Depreciated. | |||
<br> | |||
<br> | |||
===CHAT_MSG_PRINT=== | |||
'''Description:''' | |||
<br> | |||
Processing this event calls print function with msg as argument (and possibly does other stuff), | |||
it's triggered by echo command. | |||
<br> | |||
'''Arguments:'''<br> | |||
'''data''' = {string msg} | |||
<br> | |||
<br> | |||
===CHAT_MSG_PRIVATE=== | |||
'''Description:'''<br> | |||
An incoming private message from another player.<br> | |||
<br> | |||
'''Arguments:'''<br> | |||
'''data''' = {string msg, string name} | |||
<br> | |||
<br> | |||
===CHAT_MSG_PRIVATEOUTGOING=== | |||
'''Description:''' | |||
<br> | |||
An outgoing private message to another player.<br> | |||
Causes outgoing message to be shown in chat. For example using [[API_SendChat|SendChat]] function to send a priavate message will not cause it to be displayed, in this case it's required to trigger this event.<br> | |||
<br> | |||
'''Arguments:'''<br> | |||
'''data''' = {string msg, string name} | |||
<br><br> | |||
===CHAT_MSG_SECTOR=== | |||
'''Description:''' | |||
<br> | |||
A message from a player in the sector. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_SECTORD=== | |||
'''Description:''' | |||
<br> | |||
A message from the sector daemon. | |||
Sends messages: (only way to get those messages, as far as i know)<br> | |||
'You lost/won the duel.'<br> | |||
'PLYAER_NAME sent you XXX credits.'<br> | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
'''data''' = {string msg} | |||
<br><br> | |||
===CHAT_MSG_SECTORD_MISSION=== | |||
'''Description:''' | |||
<br> | |||
A mission message from the sector daemon. | |||
Top5 listing at racetracks triggers this event too. | |||
<br> | |||
<br> | |||
'''Arguments:'''<br> | |||
data = {string msg, int missionid} | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_SECTORD_SECTOR=== | |||
'''Description:''' | |||
<br> | |||
A sector message from the sector daemon (temp KOS standing messages and the 'You've been caught in an Ion Storm.' messages) | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_SECTOR_EMOTE=== | |||
'''Description:''' | |||
<br> | |||
An emote (/me) message from a player in-sector. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_MSG_SERVER=== | |||
'''Description:''' | |||
<br />Messages triggered by events such as <br /> | |||
'*** Your buddy [name] logged off/on.' | |||
<br />'''Arguments:'''<br /> | |||
'''msg''' - table containing string with the message | |||
===CHAT_MSG_SERVER_CHANNEL=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_SERVER_CHANNEL_ACTIVE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_SERVER_GUILD=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_MSG_SERVER_SECTOR=== | |||
'''Description:'''<br> | |||
Messages triggered by (or that trigger) this event: | |||
'You are entering [location].' | |||
<br> | |||
'''Arguments:'''<br> | |||
'''msg''' - string containing the message | |||
<br> | |||
===CHAT_MSG_SYSTEM=== | |||
'''Description:''' | |||
<br> | |||
A message from another player in your system. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===CHAT_SCROLL_DOWN=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CHAT_SCROLL_UP=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===CINEMATIC_START=== | |||
'''Description:''' | |||
<br> | |||
Called when an ingame cinematic is started. Examples include the undocking animation and the warping sequences. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
=== COMMAND === | |||
'''Description:''' | |||
A command is executed, such as /echo.<br> | |||
'''Arguments:'''<br> | |||
''command_id'' - unique integer id corresponding to the command which was executed. For example, /echo is 20.<br> | |||
''args'' - list of string arguments to the command. For example, "/echo a b c" will receive {'a', 'b', 'c'}. nil if there are no arguments. | |||
<br> | |||
===CONQUERED_SECTORS_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===DESIRED_SPEED_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===EMOTE_ENTERED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ENTERED_STATION=== | |||
'''Description:'''<br> | |||
Triggered when entering station.<br> | |||
'''Arguments:'''<br> | |||
None.<br> | |||
===ENTERING_STATION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ENTER_ZONE_dock=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ENTER_ZONE_NFZ=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===ENTER_ZONE_wormhole=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===FLIGHT_MODE_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===FORGIVENESS_DIALOG=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GROUP_CREATED=== | |||
'''Description:'''<br> | |||
Triggered when you create a group before anyone joins.<br> | |||
'''Arguments:'''<br> | |||
none | |||
<br/> | |||
<br> | |||
===GROUP_MEMBER_DIED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GROUP_MEMBER_HEALTH_UPDATE=== | |||
'''Description:'''<br> | |||
Triggered when a group members health is updated for any reason and you're in the same sector.<br/> | |||
'''Arguments:'''<br> | |||
'''charid''' character id of the group member<br> | |||
'''(number)''' unknown<br> | |||
'''percent''' percent health they are now at<br> | |||
'''(number)''' unknown<br> | |||
<br/> | |||
<br> | |||
===GROUP_MEMBER_JOINED=== | |||
'''Description:'''<br> | |||
Triggers when someone joins your group<br/> | |||
'''Arguments:'''<br> | |||
'''name''' character name of the joiner | |||
<br> | |||
<br> | |||
===GROUP_MEMBER_KILLED=== | |||
'''Description:'''<br> | |||
Triggers when a group member kills someone<br> | |||
'''Arguments:'''<br> | |||
'''charid''' character id of the deceased<br> | |||
'''charid''' character id of the killer<br> | |||
'''sectorid''' sector id where the event took place<br> | |||
'''weaponname''' name of the weapon used<br> | |||
'''(number)''' unknown | |||
<br> | |||
<br> | |||
===GROUP_MEMBER_LEFT=== | |||
'''Description:'''<br> | |||
Triggers when a group member leaves the group<br> | |||
'''Arguments:'''<br> | |||
'''charid''' character id of the member who left the group | |||
<br> | |||
<br> | |||
===GROUP_MEMBER_LOCATION_CHANGED=== | |||
'''Description:'''<br> | |||
Triggers when a group members location changes<br> | |||
'''Arguments:'''<br> | |||
'''charid''' character id of the member who changed their location | |||
<br> | |||
<br> | |||
===GROUP_MEMBER_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GROUP_OWNER_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GROUP_SELF_INVITED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GROUP_SELF_JOINED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GROUP_SELF_LEFT=== | |||
'''Description:'''<br> | |||
Triggers when you leave a group but are not kicked.<br> | |||
'''Arguments:'''<br> | |||
none | |||
<br> | |||
<br> | |||
===GUILD_ACTIVITY_LOG=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUILD_BALANCE_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUILD_BANK_LOG=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUILD_MEMBERS_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUILD_MEMBER_ADDED=== | |||
'''Description:''' | |||
<br> | |||
Triggered when guild member logs on or joins the guild. | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
'''charid''' [[charid]] of added guild member.<br/> | |||
'''rank''' 0=member, 1=lieutenant, 2=council member, 3=council member and lieutenant, 4=commander | |||
<br><br> | |||
===GUILD_MEMBER_REMOVED=== | |||
'''Description:''' | |||
<br> | |||
Triggered when guild member logs off or leaves the guild. | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
'''charid''' [[charid]] of removed guild member.<br/> | |||
'''reason''' 0=logoff, 1=resign, 2=kicked out by commander/lieutenant, 3=voted out by council. | |||
<br><br> | |||
===GUILD_MEMBER_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUILD_MOTD_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUILD_PRIVILEGES_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUNNER_KICKED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===GUNNER_LEFT=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_HELP_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_HIDE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_INVENTORY_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_MODE_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_RELOADING=== | |||
'''Description:''' | |||
<br> | |||
Triggered after rHUDxscale but before the HUD is reloaded | |||
<br> | |||
===HUD_RELOADED=== | |||
'''Description:''' | |||
<br> | |||
Triggered after the HUD is reloaded by rHUDxscale | |||
<br> | |||
===HUD_SHOW=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_SKIRMISH_CLOSE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_SKIRMISH_OPEN=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_SKIRMISH_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===HUD_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===INVENTORY_ADD=== | |||
'''Description:''' | |||
<br> | |||
'''Arguments:'''(itemid)<br> | |||
'''itemid''' [[itemid]] of added item<br> | |||
<br> | |||
===INVENTORY_RECEIVED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===INVENTORY_REMOVE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===INVENTORY_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===JETTISONMENU_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===JUMP_OUT_CINEMATIC_FINISHED=== | |||
'''Description:''' | |||
<br> | |||
Called when the sector jump-out cinematic is finished. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===KEYADDED=== | |||
'''Description:''' | |||
<br> | |||
Triggered after a key was added to the keychain | |||
<br> | |||
'''Arguments:'''<br> | |||
key id of added key | |||
<br> | |||
===KEYINFO_DIALOG=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===KEYREMOVED=== | |||
'''Description:''' | |||
<br> | |||
Triggered after a key was removed from the keychain | |||
<br> | |||
'''Arguments:'''<br> | |||
key id of removed key | |||
<br> | |||
===LEAVE_ZONE_dock=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===LEAVE_ZONE_NFZ=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===LEAVE_ZONE_wormhole=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===LEAVING_STATION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===LOGIN_FAILED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===LOGIN_SUCCESSFUL=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSIONLIST_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSION_ADDED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSION_NOTIFICATION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSION_QUESTION_OPEN=== | |||
'''Description:''' Triggered when the user opens the "info" screen to consider accepting a mission, OR after RequestMissionExtendedDescription is called.<br> | |||
'''Arguments:'''<br> | |||
- string extended description - the text which appears in the info screen<br> | |||
- string s - usually "Accept", but not always<br> | |||
- string missionid - mission id (Note that it is in string form, so "1234" instead of 1234)<br> | |||
- int stationid - station id<br> | |||
<br> | |||
===MISSION_REMOVED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSION_TIMER_START=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSION_TIMER_STOP=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MISSION_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===MSG_LOGOFF_TIMER=== | |||
'''Description:''' | |||
<br> | |||
Logoff and explode countdowns and abort messages.<br> | |||
<br> | |||
'''Arguments:''' (string msg)<br> | |||
<br> | |||
===MSG_NOTIFICATION=== | |||
'''Description:''' | |||
<br> | |||
Occurs when a message is overlaid to the center of your HUD; eg. when you attempt to mine with a full inventory. | |||
<br> | |||
'''Arguments:''' (string msg, ...? unknown)<br> | |||
<br> | |||
===NAVMENU_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===NAVROUTE_ADD=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===NAVROUTE_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===NAVROUTE_SAVE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===NAVROUTE_UNDOLAST=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===OBJECT_INFO_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===OPEN_SURVEY=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYERLIST_CLOSE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYERLIST_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_DEATH_CINEMATIC_FINISHED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_DIED=== | |||
'''Description:''' | |||
<br> | |||
Triggered when player in the sector dies. | |||
<br> | |||
'''Arguments:'''(int died = [[charid]], int killed = [[charid]])<br> | |||
'''died''' - [[charid]] of player who died<br> | |||
'''killed''' - [[charid]] of player who killed him<br> | |||
'''weaponid''' - [[weaponid]] of the weapon which scored the kill | |||
<br> | |||
===PLAYER_ENTERED_GAME=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_ENTERED_SECTOR=== | |||
'''Description:''' Called whenever a player enters the sector you are in. When you first enter a sector it is called for every player and NPC currently in the sector. When you are entering a sector the first return value is 0 everything following is a character id but when you are already in the sector and another npc/player joins it returns a charid without starting with 0 | |||
<br> | |||
'''Arguments:''' int charid | |||
<br> | |||
===PLAYER_GOT_HIT=== | |||
'''Description:'''<br> | |||
Triggered when player gets shot.<br> | |||
'''Arguments:''' (int attacked = [[charid]], attacker = [[charid]], unknown, boolean damaged)<br> | |||
'''unknown''' - seems proportional to damage but not quite the same<br> | |||
'''damaged''' - true when taking damage, false when being healed<br> | |||
===PLAYER_GUILD_TAG_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_HIT=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_HOME_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_LEFT_SECTOR=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYERLIST_TOGGLE=== | |||
'''Description:'''<br> | |||
Playerlist was toggled with command or keybind.<br> | |||
'''Arguments:''' None.<br> | |||
===PLAYER_LOGGED_OUT=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_RECEIVED_NEW_ACCOMPLISHMENTS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_STATS_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_UPDATE_ACCOMPLISHMENTS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_UPDATE_FACTIONSTANDINGS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_UPDATE_SKILLS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLAYER_UPDATE_STATS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PLUGINS_LOADED=== | |||
'''Description:'''<br> | |||
Triggered right after the plugin load sequence has completed. | |||
<br> | |||
===PROXIMITY_ALERT=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===PUSH_TO_TALK=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===QUIT=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SECTOR_ALIGNMENT_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SECTOR_CHANGED=== | |||
'''Description:'''<br> | |||
Triggered on entering a sector<br> | |||
<br> | |||
'''Arguments:'''<br> | |||
'''sectorid''' - [[sectorid]] of the entered sector. | |||
<br> | |||
===SECTOR_LOADED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SECTOR_LOADING=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SERVER_DISCONNECTED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SHIP_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SHIP_SPAWNED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SHIP_SPAWN_CINEMATIC_FINISHED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SHIP_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SHOW_STATION=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===START=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===STATION_TURRET_HEALTH_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===STATION_UPDATED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===STATION_UPDATE_DESIREDITEMS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===STATION_UPDATE_PRICE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===STATION_UPDATE_REQUESTED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===STORM_STARTED=== | |||
'''Description:''' Triggered when entering a sector which has an ion storm.<br> | |||
'''Arguments:''' None | |||
<br> | |||
<br> | |||
===STORM_STOPPED=== | |||
'''Description:''' Triggered when entering a sector which does not have an Ion Storm (eg. from entering the game, performing a sector jump, performing a wormhole jump, or respawning). Also triggers if you are in a sector with an Ion Storm and that storm ends.<br> | |||
'''Arguments:''' None<br> | |||
===SYSMENU_TOGGLE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===SYSTEM_BEST_PRICE=== | |||
'''Description:''' | |||
<br> | |||
Triggered when the best sell price of an item in the active ships cargo hold changes | |||
<br> | |||
'''Arguments:'''(item, price, station)<br> | |||
'''item''' [[itemid]] of changed item<br> | |||
'''price''' new price<br> | |||
'''station''' [[locationid]] of station with highest price<br> | |||
<br> | |||
<br> | |||
<br> | |||
===TARGET_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
'''Arguments:''' None. | |||
<br> | |||
===TARGET_HEALTH_UPDATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TARGET_SCANNED=== | |||
'''Description:''' | |||
<br> | |||
Triggered when an object (ship or asteroid depending on scanner equipped) is scanned.<br> | |||
Causes HUD.scaninfo to be updated. | |||
<br> | |||
'''Arguments:''' (scaninfo, nodeid, objectid)<br> | |||
'''scaninfo''' string containing information about scan result. Same thing that's displayed in top right corner of the hud (HUD.scaninfo.title)<br> | |||
possible values:<br> | |||
- 'Object too far to scan\n' (note the trailing newline)<br> | |||
- for asteroids list of ore contents with one line per each ore, where line is: '[ore name] Ore: [percent]%'<br> | |||
- list of cargo for cargo scanners etc.<br> | |||
'''nodeid''' [[nodeid]] of scanned object.<br> | |||
'''objectid''' [[objectid]] of scanned object.<br> | |||
<br> | |||
<br> | |||
===TERMINATE=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TOUCH_PRESSED=== | |||
'''Description:''' | |||
<br> | |||
Triggered when a Touch Region is pressed.<br> | |||
<br> | |||
'''Arguments:''' (regionid, Xpos, Ypos)<br> | |||
'''regionid''' number identifying the region pressed<br> | |||
'''Xpos''' X position touched on the screen<br> | |||
'''Ypos''' Y position touched on the screen<br> | |||
<br> | |||
<br> | |||
===TOUCH_RELEASED=== | |||
'''Description:''' | |||
<br> | |||
Triggered when a Touch Region is released.<br> | |||
<br> | |||
'''Arguments:''' (regionid, Xpos, Ypos)<br> | |||
'''regionid''' number identifying the region pressed<br> | |||
'''Xpos''' X position touched on the screen<br> | |||
'''Ypos''' Y position touched on the screen<br> | |||
<br> | |||
<br> | |||
===TRANSACTION_COMPLETED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TRANSACTION_FAILED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TURRET_SPAWNED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TURRET_SPAWN_CINEMATIC_FINISHED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UNLOAD_INTERFACE=== | |||
'''Description:''' | |||
<br> | |||
Raised when interface is about to be reloaded. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===UPDATE_BUDDY_LIST=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UPDATE_CHARACTER_LIST=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UPDATE_CHARINFO=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UPDATE_DUEL_INFO=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UPDATE_FRIENDKEY_LIST=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UPDATE_NEWS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===UPDATE_NEWS_HEADLINES=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===VOICECHAT_PLAYER_LISTEN_STATUS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===VOICECHAT_PLAYER_MUTE_STATUS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===VOICECHAT_PLAYER_TALK_STATUS=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===WAITING_FOR_CAPSHIP_LAUNCH=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===WARP_OUT_CINEMATIC_FINISHED=== | |||
'''Description:''' | |||
<br> | |||
Called when the wormhole warp-out cinematic is finished. | |||
<br> | |||
<br> | |||
'''Arguments:''' | |||
<br> | |||
<br><br> | |||
===WEAPON_GROUP_CHANGED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===WEAPON_PROGRESS_START=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===WEAPON_PROGRESS_STOP=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===rHUDxscale=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TURRET_OCCUPIED=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TURRET_EMPTY=== | |||
'''Description:''' | |||
<br> | |||
<br> | |||
===TURRET_DEAD=== | |||
'''Description:''' | |||
<br> | |||
<br> |
Latest revision as of 01:12, 19 March 2024
Introduction
Events are used for communication between different parts of the client. For example the chat log is registered to the CHAT_MSG_CHANNEL event. When the client receives a chat message the event is triggered and the received string passed along with it. The event callback in the chat log now appends the string to the log.
A very basic example using the TARGET_CHANGED event. It's triggered whenever the target changes. There are three ways to register an object with the event.
A table with OnEvent callback: <source lang="lua"> -- define a table. this table is the "object" that gets registered with event target = {}
-- define a function called OnEvent within this table. It's called when the event is triggered. -- It has at least one argument, the name of the event that is passed to it -- the remaining arguments are optional event data function target:OnEvent(event, data)
-- this way it is possible to handle multiple events with one table if event == "TARGET_CHANGED" then -- the only action is to print something print("Target Changed") end
end
-- register the table with the event RegisterEvent(target, "TARGET_CHANGED") </source>
A table with TARGET_CHANGED callback: <source lang="lua"> -- define a table. this table is the "object" that gets registered with event target = {}
-- define a function called TARGET_CHANGED within this table. It's called when the event is triggered. -- It has at least one argument, the name of the event that is passed to it -- the remaining arguments are optional event data function target:TARGET_CHANGED(event, data)
-- the only action is to print something print("Target Changed")
end
-- register the table with the event RegisterEvent(target, "TARGET_CHANGED") </source>
A callback directly: <source lang="lua"> -- define the function that will be registered with the event -- It has at least one argument, the name of the event that is passed to it -- the remaining arguments are optional event data function eventhandler(event, data)
-- this way it is possible to handle multiple events with one function if event == "TARGET_CHANGED" then -- the only action is to print something print("Target Changed") end
end
-- register the function with the event RegisterEvent(eventhandler, "TARGET_CHANGED") </source>
Triggering Events
You can trigger an event with the ProcessEvent function. This lets you create your own custom events as well as triggering the standard ones. <source lang="lua"> --define some data to send with the event local data = {} data.name = "Joe SpaceGuy" data.energylevel = 9001
--send the event ProcessEvent("MY_CUSTOM_EVENT", data) </source>
Notes
Calling RegisterEvent twice with the same arguments will result in the same table receiving an event twice, which is generally not wanted. Use ReloadInterface or UnregisterEvent to get rid previously registered tables before registering new ones.
Passing locally defined tables to RegisterEvent doesn't work. example: <source lang="lua"> do
local tab = {} function tab:OnEvent() print("this doesn't work") end RegisterEvent(tab, "MYEVENT")
end </source>
the table needs a strong reference: <source lang="lua"> do
local tab = {} function tab:OnEvent() print("this does work") end RegisterEvent(tab, "MYEVENT") tab_strong = tab
end </source>
Order of Events
Eventlist
The client provides a set of predefined events.
Known events are:
ACTIVATE_CHAT_CHANNEL
Description:
ACTIVATE_CHAT_GROUP
Description:
ACTIVATE_CHAT_GUILD
Description:
ACTIVATE_CHAT_MISSION
Description:
ACTIVATE_CHAT_PRIVATE
Description:
ACTIVATE_CHAT_SAY
Description:
ACTIVATE_CHAT_SECTOR
Description:
ACTIVATE_CHAT_USER
Description:
ASSIGNOWNERKEY_DIALOG
Description:
Triggered when the station requests a key assignment
AUTOAIM_MODE_CHANGED
Description:
CHANGE_ACTIVE_CHATTAB
Description:
CHARINFOMENU_TOGGLE
Description:
Charinfo menu was toggled with /charinfo command or key bind.
Arguments: None.
CHAT_CANCELLED
Description:
Triggered when esc is pressed in chat entry box.
Arguments: None.
CHAT_DONE
Description:
Triggered when enter is pressed in chat entry box.
Arguments: None.
CHAT_ENTERED
Description:
Triggers after CHAT_DONE and echos back the text entered into the chat bar.
text the text entered on the chat bar.
CHAT_MSG_BAR1
Description:
A message from an Itani in the station bar.
Arguments:
CHAT_MSG_BAR2
Description:
A message from a Serco in the station bar.
Arguments:
CHAT_MSG_BAR3
Description:
A message from a UIT in the station bar.
Arguments:
CHAT_MSG_BAR
Description:
CHAT_MSG_BARENTER
Description:
A message stating that a player has entered the bar.
Arguments:
CHAT_MSG_BARLEAVE
Description:
A message stating that a player has left the bar.
Arguments:
CHAT_MSG_BARLIST
Description:
A message listing the players currently in the bar.
Arguments:
CHAT_MSG_BAR_EMOTE1
Description:
An emote (/me) message from an Itani in the station bar.
Arguments:
CHAT_MSG_BAR_EMOTE2
Description:
An emote (/me) message from a Serco in the station bar.
Arguments:
CHAT_MSG_BAR_EMOTE3
Description:
An emote (/me) message from a UIT in the station bar.
Arguments:
CHAT_MSG_BAR_EMOTE
Description:
CHAT_MSG_BUDDYNOTE
Description:
CHAT_MSG_CHANNEL
Description:
Message on inactive channel.
Arguments:
data = {string name, string msg, int faction = factionid, int channelid}
CHAT_MSG_CHANNEL_ACTIVE
Description:
Message on active channel.
Arguments:
data = {string name, string msg, int faction = factionid, int channelid}
CHAT_MSG_CHANNEL_EMOTE
Description:
An emote (/me) message in channel chat
Arguments:
data = {string name, string msg, int faction = factionid, int channelid}
CHAT_MSG_CHANNEL_EMOTE_ACTIVE
Description:
CHAT_MSG_CONFIRMATION
Description:
CHAT_MSG_DEATH
Description:
CHAT_MSG_DISABLED
Description:
CHAT_MSG_ERROR
Description:
CHAT_MSG_GLOBAL_SERVER
Description:
CHAT_MSG_GROUP
Description:
A message from a player in your group.
Arguments:
CHAT_MSG_GROUP_NOTIFICATION
Description:
eg. Group death notification
Arguments:
data = {string msg, int location = sectorid}
CHAT_MSG_GUIDE
Description:
A message from a guide.
Arguments:
CHAT_MSG_GUILD
Description:
A message from guildmate.
Arguments:
data = {string msg, string name, int location = sectorid, int faction = factionid}
CHAT_MSG_GUILD_EMOTE
Description:
An emote (/me) message from a guildmate.
Arguments:
data = {string msg, string name, int location = sectorid, int faction = factionid}
CHAT_MSG_GUILD_MOTD
Description:
Not used, instead guild MOTD triggers CHAT_MSG_SERVER event.
CHAT_MSG_INCOMINGBUDDYNOTE
Description:
CHAT_MSG_MISSION
Description:
CHAT_MSG_MOTD
Description:
CHAT_MSG_NATION
Description:
A message on nation chat. Depreciated.
CHAT_MSG_PRINT
Description:
Processing this event calls print function with msg as argument (and possibly does other stuff),
it's triggered by echo command.
Arguments:
data = {string msg}
CHAT_MSG_PRIVATE
Description:
An incoming private message from another player.
Arguments:
data = {string msg, string name}
CHAT_MSG_PRIVATEOUTGOING
Description:
An outgoing private message to another player.
Causes outgoing message to be shown in chat. For example using SendChat function to send a priavate message will not cause it to be displayed, in this case it's required to trigger this event.
Arguments:
data = {string msg, string name}
CHAT_MSG_SECTOR
Description:
A message from a player in the sector.
Arguments:
CHAT_MSG_SECTORD
Description:
A message from the sector daemon.
Sends messages: (only way to get those messages, as far as i know)
'You lost/won the duel.'
'PLYAER_NAME sent you XXX credits.'
Arguments:
data = {string msg}
CHAT_MSG_SECTORD_MISSION
Description:
A mission message from the sector daemon.
Top5 listing at racetracks triggers this event too.
Arguments:
data = {string msg, int missionid}
CHAT_MSG_SECTORD_SECTOR
Description:
A sector message from the sector daemon (temp KOS standing messages and the 'You've been caught in an Ion Storm.' messages)
Arguments:
CHAT_MSG_SECTOR_EMOTE
Description:
An emote (/me) message from a player in-sector.
Arguments:
CHAT_MSG_SERVER
Description:
Messages triggered by events such as
'*** Your buddy [name] logged off/on.'
Arguments:
msg - table containing string with the message
CHAT_MSG_SERVER_CHANNEL
Description:
CHAT_MSG_SERVER_CHANNEL_ACTIVE
Description:
CHAT_MSG_SERVER_GUILD
Description:
CHAT_MSG_SERVER_SECTOR
Description:
Messages triggered by (or that trigger) this event:
'You are entering [location].'
Arguments:
msg - string containing the message
CHAT_MSG_SYSTEM
Description:
A message from another player in your system.
Arguments:
CHAT_SCROLL_DOWN
Description:
CHAT_SCROLL_UP
Description:
CINEMATIC_START
Description:
Called when an ingame cinematic is started. Examples include the undocking animation and the warping sequences.
Arguments:
COMMAND
Description:
A command is executed, such as /echo.
Arguments:
command_id - unique integer id corresponding to the command which was executed. For example, /echo is 20.
args - list of string arguments to the command. For example, "/echo a b c" will receive {'a', 'b', 'c'}. nil if there are no arguments.
CONQUERED_SECTORS_UPDATED
Description:
DESIRED_SPEED_CHANGED
Description:
EMOTE_ENTERED
Description:
ENTERED_STATION
Description:
Triggered when entering station.
Arguments:
None.
ENTERING_STATION
Description:
ENTER_ZONE_dock
Description:
ENTER_ZONE_NFZ
Description:
ENTER_ZONE_wormhole
Description:
FLIGHT_MODE_CHANGED
Description:
FORGIVENESS_DIALOG
Description:
GROUP_CREATED
Description:
Triggered when you create a group before anyone joins.
Arguments:
none
GROUP_MEMBER_DIED
Description:
GROUP_MEMBER_HEALTH_UPDATE
Description:
Triggered when a group members health is updated for any reason and you're in the same sector.
Arguments:
charid character id of the group member
(number) unknown
percent percent health they are now at
(number) unknown
GROUP_MEMBER_JOINED
Description:
Triggers when someone joins your group
Arguments:
name character name of the joiner
GROUP_MEMBER_KILLED
Description:
Triggers when a group member kills someone
Arguments:
charid character id of the deceased
charid character id of the killer
sectorid sector id where the event took place
weaponname name of the weapon used
(number) unknown
GROUP_MEMBER_LEFT
Description:
Triggers when a group member leaves the group
Arguments:
charid character id of the member who left the group
GROUP_MEMBER_LOCATION_CHANGED
Description:
Triggers when a group members location changes
Arguments:
charid character id of the member who changed their location
GROUP_MEMBER_UPDATE
Description:
GROUP_OWNER_CHANGED
Description:
GROUP_SELF_INVITED
Description:
GROUP_SELF_JOINED
Description:
GROUP_SELF_LEFT
Description:
Triggers when you leave a group but are not kicked.
Arguments:
none
GUILD_ACTIVITY_LOG
Description:
GUILD_BALANCE_UPDATED
Description:
GUILD_BANK_LOG
Description:
GUILD_MEMBERS_UPDATED
Description:
GUILD_MEMBER_ADDED
Description:
Triggered when guild member logs on or joins the guild.
Arguments:
charid charid of added guild member.
rank 0=member, 1=lieutenant, 2=council member, 3=council member and lieutenant, 4=commander
GUILD_MEMBER_REMOVED
Description:
Triggered when guild member logs off or leaves the guild.
Arguments:
charid charid of removed guild member.
reason 0=logoff, 1=resign, 2=kicked out by commander/lieutenant, 3=voted out by council.
GUILD_MEMBER_UPDATED
Description:
GUILD_MOTD_UPDATED
Description:
GUILD_PRIVILEGES_UPDATED
Description:
GUNNER_KICKED
Description:
GUNNER_LEFT
Description:
HUD_HELP_TOGGLE
Description:
HUD_HIDE
Description:
HUD_INVENTORY_TOGGLE
Description:
HUD_MODE_TOGGLE
Description:
HUD_RELOADING
Description:
Triggered after rHUDxscale but before the HUD is reloaded
HUD_RELOADED
Description:
Triggered after the HUD is reloaded by rHUDxscale
HUD_SHOW
Description:
HUD_SKIRMISH_CLOSE
Description:
HUD_SKIRMISH_OPEN
Description:
HUD_SKIRMISH_UPDATE
Description:
HUD_TOGGLE
Description:
HUD_UPDATE
Description:
INVENTORY_ADD
Description:
Arguments:(itemid)
itemid itemid of added item
INVENTORY_RECEIVED
Description:
INVENTORY_REMOVE
Description:
INVENTORY_UPDATE
Description:
JETTISONMENU_TOGGLE
Description:
JUMP_OUT_CINEMATIC_FINISHED
Description:
Called when the sector jump-out cinematic is finished.
Arguments:
KEYADDED
Description:
Triggered after a key was added to the keychain
Arguments:
key id of added key
KEYINFO_DIALOG
Description:
KEYREMOVED
Description:
Triggered after a key was removed from the keychain
Arguments:
key id of removed key
LEAVE_ZONE_dock
Description:
LEAVE_ZONE_NFZ
Description:
LEAVE_ZONE_wormhole
Description:
LEAVING_STATION
Description:
LOGIN_FAILED
Description:
LOGIN_SUCCESSFUL
Description:
MISSIONLIST_UPDATED
Description:
MISSION_ADDED
Description:
MISSION_NOTIFICATION
Description:
MISSION_QUESTION_OPEN
Description: Triggered when the user opens the "info" screen to consider accepting a mission, OR after RequestMissionExtendedDescription is called.
Arguments:
- string extended description - the text which appears in the info screen
- string s - usually "Accept", but not always
- string missionid - mission id (Note that it is in string form, so "1234" instead of 1234)
- int stationid - station id
MISSION_REMOVED
Description:
MISSION_TIMER_START
Description:
MISSION_TIMER_STOP
Description:
MISSION_UPDATED
Description:
MSG_LOGOFF_TIMER
Description:
Logoff and explode countdowns and abort messages.
Arguments: (string msg)
MSG_NOTIFICATION
Description:
Occurs when a message is overlaid to the center of your HUD; eg. when you attempt to mine with a full inventory.
Arguments: (string msg, ...? unknown)
NAVMENU_TOGGLE
Description:
NAVROUTE_ADD
Description:
NAVROUTE_CHANGED
Description:
NAVROUTE_SAVE
Description:
NAVROUTE_UNDOLAST
Description:
OBJECT_INFO_UPDATED
Description:
OPEN_SURVEY
Description:
PLAYERLIST_CLOSE
Description:
PLAYERLIST_TOGGLE
Description:
PLAYER_DEATH_CINEMATIC_FINISHED
Description:
PLAYER_DIED
Description:
Triggered when player in the sector dies.
Arguments:(int died = charid, int killed = charid)
died - charid of player who died
killed - charid of player who killed him
weaponid - weaponid of the weapon which scored the kill
PLAYER_ENTERED_GAME
Description:
PLAYER_ENTERED_SECTOR
Description: Called whenever a player enters the sector you are in. When you first enter a sector it is called for every player and NPC currently in the sector. When you are entering a sector the first return value is 0 everything following is a character id but when you are already in the sector and another npc/player joins it returns a charid without starting with 0
Arguments: int charid
PLAYER_GOT_HIT
Description:
Triggered when player gets shot.
Arguments: (int attacked = charid, attacker = charid, unknown, boolean damaged)
unknown - seems proportional to damage but not quite the same
damaged - true when taking damage, false when being healed
PLAYER_GUILD_TAG_UPDATED
Description:
PLAYER_HIT
Description:
PLAYER_HOME_CHANGED
Description:
PLAYER_LEFT_SECTOR
Description:
PLAYERLIST_TOGGLE
Description:
Playerlist was toggled with command or keybind.
Arguments: None.
PLAYER_LOGGED_OUT
Description:
PLAYER_RECEIVED_NEW_ACCOMPLISHMENTS
Description:
PLAYER_STATS_UPDATED
Description:
PLAYER_UPDATE
Description:
PLAYER_UPDATE_ACCOMPLISHMENTS
Description:
PLAYER_UPDATE_FACTIONSTANDINGS
Description:
PLAYER_UPDATE_SKILLS
Description:
PLAYER_UPDATE_STATS
Description:
PLUGINS_LOADED
Description:
Triggered right after the plugin load sequence has completed.
PROXIMITY_ALERT
Description:
PUSH_TO_TALK
Description:
QUIT
Description:
SECTOR_ALIGNMENT_UPDATED
Description:
SECTOR_CHANGED
Description:
Triggered on entering a sector
Arguments:
sectorid - sectorid of the entered sector.
SECTOR_LOADED
Description:
SECTOR_LOADING
Description:
SERVER_DISCONNECTED
Description:
SHIP_CHANGED
Description:
SHIP_SPAWNED
Description:
SHIP_SPAWN_CINEMATIC_FINISHED
Description:
SHIP_UPDATED
Description:
SHOW_STATION
Description:
START
Description:
STATION_TURRET_HEALTH_UPDATE
Description:
STATION_UPDATED
Description:
STATION_UPDATE_DESIREDITEMS
Description:
STATION_UPDATE_PRICE
Description:
STATION_UPDATE_REQUESTED
Description:
STORM_STARTED
Description: Triggered when entering a sector which has an ion storm.
Arguments: None
STORM_STOPPED
Description: Triggered when entering a sector which does not have an Ion Storm (eg. from entering the game, performing a sector jump, performing a wormhole jump, or respawning). Also triggers if you are in a sector with an Ion Storm and that storm ends.
Arguments: None
SYSMENU_TOGGLE
Description:
SYSTEM_BEST_PRICE
Description:
Triggered when the best sell price of an item in the active ships cargo hold changes
Arguments:(item, price, station)
item itemid of changed item
price new price
station locationid of station with highest price
TARGET_CHANGED
Description:
Arguments: None.
TARGET_HEALTH_UPDATE
Description:
TARGET_SCANNED
Description:
Triggered when an object (ship or asteroid depending on scanner equipped) is scanned.
Causes HUD.scaninfo to be updated.
Arguments: (scaninfo, nodeid, objectid)
scaninfo string containing information about scan result. Same thing that's displayed in top right corner of the hud (HUD.scaninfo.title)
possible values:
- 'Object too far to scan\n' (note the trailing newline)
- for asteroids list of ore contents with one line per each ore, where line is: '[ore name] Ore: [percent]%'
- list of cargo for cargo scanners etc.
nodeid nodeid of scanned object.
objectid objectid of scanned object.
TERMINATE
Description:
TOUCH_PRESSED
Description:
Triggered when a Touch Region is pressed.
Arguments: (regionid, Xpos, Ypos)
regionid number identifying the region pressed
Xpos X position touched on the screen
Ypos Y position touched on the screen
TOUCH_RELEASED
Description:
Triggered when a Touch Region is released.
Arguments: (regionid, Xpos, Ypos)
regionid number identifying the region pressed
Xpos X position touched on the screen
Ypos Y position touched on the screen
TRANSACTION_COMPLETED
Description:
TRANSACTION_FAILED
Description:
TURRET_SPAWNED
Description:
TURRET_SPAWN_CINEMATIC_FINISHED
Description:
UNLOAD_INTERFACE
Description:
Raised when interface is about to be reloaded.
Arguments:
UPDATE_BUDDY_LIST
Description:
UPDATE_CHARACTER_LIST
Description:
UPDATE_CHARINFO
Description:
UPDATE_DUEL_INFO
Description:
UPDATE_FRIENDKEY_LIST
Description:
UPDATE_NEWS
Description:
UPDATE_NEWS_HEADLINES
Description:
VOICECHAT_PLAYER_LISTEN_STATUS
Description:
VOICECHAT_PLAYER_MUTE_STATUS
Description:
VOICECHAT_PLAYER_TALK_STATUS
Description:
WAITING_FOR_CAPSHIP_LAUNCH
Description:
WARP_OUT_CINEMATIC_FINISHED
Description:
Called when the wormhole warp-out cinematic is finished.
Arguments:
WEAPON_GROUP_CHANGED
Description:
WEAPON_PROGRESS_START
Description:
WEAPON_PROGRESS_STOP
Description:
rHUDxscale
Description:
TURRET_OCCUPIED
Description:
TURRET_EMPTY
Description:
TURRET_DEAD
Description: