add new ore creation to the world-generator docs

MihailRis · Dec 21, 2024 · db902c1 · db902c1
1 parent fc8b166
commit db902c1
Show file tree

Hide file tree

Showing 2 changed files with 43 additions and 0 deletions.
diff --git a/doc/en/world-generator.md b/doc/en/world-generator.md
@@ -27,6 +27,7 @@
    * [Small structures placement](#small-structures-placement)
    * [Wide structures placement](#wide-structures-placement)
 - [Structural air](#structural-air)
+- [Generator 'Demo' (base:demo)](#generator-demo-basedemo)
 
 ## Basic concepts
 
@@ -473,3 +474,24 @@ function place_structures_wide(
 `core:struct_air` - a block that should be used in chunks to mark empty space that should not be filled with blocks when generated in the world.
 
 <image src="../../res/textures/blocks/struct_air.png" width="128px" height="128px" style="image-rendering: pixelated">
+
+# Generator 'Demo' (base:demo)
+
+## Adding new ore
+
+To add a new ore in your pack:
+1. In the `generators` folder, create a `demo.files` folder (you don't need to create demo.toml).
+
+2. In the created folder, create a fragments folder and place the ore fragment file in it.
+3. In `demo.files`, create a structures.toml file:
+```toml
+fragment_name = {}
+```
+4. Also in `demo.files`, create an ores.json file:
+```json
+[
+    {"struct": "fragment_name", "rarity": rarity}
+]
+```
+The higher the rarity value, the less ore generation chance.
+You can rely on the rarity of coal ore: 4400.
diff --git a/doc/ru/world-generator.md b/doc/ru/world-generator.md
@@ -27,6 +27,7 @@
    * [Расстановка малых структур](#расстановка-малых-структур)
    * [Расстановка 'широких' структур](#расстановка-широких-структур)
 - [Структурный воздух](#структурный-воздух)
+- [Генератор 'Demo' (base:demo)](#генератор-demo-basedemo)
 
 ## Основные понятия
 
@@ -478,3 +479,23 @@ function place_structures_wide(
 `core:struct_air` - блок, которые следует использовать в фрагментах для обозначения пустого пространства, которое не должно заполняться блоками при генерации в мире.
 
 <image src="../../res/textures/blocks/struct_air.png" width="128px" height="128px" style="image-rendering: pixelated">
+
+# Генератор 'Demo' (base:demo)
+
+## Добавление новой руды
+
+Чтобы добавить новую руду из своего пака:
+1. В папке `generators` создайте папку `demo.files` (demo.toml создавать не нужно). 
+2. В созданной папке создайте папку fragments и поместите в неё файл фрагмента руды.
+3. В `demo.files` создайте файл structures.toml:
+```toml
+имя_фрагмента = {}
+```
+4. Также в `demo.files` создайте файл ores.json:
+```json
+[
+    {"struct": "имя_фрагмента", "rarity": редкость}
+]
+```
+Чем выше значение редкости, тем меньше вероятность генерации руды.
+Опираться можно на редкость угольной руды: 4400.