src/script/lua_api/l_env.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 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 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.
   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 Lesser General Public License for more details.
  14
  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.
  18 */
  19
  20 #ifndef L_ENV_H_
  21 #define L_ENV_H_
  22
  23 #include "lua_api/l_base.h"
  24 #include "environment.h"
  25
  26 class ModApiEnvMod : public ModApiBase {
  27 private:
  28         // set_node(pos, node)
  29         // pos = {x=num, y=num, z=num}
  30         static int l_set_node(lua_State *L);
  31
  32         static int l_add_node(lua_State *L);
  33
  34         // remove_node(pos)
  35         // pos = {x=num, y=num, z=num}
  36         static int l_remove_node(lua_State *L);
  37
  38         // swap_node(pos, node)
  39         // pos = {x=num, y=num, z=num}
  40         static int l_swap_node(lua_State *L);
  41
  42         // get_node(pos)
  43         // pos = {x=num, y=num, z=num}
  44         static int l_get_node(lua_State *L);
  45
  46         // get_node_or_nil(pos)
  47         // pos = {x=num, y=num, z=num}
  48         static int l_get_node_or_nil(lua_State *L);
  49
  50         // get_node_light(pos, timeofday)
  51         // pos = {x=num, y=num, z=num}
  52         // timeofday: nil = current time, 0 = night, 0.5 = day
  53         static int l_get_node_light(lua_State *L);
  54
  55         // place_node(pos, node)
  56         // pos = {x=num, y=num, z=num}
  57         static int l_place_node(lua_State *L);
  58
  59         // dig_node(pos)
  60         // pos = {x=num, y=num, z=num}
  61         static int l_dig_node(lua_State *L);
  62
  63         // punch_node(pos)
  64         // pos = {x=num, y=num, z=num}
  65         static int l_punch_node(lua_State *L);
  66
  67         // get_node_max_level(pos)
  68         // pos = {x=num, y=num, z=num}
  69         static int l_get_node_max_level(lua_State *L);
  70
  71         // get_node_level(pos)
  72         // pos = {x=num, y=num, z=num}
  73         static int l_get_node_level(lua_State *L);
  74
  75         // set_node_level(pos)
  76         // pos = {x=num, y=num, z=num}
  77         static int l_set_node_level(lua_State *L);
  78
  79         // add_node_level(pos)
  80         // pos = {x=num, y=num, z=num}
  81         static int l_add_node_level(lua_State *L);
  82
  83         // find_nodes_with_meta(pos1, pos2)
  84         static int l_find_nodes_with_meta(lua_State *L);
  85
  86         // get_meta(pos)
  87         static int l_get_meta(lua_State *L);
  88
  89         // get_node_timer(pos)
  90         static int l_get_node_timer(lua_State *L);
  91
  92         // add_entity(pos, entityname) -> ObjectRef or nil
  93         // pos = {x=num, y=num, z=num}
  94         static int l_add_entity(lua_State *L);
  95
  96         // add_item(pos, itemstack or itemstring or table) -> ObjectRef or nil
  97         // pos = {x=num, y=num, z=num}
  98         static int l_add_item(lua_State *L);
  99
 100         // get_player_by_name(name)
 101         static int l_get_player_by_name(lua_State *L);
 102
 103         // get_objects_inside_radius(pos, radius)
 104         static int l_get_objects_inside_radius(lua_State *L);
 105
 106         // set_timeofday(val)
 107         // val = 0...1
 108         static int l_set_timeofday(lua_State *L);
 109
 110         // get_timeofday() -> 0...1
 111         static int l_get_timeofday(lua_State *L);
 112
 113         // get_gametime()
 114         static int l_get_gametime(lua_State *L);
 115
 116         // find_node_near(pos, radius, nodenames) -> pos or nil
 117         // nodenames: eg. {"ignore", "group:tree"} or "default:dirt"
 118         static int l_find_node_near(lua_State *L);
 119
 120         // find_nodes_in_area(minp, maxp, nodenames) -> list of positions
 121         // nodenames: eg. {"ignore", "group:tree"} or "default:dirt"
 122         static int l_find_nodes_in_area(lua_State *L);
 123
 124         // find_surface_nodes_in_area(minp, maxp, nodenames) -> list of positions
 125         // nodenames: eg. {"ignore", "group:tree"} or "default:dirt"
 126         static int l_find_nodes_in_area_under_air(lua_State *L);
 127
 128         // emerge_area(p1, p2)
 129         static int l_emerge_area(lua_State *L);
 130
 131         // delete_area(p1, p2) -> true/false
 132         static int l_delete_area(lua_State *L);
 133
 134         // get_perlin(seeddiff, octaves, persistence, scale)
 135         // returns world-specific PerlinNoise
 136         static int l_get_perlin(lua_State *L);
 137
 138         // get_perlin_map(noiseparams, size)
 139         // returns world-specific PerlinNoiseMap
 140         static int l_get_perlin_map(lua_State *L);
 141
 142         // get_voxel_manip()
 143         // returns world-specific voxel manipulator
 144         static int l_get_voxel_manip(lua_State *L);
 145
 146         // clear_objects()
 147         // clear all objects in the environment
 148         static int l_clear_objects(lua_State *L);
 149
 150         // spawn_tree(pos, treedef)
 151         static int l_spawn_tree(lua_State *L);
 152
 153         // line_of_sight(pos1, pos2, stepsize) -> true/false
 154         static int l_line_of_sight(lua_State *L);
 155
 156         // find_path(pos1, pos2, searchdistance,
 157         //     max_jump, max_drop, algorithm) -> table containing path
 158         static int l_find_path(lua_State *L);
 159
 160         // transforming_liquid_add(pos)
 161         static int l_transforming_liquid_add(lua_State *L);
 162
 163         // forceload_block(blockpos)
 164         // forceloads a block
 165         static int l_forceload_block(lua_State *L);
 166
 167         // forceload_free_block(blockpos)
 168         // stops forceloading a position
 169         static int l_forceload_free_block(lua_State *L);
 170
 171         // get us precision time
 172         static int l_get_us_time(lua_State *L);
 173
 174 public:
 175         static void Initialize(lua_State *L, int top);
 176 };
 177
 178 class LuaABM : public ActiveBlockModifier
 179 {
 180 private:
 181         int m_id;
 182
 183         std::set<std::string> m_trigger_contents;
 184         std::set<std::string> m_required_neighbors;
 185         float m_trigger_interval;
 186         u32 m_trigger_chance;
 187 public:
 188         LuaABM(lua_State *L, int id,
 189                         const std::set<std::string> &trigger_contents,
 190                         const std::set<std::string> &required_neighbors,
 191                         float trigger_interval, u32 trigger_chance):
 192                 m_id(id),
 193                 m_trigger_contents(trigger_contents),
 194                 m_required_neighbors(required_neighbors),
 195                 m_trigger_interval(trigger_interval),
 196                 m_trigger_chance(trigger_chance)
 197         {
 198         }
 199         virtual std::set<std::string> getTriggerContents()
 200         {
 201                 return m_trigger_contents;
 202         }
 203         virtual std::set<std::string> getRequiredNeighbors()
 204         {
 205                 return m_required_neighbors;
 206         }
 207         virtual float getTriggerInterval()
 208         {
 209                 return m_trigger_interval;
 210         }
 211         virtual u32 getTriggerChance()
 212         {
 213                 return m_trigger_chance;
 214         }
 215         virtual void trigger(ServerEnvironment *env, v3s16 p, MapNode n,
 216                         u32 active_object_count, u32 active_object_count_wider);
 217 };
 218
 219 #endif /* L_ENV_H_ */