Eventtype: Difference between revisions

From Vendetta Lua
Jump to navigationJump to search
← Older edit
Mick (talk | contribs)
72 edits
No edit summary
 
(59 intermediate revisions by 13 users not shown)
Line 5: Line 5:




A very basic example using the TARGET_CHANGED event. It's triggered whenever the target changes
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">
<source lang="lua">
-- define a table. this table is the "object" that gets registered with event
-- define a table. this table is the "object" that gets registered with event
Line 11: Line 13:


-- define a function called OnEvent within this table. It's called when the event is triggered.  
-- define a function called OnEvent within this table. It's called when the event is triggered.  
-- It has at least one argument, containing the name of the event that is passed to it
-- It has at least one argument, the name of the event that is passed to it
function target:OnEvent(event)
-- the remaining arguments are optional event data
function target:OnEvent(event, data)
     -- this way it is possible to handle multiple events with one table
     -- this way it is possible to handle multiple events with one table
     if event == "TARGET_CHANGED" then
     if event == "TARGET_CHANGED" then
Line 22: Line 25:
-- register the table with the event
-- register the table with the event
RegisterEvent(target, "TARGET_CHANGED")  
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>
</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 ==
== Notes ==
Line 52: Line 100:
</source>
</source>


== [[Order of Events]] ==


== Eventlist ==
== Eventlist ==
Line 96: Line 145:
===ACTIVATE_CHAT_USER===
===ACTIVATE_CHAT_USER===
'''Description:'''
'''Description:'''
<br>
<br>
===ASSIGNOWNERKEY_DIALOG===
'''Description:'''
<br>
Triggered when the station requests a key assignment
<br>
<br>


Line 110: Line 166:
<br>
<br>
===CHARINFOMENU_TOGGLE===
===CHARINFOMENU_TOGGLE===
'''Description:'''
'''Description:'''<br>
Charinfo menu was toggled with /charinfo command or key bind.<br>
'''Arguments:''' None.<br>
<br>
<br>


<br>
===CHAT_CANCELLED===
===CHAT_CANCELLED===
'''Description:'''
'''Description:'''<br>
Triggered when esc is pressed in chat entry box.<br>
'''Arguments:''' None.<br>
<br>
<br>


===CHAT_DONE===
'''Description:'''<br>
Triggered when enter is pressed in chat entry box.<br>
'''Arguments:''' None.<br>
<br>
<br>
===CHAT_DONE===
 
===CHAT_ENTERED===
'''Description:'''
'''Description:'''
<br>
<br>
 
