Updated Скриптинг (markdown)

MihailRis 2024-01-25 16:20:21 +03:00
parent 4f5136fd12
commit 4cfd2c6aa3

@ -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()
```
Возвращает время с момента запуска движка в секундах