src/scriptapi.h

   1 /*
   2 Minetest-c55
   3 Copyright (C) 2011 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU General Public License as published by
   7 the Free Software Foundation; either version 2 of the License, or
   8 (at your option) any later version.
   9
  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 General Public License for more details.
  14
  15 You should have received a copy of the GNU 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.
  18 */
  19
  20 #ifndef SCRIPTAPI_HEADER
  21 #define SCRIPTAPI_HEADER
  22
  23 #include "irrlichttypes.h"
  24 #include <string>
  25 #include "mapnode.h"
  26
  27 class Server;
  28 class ServerEnvironment;
  29 class ServerActiveObject;
  30 typedef struct lua_State lua_State;
  31 struct LuaEntityProperties;
  32 struct PointedThing;
  33 //class IGameDef;
  34 class ServerRemotePlayer;
  35
  36 void scriptapi_export(lua_State *L, Server *server);
  37 bool scriptapi_loadmod(lua_State *L, const std::string &scriptpath,
  38                 const std::string &modname);
  39 void scriptapi_add_environment(lua_State *L, ServerEnvironment *env);
  40
  41 void scriptapi_add_object_reference(lua_State *L, ServerActiveObject *cobj);
  42 void scriptapi_rm_object_reference(lua_State *L, ServerActiveObject *cobj);
  43
  44 // Returns true if script handled message
  45 bool scriptapi_on_chat_message(lua_State *L, const std::string &name,
  46                 const std::string &message);
  47
  48 /* environment */
  49 // On environment step
  50 void scriptapi_environment_step(lua_State *L, float dtime);
  51 // After adding node
  52 void scriptapi_environment_on_placenode(lua_State *L, v3s16 p, MapNode newnode,
  53                 ServerActiveObject *placer);
  54 // After removing node
  55 void scriptapi_environment_on_dignode(lua_State *L, v3s16 p, MapNode oldnode,
  56                 ServerActiveObject *digger);
  57 // When punching node
  58 void scriptapi_environment_on_punchnode(lua_State *L, v3s16 p, MapNode node,
  59                 ServerActiveObject *puncher);
  60 // After generating a piece of map
  61 void scriptapi_environment_on_generated(lua_State *L, v3s16 minp, v3s16 maxp);
  62
  63 /* misc */
  64 void scriptapi_on_newplayer(lua_State *L, ServerActiveObject *player);
  65 void scriptapi_on_dieplayer(lua_State *L, ServerActiveObject *player);
  66 bool scriptapi_on_respawnplayer(lua_State *L, ServerActiveObject *player);
  67 void scriptapi_get_creative_inventory(lua_State *L, ServerRemotePlayer *player);
  68
  69 /* craftitem */
  70 void scriptapi_add_craftitem(lua_State *L, const char *name);
  71 bool scriptapi_craftitem_on_drop(lua_State *L, const char *name,
  72                 ServerActiveObject *dropper, v3f pos,
  73                 bool &callback_exists);
  74 bool scriptapi_craftitem_on_place_on_ground(lua_State *L, const char *name,
  75                 ServerActiveObject *placer, v3f pos,
  76                 bool &callback_exists);
  77 bool scriptapi_craftitem_on_use(lua_State *L, const char *name,
  78                 ServerActiveObject *user, const PointedThing& pointed,
  79                 bool &callback_exists);
  80
  81 /* luaentity */
  82 // Returns true if succesfully added into Lua; false otherwise.
  83 bool scriptapi_luaentity_add(lua_State *L, u16 id, const char *name,
  84                 const std::string &staticdata);
  85 void scriptapi_luaentity_rm(lua_State *L, u16 id);
  86 std::string scriptapi_luaentity_get_staticdata(lua_State *L, u16 id);
  87 void scriptapi_luaentity_get_properties(lua_State *L, u16 id,
  88                 LuaEntityProperties *prop);
  89 void scriptapi_luaentity_step(lua_State *L, u16 id, float dtime);
  90 void scriptapi_luaentity_punch(lua_State *L, u16 id,
  91                 ServerActiveObject *puncher, float time_from_last_punch);
  92 void scriptapi_luaentity_rightclick(lua_State *L, u16 id,
  93                 ServerActiveObject *clicker);
  94
  95 #endif
  96