Triggers after CHAT_DONE and echos back the text entered into the chat bar.
<br>
<br>
'''text''' the text entered on the chat bar.
<br/><br/>
===CHAT_MSG_BAR1===
===CHAT_MSG_BAR1===
'''Description:'''
'''Description:'''
Line 238: Line 304:
<br>
<br>
===CHAT_MSG_CHANNEL===
===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:'''
'''Description:'''
<br>
<br>
 
Message on active channel.
<br>
<br>
<br>
===CHAT_MSG_CHANNEL_ACTIVE===
'''Arguments:'''
'''Description:'''
<br>
<br>
'''data''' = {string name, string msg, int faction = [[factionid]], int channelid}
<br><br>


<br>
===CHAT_MSG_CHANNEL_EMOTE===
===CHAT_MSG_CHANNEL_EMOTE===
'''Description:'''
'''Description:'''
An emote (/me) message in channel chat
<br>
<br />
'''Arguments:'''
'''data''' = {string name, string msg, int faction = factionid, int channelid}
<br>
<br>


<br>
===CHAT_MSG_CHANNEL_EMOTE_ACTIVE===
===CHAT_MSG_CHANNEL_EMOTE_ACTIVE===
'''Description:'''
'''Description:'''
Line 263: Line 343:
<br>
<br>
===CHAT_MSG_DEATH===
===CHAT_MSG_DEATH===
'''Description:'''
<br>
<br>
===CHAT_MSG_DISABLED===
'''Description:'''
'''Description:'''
<br>
<br>
Line 287: Line 372:


<br><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===
===CHAT_MSG_GUIDE===
Line 306: Line 399:
'''Arguments:'''
'''Arguments:'''
<br>
<br>
arg1 = {string msg, string name, int location = [[sectorid]], int faction = [[factionid]]}
'''data''' = {string msg, string name, int location = [[sectorid]], int faction = [[factionid]]}
<br><br>
<br><br>


Line 317: Line 410:
'''Arguments:'''
'''Arguments:'''
<br>
<br>
arg1 = {string msg, string name, int location = [[sectorid]], int faction = [[factionid]]}
'''data''' = {string msg, string name, int location = [[sectorid]], int faction = [[factionid]]}
<br><br>
<br><br>


Line 323: Line 416:
'''Description:'''
'''Description:'''
<br>
<br>
Not used, instead guild MOTD triggers CHAT_MSG_SERVER event.
Not used, instead guild MOTD triggers [[Eventtype#CHAT_MSG_SERVER|CHAT_MSG_SERVER]] event.
The guild MOTD.
<br>
<br>
<br>
<br>


===CHAT_MSG_GROUP_NOTIFICATION===
'''Description:'''
<br>
<br>
===CHAT_MSG_INCOMINGBUDDYNOTE===
===CHAT_MSG_INCOMINGBUDDYNOTE===
'''Description:'''
'''Description:'''
Line 351: Line 438:
'''Description:'''
'''Description:'''
<br>
<br>
A message on nation chat. Depricated/unused.
A message on nation chat. Depreciated.
<br>
<br>
<br>
<br>
Line 357: Line 444:
===CHAT_MSG_PRINT===
===CHAT_MSG_PRINT===
'''Description:'''
'''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>
<br>


<br>
===CHAT_MSG_PRIVATE===
===CHAT_MSG_PRIVATE===
'''Description:'''<br>
'''Description:'''<br>
 
An incoming private message from another player.<br>
An incoming private message from another player.
<br>
'''Arguments:'''<br>
'''data''' = {string msg, string name}
<br>
<br>
<br>
<br>
'''Arguments:'''<br>
arg1 = {string msg, string name}
<br><br>


===CHAT_MSG_PRIVATEOUTGOING===
===CHAT_MSG_PRIVATEOUTGOING===
'''Description:'''
'''Description:'''
<br>
<br>
An outgoing private message to another player.
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>
<br>
<br>
'''Arguments:'''<br>
'''Arguments:'''
'''data''' = {string msg, string name}
<br>
 
<br><br>
<br><br>


Line 397: Line 487:
<br>
<br>
A message from the sector daemon.
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>
<br>
<br>
'''Arguments:'''
'''Arguments:'''
<br>
<br>
 
'''data''' = {string msg}
<br><br>
<br><br>


Line 408: Line 502:
<br>
<br>
A mission message from the sector daemon.
A mission message from the sector daemon.
Top5 listing at racetracks triggers this event too.
<br>
<br>
<br>
<br>
'''Arguments:'''
'''Arguments:'''<br>
data = {string msg, int missionid}
 
<br>
<br>


Line 439: Line 537:
===CHAT_MSG_SERVER===
===CHAT_MSG_SERVER===
'''Description:'''
'''Description:'''
<br>
<br />Messages triggered by events such as <br />
'*** Your buddy [name] logged off/on.'
<br />'''Arguments:'''<br />
'''msg''' - table containing string with the message


<br>
===CHAT_MSG_SERVER_CHANNEL===
===CHAT_MSG_SERVER_CHANNEL===
'''Description:'''
'''Description:'''
Line 458: Line 558:
<br>
<br>
===CHAT_MSG_SERVER_SECTOR===
===CHAT_MSG_SERVER_SECTOR===
'''Description:'''
'''Description:'''<br>
Messages triggered by (or that trigger) this event:
 
'You are entering [location].'
<br>
'''Arguments:'''<br>
'''msg''' - string containing the message
<br>
<br>


<br>
===CHAT_MSG_SYSTEM===
===CHAT_MSG_SYSTEM===
'''Description:'''
'''Description:'''
Line 494: Line 599:
<br><br>
<br><br>


