From 69b565384a8e450ffc17f79fc904c65316ec485f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 30 Dec 2023 18:55:27 +0300
Subject: [PATCH] =?UTF-8?q?Created=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 | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 Скриптинг.md

diff --git a/Скриптинг.md b/Скриптинг.md
new file mode 100644
index 0000000..6f2b8a3
--- /dev/null
+++ b/Скриптинг.md
@@ -0,0 +1,38 @@
+В качестве языка сценариев используется Lua (предпочтительна JIT реализация)
+
+На данном этапе, скриптинг реализован в тестовом режиме и будет активно развиваться, с изменением (иногда и радикальным) API движка.
+
+На момент выхода версии 0.16 в движке существует следующий набор функций, доступных из всех Lua скриптов, выполняемых движком:
+
+```lua
+block_name(id) -- возвращает строковый id блока, принимая в качестве агрумента числовой
+```
+
+```lua
+block_index(id) -- возвращает числовой id блока, принимая в качестве агрумента строковый
+```
+
+```lua
+get_block(x, y, z) -- возвращает числовой id блока на указанных координатах
+```
+
+```lua
+set_block(x, y, z, id, states) -- устанавливает блок с заданным числовым id и состоянием (0 - по-умолчанию) на заданных координатах
+-- НЕ вызывает событие on_placed
+```
+
+```lua
+is_solid_at(x, y, z) -- проверяет, является ли блок на указанных координатах полным
+```
+
+```lua
+blocks_count(x, y, z) -- возвращает количество id доступных в движке блоков
+```
+
+```lua
+get_player_pos() -- возвращает x, y, z координаты игрока
+```
+
+```lua
+set_player_pos(x, y, z) -- устанавливает x, y, z координаты игрока
+```
\ No newline at end of file