add 'lowering' generated structures property

doc/en/world-generator.md

@@ -72,17 +72,20 @@ Fragments used by the generator must present in the directory:
 
 ## Structures
 
-A structure is a set of rules for inserting a fragment into the world by the generator. It currently has no properties, being created as empty objects in the `generators/generator_name.files/structures.toml` file. Example:
+A structure is a set of rules for inserting a fragment into the world by the generator. Structures are declared as objects in the file `generators/generator_name.files/structures.toml`. Example:
 ```toml
 tree0 = {}
 tree1 = {}
 tree2 = {}
-tower = {}
+tower = {lowering=2}
 coal_ore0 = {}
 ```
 
 Currently, the name of the structure must match the name of the fragment used.
 
+Available properties:
+- lowering - depth of structure lowering.
+
 ## Biomes
 
 A biome defines what blocks and layers the terrain is generated from, as well as a set of plants and structures.

doc/ru/world-generator.md

@@ -72,17 +72,20 @@
 
 ## Структуры
 
-Структура - набор правил по вставке фрагмента в мир генератором. На данный момент не имеет свойств, создаваясь в виде пустых объектов в файле `generators/имя_генератора.files/structures.toml`. Пример:
+Структура - набор правил по вставке фрагмента в мир генератором. Структуры объявляются в виде объектов в файле `generators/имя_генератора.files/structures.toml`. Пример:
 ```toml
 tree0 = {}
 tree1 = {}
 tree2 = {}
-tower = {}
+tower = {lowering=-2}
 coal_ore0 = {}
 ```
 
 На данный момент, имя структуры должно совпадать с именем использованного фрагмента.
 
+Доступные свойства:
+- lowering - глубина погружения структуры под поверхность.
+
 ## Биомы
 
 Биом определяет то, из каких блоков и какими слоями генерируется ландшафт, а так же набор растений, структур.

res/content/base/generators/demo.files/structures.toml

@@ -1,5 +1,5 @@
 tree0 = {}
 tree1 = {}
 tree2 = {}
-tower = {}
+tower = {lowering=2}
 coal_ore0 = {}

src/content/loading/GeneratorLoader.cpp

@@ -127,7 +127,7 @@ static VoxelStructureMeta load_structure_meta(
 ) {
     VoxelStructureMeta meta;
     meta.name = name;
-
+    config.at("lowering").get(meta.lowering);
     return meta;
 }
 

src/world/generator/GeneratorDef.hpp

@@ -15,7 +15,10 @@ class VoxelFragment;
 struct GeneratorDef;
 
 struct VoxelStructureMeta {
+    /// @brief Structure name
     std::string name;
+    /// @brief Structure lowering on placement
+    int lowering = 0;
 };
 
 struct BlocksLayer {

src/world/generator/WorldGenerator.cpp

@@ -270,10 +270,11 @@ void WorldGenerator::generateStructures(
             if (height < def.seaLevel) {
                 continue;
             }
-            auto& structure = *def.structures[structureId]->fragments[rotation];
+            auto& structure = *def.structures[structureId];
-            glm::ivec3 position {x, height, z};
+            auto& fragment = *structure.fragments[rotation];
-            position.x -= structure.getSize().x / 2;
+            glm::ivec3 position {x, height-structure.meta.lowering, z};
-            position.z -= structure.getSize().z / 2;
+            position.x -= fragment.getSize().x / 2;
+            position.z -= fragment.getSize().z / 2;
             placeStructure(
                 StructurePlacement {
                     structureId,