]> git.lizzy.rs Git - minetest.git/blobdiff - src/mapgen.h
Dungeons: Add nodebox stairs to desert and sandstone dungeons
[minetest.git] / src / mapgen.h
index 7229e89967660e7183f7c95bb81ccbeaf653e08b..a95e1942aeea5d40fdded5eb67c579b068fe736b 100644 (file)
@@ -20,296 +20,266 @@ with this program; if not, write to the Free Software Foundation, Inc.,
 #ifndef MAPGEN_HEADER
 #define MAPGEN_HEADER
 
-#include "irrlichttypes_extrabloated.h"
-#include "util/container.h" // UniqueQueue
-#include "gamedef.h"
-#include "mapnode.h"
 #include "noise.h"
-#include "settings.h"
-#include <map>
+#include "nodedef.h"
+#include "mapnode.h"
+#include "util/string.h"
+#include "util/container.h"
+
+#define MAPGEN_DEFAULT MAPGEN_V7
+#define MAPGEN_DEFAULT_NAME "v7"
 
 /////////////////// Mapgen flags
-#define MG_TREES         0x01
-#define MG_CAVES         0x02
-#define MG_DUNGEONS      0x04
-#define MGV6_JUNGLES     0x08
-#define MGV6_BIOME_BLEND 0x10
-#define MG_FLAT          0x20
-#define MG_NOLIGHT       0x40
-#define MGV7_MOUNTAINS   0x80
-#define MGV7_RIDGES      0x100
-
-/////////////////// Ore generation flags
-// Use absolute value of height to determine ore placement
-#define OREFLAG_ABSHEIGHT 0x01 
-// Use 3d noise to get density of ore placement, instead of just the position
-#define OREFLAG_DENSITY   0x02 // not yet implemented
-// For claylike ore types, place ore if the number of surrounding
-// nodes isn't the specified node
-#define OREFLAG_NODEISNT  0x04 // not yet implemented
-
-/////////////////// Decoration flags
-#define DECO_PLACE_CENTER_X 1
-#define DECO_PLACE_CENTER_Y 2
-#define DECO_PLACE_CENTER_Z 4
+#define MG_TREES       0x01  // Deprecated. Moved into mgv6 flags
+#define MG_CAVES       0x02
+#define MG_DUNGEONS    0x04
+#define MG_FLAT        0x08  // Deprecated. Moved into mgv6 flags
+#define MG_LIGHT       0x10
+#define MG_DECORATIONS 0x20
+
+typedef u8 biome_t;  // copy from mg_biome.h to avoid an unnecessary include
+
+class Settings;
+class MMVManip;
+class INodeDefManager;
 
 extern FlagDesc flagdesc_mapgen[];
-extern FlagDesc flagdesc_ore[];
-extern FlagDesc flagdesc_deco_schematic[];
+extern FlagDesc flagdesc_gennotify[];
 
-class BiomeDefManager;
 class Biome;
+class BiomeGen;
+struct BiomeParams;
+class BiomeManager;
 class EmergeManager;
 class MapBlock;
-class ManualMapVoxelManipulator;
 class VoxelManipulator;
-class INodeDefManager;
 struct BlockMakeData;
 class VoxelArea;
 class Map;
 
