3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as published by
7 the Free Software Foundation; either version 2.1 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 #include "cpp_api/s_base.h"
21 #include "cpp_api/s_internal.h"
22 #include "cpp_api/s_security.h"
23 #include "lua_api/l_object.h"
24 #include "common/c_converter.h"
25 #include "serverobject.h"
31 #include "util/string.h"
50 ModNameStorer(lua_State *L_, const std::string &mod_name):
53 // Store current mod name in registry
54 lua_pushstring(L, mod_name.c_str());
55 lua_setfield(L, LUA_REGISTRYINDEX, SCRIPT_MOD_NAME_FIELD);
59 // Clear current mod name from registry
61 lua_setfield(L, LUA_REGISTRYINDEX, SCRIPT_MOD_NAME_FIELD);
70 ScriptApiBase::ScriptApiBase()
72 #ifdef SCRIPTAPI_LOCK_DEBUG
76 m_luastack = luaL_newstate();
77 FATAL_ERROR_IF(!m_luastack, "luaL_newstate() failed");
79 luaL_openlibs(m_luastack);
81 // Add and save an error handler
82 lua_pushcfunction(m_luastack, script_error_handler);
83 m_errorhandler = lua_gettop(m_luastack);
85 // Make the ScriptApiBase* accessible to ModApiBase
86 lua_pushlightuserdata(m_luastack, this);
87 lua_setfield(m_luastack, LUA_REGISTRYINDEX, "scriptapi");
89 // If we are using LuaJIT add a C++ wrapper function to catch
90 // exceptions thrown in Lua -> C++ calls
92 lua_pushlightuserdata(m_luastack, (void*) script_exception_wrapper);
93 luaJIT_setmode(m_luastack, -1, LUAJIT_MODE_WRAPCFUNC | LUAJIT_MODE_ON);
94 lua_pop(m_luastack, 1);
98 lua_newtable(m_luastack);
99 lua_setglobal(m_luastack, "core");
101 lua_pushstring(m_luastack, DIR_DELIM);
102 lua_setglobal(m_luastack, "DIR_DELIM");
104 lua_pushstring(m_luastack, porting::getPlatformName());
105 lua_setglobal(m_luastack, "PLATFORM");
107 // m_secure gets set to true inside
108 // ScriptApiSecurity::initializeSecurity(), if neccessary.
109 // Default to false otherwise
113 m_environment = NULL;
117 ScriptApiBase::~ScriptApiBase()
119 lua_close(m_luastack);
122 bool ScriptApiBase::loadMod(const std::string &script_path,
123 const std::string &mod_name, std::string *error)
125 ModNameStorer mod_name_storer(getStack(), mod_name);
127 return loadScript(script_path, error);
130 bool ScriptApiBase::loadScript(const std::string &script_path, std::string *error)
132 verbosestream << "Loading and running script from " << script_path << std::endl;
134 lua_State *L = getStack();
138 ok = ScriptApiSecurity::safeLoadFile(L, script_path.c_str());
140 ok = !luaL_loadfile(L, script_path.c_str());
142 ok = ok && !lua_pcall(L, 0, 0, m_errorhandler);
144 std::string error_msg = lua_tostring(L, -1);
147 errorstream << "========== ERROR FROM LUA ===========" << std::endl
148 << "Failed to load and run script from " << std::endl
149 << script_path << ":" << std::endl << std::endl
150 << error_msg << std::endl << std::endl
151 << "======= END OF ERROR FROM LUA ========" << std::endl;
152 lua_pop(L, 1); // Pop error message from stack
158 // Push the list of callbacks (a lua table).
159 // Then push nargs arguments.
160 // Then call this function, which
161 // - runs the callbacks
162 // - replaces the table and arguments with the return value,
163 // computed depending on mode
164 void ScriptApiBase::runCallbacksRaw(int nargs,
165 RunCallbacksMode mode, const char *fxn)
167 lua_State *L = getStack();
168 FATAL_ERROR_IF(lua_gettop(L) < nargs + 1, "Not enough arguments");
170 // Insert error handler
171 lua_pushcfunction(L, script_error_handler);
172 int errorhandler = lua_gettop(L) - nargs - 1;
173 lua_insert(L, errorhandler);
175 // Insert run_callbacks between error handler and table
176 lua_getglobal(L, "core");
177 lua_getfield(L, -1, "run_callbacks");
179 lua_insert(L, errorhandler + 1);
181 // Insert mode after table
182 lua_pushnumber(L, (int)mode);
183 lua_insert(L, errorhandler + 3);
185 // Stack now looks like this:
186 // ... <error handler> <run_callbacks> <table> <mode> <arg#1> <arg#2> ... <arg#n>
188 int result = lua_pcall(L, nargs + 2, 1, errorhandler);
190 scriptError(result, fxn);
192 lua_remove(L, -2); // Remove error handler
195 void ScriptApiBase::realityCheck()
197 int top = lua_gettop(m_luastack);
199 dstream << "Stack is over 30:" << std::endl;
201 std::string traceback = script_get_backtrace(m_luastack);
202 throw LuaError("Stack is over 30 (reality check)\n" + traceback);
206 void ScriptApiBase::scriptError(int result, const char *fxn)
208 script_error(getStack(), result, m_last_run_mod.c_str(), fxn);
211 void ScriptApiBase::stackDump(std::ostream &o)
213 int top = lua_gettop(m_luastack);
214 for (int i = 1; i <= top; i++) { /* repeat for each level */
215 int t = lua_type(m_luastack, i);
217 case LUA_TSTRING: /* strings */
218 o << "\"" << lua_tostring(m_luastack, i) << "\"";
220 case LUA_TBOOLEAN: /* booleans */
221 o << (lua_toboolean(m_luastack, i) ? "true" : "false");
223 case LUA_TNUMBER: /* numbers */ {
225 snprintf(buf, 10, "%g", lua_tonumber(m_luastack, i));
229 default: /* other values */
230 o << lua_typename(m_luastack, t);
238 void ScriptApiBase::setOriginDirect(const char *origin)
240 m_last_run_mod = origin ? origin : "??";
243 void ScriptApiBase::setOriginFromTableRaw(int index, const char *fxn)
245 #ifdef SCRIPTAPI_DEBUG
246 lua_State *L = getStack();
248 m_last_run_mod = lua_istable(L, index) ?
249 getstringfield_default(L, index, "mod_origin", "") : "";
250 //printf(">>>> running %s for mod: %s\n", fxn, m_last_run_mod.c_str());
254 void ScriptApiBase::addObjectReference(ServerActiveObject *cobj)
256 SCRIPTAPI_PRECHECKHEADER
257 //infostream<<"scriptapi_add_object_reference: id="<<cobj->getId()<<std::endl;
259 // Create object on stack
260 ObjectRef::create(L, cobj); // Puts ObjectRef (as userdata) on stack
261 int object = lua_gettop(L);
263 // Get core.object_refs table
264 lua_getglobal(L, "core");
265 lua_getfield(L, -1, "object_refs");
266 luaL_checktype(L, -1, LUA_TTABLE);
267 int objectstable = lua_gettop(L);
269 // object_refs[id] = object
270 lua_pushnumber(L, cobj->getId()); // Push id
271 lua_pushvalue(L, object); // Copy object to top of stack
272 lua_settable(L, objectstable);
275 void ScriptApiBase::removeObjectReference(ServerActiveObject *cobj)
277 SCRIPTAPI_PRECHECKHEADER
278 //infostream<<"scriptapi_rm_object_reference: id="<<cobj->getId()<<std::endl;
280 // Get core.object_refs table
281 lua_getglobal(L, "core");
282 lua_getfield(L, -1, "object_refs");
283 luaL_checktype(L, -1, LUA_TTABLE);
284 int objectstable = lua_gettop(L);
286 // Get object_refs[id]
287 lua_pushnumber(L, cobj->getId()); // Push id
288 lua_gettable(L, objectstable);
289 // Set object reference to NULL
290 ObjectRef::set_null(L);
291 lua_pop(L, 1); // pop object
293 // Set object_refs[id] = nil
294 lua_pushnumber(L, cobj->getId()); // Push id
296 lua_settable(L, objectstable);
299 // Creates a new anonymous reference if cobj=NULL or id=0
300 void ScriptApiBase::objectrefGetOrCreate(lua_State *L,
301 ServerActiveObject *cobj)
303 if (cobj == NULL || cobj->getId() == 0) {
304 ObjectRef::create(L, cobj);
306 objectrefGet(L, cobj->getId());
310 void ScriptApiBase::objectrefGet(lua_State *L, u16 id)
312 // Get core.object_refs[i]
313 lua_getglobal(L, "core");
314 lua_getfield(L, -1, "object_refs");
315 luaL_checktype(L, -1, LUA_TTABLE);
316 lua_pushnumber(L, id);
318 lua_remove(L, -2); // object_refs
319 lua_remove(L, -2); // core