Tune caves
[oweals/minetest.git] / 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 class ServerRemotePlayer;
31 typedef struct lua_State lua_State;
32 struct LuaEntityProperties;
33 struct ItemStack;
34 struct PointedThing;
35 //class IGameDef;
36 struct ToolCapabilities;
37
38 void scriptapi_export(lua_State *L, Server *server);
39 bool scriptapi_loadmod(lua_State *L, const std::string &scriptpath,
40                 const std::string &modname);
41 void scriptapi_add_environment(lua_State *L, ServerEnvironment *env);
42
43 void scriptapi_add_object_reference(lua_State *L, ServerActiveObject *cobj);
44 void scriptapi_rm_object_reference(lua_State *L, ServerActiveObject *cobj);
45
46 // Returns true if script handled message
47 bool scriptapi_on_chat_message(lua_State *L, const std::string &name,
48                 const std::string &message);
49
50 /* environment */
51 // On environment step
52 void scriptapi_environment_step(lua_State *L, float dtime);
53 // After generating a piece of map
54 void scriptapi_environment_on_generated(lua_State *L, v3s16 minp, v3s16 maxp);
55
56 /* misc */
57 void scriptapi_on_newplayer(lua_State *L, ServerActiveObject *player);
58 void scriptapi_on_dieplayer(lua_State *L, ServerActiveObject *player);
59 bool scriptapi_on_respawnplayer(lua_State *L, ServerActiveObject *player);
60 void scriptapi_get_creative_inventory(lua_State *L, ServerRemotePlayer *player);
61
62 /* item callbacks */
63 bool scriptapi_item_on_drop(lua_State *L, ItemStack &item,
64                 ServerActiveObject *dropper, v3f pos);
65 bool scriptapi_item_on_place(lua_State *L, ItemStack &item,
66                 ServerActiveObject *placer, const PointedThing &pointed);
67 bool scriptapi_item_on_use(lua_State *L, ItemStack &item,
68                 ServerActiveObject *user, const PointedThing &pointed);
69
70 /* node callbacks */
71 bool scriptapi_node_on_punch(lua_State *L, v3s16 p, MapNode node,
72                 ServerActiveObject *puncher);
73 bool scriptapi_node_on_dig(lua_State *L, v3s16 p, MapNode node,
74                 ServerActiveObject *digger);
75
76 /* luaentity */
77 // Returns true if succesfully added into Lua; false otherwise.
78 bool scriptapi_luaentity_add(lua_State *L, u16 id, const char *name);
79 void scriptapi_luaentity_activate(lua_State *L, u16 id,
80                 const std::string &staticdata);
81 void scriptapi_luaentity_rm(lua_State *L, u16 id);
82 std::string scriptapi_luaentity_get_staticdata(lua_State *L, u16 id);
83 void scriptapi_luaentity_get_properties(lua_State *L, u16 id,
84                 LuaEntityProperties *prop);
85 void scriptapi_luaentity_step(lua_State *L, u16 id, float dtime);
86 void scriptapi_luaentity_punch(lua_State *L, u16 id,
87                 ServerActiveObject *puncher, float time_from_last_punch,
88                 const ToolCapabilities *toolcap, v3f dir);
89 void scriptapi_luaentity_rightclick(lua_State *L, u16 id,
90                 ServerActiveObject *clicker);
91
92 #endif
93