Merge pull request #568 from GHOST3118/improve-items

Improve items

doc/ru/item-properties.md

@@ -17,6 +17,14 @@
 Значение по-умолчанию - `packid:itemname.model`.
 Если модель не указана, будет сгенерирована автоматическию
 
+### Имя и Описание
+`caption` - имя предмета в инвентаре
+`description` - описание предмета в инвентаре
+
+Можно использовать `md`
+
+*см. [Text Styles](/doc/en/text-styles.md)*
+
 ## Поведение
 
 ### Устанавливаемый блок - `placing-block`

doc/ru/scripting/builtins/libinventory.md

@@ -94,6 +94,40 @@ inventory.set(...)
 inventory.set_all_data(...)
 ```
 для перемещения вляется неэффективным, используйте inventory.move или inventory.move_range.
+```lua
+-- Получает имя предмета в слоте
+inventory.get_caption(
+    -- id инвентаря
+    invid: int,
+    -- индекс слота
+    slot: int
+)
+-- Задает имя предмету в слоте
+inventory.set_caption(
+    -- id инвентаря
+    invid: int,
+    -- индекс слота
+    slot: int,
+    -- Имя предмета
+    caption: string
+)
+-- Получает описание предмета в слоте
+inventory.get_description(
+    -- id инвентаря
+    invid: int,
+    -- индекс слота
+    slot: int
+)
+-- Задает описание предмету в слоте
+inventory.set_description(
+    -- id инвентаря
+    invid: int,
+    -- индекс слота
+    slot: int,
+    -- Описание предмета
+    description: string
+)
+```
 
 ```lua
 -- Проверяет наличие локального свойства по имени без копирования его значения.

doc/ru/scripting/builtins/libitem.md

@@ -10,6 +10,9 @@ item.index(name: str) -> int
 -- Возвращает название предмета, отображаемое в интерфейсе.
 item.caption(itemid: int) -> str
 
+-- Возвращает описание предмета, отображаемое в интерфейсе.
+item.description(itemid: int) -> str
+
 -- Возвращает максимальный размер стопки для предмета.
 item.stack_size(itemid: int) -> int