/* Minetest Copyright (C) 2013 celeron55, Perttu Ahola This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #pragma once #include #include #include #include #include #include "common/helper.h" #include "util/basic_macros.h" extern "C" { #include #include } #include "irrlichttypes.h" #include "common/c_types.h" #include "common/c_internal.h" #include "debug.h" #include "config.h" #define SCRIPTAPI_LOCK_DEBUG // MUST be an invalid mod name so that mods can't // use that name to bypass security! #define BUILTIN_MOD_NAME "*builtin*" #define PCALL_RES(RES) { \ int result_ = (RES); \ if (result_ != 0) { \ scriptError(result_, __FUNCTION__); \ } \ } #define runCallbacks(nargs, mode) \ runCallbacksRaw((nargs), (mode), __FUNCTION__) #define setOriginFromTable(index) \ setOriginFromTableRaw(index, __FUNCTION__) enum class ScriptingType: u8 { Async, Client, MainMenu, Server }; class Server; #ifndef SERVER class Client; #endif class IGameDef; class Environment; class GUIEngine; class ServerActiveObject; struct PlayerHPChangeReason; class ScriptApiBase : protected LuaHelper { public: ScriptApiBase(ScriptingType type); // fake constructor to allow script API classes (e.g ScriptApiEnv) to virtually inherit from this one. ScriptApiBase() { FATAL_ERROR("ScriptApiBase created without ScriptingType!"); } virtual ~ScriptApiBase(); DISABLE_CLASS_COPY(ScriptApiBase); // These throw a ModError on failure void loadMod(const std::string &script_path, const std::string &mod_name); void loadScript(const std::string &script_path); #ifndef SERVER void loadModFromMemory(const std::string &mod_name); #endif void runCallbacksRaw(int nargs, RunCallbacksMode mode, const char *fxn); /* object */ void addObjectReference(ServerActiveObject *cobj); void removeObjectReference(ServerActiveObject *cobj); IGameDef *getGameDef() { return m_gamedef; } Server* getServer(); ScriptingType getType() { return m_type; } #ifndef SERVER Client* getClient(); #endif // IMPORTANT: these cannot be used for any security-related uses, they exist // only to enrich error messages const std::string &getOrigin() { return m_last_run_mod; } void setOriginDirect(const char *origin); void setOriginFromTableRaw(int index, const char *fxn); void clientOpenLibs(lua_State *L); protected: friend class LuaABM; friend class LuaLBM; friend class InvRef; friend class ObjectRef; friend class NodeMetaRef; friend class ModApiBase; friend class ModApiEnvMod; friend class LuaVoxelManip; lua_State* getStack() { return m_luastack; } void realityCheck(); void scriptError(int result, const char *fxn); void stackDump(std::ostream &o); void setGameDef(IGameDef* gamedef) { m_gamedef = gamedef; } Environment* getEnv() { return m_environment; } void setEnv(Environment* env) { m_environment = env; } #ifndef SERVER GUIEngine* getGuiEngine() { return m_guiengine; } void setGuiEngine(GUIEngine* guiengine) { m_guiengine = guiengine; } #endif void objectrefGetOrCreate(lua_State *L, ServerActiveObject *cobj); void pushPlayerHPChangeReason(lua_State *L, const PlayerHPChangeReason& reason); std::recursive_mutex m_luastackmutex; std::string m_last_run_mod; bool m_secure = false; #ifdef SCRIPTAPI_LOCK_DEBUG int m_lock_recursion_count{}; std::thread::id m_owning_thread; #endif private: static int luaPanic(lua_State *L); lua_State *m_luastack = nullptr; IGameDef *m_gamedef = nullptr; Environment *m_environment = nullptr; #ifndef SERVER GUIEngine *m_guiengine = nullptr; #endif ScriptingType m_type; };