===COMMAND===
=== 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:'''
'''Description:'''
<br>
<br>
Line 500: Line 613:
<br>
<br>
===DESIRED_SPEED_CHANGED===
===DESIRED_SPEED_CHANGED===
'''Description:'''
<br>
<br>
===EMOTE_ENTERED===
'''Description:'''
'''Description:'''
<br>
<br>
Line 505: Line 623:
<br>
<br>
===ENTERED_STATION===
===ENTERED_STATION===
'''Description:'''<br>
Triggered when entering station.<br>
'''Arguments:'''<br>
None.<br>
===ENTERING_STATION===
'''Description:'''
'''Description:'''
<br>
<br>


<br>
<br>
===ENTERING_STATION===
===ENTER_ZONE_dock===
'''Description:'''
'''Description:'''
<br>
<br>
Line 515: Line 639:
<br>
<br>
===ENTER_ZONE_NFZ===
===ENTER_ZONE_NFZ===
'''Description:'''
<br>
<br>
===ENTER_ZONE_wormhole===
'''Description:'''
'''Description:'''
<br>
<br>
Line 530: Line 659:
<br>
<br>
===GROUP_CREATED===
===GROUP_CREATED===
'''Description:'''
'''Description:'''<br>
<br>
Triggered when you create a group before anyone joins.<br>
 
'''Arguments:'''<br>
none
<br/>
<br>
<br>
===GROUP_MEMBER_DIED===
===GROUP_MEMBER_DIED===
Line 540: Line 671:
<br>
<br>
===GROUP_MEMBER_HEALTH_UPDATE===
===GROUP_MEMBER_HEALTH_UPDATE===
'''Description:'''
'''Description:'''<br>
<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>
<br>
===GROUP_MEMBER_JOINED===
===GROUP_MEMBER_JOINED===
'''Description:'''
'''Description:'''<br>
Triggers when someone joins your group<br/>
'''Arguments:'''<br>
'''name''' character name of the joiner
<br>
<br>
<br>
<br>
===GROUP_MEMBER_KILLED===
===GROUP_MEMBER_KILLED===
'''Description:'''
'''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>
<br>
<br>
===GROUP_MEMBER_LEFT===
===GROUP_MEMBER_LEFT===
'''Description:'''
'''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>
<br>
<br>
===GROUP_MEMBER_LOCATION_CHANGED===
===GROUP_MEMBER_LOCATION_CHANGED===
'''Description:'''
'''Description:'''<br>
Triggers when a group members location changes<br>
'''Arguments:'''<br>
'''charid''' character id of the member who changed their location
<br>
<br>
<br>
<br>
===GROUP_MEMBER_UPDATE===
===GROUP_MEMBER_UPDATE===
Line 585: Line 733:
<br>
<br>
===GROUP_SELF_LEFT===
===GROUP_SELF_LEFT===
'''Description:'''
'''Description:'''<br>
Triggers when you leave a group but are not kicked.<br>
'''Arguments:'''<br>
none
<br>
<br>
<br>
<br>
===GUILD_ACTIVITY_LOG===
===GUILD_ACTIVITY_LOG===
Line 613: Line 763:
<br>
<br>
Triggered when guild member logs on or joins the guild.
Triggered when guild member logs on or joins the guild.
<br>
'''Arguments:'''
'''Arguments:'''
<br>
<br>
'''charid''' [[charid]] of added guild member.
'''charid''' [[charid]] of added guild member.<br/>
'''rank''' 0=member, 1=lieutenant, 2=council member, 3=council member and lieutenant, 4=commander
<br><br>
<br><br>
===GUILD_MEMBER_REMOVED===
===GUILD_MEMBER_REMOVED===
Line 621: Line 773:
<br>
<br>
Triggered when guild member logs off or leaves the guild.
Triggered when guild member logs off or leaves the guild.
<br>
'''Arguments:'''
'''Arguments:'''
<br>
<br>
'''charid''' [[charid]] of removed guild member.
'''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>
<br><br>
===GUILD_MEMBER_UPDATED===
===GUILD_MEMBER_UPDATED===
'''Description:'''
'''Description:'''
Line 636: Line 791:
<br>
<br>
===GUILD_PRIVILEGES_UPDATED===
===GUILD_PRIVILEGES_UPDATED===
'''Description:'''
<br>
<br>
===GUNNER_KICKED===
'''Description:'''
<br>
<br>
===GUNNER_LEFT===
'''Description:'''
'''Description:'''
<br>
<br>
Line 658: Line 823:
'''Description:'''
'''Description:'''
<br>
<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>
<br>
Line 692: Line 869:
===INVENTORY_ADD===
===INVENTORY_ADD===
'''Description:'''
'''Description:'''
<br>
'''Arguments:'''(itemid)<br>
'''itemid''' [[itemid]] of added item<br>
<br>
<br>


