mirror of
https://github.com/OpenMW/openmw.git
synced 2025-01-22 06:23:53 +00:00
42 lines
1.3 KiB
ReStructuredText
42 lines
1.3 KiB
ReStructuredText
Built-in events
|
|
===============
|
|
|
|
Actor events
|
|
------------
|
|
|
|
**StartAIPackage, RemoveAIPackages**
|
|
|
|
Any script can send to any actor (except player, for player will be ignored) events ``StartAIPackage`` and ``RemoveAIPackages``.
|
|
The effect is equivalent to calling ``interfaces.AI.startPackage`` or ``interfaces.AI.removePackages`` in a local script on this actor.
|
|
|
|
Examples:
|
|
|
|
.. code-block:: Lua
|
|
|
|
actor:sendEvent('StartAIPackage', {type='Combat', target=self.object})
|
|
actor:sendEvent('RemoveAIPackages', 'Pursue')
|
|
|
|
**UseItem**
|
|
|
|
Any script can send global event ``UseItem`` with arguments ``object`` and ``actor``.
|
|
The actor will use (e.g. equip or consume) the object. The object should be in the actor's inventory.
|
|
|
|
Example:
|
|
|
|
.. code-block:: Lua
|
|
|
|
core.sendGlobalEvent('UseItem', {object = potion, actor = player})
|
|
|
|
UI events
|
|
---------
|
|
|
|
Every time UI mode is changed built-in scripts send to player the event ``UiModeChanged`` with arguments ``oldMode, ``newMode`` (same as ``I.UI.getMode()``)
|
|
and ``arg`` (for example in the mode ``Book`` the argument is the book the player is reading).
|
|
|
|
.. code-block:: Lua
|
|
|
|
eventHandlers = {
|
|
UiModeChanged = function(data)
|
|
print('UiModeChanged from', data.oldMode , 'to', data.newMode, '('..tostring(data.arg)..')')
|
|
end
|
|
}
|