From 4cfd2c6aa3c0541afe1343b91b55db33568125be Mon Sep 17 00:00:00 2001 From: MihailRis Date: Thu, 25 Jan 2024 16:20:21 +0300 Subject: [PATCH] =?UTF-8?q?Updated=20=D0=A1=D0=BA=D1=80=D0=B8=D0=BF=D1=82?= =?UTF-8?q?=D0=B8=D0=BD=D0=B3=20(markdown)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Скриптинг.md | 64 ++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 59 insertions(+), 5 deletions(-) diff --git a/Скриптинг.md b/Скриптинг.md index ea1ced5..a924e36 100644 --- a/Скриптинг.md +++ b/Скриптинг.md @@ -124,11 +124,6 @@ set_block_user_bits(x, y, z, offset, bits, value) ``` Записывает указанное число бит значения value в user bits по выбранному смещению -```lua -time.uptime() -``` -[с версии 0.18] Возвращает время с момента запуска движка в секундах - ## События блоков ```lua @@ -169,3 +164,62 @@ function on_block_break_by(x, y, z, playerid) ``` Вызывается при нажатии ЛКМ на блок (в т.ч неразрушимый). Предотвращает разрушение блока, если возвращает `true` + +## Библиотеки движка + +### file + +Библиотека функций для работы с файлами + +```lua +file.resolve(путь: string) -> string +``` + +Функция приводит запись `точка_входа:путь` (например `user:worlds/house1`) к обычному пути. (например `C://Users/user/.voxeng/worlds/house1`) +> [!NOTE] +> Функцию не нужно использовать в сочетании с другими функциями из библиотеки, так как они делают это автоматически + +Возвращаемый путь не является каноническим и может быть как абсолютным, так и относительным. + +```lua +file.read(путь: string) -> string +``` + +Читает весь текстовый файл и возвращает в виде строки + +```lua +file.write(путь: string, текст: string) -> nil +``` + +Записывает текст в файл (с перезаписью) + +```lua +file.length(путь: string) -> integer +``` + +Возвращает размер файла в байтах, либо -1, если файл не найден + +```lua +file.exists(путь: string) -> boolean +``` + +Проверяет, существует ли по данному пути файл или директория + +```lua +file.isfile(путь: string) -> boolean +``` + +Проверяет, существует ли по данному пути файл + +```lua +file.isdir(путь: string) -> boolean +``` + +Проверяет, существует ли по данному пути директория + +### time + +```lua +time.uptime() +``` +Возвращает время с момента запуска движка в секундах \ No newline at end of file