2012-06-14 09:06:06 -04:00
|
|
|
|
2013-08-09 09:15:56 -04:00
|
|
|
// PluginLua.h
|
|
|
|
|
|
|
|
// Declares the cPluginLua class representing a plugin written in Lua
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
#pragma once
|
|
|
|
|
2012-09-23 18:09:57 -04:00
|
|
|
#include "Plugin.h"
|
2013-08-04 17:11:25 -04:00
|
|
|
#include "LuaState.h"
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-02-01 14:55:42 -05:00
|
|
|
// Names for the global variables through which the plugin is identified in its LuaState
|
2015-09-25 04:14:17 -04:00
|
|
|
#define LUA_PLUGIN_NAME_VAR_NAME "_CuberiteInternal_PluginName"
|
|
|
|
#define LUA_PLUGIN_INSTANCE_VAR_NAME "_CuberiteInternal_PluginInstance"
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2015-05-09 03:25:09 -04:00
|
|
|
// fwd: "UI/Window.h"
|
2013-05-30 16:40:43 -04:00
|
|
|
class cWindow;
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2012-12-21 06:04:08 -05:00
|
|
|
// tolua_begin
|
2013-08-19 03:39:18 -04:00
|
|
|
class cPluginLua :
|
2016-03-02 04:05:10 -05:00
|
|
|
public cPlugin
|
2012-12-21 06:04:08 -05:00
|
|
|
{
|
2015-04-19 04:57:41 -04:00
|
|
|
typedef cPlugin super;
|
|
|
|
|
2012-12-21 06:04:08 -05:00
|
|
|
public:
|
|
|
|
// tolua_end
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-02-10 14:38:02 -05:00
|
|
|
/** A RAII-style mutex lock for accessing the internal LuaState.
|
|
|
|
This will be the only way to retrieve the plugin's LuaState;
|
|
|
|
therefore it directly supports accessing the LuaState of the locked plugin.
|
|
|
|
Usage:
|
|
|
|
cPluginLua::cOperation Op(SomePlugin);
|
|
|
|
Op().Call(...) // Call a function in the plugin's LuaState
|
|
|
|
*/
|
|
|
|
class cOperation
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
cOperation(cPluginLua & a_Plugin) :
|
|
|
|
m_Plugin(a_Plugin),
|
2016-06-12 10:53:24 -04:00
|
|
|
m_Lock(a_Plugin.m_LuaState)
|
2014-02-10 14:38:02 -05:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
cLuaState & operator ()(void) { return m_Plugin.m_LuaState; }
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-02-10 14:38:02 -05:00
|
|
|
protected:
|
|
|
|
cPluginLua & m_Plugin;
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2016-06-12 10:53:24 -04:00
|
|
|
/** RAII lock for the Lua state. */
|
|
|
|
cLuaState::cLock m_Lock;
|
2014-02-10 14:38:02 -05:00
|
|
|
} ;
|
2015-03-20 10:13:33 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
2017-01-17 16:38:04 -05:00
|
|
|
cPluginLua(const AString & a_PluginDirectory, cDeadlockDetect & a_DeadlockDetect);
|
2017-05-20 02:16:28 -04:00
|
|
|
virtual ~cPluginLua() override;
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-01-11 23:46:01 -05:00
|
|
|
virtual void OnDisable(void) override;
|
2015-04-19 04:57:41 -04:00
|
|
|
virtual bool Load(void) override;
|
|
|
|
virtual void Unload(void) override;
|
2013-01-11 23:46:01 -05:00
|
|
|
|
|
|
|
virtual void Tick(float a_Dt) override;
|
|
|
|
|
2014-10-15 13:01:55 -04:00
|
|
|
virtual bool OnBlockSpread (cWorld & a_World, int a_BlockX, int a_BlockY, int a_BlockZ, eSpreadSource a_Source) override;
|
|
|
|
virtual bool OnBlockToPickups (cWorld & a_World, cEntity * a_Digger, int a_BlockX, int a_BlockY, int a_BlockZ, BLOCKTYPE a_BlockType, NIBBLETYPE a_BlockMeta, cItems & a_Pickups) override;
|
2015-09-24 04:48:33 -04:00
|
|
|
virtual bool OnBrewingCompleting (cWorld & a_World, cBrewingstandEntity & a_BrewingstandEntity) override;
|
|
|
|
virtual bool OnBrewingCompleted (cWorld & a_World, cBrewingstandEntity & a_BrewingstandEntity) override;
|
2014-10-15 13:01:55 -04:00
|
|
|
virtual bool OnChat (cPlayer & a_Player, AString & a_Message) override;
|
|
|
|
virtual bool OnChunkAvailable (cWorld & a_World, int a_ChunkX, int a_ChunkZ) override;
|
|
|
|
virtual bool OnChunkGenerated (cWorld & a_World, int a_ChunkX, int a_ChunkZ, cChunkDesc * a_ChunkDesc) override;
|
|
|
|
virtual bool OnChunkGenerating (cWorld & a_World, int a_ChunkX, int a_ChunkZ, cChunkDesc * a_ChunkDesc) override;
|
|
|
|
virtual bool OnChunkUnloaded (cWorld & a_World, int a_ChunkX, int a_ChunkZ) override;
|
|
|
|
virtual bool OnChunkUnloading (cWorld & a_World, int a_ChunkX, int a_ChunkZ) override;
|
|
|
|
virtual bool OnCollectingPickup (cPlayer & a_Player, cPickup & a_Pickup) override;
|
2014-12-04 03:21:57 -05:00
|
|
|
virtual bool OnCraftingNoRecipe (cPlayer & a_Player, cCraftingGrid & a_Grid, cCraftingRecipe & a_Recipe) override;
|
2014-05-02 05:18:02 -04:00
|
|
|
virtual bool OnDisconnect (cClientHandle & a_Client, const AString & a_Reason) override;
|
2014-07-11 20:27:29 -04:00
|
|
|
virtual bool OnEntityAddEffect (cEntity & a_Entity, int a_EffectType, int a_EffectDurationTicks, int a_EffectIntensity, double a_DistanceModifier) override;
|
2015-05-21 06:27:54 -04:00
|
|
|
virtual bool OnEntityChangingWorld (cEntity & a_Entity, cWorld & a_World) override;
|
2015-05-18 16:29:39 -04:00
|
|
|
virtual bool OnEntityChangedWorld (cEntity & a_Entity, cWorld & a_World) override;
|
2015-05-10 17:11:30 -04:00
|
|
|
virtual bool OnExecuteCommand (cPlayer * a_Player, const AStringVector & a_Split, const AString & a_EntireCommand, cPluginManager::CommandResult & a_Result) override;
|
Added OnExploding() and OnExploded() hooks.
As requested in FS 413, with extra parameters:
World, BlockX, BlockY, BlockZ, Size, CanCauseFire, Source, SourceData
OnExploding() can return 3 values:
StopHook, CanCauseFire, ExplosionSize
2013-08-09 08:58:43 -04:00
|
|
|
virtual bool OnExploded (cWorld & a_World, double a_ExplosionSize, bool a_CanCauseFire, double a_X, double a_Y, double a_Z, eExplosionSource a_Source, void * a_SourceData) override;
|
|
|
|
virtual bool OnExploding (cWorld & a_World, double & a_ExplosionSize, bool & a_CanCauseFire, double a_X, double a_Y, double a_Z, eExplosionSource a_Source, void * a_SourceData) override;
|
2014-10-15 13:01:55 -04:00
|
|
|
virtual bool OnHandshake (cClientHandle & a_Client, const AString & a_Username) override;
|
2013-08-11 08:57:07 -04:00
|
|
|
virtual bool OnHopperPullingItem (cWorld & a_World, cHopperEntity & a_Hopper, int a_DstSlotNum, cBlockEntityWithItems & a_SrcEntity, int a_SrcSlotNum) override;
|
|
|
|
virtual bool OnHopperPushingItem (cWorld & a_World, cHopperEntity & a_Hopper, int a_SrcSlotNum, cBlockEntityWithItems & a_DstEntity, int a_DstSlotNum) override;
|
2015-06-02 11:06:18 -04:00
|
|
|
virtual bool OnKilled (cEntity & a_Victim, TakeDamageInfo & a_TDI, AString & a_DeathMessage) override;
|
2014-07-16 06:38:52 -04:00
|
|
|
virtual bool OnKilling (cEntity & a_Victim, cEntity * a_Killer, TakeDamageInfo & a_TDI) override;
|
2015-07-29 11:04:03 -04:00
|
|
|
virtual bool OnLogin (cClientHandle & a_Client, UInt32 a_ProtocolVersion, const AString & a_Username) override;
|
2013-12-18 11:11:15 -05:00
|
|
|
virtual bool OnPlayerAnimation (cPlayer & a_Player, int a_Animation) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnPlayerBreakingBlock (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, BLOCKTYPE a_BlockType, NIBBLETYPE a_BlockMeta) override;
|
|
|
|
virtual bool OnPlayerBrokenBlock (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, BLOCKTYPE a_BlockType, NIBBLETYPE a_BlockMeta) override;
|
2014-01-25 05:25:22 -05:00
|
|
|
virtual bool OnPlayerDestroyed (cPlayer & a_Player) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnPlayerEating (cPlayer & a_Player) override;
|
2013-12-31 08:53:10 -05:00
|
|
|
virtual bool OnPlayerFished (cPlayer & a_Player, const cItems & a_Reward) override;
|
2014-01-01 09:09:53 -05:00
|
|
|
virtual bool OnPlayerFishing (cPlayer & a_Player, cItems & a_Reward) override;
|
2014-07-02 08:46:00 -04:00
|
|
|
virtual bool OnPlayerFoodLevelChange (cPlayer & a_Player, int a_NewFoodLevel) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnPlayerJoined (cPlayer & a_Player) override;
|
|
|
|
virtual bool OnPlayerLeftClick (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, char a_Status) override;
|
2014-08-22 04:33:53 -04:00
|
|
|
virtual bool OnPlayerMoving (cPlayer & a_Player, const Vector3d & a_OldPosition, const Vector3d & a_NewPosition) override;
|
2014-12-24 01:20:17 -05:00
|
|
|
virtual bool OnPlayerPlacedBlock (cPlayer & a_Player, const sSetBlock & a_BlockChange) override;
|
|
|
|
virtual bool OnPlayerPlacingBlock (cPlayer & a_Player, const sSetBlock & a_BlockChange) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnPlayerRightClick (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, int a_CursorX, int a_CursorY, int a_CursorZ) override;
|
|
|
|
virtual bool OnPlayerRightClickingEntity(cPlayer & a_Player, cEntity & a_Entity) override;
|
|
|
|
virtual bool OnPlayerShooting (cPlayer & a_Player) override;
|
|
|
|
virtual bool OnPlayerSpawned (cPlayer & a_Player) override;
|
2015-03-05 05:52:42 -05:00
|
|
|
virtual bool OnEntityTeleport (cEntity & a_Entity, const Vector3d & a_OldPosition, const Vector3d & a_NewPosition) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnPlayerTossingItem (cPlayer & a_Player) override;
|
|
|
|
virtual bool OnPlayerUsedBlock (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, int a_CursorX, int a_CursorY, int a_CursorZ, BLOCKTYPE a_BlockType, NIBBLETYPE a_BlockMeta) override;
|
|
|
|
virtual bool OnPlayerUsedItem (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, int a_CursorX, int a_CursorY, int a_CursorZ) override;
|
|
|
|
virtual bool OnPlayerUsingBlock (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, int a_CursorX, int a_CursorY, int a_CursorZ, BLOCKTYPE a_BlockType, NIBBLETYPE a_BlockMeta) override;
|
|
|
|
virtual bool OnPlayerUsingItem (cPlayer & a_Player, int a_BlockX, int a_BlockY, int a_BlockZ, char a_BlockFace, int a_CursorX, int a_CursorY, int a_CursorZ) override;
|
2014-01-07 11:47:05 -05:00
|
|
|
virtual bool OnPluginMessage (cClientHandle & a_Client, const AString & a_Channel, const AString & a_Message) override;
|
2013-12-29 06:51:58 -05:00
|
|
|
virtual bool OnPluginsLoaded (void) override;
|
2014-10-15 13:01:55 -04:00
|
|
|
virtual bool OnPostCrafting (cPlayer & a_Player, cCraftingGrid & a_Grid, cCraftingRecipe & a_Recipe) override;
|
|
|
|
virtual bool OnPreCrafting (cPlayer & a_Player, cCraftingGrid & a_Grid, cCraftingRecipe & a_Recipe) override;
|
2014-06-01 08:06:47 -04:00
|
|
|
virtual bool OnProjectileHitBlock (cProjectileEntity & a_Projectile, int a_BlockX, int a_BlockY, int a_BlockZ, eBlockFace a_Face, const Vector3d & a_BlockHitPos) override;
|
2014-03-29 10:26:41 -04:00
|
|
|
virtual bool OnProjectileHitEntity (cProjectileEntity & a_Projectile, cEntity & a_HitEntity) override;
|
2014-08-20 16:22:38 -04:00
|
|
|
virtual bool OnServerPing (cClientHandle & a_ClientHandle, AString & a_ServerDescription, int & a_OnlinePlayersCount, int & a_MaxPlayersCount, AString & a_Favicon) override;
|
2013-08-08 03:13:13 -04:00
|
|
|
virtual bool OnSpawnedEntity (cWorld & a_World, cEntity & a_Entity) override;
|
|
|
|
virtual bool OnSpawnedMonster (cWorld & a_World, cMonster & a_Monster) override;
|
|
|
|
virtual bool OnSpawningEntity (cWorld & a_World, cEntity & a_Entity) override;
|
|
|
|
virtual bool OnSpawningMonster (cWorld & a_World, cMonster & a_Monster) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnTakeDamage (cEntity & a_Receiver, TakeDamageInfo & a_TakeDamageInfo) override;
|
2014-10-15 13:01:55 -04:00
|
|
|
virtual bool OnUpdatedSign (cWorld & a_World, int a_BlockX, int a_BlockY, int a_BlockZ, const AString & a_Line1, const AString & a_Line2, const AString & a_Line3, const AString & a_Line4, cPlayer * a_Player) override;
|
|
|
|
virtual bool OnUpdatingSign (cWorld & a_World, int a_BlockX, int a_BlockY, int a_BlockZ, AString & a_Line1, AString & a_Line2, AString & a_Line3, AString & a_Line4, cPlayer * a_Player) override;
|
2013-08-02 02:44:06 -04:00
|
|
|
virtual bool OnWeatherChanged (cWorld & a_World) override;
|
|
|
|
virtual bool OnWeatherChanging (cWorld & a_World, eWeather & a_NewWeather) override;
|
2013-12-11 06:39:13 -05:00
|
|
|
virtual bool OnWorldStarted (cWorld & a_World) override;
|
2015-01-11 16:12:26 -05:00
|
|
|
virtual bool OnWorldTick (cWorld & a_World, std::chrono::milliseconds a_Dt, std::chrono::milliseconds a_LastTickDurationMSec) override;
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-01-21 16:59:08 -05:00
|
|
|
/** Returns true if the plugin contains the function for the specified hook type, using the old-style registration (#121) */
|
2013-08-22 15:03:20 -04:00
|
|
|
bool CanAddOldStyleHook(int a_HookType);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-01-21 16:59:08 -05:00
|
|
|
/** Returns the name of Lua function that should handle the specified hook type in the older (#121) API */
|
2013-08-21 15:29:30 -04:00
|
|
|
static const char * GetHookFnName(int a_HookType);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2016-03-02 04:12:43 -05:00
|
|
|
/** Adds a Lua callback to be called for the specified hook.
|
|
|
|
Returns true if the hook was added successfully. */
|
2016-06-27 14:49:59 -04:00
|
|
|
bool AddHookCallback(int a_HookType, cLuaState::cCallbackPtr && a_Callback);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-01-21 16:59:08 -05:00
|
|
|
/** Calls a function in this plugin's LuaState with parameters copied over from a_ForeignState.
|
|
|
|
The values that the function returns are placed onto a_ForeignState.
|
|
|
|
Returns the number of values returned, if successful, or negative number on failure. */
|
|
|
|
int CallFunctionFromForeignState(
|
|
|
|
const AString & a_FunctionName,
|
|
|
|
cLuaState & a_ForeignState,
|
|
|
|
int a_ParamStart,
|
|
|
|
int a_ParamEnd
|
|
|
|
);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2015-03-20 10:13:33 -04:00
|
|
|
/** Call a Lua function residing in the plugin. */
|
|
|
|
template <typename FnT, typename... Args>
|
|
|
|
bool Call(FnT a_Fn, Args && ... a_Args)
|
2013-10-12 16:24:59 -04:00
|
|
|
{
|
2016-06-12 10:53:24 -04:00
|
|
|
return cOperation(*this)().Call(a_Fn, a_Args...);
|
2013-10-12 16:24:59 -04:00
|
|
|
}
|
|
|
|
|
2013-08-21 15:29:30 -04:00
|
|
|
protected:
|
2014-01-21 16:59:08 -05:00
|
|
|
/** Provides an array of Lua function references */
|
2016-03-02 04:12:43 -05:00
|
|
|
typedef std::vector<cLuaState::cCallbackPtr> cLuaCallbacks;
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-01-21 16:59:08 -05:00
|
|
|
/** Maps hook types into arrays of Lua function references to call for each hook type */
|
2016-03-02 04:12:43 -05:00
|
|
|
typedef std::map<int, cLuaCallbacks> cHookMap;
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2015-03-20 10:13:33 -04:00
|
|
|
|
|
|
|
/** The plugin's Lua state. */
|
2013-08-21 15:29:30 -04:00
|
|
|
cLuaState m_LuaState;
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2015-03-20 10:13:33 -04:00
|
|
|
/** Hooks that the plugin has registered. */
|
2013-08-21 15:29:30 -04:00
|
|
|
cHookMap m_HookMap;
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2017-01-17 16:38:04 -05:00
|
|
|
/** The DeadlockDetect object to which the plugin's CS is tracked. */
|
|
|
|
cDeadlockDetect & m_DeadlockDetect;
|
|
|
|
|
2015-03-20 10:13:33 -04:00
|
|
|
|
|
|
|
/** Releases all Lua references, notifies and removes all m_Resettables[] and closes the m_LuaState. */
|
2013-08-21 15:29:30 -04:00
|
|
|
void Close(void);
|
2016-03-02 04:05:10 -05:00
|
|
|
|
|
|
|
/** Removes all WebTabs currently registered for this plugin from the WebAdmin. */
|
|
|
|
void ClearWebTabs(void);
|
2016-03-02 04:12:43 -05:00
|
|
|
|
|
|
|
/** Calls a hook that has the simple format - single bool return value specifying whether the chain should continue.
|
|
|
|
The advanced hook types that need more processing implement a similar loop manually instead.
|
|
|
|
Returns true if any of hook calls wants to abort the hook (returned true), false if all hook calls returned false. */
|
|
|
|
template <typename... Args>
|
|
|
|
bool CallSimpleHooks(int a_HookType, Args && ... a_Args)
|
|
|
|
{
|
2016-06-12 10:53:24 -04:00
|
|
|
cOperation op(*this);
|
2016-03-02 04:12:43 -05:00
|
|
|
auto & hooks = m_HookMap[a_HookType];
|
|
|
|
bool res = false;
|
|
|
|
for (auto & hook: hooks)
|
|
|
|
{
|
|
|
|
hook->Call(std::forward<Args>(a_Args)..., cLuaState::Return, res);
|
|
|
|
if (res)
|
|
|
|
{
|
|
|
|
// Hook wants to terminate the chain processing
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
2013-01-11 23:46:01 -05:00
|
|
|
} ; // tolua_export
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|