1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
|
/*
Minetest
Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
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.
*/
#ifndef LUA_OBJECT_H_
#define LUA_OBJECT_H_
extern "C" {
#include <lua.h>
#include <lauxlib.h>
}
#include "serverobject.h"
#include "content_sao.h"
#include "player.h"
/*
ObjectRef
*/
class ObjectRef
{
private:
ServerActiveObject *m_object;
static const char className[];
static const luaL_reg methods[];
public:
static ObjectRef *checkobject(lua_State *L, int narg);
static ServerActiveObject* getobject(ObjectRef *ref);
private:
static LuaEntitySAO* getluaobject(ObjectRef *ref);
static PlayerSAO* getplayersao(ObjectRef *ref);
static Player* getplayer(ObjectRef *ref);
// Exported functions
// garbage collector
static int gc_object(lua_State *L);
// remove(self)
static int l_remove(lua_State *L);
// getpos(self)
// returns: {x=num, y=num, z=num}
static int l_getpos(lua_State *L);
// setpos(self, pos)
static int l_setpos(lua_State *L);
// moveto(self, pos, continuous=false)
static int l_moveto(lua_State *L);
// punch(self, puncher, time_from_last_punch, tool_capabilities, dir)
static int l_punch(lua_State *L);
// right_click(self, clicker); clicker = an another ObjectRef
static int l_right_click(lua_State *L);
// set_hp(self, hp)
// hp = number of hitpoints (2 * number of hearts)
// returns: nil
static int l_set_hp(lua_State *L);
// get_hp(self)
// returns: number of hitpoints (2 * number of hearts)
// 0 if not applicable to this type of object
static int l_get_hp(lua_State *L);
// get_inventory(self)
static int l_get_inventory(lua_State *L);
// get_wield_list(self)
static int l_get_wield_list(lua_State *L);
// get_wield_index(self)
static int l_get_wield_index(lua_State *L);
// get_wielded_item(self)
static int l_get_wielded_item(lua_State *L);
// set_wielded_item(self, itemstack or itemstring or table or nil)
static int l_set_wielded_item(lua_State *L);
// set_armor_groups(self, groups)
static int l_set_armor_groups(lua_State *L);
// set_physics_override(self, physics_override_speed, physics_override_jump, physics_override_gravity)
static int l_set_physics_override(lua_State *L);
// set_animation(self, frame_range, frame_speed, frame_blend)
static int l_set_animation(lua_State *L);
// set_bone_position(self, std::string bone, v3f position, v3f rotation)
static int l_set_bone_position(lua_State *L);
// set_attach(self, parent, bone, position, rotation)
static int l_set_attach(lua_State *L);
// set_detach(self)
static int l_set_detach(lua_State *L);
// set_properties(self, properties)
static int l_set_properties(lua_State *L);
/* LuaEntitySAO-only */
// setvelocity(self, {x=num, y=num, z=num})
static int l_setvelocity(lua_State *L);
// getvelocity(self)
static int l_getvelocity(lua_State *L);
// setacceleration(self, {x=num, y=num, z=num})
static int l_setacceleration(lua_State *L);
// getacceleration(self)
static int l_getacceleration(lua_State *L);
// setyaw(self, radians)
static int l_setyaw(lua_State *L);
// getyaw(self)
static int l_getyaw(lua_State *L);
// settexturemod(self, mod)
static int l_settexturemod(lua_State *L);
// setsprite(self, p={x=0,y=0}, num_frames=1, framelength=0.2,
// select_horiz_by_yawpitch=false)
static int l_setsprite(lua_State *L);
// DEPRECATED
// get_entity_name(self)
static int l_get_entity_name(lua_State *L);
// get_luaentity(self)
static int l_get_luaentity(lua_State *L);
/* Player-only */
// is_player(self)
static int l_is_player(lua_State *L);
// get_player_name(self)
static int l_get_player_name(lua_State *L);
// get_look_dir(self)
static int l_get_look_dir(lua_State *L);
// get_look_pitch(self)
static int l_get_look_pitch(lua_State *L);
// get_look_yaw(self)
static int l_get_look_yaw(lua_State *L);
// set_look_pitch(self, radians)
static int l_set_look_pitch(lua_State *L);
// set_look_yaw(self, radians)
static int l_set_look_yaw(lua_State *L);
// set_inventory_formspec(self, formspec)
static int l_set_inventory_formspec(lua_State *L);
// get_inventory_formspec(self) -> formspec
static int l_get_inventory_formspec(lua_State *L);
// get_player_control(self)
static int l_get_player_control(lua_State *L);
// get_player_control_bits(self)
static int l_get_player_control_bits(lua_State *L);
public:
ObjectRef(ServerActiveObject *object);
~ObjectRef();
// Creates an ObjectRef and leaves it on top of stack
// Not callable from Lua; all references are created on the C side.
static void create(lua_State *L, ServerActiveObject *object);
static void set_null(lua_State *L);
static void Register(lua_State *L);
};
/*****************************************************************************/
/* scriptapi internal */
/*****************************************************************************/
// Creates a new anonymous reference if cobj=NULL or id=0
void objectref_get_or_create(lua_State *L,
ServerActiveObject *cobj);
void objectref_get(lua_State *L, u16 id);
void read_object_properties(lua_State *L, int index,
ObjectProperties *prop);
/*****************************************************************************/
/* Minetest interface */
/*****************************************************************************/
void scriptapi_add_object_reference(lua_State *L, ServerActiveObject *cobj);
void scriptapi_rm_object_reference(lua_State *L, ServerActiveObject *cobj);
#endif /* LUA_OBJECT_H_ */
|
