User Tools

Site Tools


addons:events

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
addons:events [2017/04/21 19:28]
atom0s
addons:events [2017/04/22 00:10] (current)
Line 22: Line 22:
  
 **Short-hand Method** **Short-hand Method**
-<code lua>+<sxh lua>
 ashita.register_event('​load',​ function() ashita.register_event('​load',​ function()
     print('​Load event fired!'​);​     print('​Load event fired!'​);​
 end); end);
-</code>+</sxh>
  
 **Long-hand Method** **Long-hand Method**
-<code lua>+<sxh lua>
 function loadfunction() function loadfunction()
     print('​Load event fired!'​);​     print('​Load event fired!'​);​
Line 35: Line 35:
  
 ashita.register_event('​load',​ loadfunction);​ ashita.register_event('​load',​ loadfunction);​
-</code>+</sxh> 
 + 
 +---- 
 + 
 +===== Built-In Events ===== 
 + 
 +Below, you will find documentation for the built-in events that the Ashita addons library exposes to all addons. Please be aware of the returns and such of each event as incorrect returns can cause log spam of warnings/​errors as well as potential client crashes! Be sure to test your addons thoroughly before having others use them!
  
 ---- ----
Line 42: Line 48:
 Called when the current addon is being loaded. (Also called when the addon is reloaded.) Called when the current addon is being loaded. (Also called when the addon is reloaded.)
  
-<code lua>+<sxh lua>
 ashita.register_event('​load',​ function() ashita.register_event('​load',​ function()
     print('​Load event fired!'​);​     print('​Load event fired!'​);​
 end); end);
-</code>+</sxh>
  
 **Parameters** \\ **Parameters** \\
Line 59: Line 65:
 Called when the current addon is being unloaded. (Also called when the addon is reloaded.) Called when the current addon is being unloaded. (Also called when the addon is reloaded.)
  
-<code lua>+<sxh lua>
 ashita.register_event('​unload',​ function() ashita.register_event('​unload',​ function()
     print('​Unload event fired!'​);​     print('​Unload event fired!'​);​
 end); end);
-</code>+</sxh>
  
 **Parameters** \\ **Parameters** \\
Line 76: Line 82:
 Called when a command has been entered in the game. Called when a command has been entered in the game.
  
-<code lua>+<sxh lua>
 ashita.register_event('​command',​ function(cmd,​ nType) ashita.register_event('​command',​ function(cmd,​ nType)
     print('​Command event fired!'​);​     print('​Command event fired!'​);​
     return false;     return false;
 end); end);
-</code>+</sxh>
  
 **Parameters** \\ **Parameters** \\
Line 95: Line 101:
 Called when the game client is receiving an incoming packet. Called when the game client is receiving an incoming packet.
  
-<code lua>+<sxh lua>
 ashita.register_event('​incoming_packet',​ function(id,​ size, packet, packet_modified,​ blocked) ashita.register_event('​incoming_packet',​ function(id,​ size, packet, packet_modified,​ blocked)
     print('​Incoming packet event fired!'​);​     print('​Incoming packet event fired!'​);​
     return false;     return false;
 end); end);
-</code>+</sxh>
  
 **Parameters** \\ **Parameters** \\
Line 113: Line 119:
     * or     * or
     * **table** - A table containing new packet data that should be used to modify the packet.     * **table** - A table containing new packet data that should be used to modify the packet.
-    ​+
 ---- ----
 ==== Event: outgoing_packet ===== ==== Event: outgoing_packet =====
Line 119: Line 125:
 Called when the game client is sending an outgoing packet. Called when the game client is sending an outgoing packet.
  
-<code lua>+<sxh lua>
 ashita.register_event('​outgoing_packet',​ function(id,​ size, packet, packet_modified,​ blocked) ashita.register_event('​outgoing_packet',​ function(id,​ size, packet, packet_modified,​ blocked)
     print('​Outgoing packet event fired!'​);​     print('​Outgoing packet event fired!'​);​
     return false;     return false;
 end); end);
-</code>+</sxh>
  
 **Parameters** \\ **Parameters** \\
Line 137: Line 143:
     * or     * or
     * **table** - A table containing new packet data that should be used to modify the packet.     * **table** - A table containing new packet data that should be used to modify the packet.