-struct MapgenParams {
-       std::string mg_name;
-       int chunksize;
-       u64 seed;
-       int water_level;
-       u32 flags;
+enum MapgenObject {
+       MGOBJ_VMANIP,
+       MGOBJ_HEIGHTMAP,
+       MGOBJ_BIOMEMAP,
+       MGOBJ_HEATMAP,
+       MGOBJ_HUMIDMAP,
+       MGOBJ_GENNOTIFY
+};
 
-       MapgenParams() {
-               mg_name     = "v6";
-               seed        = 0;
-               water_level = 1;
-               chunksize   = 5;
-               flags       = MG_TREES | MG_CAVES | MGV6_BIOME_BLEND;
-       }
-       
-       virtual bool readParams(Settings *settings) { return true; }
-       virtual void writeParams(Settings *settings) {}
-       virtual ~MapgenParams() {}
+enum GenNotifyType {
+       GENNOTIFY_DUNGEON,
+       GENNOTIFY_TEMPLE,
+       GENNOTIFY_CAVE_BEGIN,
+       GENNOTIFY_CAVE_END,
+       GENNOTIFY_LARGECAVE_BEGIN,
+       GENNOTIFY_LARGECAVE_END,
+       GENNOTIFY_DECORATION,
+       NUM_GENNOTIFY_TYPES
 };
 
-class Mapgen {
-public:
-       int seed;
-       int water_level;
-       bool generating;
-       int id;
-       ManualMapVoxelManipulator *vm;
-       INodeDefManager *ndef;
-       
-       s16 *heightmap;
-       u8 *biomemap;
-       v3s16 csize;
+// TODO(hmmmm/paramat): make stone type selection dynamic
+enum MgStoneType {
+       MGSTONE_STONE,
+       MGSTONE_DESERT_STONE,
+       MGSTONE_SANDSTONE,
+};
 
-       Mapgen();
-       virtual ~Mapgen() {}
+struct GenNotifyEvent {
+       GenNotifyType type;
+       v3s16 pos;
+       u32 id;
+};
 
-       s16 findGroundLevelFull(v2s16 p2d);
-       s16 findGroundLevel(v2s16 p2d, s16 ymin, s16 ymax);
-       void updateHeightmap(v3s16 nmin, v3s16 nmax);
-       void updateLiquid(UniqueQueue<v3s16> *trans_liquid, v3s16 nmin, v3s16 nmax);
-       void setLighting(v3s16 nmin, v3s16 nmax, u8 light);
-       void lightSpread(VoxelArea &a, v3s16 p, u8 light);
-       void calcLighting(v3s16 nmin, v3s16 nmax);
-       void calcLightingOld(v3s16 nmin, v3s16 nmax);
+class GenerateNotifier {
+public:
+       GenerateNotifier();
+       GenerateNotifier(u32 notify_on, std::set<u32> *notify_on_deco_ids);
 
-       virtual void makeChunk(BlockMakeData *data) {}
-       virtual int getGroundLevelAtPoint(v2s16 p) { return 0; }
+       void setNotifyOn(u32 notify_on);
+       void setNotifyOnDecoIds(std::set<u32> *notify_on_deco_ids);
 
-       //Legacy functions for Farmesh (pending removal)
-       static bool get_have_beach(u64 seed, v2s16 p2d);
-       static double tree_amount_2d(u64 seed, v2s16 p);
-       static s16 find_ground_level_from_noise(u64 seed, v2s16 p2d, s16 precision);
-};
+       bool addEvent(GenNotifyType type, v3s16 pos, u32 id=0);
+       void getEvents(std::map<std::string, std::vector<v3s16> > &event_map,
+               bool peek_events=false);
 
-struct MapgenFactory {
-       virtual Mapgen *createMapgen(int mgid, MapgenParams *params,
-                                                                EmergeManager *emerge) = 0;
-       virtual MapgenParams *createMapgenParams() = 0;
-       virtual ~MapgenFactory() {}
+private:
+       u32 m_notify_on;
+       std::set<u32> *m_notify_on_deco_ids;
+       std::list<GenNotifyEvent> m_notify_events;
 };
 
-enum MapgenObject {
-       MGOBJ_VMANIP,
-       MGOBJ_HEIGHTMAP,
-       MGOBJ_BIOMEMAP,
-       MGOBJ_HEATMAP,
-       MGOBJ_HUMIDMAP
+enum MapgenType {
+       MAPGEN_V5,
+       MAPGEN_V6,
+       MAPGEN_V7,
+       MAPGEN_FLAT,
+       MAPGEN_FRACTAL,
+       MAPGEN_VALLEYS,
+       MAPGEN_SINGLENODE,
+       MAPGEN_INVALID,
 };
 
-enum OreType {
-       ORE_SCATTER,
-       ORE_SHEET,
-       ORE_CLAYLIKE
-};
+struct MapgenParams {
+       MapgenType mgtype;
+       s16 chunksize;
+       u64 seed;
+       s16 water_level;
+       u32 flags;
 
-#define ORE_RANGE_ACTUAL 1
-#define ORE_RANGE_MIRROR 2
+       BiomeParams *bparams;
 
-class Ore {
-public:
-       std::string ore_name;
-       std::string wherein_name;
-       content_t ore;
-       content_t wherein;  // the node to be replaced
-       u32 clust_scarcity; // ore cluster has a 1-in-clust_scarcity chance of appearing at a node
-       s16 clust_num_ores; // how many ore nodes are in a chunk
-       s16 clust_size;     // how large (in nodes) a chunk of ore is
-       s16 height_min;
-       s16 height_max;
-       u8 ore_param2;          // to set node-specific attributes
-       u32 flags;          // attributes for this ore
-       float nthresh;      // threshhold for noise at which an ore is placed 
-       NoiseParams *np;    // noise for distribution of clusters (NULL for uniform scattering)
-       Noise *noise;
-       
-       Ore() {
-               ore     = CONTENT_IGNORE;
-               wherein = CONTENT_IGNORE;
-               np      = NULL;
-               noise   = NULL;
+       MapgenParams() :
+               mgtype(MAPGEN_DEFAULT),
+               chunksize(5),
+               seed(0),
+               water_level(1),
+               flags(MG_CAVES | MG_LIGHT | MG_DECORATIONS),
+               bparams(NULL)
+       {
        }
-       
-       virtual ~Ore();
-       
-       void resolveNodeNames(INodeDefManager *ndef);
-       void placeOre(Mapgen *mg, u32 blockseed, v3s16 nmin, v3s16 nmax);
-       virtual void generate(ManualMapVoxelManipulator *vm, int seed,
-                                               u32 blockseed, v3s16 nmin, v3s16 nmax) = 0;
-};
 
-class OreScatter : public Ore {
-       ~OreScatter() {}
-       virtual void generate(ManualMapVoxelManipulator *vm, int seed,
-                                               u32 blockseed, v3s16 nmin, v3s16 nmax);
-};
+       virtual ~MapgenParams();
 
-class OreSheet : public Ore {
-       ~OreSheet() {}
-       virtual void generate(ManualMapVoxelManipulator *vm, int seed,
-                                               u32 blockseed, v3s16 nmin, v3s16 nmax);
+       virtual void readParams(const Settings *settings);
+       virtual void writeParams(Settings *settings) const;
 };
 
-Ore *createOre(OreType type);
 
+/*
+       Generic interface for map generators.  All mapgens must inherit this class.
+       If a feature exposed by a public member pointer is not supported by a
+       certain mapgen, it must be set to NULL.
 
-enum DecorationType {
-       DECO_SIMPLE,
-       DECO_SCHEMATIC,
-       DECO_LSYSTEM
-};
+       Apart from makeChunk, getGroundLevelAtPoint, and getSpawnLevelAtPoint, all
+       methods can be used by constructing a Mapgen base class and setting the
+       appropriate public members (e.g. vm, ndef, and so on).
+*/
+class Mapgen {
+public:
+       s32 seed;
+       int water_level;
+       u32 flags;
+       bool generating;
+       int id;
 
-#if 0
-struct CutoffData {
-       VoxelArea a;
-       Decoration *deco;
-       //v3s16 p;
-       //v3s16 size;
-       //s16 height;
-       
-       CutoffData(s16 x, s16 y, s16 z, s16 h) {
-               p = v3s16(x, y, z);
-               height = h;
-       }
-};
-#endif
+       MMVManip *vm;
+       INodeDefManager *ndef;
 
-class Decoration {
-public:
-       int mapseed;
-       std::string place_on_name;
-       content_t c_place_on;
-       s16 sidelen;
-       float fill_ratio;
-       NoiseParams *np;
-       
-       std::set<u8> biomes;
-       //std::list<CutoffData> cutoffs;
-       //JMutex cutoff_mutex;
-
-       Decoration();
-       virtual ~Decoration();
-       
-       virtual void resolveNodeNames(INodeDefManager *ndef);
-       void placeDeco(Mapgen *mg, u32 blockseed, v3s16 nmin, v3s16 nmax);
-       void placeCutoffs(Mapgen *mg, u32 blockseed, v3s16 nmin, v3s16 nmax);
-       
-       virtual void generate(Mapgen *mg, PseudoRandom *pr, s16 max_y, v3s16 p) = 0;
-       virtual int getHeight() = 0;
-       virtual std::string getName() = 0;
-};
+       u32 blockseed;
+       s16 *heightmap;
+       biome_t *biomemap;
+       v3s16 csize;
 
-class DecoSimple : public Decoration {
-public:
-       std::string deco_name;
-       std::string spawnby_name;
-       content_t c_deco;
-       content_t c_spawnby;
-       s16 deco_height;
-       s16 deco_height_max;
-       s16 nspawnby;
-       
-       std::vector<std::string> decolist_names;
-       std::vector<content_t> c_decolist;
-
-       ~DecoSimple() {}
-       
-       void resolveNodeNames(INodeDefManager *ndef);
-       virtual void generate(Mapgen *mg, PseudoRandom *pr, s16 max_y, v3s16 p);
-       virtual int getHeight();
-       virtual std::string getName();
-};
+       BiomeGen *biomegen;
+       GenerateNotifier gennotify;
 
-enum Rotation {
-       ROTATE_0,
-       ROTATE_90,
-       ROTATE_180,
-       ROTATE_270,
-       ROTATE_RAND,
-};
+       Mapgen();
+       Mapgen(int mapgenid, MapgenParams *params, EmergeManager *emerge);
+       virtual ~Mapgen();
 
-class DecoSchematic : public Decoration {
-public:
-       std::string filename;
-       
-       std::vector<std::string> *node_names;
-       std::vector<content_t> c_nodes;
+       virtual MapgenType getType() const { return MAPGEN_INVALID; }
 
-       u32 flags;
-       Rotation rotation;
-       v3s16 size;
-       MapNode *schematic;
-
-       DecoSchematic();
-       ~DecoSchematic();
-       
-       void resolveNodeNames(INodeDefManager *ndef);
-       virtual void generate(Mapgen *mg, PseudoRandom *pr, s16 max_y, v3s16 p);
-       virtual int getHeight();
-       virtual std::string getName();
-       
-       void blitToVManip(v3s16 p, ManualMapVoxelManipulator *vm,
-                                       int rot, bool force_placement);
-       
-       bool loadSchematicFile();
-       void saveSchematicFile(INodeDefManager *ndef);
-       
-       bool getSchematicFromMap(Map *map, v3s16 p1, v3s16 p2);
-       void placeStructure(Map *map, v3s16 p);
-       void applyProbabilities(std::vector<std::pair<v3s16, s16> > *plist, v3s16 p0);
-};
+       static u32 getBlockSeed(v3s16 p, s32 seed);
+       static u32 getBlockSeed2(v3s16 p, s32 seed);
+       s16 findGroundLevelFull(v2s16 p2d);
+       s16 findGroundLevel(v2s16 p2d, s16 ymin, s16 ymax);
+       s16 findLiquidSurface(v2s16 p2d, s16 ymin, s16 ymax);
+       void updateHeightmap(v3s16 nmin, v3s16 nmax);
+       void updateLiquid(UniqueQueue<v3s16> *trans_liquid, v3s16 nmin, v3s16 nmax);
+
+       void setLighting(u8 light, v3s16 nmin, v3s16 nmax);
+       void lightSpread(VoxelArea &a, v3s16 p, u8 light);
+       void calcLighting(v3s16 nmin, v3s16 nmax, v3s16 full_nmin, v3s16 full_nmax,
+               bool propagate_shadow = true);
+       void propagateSunlight(v3s16 nmin, v3s16 nmax, bool propagate_shadow);
+       void spreadLight(v3s16 nmin, v3s16 nmax);
 
-void build_nnlist_and_update_ids(MapNode *nodes, u32 nodecount,
-                                       std::vector<content_t> *usednodes);
+       virtual void makeChunk(BlockMakeData *data) {}
+       virtual int getGroundLevelAtPoint(v2s16 p) { return 0; }
+
+       // getSpawnLevelAtPoint() is a function within each mapgen that returns a
+       // suitable y co-ordinate for player spawn ('suitable' usually meaning
+       // within 16 nodes of water_level). If a suitable spawn level cannot be
+       // found at the specified (X, Z) 'MAX_MAP_GENERATION_LIMIT' is returned to
+       // signify this and to cause Server::findSpawnPos() to try another (X, Z).
+       virtual int getSpawnLevelAtPoint(v2s16 p) { return 0; }
+
+       // Mapgen management functions
+       static MapgenType getMapgenType(const std::string &mgname);
+       static const char *getMapgenName(MapgenType mgtype);
+       static Mapgen *createMapgen(MapgenType mgtype, int mgid,
+               MapgenParams *params, EmergeManager *emerge);
+       static MapgenParams *createMapgenParams(MapgenType mgtype);
+       static void getMapgenNames(std::vector<const char *> *mgnames, bool include_hidden);
+
+private:
+       // isLiquidHorizontallyFlowable() is a helper function for updateLiquid()
+       // that checks whether there are floodable nodes without liquid beneath
+       // the node at index vi.
+       inline bool isLiquidHorizontallyFlowable(u32 vi, v3s16 em);
+       DISABLE_CLASS_COPY(Mapgen);
+};
 
 /*
-class DecoLSystem : public Decoration {
+       MapgenBasic is a Mapgen implementation that handles basic functionality
+       the majority of conventional mapgens will probably want to use, but isn't
+       generic enough to be included as part of the base Mapgen class (such as
+       generating biome terrain over terrain node skeletons, generating caves,
+       dungeons, etc.)
+
+       Inherit MapgenBasic instead of Mapgen to add this basic functionality to
+       your mapgen without having to reimplement it.  Feel free to override any of
+       these methods if you desire different or more advanced behavior.
+
+       Note that you must still create your own generateTerrain implementation when
+       inheriting MapgenBasic.
+*/
+class MapgenBasic : public Mapgen {
 public:
-       virtual void generate(Mapgen *mg, u32 blockseed, v3s16 nmin, v3s16 nmax);
+       MapgenBasic(int mapgenid, MapgenParams *params, EmergeManager *emerge);
+       virtual ~MapgenBasic();
+
+       virtual void generateCaves(s16 max_stone_y, s16 large_cave_depth);
+       virtual void generateDungeons(s16 max_stone_y, MgStoneType stone_type);
+       virtual MgStoneType generateBiomes();
+       virtual void dustTopNodes();
+
+protected:
+       EmergeManager *m_emerge;
+       BiomeManager *m_bmgr;
+
+       Noise *noise_filler_depth;
+
+       v3s16 node_min;
+       v3s16 node_max;
+       v3s16 full_node_min;
+       v3s16 full_node_max;
+
+       // Content required for generateBiomes
+       content_t c_stone;
+       content_t c_water_source;
+       content_t c_river_water_source;
+       content_t c_desert_stone;
+       content_t c_sandstone;
+
+       // Content required for generateDungeons
+       content_t c_cobble;
+       content_t c_stair_cobble;
+       content_t c_mossycobble;
+       content_t c_stair_desert_stone;
+       content_t c_sandstonebrick;
+       content_t c_stair_sandstonebrick;
+
+       int ystride;
+       int zstride;
+       int zstride_1d;
+       int zstride_1u1d;
+
+       u32 spflags;
+
+       NoiseParams np_cave1;
+       NoiseParams np_cave2;
+       float cave_width;
 };
-*/
-
-Decoration *createDecoration(DecorationType type);
 
 #endif
-