diff --git a/doc/en/8.Scripting.md b/doc/en/8.Scripting.md index ace3c80e..de5e0ca3 100644 --- a/doc/en/8.Scripting.md +++ b/doc/en/8.Scripting.md @@ -13,6 +13,30 @@ load_script("packid:scripts/script_name.lua") -- load Lua script if not loaded y load_script("packid:scripts/script_name.lua", true) -- load Lua script anyway ``` +## *pack* library + +```python +pack.is_installed(packid: str) -> bool +``` + +Check if specified pack is installed in the world + +```python +pack.data_file(packid: str, filename: str) -> str +``` + +Returns data file path like `world:data/packid/filename` +and creates missing directories. + +Use this function when saving pack settings or other data to the world. + +Example: +```lua +file.write(pack.data_file(PACK_ID, "example.txt"), text) +``` + +For pack *containermod* will write text to the file `world:data/containermod/example.txt` + ## *player* library diff --git a/doc/ru/8.Скриптинг.md b/doc/ru/8.Скриптинг.md index 40b0a5a3..2b2a7326 100644 --- a/doc/ru/8.Скриптинг.md +++ b/doc/ru/8.Скриптинг.md @@ -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