-    ​+ 
 +---- 
 +==== Event: incoming_text ===== 
 + 
 +Called when the game client is adding text to the chat log. 
 + 
 +<sxh lua> 
 +ashita.register_event('​incoming_text',​ function(mode,​ message, modifiedmode,​ modifiedmessage,​ blocked) 
 +    print('​Incoming text event fired!'​);​ 
 +    return false; 
 +end); 
 +</​sxh>​ 
 + 
 +**Parameters** \\ 
 +    * **mode** - (number) The chat mode of the message. (Controls the color of the overall message.) 
 +    * **message** - (string) The message being added to the chat log. 
 +    * **modifiedmode** - (number) The modified mode, if another addon or plugin has modified it. 
 +    * **modifiedmessage** - (string) The modified message, if another addon or plugin has modified it. 
 +    * **blocked** - (bool) True if the message has been blocked by another addon or plugin, false otherwise. 
 + 
 +**Returns** \\ 
 +    * **bool** - True if the message should be blocked, false otherwise. 
 +    * or 
 +    * **number** - The modified message mode to use instead of the current one. 
 +    * or 
 +    * **string** - The modified message to use instead of the current one. 
 +    * or 
 +    * **string, number** - The modified message and mode to use instead of the current ones. 
 + 
 +---- 
 +==== Event: outgoing_text ===== 
 + 
 +Called when the game client is sending text to the server.\\ 
 +//(This gets called when a command, chat, etc. is not handled by the client and is being sent to the server.)//​ 
 + 
 +<sxh lua> 
 +ashita.register_event('​outgoing_text',​ function(mode,​ message, modifiedmode,​ modifiedmessage,​ blocked) 
 +    print('​Outgoing text event fired!'​);​ 
 +    return false; 
 +end); 
 +</​sxh>​ 
 + 
 +**Parameters** \\ 
 +    * **mode** - (number) The chat mode of the message. (Controls the color of the overall message.) 
 +    * **message** - (string) The message being added to the chat log. 
 +    * **modifiedmode** - (number) The modified mode, if another addon or plugin has modified it. 
 +    * **modifiedmessage** - (string) The modified message, if another addon or plugin has modified it. 
 +    * **blocked** - (bool) True if the message has been blocked by another addon or plugin, false otherwise. 
 + 
 +**Returns** \\ 
 +    * **bool** - True if the message should be blocked, false otherwise. 
 +    * or 
 +    * **number** - The modified message mode to use instead of the current one. 
 +    * or 
 +    * **string** - The modified message to use instead of the current one. 
 +    * or 
 +    * **string, number** - The modified message and mode to use instead of the current ones. 
 + 
 +---- 
 +==== Event: prerender ==== 
 + 
 +Called when the client is about to start rendering. (Called just after D3D8 BeginScene.) 
 + 
 +<sxh lua> 
 +ashita.register_event('​prerender',​ function() 
 +    print('​Prerender event fired!'​);​ 
 +end); 
 +</​sxh>​ 
 + 
 +**Parameters** \\ 
 +    * None 
 + 
 +**Returns** \\ 
 +    * None 
 + 
 +---- 
 +==== Event: render ==== 
 + 
 +Called when the client has finished its rendering and other tools can now render. (Called during D3D8 EndScene.) 
 + 
 +<sxh lua> 
 +ashita.register_event('​render',​ function() 
 +    print('​Render event fired!'​);​ 
 +end); 
 +</​sxh>​ 
 + 
 +**Parameters** \\ 
 +    * None 
 + 
 +**Returns** \\ 
 +    * None 
 + 
 +---- 
 +==== Event: timerpulse ==== 
 + 
 +Called when the client is rendering the scene, used for Addons Lua timers library.\\ 
 +//(Addons should not register to this event themselves, it is used for the timers library.)//​ 
 + 
 +<sxh lua> 
 +ashita.register_event('​timerpulse',​ function() 
 +    print('​Timer pulse event fired!'​);​ 
 +end); 
 +</​sxh>​ 
 + 
 +**Parameters** \\ 
 +    * None 
 + 
 +**Returns** \\ 
 +    * None 
 + 
 ---- ----
addons/events.1492828115.txt.gz · Last modified: 2017/04/21 19:28 by atom0s