From 092ec749b83890c09fd9257e0b5dcb2aa88bfca9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=93=D1=80=D0=B8=D0=B3=D0=BE=D1=80=D0=B8=D0=B9=20=D0=A1?=
 =?UTF-8?q?=D0=B0=D1=84=D1=80=D0=BE=D0=BD=D0=BE=D0=B2?=
 <gvsafronov@yandex.ru>
Date: Sun, 20 Jul 2025 12:51:40 +0000
Subject: [PATCH] Update README.md

---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/README.md b/README.md
index 6637810..6d66f22 100644
--- a/README.md
+++ b/README.md
@@ -358,7 +358,39 @@ def get_value(key):
 
 ## Lua-скрипты
 
+> [!CAUTION]
+> **Поддержка работы lua в настоящий момент эксперементальная и может вызвать аварийное завершение сервера!!!**
 
+1. Интерактивный режим работы, (выполнение скрипта в клиенте `futriix-cli`):
+
+```sh
+  futriix:~> futexec
+lua> return "Hello, " .. os.date("%Y-%m-%d")
+```
+
+2. Выполнение файлов скриптов (c помоью команды в клиенте `SysExec`):
+
+    ```sh
+    futriix:~> sysexec my_script
+
+   ````
+
+3. Доступ к данным из сервера Lua
+
+Скрипты имеют доступ к специальному API:
+
+```sh
+-- Чтение данных
+local value = futriix.get("my_key")
+
+-- Запись данных
+futriix.put("temp_key", {data = "test", ts = os.time()})
+
+-- Пример сложной логики
+for i = 1, 10 do
+    futriix.put("counter/"..i, i*2)
+end
+```
 
 <p align="right">(<a href="#readme-top">К началу</a>)</p>