merge main

2024-05-18 16:39:02 +03:00
parent 47214d8e52 d3c9911640
commit 92d4cc904f
413 changed files with 17869 additions and 13272 deletions
@@ -60,10 +60,6 @@

 - `src` - имя изображения в папке textures без указания расширения. Тип: строка. Например `gui/error`

-## Изображение `image`
-
- `src` - имя изображения в папке textures без указания расширения. Тип: строка. Например `gui/error`
-
 # Текстовое поле `textbox`

 Внутренний текст - изначально введенный текст
@@ -110,4 +106,4 @@
 - `padding` - отступ вокруг решетки слотов. Тип: число.   (*атрибут будет удален*)
 - `sharefunc` - lua событие вызываемое при использовании ЛКМ + Shift. Передается id инвентаря и индекс слота
 - `updatefunc` - lua событие вызываемое при изменении содержимого слота
- `onrightclick` - lua событие вызываемое при использовании ПКМ. Передается id инвентаря и индекс слота
+- `onrightclick` - lua событие вызываемое при использовании ПКМ. Передается id инвентаря и индекс слота
@@ -10,6 +10,29 @@ load_script("контентпак:scripts/имя_скрипта.lua", true) --
 require "контентпак:имя_модуля" -- загружает lua модуль из папки modules (расширение не указывается)
 ```

+## Библиотека pack
+
+```python
+pack.is_installed(packid: str) -> bool
+```
+
+Проверяет наличие установленного пака в мире
+
+```python
+pack.data_file(packid: str, filename: str) -> str
+```
+
+Возвращает путь к файлу данных по типу: `world:data/packid/filename` 
+и создает недостающие директории в пути.
+
+Используйте эту функцию при сохранении настроек пака или иных данных в мире.
+
+Пример:
+```lua
+file.write(pack.data_file(PACK_ID, "example.txt"), text)
+```
+Для пака *containermod* запишет текст в файл `world:data/containermod/example.txt`
+
 ## Библиотека player
 ```python
 player.get_pos(playerid: int) -> number, number, number
@@ -66,6 +89,26 @@ world.get_seed() -> int

 Возвращает зерно мира.

+## Библиотека pack
+
+```python
+pack.get_folder(packid: str) -> str
+```
+
+Возвращает путь к папке установленного контент-пака
+
+```python
+pack.is_installed(packid: str) -> bool
+```
+
+Проверяет наличие контент-пака в мире
+
+```python
+pack.get_installed() -> массив строк
+```
+
+Возращает id всех установленных в мире контент-паков
+
 ## Библиотека gui

 Библиотека содержит функции для доступа к свойствам UI элементов. Вместо gui следует использовать объектную обертку, предоставляющую доступ к свойствам через мета-методы __index, __newindex:
@@ -132,6 +175,14 @@ inventory.clone(invid: int) -> int

 Создает копию инвентаря и возвращает id копии. Если копируемого инвентаря не существует, возвращает 0. 

+```python
+inventory.move(invA: int, slotA: int, invB: int, slotB: int)
+```
+
+Перемещает предмет из slotA инвентаря invA в slotB инвентаря invB.
+invA и invB могут указывать на один инвентарь.
+slotB будет выбран автоматически, если не указывать явно.
+
 ## Библиотека block

 ```python
@@ -303,6 +354,13 @@ hud.close(layoutid: str)
 ```

 Удаляет элемент с экрана
+
+```python
+hud.get_block_inventory() -> int
+```
+
+Получить ID инвентаря открытого блока или 0
+
 ## События блоков

 ```lua