<br>
===INVENTORY_RECEIVED===
===INVENTORY_RECEIVED===
'''Description:'''
'''Description:'''
Line 726: Line 905:
<br><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===
===LEAVE_ZONE_NFZ===
'''Description:'''
<br>
<br>
===LEAVE_ZONE_wormhole===
'''Description:'''
'''Description:'''
<br>
<br>
Line 762: Line 975:
<br>
<br>
===MISSION_QUESTION_OPEN===
===MISSION_QUESTION_OPEN===
'''Description:'''
'''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>
<br>


<br>
===MISSION_REMOVED===
===MISSION_REMOVED===
'''Description:'''
'''Description:'''
Line 788: Line 1,005:
===MSG_LOGOFF_TIMER===
===MSG_LOGOFF_TIMER===
'''Description:'''
'''Description:'''
<br>
Logoff and explode countdowns and abort messages.<br>
<br>
'''Arguments:''' (string msg)<br>
<br>
<br>


<br>
===MSG_NOTIFICATION===
===MSG_NOTIFICATION===
'''Description:'''
'''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>
<br>


<br>
===NAVMENU_TOGGLE===
===NAVMENU_TOGGLE===
'''Description:'''
'''Description:'''
Line 827: Line 1,050:
<br>
<br>
===OPEN_SURVEY===
===OPEN_SURVEY===
'''Description:'''
<br>
<br>
===PLAYERLIST_CLOSE===
'''Description:'''
'''Description:'''
<br>
<br>
Line 832: Line 1,060:
<br>
<br>
===PLAYERLIST_TOGGLE===
===PLAYERLIST_TOGGLE===
'''Description:'''
<br>
<br>
===PLAYER_DEATH_CINEMATIC_FINISHED===
'''Description:'''
'''Description:'''
<br>
<br>
Line 838: Line 1,071:
===PLAYER_DIED===
===PLAYER_DIED===
'''Description:'''
'''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>
<br>


<br>
===PLAYER_ENTERED_GAME===
===PLAYER_ENTERED_GAME===
'''Description:'''
'''Description:'''
Line 847: Line 1,086:
<br>
<br>
===PLAYER_ENTERED_SECTOR===
===PLAYER_ENTERED_SECTOR===
'''Description:'''
'''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>
<br>


<br>
===PLAYER_GOT_HIT===
===PLAYER_GOT_HIT===
'''Description:'''
'''Description:'''<br>
<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>


<br>
===PLAYER_GUILD_TAG_UPDATED===
===PLAYER_GUILD_TAG_UPDATED===
'''Description:'''
'''Description:'''
Line 876: Line 1,119:


<br>
<br>
===PLAYERLIST_TOGGLE===
'''Description:'''<br>
Playerlist was toggled with command or keybind.<br>
'''Arguments:''' None.<br>
===PLAYER_LOGGED_OUT===
===PLAYER_LOGGED_OUT===
'''Description:'''
'''Description:'''
Line 887: Line 1,136:
<br>
<br>
===PLAYER_STATS_UPDATED===
===PLAYER_STATS_UPDATED===
'''Description:'''
<br>
<br>
===PLAYER_UPDATE===
'''Description:'''
'''Description:'''
<br>
<br>
Line 909: Line 1,163:
'''Description:'''
'''Description:'''
<br>
<br>
<br>
===PLUGINS_LOADED===
'''Description:'''<br>
Triggered right after the plugin load sequence has completed.


