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