From 77947a4822338f4c60b2a9fc2f108a1fada79eef Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 19 Sep 2025 22:31:24 +0300
Subject: [PATCH] update doc/*/block-properties.md, doc/*/item-properties.md

---
 doc/en/block-properties.md | 26 ++++++++++++++++++++++++++
 doc/en/item-properties.md  | 26 ++++++++++++++++++++++++++
 doc/ru/block-properties.md | 26 ++++++++++++++++++++++++++
 doc/ru/item-properties.md  | 27 +++++++++++++++++++++++++++
 4 files changed, 105 insertions(+)

diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md
index 60f87722..1244da99 100644
--- a/doc/en/block-properties.md
+++ b/doc/en/block-properties.md
@@ -297,3 +297,29 @@ Methods are used to manage the overwriting of properties when extending a block
 ### `property_name@append`
 
 Adds elements to the end of the list instead of completely overwriting it.
+
+## Tags
+
+Tags allow you to designate general properties of blocks. Names should be formatted as `prefix:tag_name`.
+The prefix is ​​optional, but helps avoid unwanted logical collisions. Example:
+
+```json
+{
+    "tags": [
+        "core:ore",
+        "base_survival:food",
+    ]
+}
+```
+
+Block tags can also be added from other packs using the `your_pack:tags.toml` file. Example:
+
+```toml
+"prefix:tag_name" = [
+    "random_pack:some_block",
+    "another_pack:item",
+]
+"other_prefix:other_tag_name" = [
+    # ...
+]
+``
diff --git a/doc/en/item-properties.md b/doc/en/item-properties.md
index 8abcb93c..7bef0766 100644
--- a/doc/en/item-properties.md
+++ b/doc/en/item-properties.md
@@ -66,3 +66,29 @@ Property status is displayed in the inventory interface. Display method is defin
 - `number` - number
 - `relation` - current value to initial value (x/y)
 - `vbar` - vertical scale (used by default)
+
+## Tags
+
+Tags allow you to designate general properties of items. Names should be formatted as `prefix:tag_name`.
+The prefix is ​​optional, but helps avoid unwanted logical collisions. Example:
+
+```json
+{
+    "tags": [
+        "core:fuel",
+        "base_survival:poison",
+    ]
+}
+```
+
+Tags can also be added to items from other packs using the `your_pack:tags.toml` file. Example
+
+```toml
+"prefix:tag_name" = [
+    "random_pack:item",
+    "another_pack:some_block",
+]
+"other_prefix:other_tag_name" = [
+    # ...
+]
+```
diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md
index 601a0dba..0003cb92 100644
--- a/doc/ru/block-properties.md
+++ b/doc/ru/block-properties.md
@@ -306,3 +306,29 @@
 ### `имя_свойства@append`
 
 Добавляет элементы в конец списка, вместо его полной перезаписи.
+
+## Теги - *tags*
+
+Теги позволяют обозначать обобщённые свойства блоков. Названия следует формировать как `префикс:имя_тега`.
+Префикс не является обязательным, но позволяет избегать нежелательных логических коллизий. Пример:
+
+```json
+{
+    "tags": [
+        "core:ore",
+        "base_survival:food",
+    ]
+}
+```
+
+Теги блокам можно добавлять и из других паков, с помощью файла `ваш_пак:tags.toml`. Пример
+
+```toml
+"префикс:имя_тега" = [
+    "рандомный_пак:какой_то_блок",
+    "ещё_один_пак:предмет",
+]
+"другой_префикс:другое_имя_тега" = [
+    # ...
+]
+```
diff --git a/doc/ru/item-properties.md b/doc/ru/item-properties.md
index 8a75ca72..cb45827a 100644
--- a/doc/ru/item-properties.md
+++ b/doc/ru/item-properties.md
@@ -65,3 +65,30 @@
 - `number` - число
 - `relation` - отношение текущего значения к изначальному (x/y)
 - `vbar` - вертикальная шкала (используется по-умолчанию)
+
+
+## Теги - *tags*
+
+Теги позволяют обозначать обобщённые свойства предметов. Названия следует формировать как `префикс:имя_тега`.
+Префикс не является обязательным, но позволяет избегать нежелательных логических коллизий. Пример:
+
+```json
+{
+    "tags": [
+        "core:fuel",
+        "base_survival:poison",
+    ]
+}
+```
+
+Теги предметам можно добавлять и из других паков, с помощью файла `ваш_пак:tags.toml`. Пример
+
+```toml
+"префикс:имя_тега" = [
+    "рандомный_пак:предмет",
+    "ещё_один_пак:какой_то_блок",
+]
+"другой_префикс:другое_имя_тега" = [
+    # ...
+]
+```