<br>
<br>
===PROXIMITY_ALERT===
===PROXIMITY_ALERT===
'''Description:'''
<br>
<br>
===PUSH_TO_TALK===
'''Description:'''
<br>
<br>
===QUIT===
'''Description:'''
'''Description:'''
<br>
<br>
Line 922: Line 1,191:
<br>
<br>
===SECTOR_CHANGED===
===SECTOR_CHANGED===
'''Description:'''
'''Description:'''<br>
Triggered on entering a sector<br>
<br>
'''Arguments:'''<br>
'''sectorid''' - [[sectorid]] of the entered sector.
<br>
<br>


<br>
===SECTOR_LOADED===
===SECTOR_LOADED===
'''Description:'''
'''Description:'''
Line 947: Line 1,219:
<br>
<br>
===SHIP_SPAWNED===
===SHIP_SPAWNED===
'''Description:'''
<br>
<br>
===SHIP_SPAWN_CINEMATIC_FINISHED===
'''Description:'''
'''Description:'''
<br>
<br>
Line 992: Line 1,269:
<br>
<br>
===STORM_STARTED===
===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:'''
'''Description:'''
<br>
<br>


<br>
<br>
===STORM_STOPPED===
===SYSTEM_BEST_PRICE===
'''Description:'''
'''Description:'''
<br>
<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>
===SYSMENU_TOGGLE===
'''Description:'''
<br>
<br>


Line 1,009: Line 1,300:
'''Description:'''
'''Description:'''
<br>
<br>
 
'''Arguments:''' None.
<br>
<br>
===TARGET_HEALTH_UPDATE===
===TARGET_HEALTH_UPDATE===
Line 1,019: Line 1,310:
'''Description:'''
'''Description:'''
<br>
<br>
Triggered when asteroid is scanned.
Triggered when an object (ship or asteroid depending on scanner equipped) is scanned.<br>
Causes HUD.scaninfo to be updated.
<br>
<br>
'''Arguments:'''(scaninfo, nodeid, objectid)<br>
'''Arguments:''' (scaninfo, nodeid, objectid)<br>


'''scaninfo''' string containing information on ores contained by the roid. Same thing that's displayed in top right corner of the hud (HUD.scaninfo.title)<br>
'''scaninfo''' string containing information about scan result. Same thing that's displayed in top right corner of the hud (HUD.scaninfo.title)<br>
'''nodeid''' [[nodeid]] of scanned roid.<br>
possible values:<br>
'''objectid''' [[objectid]] of scanned roid.<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>
<br>
<br>
Line 1,033: Line 1,330:
<br>
<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>
<br>
===TRANSACTION_COMPLETED===
===TRANSACTION_COMPLETED===
Line 1,040: Line 1,362:
<br>
<br>
===TRANSACTION_FAILED===
===TRANSACTION_FAILED===
'''Description:'''
<br>
<br>
===TURRET_SPAWNED===
'''Description:'''
<br>
<br>
===TURRET_SPAWN_CINEMATIC_FINISHED===
'''Description:'''
'''Description:'''
<br>
<br>
Line 1,071: Line 1,403:
<br>
<br>
===UPDATE_DUEL_INFO===
===UPDATE_DUEL_INFO===
'''Description:'''
<br>
<br>
===UPDATE_FRIENDKEY_LIST===
'''Description:'''
'''Description:'''
<br>
<br>
Line 1,096: Line 1,433:
<br>
<br>
===VOICECHAT_PLAYER_TALK_STATUS===
===VOICECHAT_PLAYER_TALK_STATUS===
'''Description:'''
<br>
<br>
===WAITING_FOR_CAPSHIP_LAUNCH===
'''Description:'''
'''Description:'''
<br>
<br>
Line 1,127: Line 1,469:
<br>
<br>
===rHUDxscale===
===rHUDxscale===
'''Description:'''
<br>
<br>
===TURRET_OCCUPIED===
'''Description:'''
<br>
<br>
===TURRET_EMPTY===
'''Description:'''
<br>
<br>
===TURRET_DEAD===
'''Description:'''
'''Description:'''
<br>
<br>


<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:


Retrieved from "https://vo-wiki.com/racecar2/index.php?title=Eventtype&oldid=14149"