From 21725921e14d8910bdfe3cbbb8a68b40e640052a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 26 Sep 2025 21:25:54 +0300
Subject: [PATCH 001/133] start 0.30 development

---
 doc/en/main-page.md           | 4 +++-
 doc/ru/main-page.md           | 4 +++-
 res/content/base/package.json | 2 +-
 src/constants.hpp             | 4 ++--
 4 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/doc/en/main-page.md b/doc/en/main-page.md
index a5e866bf..5eb767f9 100644
--- a/doc/en/main-page.md
+++ b/doc/en/main-page.md
@@ -1,6 +1,8 @@
 # Documentation
 
-Documentation for 0.29.
+Documentation for 0.30 (in development).
+
+[Documentation for 0.29.](https://github.com/MihailRis/voxelcore/blob/release-0.29/doc/ru/main-page.md)
 
 ## Sections
 
diff --git a/doc/ru/main-page.md b/doc/ru/main-page.md
index c98d893d..60d0794d 100644
--- a/doc/ru/main-page.md
+++ b/doc/ru/main-page.md
@@ -1,6 +1,8 @@
 # Документация
 
-Документация версии 0.29.
+Документация версии 0.30 (в разработке).
+
+[Документация 0.29.](https://github.com/MihailRis/voxelcore/blob/release-0.29/doc/ru/main-page.md)
 
 ## Разделы
 
diff --git a/res/content/base/package.json b/res/content/base/package.json
index 4aeca4d9..f270a6d5 100644
--- a/res/content/base/package.json
+++ b/res/content/base/package.json
@@ -1,6 +1,6 @@
 {
     "id": "base",
     "title": "Base",
-    "version": "0.29",
+    "version": "0.30",
     "description": "basic content package"
 }
diff --git a/src/constants.hpp b/src/constants.hpp
index 0a6df9e5..6544316e 100644
--- a/src/constants.hpp
+++ b/src/constants.hpp
@@ -6,7 +6,7 @@
 #include <string>
 
 inline constexpr int ENGINE_VERSION_MAJOR = 0;
-inline constexpr int ENGINE_VERSION_MINOR = 29;
+inline constexpr int ENGINE_VERSION_MINOR = 30;
 
 #ifdef NDEBUG
 inline constexpr bool ENGINE_DEBUG_BUILD = false;
@@ -14,7 +14,7 @@ inline constexpr bool ENGINE_DEBUG_BUILD = false;
 inline constexpr bool ENGINE_DEBUG_BUILD = true;
 #endif // NDEBUG
 
-inline const std::string ENGINE_VERSION_STRING = "0.29";
+inline const std::string ENGINE_VERSION_STRING = "0.30";
 
 /// @brief world regions format version
 inline constexpr uint REGION_FORMAT_VERSION = 3;

From 240abb939fee45e0d678368d4514b07003630e33 Mon Sep 17 00:00:00 2001
From: GHOST11111100 <ghost11111100@gmail.com>
Date: Fri, 26 Sep 2025 21:39:12 +0300
Subject: [PATCH 002/133] Links (#615)

* add URL support to Label element and XML parsing

* refactor Label URL handling to use getter method in setURL

* implement URL opening confirmation dialog and platform-specific URL handling

* fix: fixed build errors

* remove: delete test link label from worlds.xml

* refactor: remove URL handling from Label class and XML parsing

* refactor: clean up Label class by removing unnecessary whitespace and improving code readability

* refactor: remove unused URL member from Label class

* refactor: remove unused URL attribute from XML UI documentation and related code

* refactor: improve code readability by adding whitespace and formatting adjustments in Label class

* refactor: improve whitespace consistency in Label class and add URL opening functionality in libcore
---
 res/layouts/pages/worlds.xml             |  1 -
 res/texts/be_BY.txt                      |  1 +
 res/texts/de_DE.txt                      |  1 +
 res/texts/fi_FI.txt                      |  1 +
 res/texts/pl_PL.txt                      |  1 +
 res/texts/ru_RU.txt                      |  1 +
 res/texts/uk_UA.txt                      |  1 +
 res/texts/uz_UZ.txt                      |  1 +
 src/graphics/ui/gui_util.cpp             |  9 ++++--
 src/logic/scripting/lua/libs/libcore.cpp | 24 +++++++++++++++
 src/util/platform.cpp                    | 37 +++++++++++++++++++++++-
 src/util/platform.hpp                    |  1 +
 12 files changed, 75 insertions(+), 4 deletions(-)

diff --git a/res/layouts/pages/worlds.xml b/res/layouts/pages/worlds.xml
index 13765930..a8a536a2 100644
--- a/res/layouts/pages/worlds.xml
+++ b/res/layouts/pages/worlds.xml
@@ -1,5 +1,4 @@
 <panel size='400' color='0' interval='1' context='menu'>
-    
     <button onclick='menu.page="new_world"'>@New World</button>
     
     <panel id='worlds' size='390,1' padding='5' color='#FFFFFF11' max-length='400'>
diff --git a/res/texts/be_BY.txt b/res/texts/be_BY.txt
index 879e5a35..1fb2a993 100644
--- a/res/texts/be_BY.txt
+++ b/res/texts/be_BY.txt
@@ -25,6 +25,7 @@ Grant %{0} pack modification permission?=Выдаць дазвол на мады
 Error at line %{0}=Памылка ў радку %{0}
 Run=Запусціць
 Filter=Фільтр
+Are you sure you want to open the link: =Ці вы ўпэўненыя, што хочаце адкрыць спасылку: 
 
 editor.info.tooltip=CTRL+S - Захаваць\nCTRL+R - Запусціць\nCTRL+Z - Скасаваць\nCTRL+Y - Паўтарыць
 devtools.traceback=Стэк выклікаў (ад апошняга)
diff --git a/res/texts/de_DE.txt b/res/texts/de_DE.txt
index 8e125159..81c39571 100644
--- a/res/texts/de_DE.txt
+++ b/res/texts/de_DE.txt
@@ -7,6 +7,7 @@ Back=Zurück
 Continue=Weitermachen
 Add=Hinzufügen
 Converting world...=Weltkonvertierung im Gange...
+Are you sure you want to open the link: =Sind Sie sicher, dass Sie den Link öffnen möchten: 
 
 error.pack-not-found=Paket konnte nicht gefunden werden
 error.dependency-not-found=Die verwendete Abhängigkeit wurde nicht gefunden
diff --git a/res/texts/fi_FI.txt b/res/texts/fi_FI.txt
index 52f4b3e0..6a21f73f 100644
--- a/res/texts/fi_FI.txt
+++ b/res/texts/fi_FI.txt
@@ -19,6 +19,7 @@ Problems=Ongelmia
 Monitor=Valvonta
 Debug=Virheenkorjaus
 File=Tiedosto
+Are you sure you want to open the link: =Haluatko varmasti avata linkin: 
 
 devtools.traceback=Puhelupino (viimeisestä)
 error.pack-not-found=Pakettia ei löytynyt!
diff --git a/res/texts/pl_PL.txt b/res/texts/pl_PL.txt
index caae775b..3e039824 100644
--- a/res/texts/pl_PL.txt
+++ b/res/texts/pl_PL.txt
@@ -7,6 +7,7 @@ Back=Powrót
 Continue=Kontynuacja
 Add=Dodać
 Converting world...=Konwersja świata w toku...
+Are you sure you want to open the link: =Czy na pewno chcesz otworzyć link: 
 
 error.pack-not-found=Nie udało się znaleźć pakietu
 
diff --git a/res/texts/ru_RU.txt b/res/texts/ru_RU.txt
index 084e11b3..1c650560 100644
--- a/res/texts/ru_RU.txt
+++ b/res/texts/ru_RU.txt
@@ -25,6 +25,7 @@ Grant %{0} pack modification permission?=Выдать разрешение на
 Error at line %{0}=Ошибка на строке %{0}
 Run=Запустить
 Filter=Фильтр
+Are you sure you want to open the link: =Вы уверены, что хотите открыть ссылку: 
 
 editor.info.tooltip=CTRL+S - Сохранить\nCTRL+R - Запустить\nCTRL+Z - Отменить\nCTRL+Y - Повторить
 devtools.traceback=Стек вызовов (от последнего)
diff --git a/res/texts/uk_UA.txt b/res/texts/uk_UA.txt
index 7ce046ea..a288f516 100644
--- a/res/texts/uk_UA.txt
+++ b/res/texts/uk_UA.txt
@@ -23,6 +23,7 @@ devtools.traceback=Стек викликів (від останнього)
 error.pack-not-found=Не вдалося знайти пакет
 error.dependency-not-found=Використовувана залежність не знайдена
 pack.remove-confirm=Видалити весь контент, що постачається паком/паками зі світу (безповоротно)?
+Are you sure you want to open the link: =Ви впевнені, що хочете відкрити посилання: 
 
 # Меню
 menu.Apply=Застосувати
diff --git a/res/texts/uz_UZ.txt b/res/texts/uz_UZ.txt
index 845c0cf5..edae1c02 100644
--- a/res/texts/uz_UZ.txt
+++ b/res/texts/uz_UZ.txt
@@ -24,6 +24,7 @@ Save=Saqlash
 Grant %{0} pack modification permission?=%{0} to‘plamini o‘zgartirish ruxsatini berilsinmi?
 Error at line %{0}=%{0}-qatorida xatolik
 Run=Ishga tushirish
+Are you sure you want to open the link: =Haqiqatan ham havolani ochmoqchimisiz: 
 
 editor.info.tooltip=CTRL+S - Saqlash\nCTRL+R - Ishga tushirish\nCTRL+Z - Bekor qilish\nCTRL+Y - Qayta bajarish
 devtools.traceback=Chaqiruvlar steki (so`nggisidan boshlab)
diff --git a/src/graphics/ui/gui_util.cpp b/src/graphics/ui/gui_util.cpp
index 6d28b990..4e521715 100644
--- a/src/graphics/ui/gui_util.cpp
+++ b/src/graphics/ui/gui_util.cpp
@@ -103,9 +103,14 @@ void guiutil::confirm(
 
     panel->setGravity(Gravity::center_center);
     container->add(panel);
-
     panel->setColor(glm::vec4(0.0f, 0.0f, 0.0f, 0.5f));
-    panel->add(std::make_shared<Label>(gui, text));
+
+    auto label = std::make_shared<Label>(gui, text);
+    label->setSize(glm::vec2(600, 50));
+    label->setMultiline(true);
+    label->setTextWrapping(true);
+
+    panel->add(label);
     auto subpanel = std::make_shared<Panel>(gui, glm::vec2(600, 53));
     subpanel->setColor(glm::vec4(0));
 
diff --git a/src/logic/scripting/lua/libs/libcore.cpp b/src/logic/scripting/lua/libs/libcore.cpp
index c453927c..5893c860 100644
--- a/src/logic/scripting/lua/libs/libcore.cpp
+++ b/src/logic/scripting/lua/libs/libcore.cpp
@@ -20,6 +20,11 @@
 #include "util/platform.hpp"
 #include "world/Level.hpp"
 #include "world/generator/WorldGenerator.hpp"
+#include "util/platform.hpp"
+#include "frontend/locale.hpp"
+#include "graphics/ui/gui_util.hpp"
+#include "graphics/ui/GUI.hpp"
+#include "graphics/ui/elements/Menu.hpp"
 
 using namespace scripting;
 
@@ -229,6 +234,24 @@ static int l_open_folder(lua::State* L) {
     return 0;
 }
 
+static int l_open_url(lua::State* L) {
+    auto url = lua::require_string(L, 1);
+
+    std::wstring msg = langs::get(L"Are you sure you want to open the link:") +
+                       L"\n" + util::str2wstr_utf8(url) +
+                       std::wstring(L"?");
+
+    auto menu = engine->getGUI().getMenu();
+
+    guiutil::confirm(*engine, msg, [url, menu]() {
+        platform::openURL(url);
+        if (!menu->back()) {
+            menu->reset();
+        }
+    });
+    return 0;
+}
+
 /// @brief Quit the game
 static int l_quit(lua::State*) {
     engine->quit();
@@ -284,6 +307,7 @@ const luaL_Reg corelib[] = {
     {"str_setting", lua::wrap<l_str_setting>},
     {"get_setting_info", lua::wrap<l_get_setting_info>},
     {"open_folder", lua::wrap<l_open_folder>},
+    {"open_url", lua::wrap<l_open_url>},
     {"quit", lua::wrap<l_quit>},
     {"capture_output", lua::wrap<l_capture_output>},
     {NULL, NULL}
diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index 3b2fdce2..ca889167 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -65,14 +65,31 @@ int platform::get_process_id() {
     return GetCurrentProcessId(); 
 }
 
+bool platform::openURL(const std::string& url) {
+    if (url.empty()) return false;
+    // UTF-8 → UTF-16
+    int wlen = MultiByteToWideChar(CP_UTF8, 0, url.c_str(), -1, nullptr, 0);
+    if (wlen <= 0) return false;
+
+    std::wstring wurl(wlen, L'\0');
+    MultiByteToWideChar(CP_UTF8, 0, url.c_str(), -1, &wurl[0], wlen);
+
+    HINSTANCE result = ShellExecuteW(
+        nullptr, L"open", wurl.c_str(), nullptr, nullptr, SW_SHOWNORMAL
+    );
+
+    return reinterpret_cast<intptr_t>(result) > 32;
+}
+
 #else // _WIN32
 
 #include <unistd.h>
+#include <sys/wait.h>
 #include "frontend/locale.hpp"
 
 void platform::configure_encoding() {
 }
-
+ 
 std::string platform::detect_locale() {
     const char* const programLocaleName = setlocale(LC_ALL, nullptr);
     const char* const preferredLocaleName =
@@ -92,6 +109,24 @@ void platform::sleep(size_t millis) {
 int platform::get_process_id() {
     return getpid();
 }
+
+bool platform::openURL(const std::string& url) {
+    if (url.empty()) return false;
+    pid_t pid = fork();
+    if (pid == 0) {
+#ifdef __APPLE__
+        execlp("open", "open", url.c_str(), (char*)nullptr);
+#else
+        execlp("xdg-open", "xdg-open", url.c_str(), (char*)nullptr);
+#endif
+        _exit(127);
+    } else if (pid > 0) {
+        int status = 0;
+        waitpid(pid, &status, 0);
+        return WIFEXITED(status) && WEXITSTATUS(status) == 0;
+    }
+    return false;
+}
 #endif // _WIN32
 
 void platform::open_folder(const std::filesystem::path& folder) {
diff --git a/src/util/platform.hpp b/src/util/platform.hpp
index 6793411e..7ef47224 100644
--- a/src/util/platform.hpp
+++ b/src/util/platform.hpp
@@ -13,4 +13,5 @@ namespace platform {
     /// Makes the current thread sleep for the specified amount of milliseconds.
     void sleep(size_t millis);
     int get_process_id();
+    bool openURL(const std::string& url);
 }

From 4c815db22242b2da37e3945c942980f76f2eb925 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 26 Sep 2025 21:57:48 +0300
Subject: [PATCH 003/133] cleanup platform.cpp

---
 src/logic/scripting/lua/libs/libcore.cpp |  2 +-
 src/util/platform.cpp                    | 44 +++++++++++++++---------
 src/util/platform.hpp                    |  2 +-
 3 files changed, 29 insertions(+), 19 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libcore.cpp b/src/logic/scripting/lua/libs/libcore.cpp
index 5893c860..09a192c7 100644
--- a/src/logic/scripting/lua/libs/libcore.cpp
+++ b/src/logic/scripting/lua/libs/libcore.cpp
@@ -244,7 +244,7 @@ static int l_open_url(lua::State* L) {
     auto menu = engine->getGUI().getMenu();
 
     guiutil::confirm(*engine, msg, [url, menu]() {
-        platform::openURL(url);
+        platform::open_url(url);
         if (!menu->back()) {
             menu->reset();
         }
diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index ca889167..2cdd0b89 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -65,7 +65,7 @@ int platform::get_process_id() {
     return GetCurrentProcessId(); 
 }
 
-bool platform::openURL(const std::string& url) {
+bool platform::open_url(const std::string& url) {
     if (url.empty()) return false;
     // UTF-8 → UTF-16
     int wlen = MultiByteToWideChar(CP_UTF8, 0, url.c_str(), -1, nullptr, 0);
@@ -84,7 +84,6 @@ bool platform::openURL(const std::string& url) {
 #else // _WIN32
 
 #include <unistd.h>
-#include <sys/wait.h>
 #include "frontend/locale.hpp"
 
 void platform::configure_encoding() {
@@ -110,22 +109,32 @@ int platform::get_process_id() {
     return getpid();
 }
 
-bool platform::openURL(const std::string& url) {
+bool platform::open_url(const std::string& url) {
     if (url.empty()) return false;
-    pid_t pid = fork();
-    if (pid == 0) {
+
 #ifdef __APPLE__
-        execlp("open", "open", url.c_str(), (char*)nullptr);
-#else
-        execlp("xdg-open", "xdg-open", url.c_str(), (char*)nullptr);
-#endif
-        _exit(127);
-    } else if (pid > 0) {
-        int status = 0;
-        waitpid(pid, &status, 0);
-        return WIFEXITED(status) && WEXITSTATUS(status) == 0;
+    auto cmd = "open " + util::quote(url);
+    if (int res = system(cmd.c_str())) {
+        logger.warning() << "'" << cmd << "' returned code " << res;
+    } else {
+        return false;
     }
-    return false;
+#elif defined(_WIN32)
+    auto res = ShellExecuteW(NULL, L"open", util::quote(url).c_str(), NULL, NULL, SW_SHOWDEFAULT);
+    if (res <= 32) {
+        logger.warning() << "'open' returned code " << res;
+    } else {
+        return false;
+    }
+#else
+    auto cmd = "xdg-open " + util::quote(url);
+    if (int res = system(cmd.c_str())) {
+        logger.warning() << "'" << cmd << "' returned code " << res;
+    } else {
+        return false;
+    }
+#endif
+    return true;
 }
 #endif // _WIN32
 
@@ -136,9 +145,10 @@ void platform::open_folder(const std::filesystem::path& folder) {
     }
 #ifdef __APPLE__
     auto cmd = "open " + util::quote(folder.u8string());
-    system(cmd.c_str());
+    if (int res = system(cmd.c_str())) {
+        logger.warning() << "'" << cmd << "' returned code " << res;
+    }
 #elif defined(_WIN32)
-    auto cmd = "start explorer " + util::quote(folder.u8string());
     ShellExecuteW(NULL, L"open", folder.wstring().c_str(), NULL, NULL, SW_SHOWDEFAULT);
 #else
     auto cmd = "xdg-open " + util::quote(folder.u8string());
diff --git a/src/util/platform.hpp b/src/util/platform.hpp
index 7ef47224..a638ee92 100644
--- a/src/util/platform.hpp
+++ b/src/util/platform.hpp
@@ -13,5 +13,5 @@ namespace platform {
     /// Makes the current thread sleep for the specified amount of milliseconds.
     void sleep(size_t millis);
     int get_process_id();
-    bool openURL(const std::string& url);
+    bool open_url(const std::string& url);
 }

From 792ee63f22733ced0adef672b77faaafbc2522e8 Mon Sep 17 00:00:00 2001
From: GHOST11111100 <mirdodoevsasha@gmail.com>
Date: Fri, 26 Sep 2025 21:59:15 +0300
Subject: [PATCH 004/133] Player Attributes (#578)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: add max interaction distance functionality to Player class and Lua bindings

* feat: add getter and setter for max interaction distance in Player class documentation

* feat: add speed and gravity scale properties with corresponding getters and setters in Player class

* fix: replace deprecated __max and __min with std::max and std::min in setMaxInteractionDistance

* feat: add time scale functionality with getters and setters in World and Engine classes

* remove speed and gravity scale functions from player and world libraries

* remove time scale setting on world open and close

* rename interaction distance functions for consistency

* refactor: update interaction distance functions and remove time scale methods

* refactor: revert classes.lua to dev

* refactor: remove time scale functionality from Engine and World classes

* fix: Now I’ve definitely rolled back `classes.lua`.

* refactor: remove unused player attributes and clean up player class

* Update Player.hpp

removed unused methods from Player.cpp
---
 doc/en/scripting/builtins/libplayer.md     |  7 +++++++
 doc/ru/scripting/builtins/libplayer.md     |  7 +++++++
 res/scripts/classes.lua                    |  2 +-
 src/logic/PlayerController.cpp             |  2 +-
 src/logic/scripting/lua/libs/libplayer.cpp | 16 ++++++++++++++++
 src/network/Network.hpp                    |  1 -
 src/objects/Player.cpp                     | 11 +++++++++++
 src/objects/Player.hpp                     |  9 +++++++++
 8 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/doc/en/scripting/builtins/libplayer.md b/doc/en/scripting/builtins/libplayer.md
index fa799198..b406f694 100644
--- a/doc/en/scripting/builtins/libplayer.md
+++ b/doc/en/scripting/builtins/libplayer.md
@@ -89,6 +89,13 @@ player.set_loading_chunks(playerid: int, bool)
 
 Getter and setter of the property that determines whether the player is loading chunks.
 
+```lua
+player.get_interaction_distance(playerid: int) -> float
+player.set_interaction_distance(playerid: int, distance: float)
+```
+
+Getter and setter of the property for max interaction distance.
+
 ``` lua
 player.set_spawnpoint(playerid: int, x: number, y: number, z: number)
 player.get_spawnpoint(playerid: int) -> number, number, number
diff --git a/doc/ru/scripting/builtins/libplayer.md b/doc/ru/scripting/builtins/libplayer.md
index 2228f42c..c40cd86d 100644
--- a/doc/ru/scripting/builtins/libplayer.md
+++ b/doc/ru/scripting/builtins/libplayer.md
@@ -89,6 +89,13 @@ player.set_loading_chunks(playerid: int, bool)
 
 Геттер и сеттер свойства, определяющего, прогружает ли игрок чанки вокруг.
 
+```lua
+player.get_interaction_distance(playerid: int) -> float
+player.set_interaction_distance(playerid: int, distance: float)
+```
+
+Геттер и сеттер свойства, определяющего максимальную дистанцию взаимодействия.
+
 ```lua
 player.set_spawnpoint(playerid: int, x: number, y: number, z: number) 
 player.get_spawnpoint(playerid: int) -> number, number, number
diff --git a/res/scripts/classes.lua b/res/scripts/classes.lua
index e950aa0d..23ee45b7 100644
--- a/res/scripts/classes.lua
+++ b/res/scripts/classes.lua
@@ -289,4 +289,4 @@ network.__process_events = function()
             cleaned = true
         end
     end
-end
+end
\ No newline at end of file
diff --git a/src/logic/PlayerController.cpp b/src/logic/PlayerController.cpp
index 8021db51..4e63f76d 100644
--- a/src/logic/PlayerController.cpp
+++ b/src/logic/PlayerController.cpp
@@ -488,7 +488,7 @@ void PlayerController::updateInteraction(const Input& inputEvents, float delta)
     }
     const auto& bindings = inputEvents.getBindings();
     bool xkey = bindings.active(BIND_PLAYER_FAST_INTERACTOIN);
-    float maxDistance = xkey ? 200.0f : 10.0f;
+    float maxDistance = xkey ? 200.0f : player.getMaxInteractionDistance();
     bool longInteraction = interactionTimer <= 0 || xkey;
     bool lclick = bindings.jactive(BIND_PLAYER_DESTROY) ||
                   (longInteraction && bindings.active(BIND_PLAYER_DESTROY));
diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index d850231d..a9e18d8e 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -181,6 +181,20 @@ static int l_set_loading_chunks(lua::State* L) {
     return 0;
 }
 
+static int l_get_interaction_distance(lua::State* L) {
+    if (auto player = get_player(L, 1)) {
+        return lua::pushnumber(L, player->getMaxInteractionDistance());
+    }
+    return 0;
+}
+
+static int l_set_interaction_distance(lua::State* L) {
+    if (auto player = get_player(L, 1)) {
+        player->setMaxInteractionDistance( static_cast<float>(lua::tonumber(L, 2)) );
+    }
+    return 0;
+}
+
 static int l_get_selected_block(lua::State* L) {
     if (auto player = get_player(L, 1)) {
         if (player->selection.vox.id == BLOCK_VOID) {
@@ -328,6 +342,8 @@ const luaL_Reg playerlib[] = {
     {"set_instant_destruction", lua::wrap<l_set_instant_destruction>},
     {"is_loading_chunks", lua::wrap<l_is_loading_chunks>},
     {"set_loading_chunks", lua::wrap<l_set_loading_chunks>},
+    {"get_interaction_distance", lua::wrap<l_get_interaction_distance>},
+    {"set_interaction_distance", lua::wrap<l_set_interaction_distance>},
     {"set_selected_slot", lua::wrap<l_set_selected_slot>},
     {"get_selected_block", lua::wrap<l_get_selected_block>},
     {"get_selected_entity", lua::wrap<l_get_selected_entity>},
diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index 054b9444..3e9feeda 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -16,7 +16,6 @@ namespace network {
     using ServerDatagramCallback = std::function<void(u64id_t sid, const std::string& addr, int port, const char* buffer, size_t length)>;
     using ClientDatagramCallback = std::function<void(u64id_t cid, const char* buffer, size_t length)>;
 
-
     class Requests {
     public:
         virtual ~Requests() {}
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index 2c2fbe24..93e86625 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -196,6 +196,14 @@ void Player::setLoadingChunks(bool flag) {
     loadingChunks = flag;
 }
 
+float Player::getMaxInteractionDistance() const {
+    return maxInteractionDistance;
+}
+
+void Player::setMaxInteractionDistance(float distance) {
+    maxInteractionDistance = std::max(1.0f, std::min(200.0f, distance));
+}
+
 entityid_t Player::getEntity() const {
     return eid;
 }
@@ -250,6 +258,7 @@ dv::value Player::serialize() const {
     root["rotation"] = dv::to_value(rotation);
     root["spawnpoint"] = dv::to_value(spawnpoint);
 
+    root["max-interaction-distance"] = maxInteractionDistance;
     root["flight"] = flight;
     root["noclip"] = noclip;
     root["suspended"] = suspended;
@@ -283,6 +292,8 @@ void Player::deserialize(const dv::value& src) {
     const auto& sparr = src["spawnpoint"];
     setSpawnPoint(glm::vec3(
         sparr[0].asNumber(), sparr[1].asNumber(), sparr[2].asNumber()));
+    
+    if (src.has("max-interaction-distance")) maxInteractionDistance = src["max-interaction-distance"].asNumber();
 
     flight = src["flight"].asBoolean();
     noclip = src["noclip"].asBoolean();
diff --git a/src/objects/Player.hpp b/src/objects/Player.hpp
index b9999c78..313966b0 100644
--- a/src/objects/Player.hpp
+++ b/src/objects/Player.hpp
@@ -46,6 +46,7 @@ class Player : public Serializable {
     int64_t id;
     std::string name;
     float speed;
+    
     int chosenSlot;
     glm::vec3 position;
     glm::vec3 spawnpoint {};
@@ -56,6 +57,10 @@ class Player : public Serializable {
     bool infiniteItems = true;
     bool instantDestruction = true;
     bool loadingChunks = true;
+
+    // attributes
+    float maxInteractionDistance = 10.0f;
+
     entityid_t eid = ENTITY_AUTO;
     entityid_t selectedEid = 0;
 
@@ -90,6 +95,7 @@ public:
     void setChosenSlot(int index);
 
     int getChosenSlot() const;
+
     float getSpeed() const;
 
     bool isSuspended() const;
@@ -110,6 +116,9 @@ public:
     bool isLoadingChunks() const;
     void setLoadingChunks(bool flag);
 
+    float getMaxInteractionDistance() const;
+    void setMaxInteractionDistance(float distance);
+
     entityid_t getEntity() const;
     void setEntity(entityid_t eid);
 

From b98954f95e491cf699ec42e183dc2f8e087b3e52 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 26 Sep 2025 22:03:08 +0300
Subject: [PATCH 005/133] cleanup

---
 res/scripts/classes.lua                    | 2 +-
 src/logic/PlayerController.cpp             | 5 ++++-
 src/logic/scripting/lua/libs/libplayer.cpp | 9 +++++----
 src/objects/Player.cpp                     | 2 +-
 src/objects/Player.hpp                     | 2 --
 5 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/res/scripts/classes.lua b/res/scripts/classes.lua
index 23ee45b7..e950aa0d 100644
--- a/res/scripts/classes.lua
+++ b/res/scripts/classes.lua
@@ -289,4 +289,4 @@ network.__process_events = function()
             cleaned = true
         end
     end
-end
\ No newline at end of file
+end
diff --git a/src/logic/PlayerController.cpp b/src/logic/PlayerController.cpp
index 4e63f76d..0ced9425 100644
--- a/src/logic/PlayerController.cpp
+++ b/src/logic/PlayerController.cpp
@@ -488,7 +488,10 @@ void PlayerController::updateInteraction(const Input& inputEvents, float delta)
     }
     const auto& bindings = inputEvents.getBindings();
     bool xkey = bindings.active(BIND_PLAYER_FAST_INTERACTOIN);
-    float maxDistance = xkey ? 200.0f : player.getMaxInteractionDistance();
+    float maxDistance = player.getMaxInteractionDistance();
+    if (xkey) {
+        maxDistance *= 100.0;
+    }
     bool longInteraction = interactionTimer <= 0 || xkey;
     bool lclick = bindings.jactive(BIND_PLAYER_DESTROY) ||
                   (longInteraction && bindings.active(BIND_PLAYER_DESTROY));
diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index a9e18d8e..12c13b3c 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -2,14 +2,14 @@
 #include <glm/glm.hpp>
 
 #include "items/Inventory.hpp"
+#include "libentity.hpp"
 #include "objects/Entities.hpp"
+#include "objects/Entity.hpp"
 #include "objects/Player.hpp"
 #include "objects/Players.hpp"
-#include "objects/Entity.hpp"
 #include "physics/Hitbox.hpp"
 #include "window/Camera.hpp"
 #include "world/Level.hpp"
-#include "libentity.hpp"
 
 using namespace scripting;
 
@@ -53,7 +53,7 @@ static int l_set_vel(lua::State* L) {
     auto x = lua::tonumber(L, 2);
     auto y = lua::tonumber(L, 3);
     auto z = lua::tonumber(L, 4);
-    
+
     if (auto hitbox = player->getHitbox()) {
         hitbox->velocity = glm::vec3(x, y, z);
     }
@@ -190,7 +190,8 @@ static int l_get_interaction_distance(lua::State* L) {
 
 static int l_set_interaction_distance(lua::State* L) {
     if (auto player = get_player(L, 1)) {
-        player->setMaxInteractionDistance( static_cast<float>(lua::tonumber(L, 2)) );
+        player->setMaxInteractionDistance(
+            static_cast<float>(lua::tonumber(L, 2)));
     }
     return 0;
 }
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index 93e86625..363c3f75 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -293,7 +293,7 @@ void Player::deserialize(const dv::value& src) {
     setSpawnPoint(glm::vec3(
         sparr[0].asNumber(), sparr[1].asNumber(), sparr[2].asNumber()));
     
-    if (src.has("max-interaction-distance")) maxInteractionDistance = src["max-interaction-distance"].asNumber();
+    src.at("max-interaction-distance").get(maxInteractionDistance);
 
     flight = src["flight"].asBoolean();
     noclip = src["noclip"].asBoolean();
diff --git a/src/objects/Player.hpp b/src/objects/Player.hpp
index 313966b0..2265dd51 100644
--- a/src/objects/Player.hpp
+++ b/src/objects/Player.hpp
@@ -57,8 +57,6 @@ class Player : public Serializable {
     bool infiniteItems = true;
     bool instantDestruction = true;
     bool loadingChunks = true;
-
-    // attributes
     float maxInteractionDistance = 10.0f;
 
     entityid_t eid = ENTITY_AUTO;

From dba3b62964c97b3878284862a4cf5326b6df0628 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 27 Sep 2025 10:06:22 +0300
Subject: [PATCH 006/133] rename 'max-interaction-distance' to
 'interaction-distance'

---
 src/objects/Player.cpp | 8 ++++----
 src/objects/Player.hpp | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index 363c3f75..f14f9d2d 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -197,11 +197,11 @@ void Player::setLoadingChunks(bool flag) {
 }
 
 float Player::getMaxInteractionDistance() const {
-    return maxInteractionDistance;
+    return interactionDistance;
 }
 
 void Player::setMaxInteractionDistance(float distance) {
-    maxInteractionDistance = std::max(1.0f, std::min(200.0f, distance));
+    interactionDistance = std::max(1.0f, std::min(200.0f, distance));
 }
 
 entityid_t Player::getEntity() const {
@@ -258,7 +258,7 @@ dv::value Player::serialize() const {
     root["rotation"] = dv::to_value(rotation);
     root["spawnpoint"] = dv::to_value(spawnpoint);
 
-    root["max-interaction-distance"] = maxInteractionDistance;
+    root["interaction-distance"] = interactionDistance;
     root["flight"] = flight;
     root["noclip"] = noclip;
     root["suspended"] = suspended;
@@ -293,7 +293,7 @@ void Player::deserialize(const dv::value& src) {
     setSpawnPoint(glm::vec3(
         sparr[0].asNumber(), sparr[1].asNumber(), sparr[2].asNumber()));
     
-    src.at("max-interaction-distance").get(maxInteractionDistance);
+    src.at("interaction-distance").get(interactionDistance);
 
     flight = src["flight"].asBoolean();
     noclip = src["noclip"].asBoolean();
diff --git a/src/objects/Player.hpp b/src/objects/Player.hpp
index 2265dd51..7d6523f2 100644
--- a/src/objects/Player.hpp
+++ b/src/objects/Player.hpp
@@ -57,7 +57,7 @@ class Player : public Serializable {
     bool infiniteItems = true;
     bool instantDestruction = true;
     bool loadingChunks = true;
-    float maxInteractionDistance = 10.0f;
+    float interactionDistance = 10.0f;
 
     entityid_t eid = ENTITY_AUTO;
     entityid_t selectedEid = 0;

From b6ca7cf91855241c0b591d52711a9b55738d5f6b Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Tue, 30 Sep 2025 23:45:00 +0300
Subject: [PATCH 007/133] make Nagle's algorithm configurable

---
 doc/ru/scripting/builtins/libnetwork.md     |  6 ++++++
 res/scripts/classes.lua                     |  2 ++
 src/logic/scripting/lua/libs/libnetwork.cpp | 24 +++++++++++++++++++++
 src/network/Network.cpp                     | 16 ++++++++++++++
 src/network/Network.hpp                     |  2 ++
 5 files changed, 50 insertions(+)

diff --git a/doc/ru/scripting/builtins/libnetwork.md b/doc/ru/scripting/builtins/libnetwork.md
index c9cc890c..16f9dd5c 100644
--- a/doc/ru/scripting/builtins/libnetwork.md
+++ b/doc/ru/scripting/builtins/libnetwork.md
@@ -72,6 +72,12 @@ socket:is_connected() --> bool
 
 -- Возвращает адрес и порт соединения.
 socket:get_address() --> str, int
+
+-- Возвращает состояние NoDelay
+socket:get_nodelay() --> bool
+
+-- Устанавливает состояние NoDelay
+socket:set_nodelay(state: bool)
 ```
 
 ```lua
diff --git a/res/scripts/classes.lua b/res/scripts/classes.lua
index e63d5a5a..0d422b04 100644
--- a/res/scripts/classes.lua
+++ b/res/scripts/classes.lua
@@ -44,6 +44,8 @@ local Socket = {__index={
     is_alive=function(self) return network.__is_alive(self.id) end,
     is_connected=function(self) return network.__is_connected(self.id) end,
     get_address=function(self) return network.__get_address(self.id) end,
+    set_nodelay=function(self, nodelay) return network.__set_nodelay(self.id, nodelay or false) end,
+    get_nodelay=function(self) return network.__get_nodelay(self.id) end,
 }}
 
 local WriteableSocket = {__index={
diff --git a/src/logic/scripting/lua/libs/libnetwork.cpp b/src/logic/scripting/lua/libs/libnetwork.cpp
index 94390c93..af7dedef 100644
--- a/src/logic/scripting/lua/libs/libnetwork.cpp
+++ b/src/logic/scripting/lua/libs/libnetwork.cpp
@@ -382,6 +382,28 @@ static int l_get_total_download(lua::State* L, network::Network& network) {
     return lua::pushinteger(L, network.getTotalDownload());
 }
 
+static int l_set_nodelay(lua::State* L, network::Network& network) {
+    u64id_t id = lua::tointeger(L, 1);
+    bool noDelay = lua::toboolean(L, 2);
+    if (auto connection = network.getConnection(id)) {
+        if (connection->getTransportType() == network::TransportType::TCP) {
+            dynamic_cast<network::TcpConnection*>(connection)->setNoDelay(noDelay);
+        }
+    }
+    return 0;
+}
+
+static int l_get_nodelay(lua::State* L, network::Network& network) {
+    u64id_t id = lua::tointeger(L, 1);
+    if (auto connection = network.getConnection(id)) {
+        if (connection->getTransportType() == network::TransportType::TCP) {
+            bool noDelay = dynamic_cast<network::TcpConnection*>(connection)->getNoDelay();
+            return lua::pushboolean(L, noDelay);
+        }
+    }
+    return lua::pushboolean(L, false);
+}
+
 static int l_pull_events(lua::State* L, network::Network& network) {
     lua::createtable(L, events_queue.size(), 0);
 
@@ -458,5 +480,7 @@ const luaL_Reg networklib[] = {
     {"__get_address", wrap<l_get_address>},
     {"__is_serveropen", wrap<l_is_serveropen>},
     {"__get_serverport", wrap<l_get_serverport>},
+    {"__set_nodelay", wrap<l_set_nodelay>},
+    {"__get_nodelay", wrap<l_get_nodelay>},
     {NULL, NULL}
 };
diff --git a/src/network/Network.cpp b/src/network/Network.cpp
index 234197e4..337193ed 100644
--- a/src/network/Network.cpp
+++ b/src/network/Network.cpp
@@ -329,6 +329,22 @@ public:
         }
     }
 
+    void setNoDelay(bool noDelay) override {
+        int opt = noDelay ? 1 : 0;
+        if (setsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, sizeof(opt)) < 0) {
+            throw handle_socket_error("setsockopt(TCP_NODELAY) failed");
+        }
+    }
+
+    bool getNoDelay() const override {
+        int opt = 0;
+        socklen_t len = sizeof(opt);
+        if (getsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, &len) < 0) {
+            throw handle_socket_error("getsockopt(TCP_NODELAY) failed");
+        }
+        return opt != 0;
+    }
+
     void startListen() {
         while (state == ConnectionState::CONNECTED) {
             int size = recvsocket(descriptor, buffer.data(), buffer.size());
diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index ddde70b5..5074bcab 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -76,6 +76,8 @@ namespace network {
         virtual void connect(runnable callback) = 0;
         virtual int recv(char* buffer, size_t length) = 0;
         virtual int available() = 0;
+        virtual void setNoDelay(bool noDelay) = 0;
+        [[nodiscard]] virtual bool getNoDelay() const = 0;
 
         [[nodiscard]] TransportType getTransportType() const noexcept override {
             return TransportType::TCP;

From b30b19e836fc7f85d05b12cafd542ad84145ccbc Mon Sep 17 00:00:00 2001
From: ChancellorIkseew <156004311+ChancellorIkseew@users.noreply.github.com>
Date: Wed, 1 Oct 2025 06:53:15 +1000
Subject: [PATCH 008/133] Add borderless window mode (from tasks) (#630)

---
 res/layouts/pages/settings_display.xml.lua | 10 +++++-
 src/engine/Engine.cpp                      | 15 ++++++---
 src/io/settings_io.cpp                     |  2 +-
 src/settings.hpp                           |  4 +--
 src/window/Window.hpp                      | 11 +++++--
 src/window/detail/GLFWWindow.cpp           | 36 +++++++++++++---------
 6 files changed, 53 insertions(+), 25 deletions(-)

diff --git a/res/layouts/pages/settings_display.xml.lua b/res/layouts/pages/settings_display.xml.lua
index f8b24d0b..5dd88a88 100644
--- a/res/layouts/pages/settings_display.xml.lua
+++ b/res/layouts/pages/settings_display.xml.lua
@@ -53,10 +53,18 @@ function create_checkbox(id, name, tooltip)
     ))
 end
 
+function create_selectbox(id, name, tooltip)
+    tooltip = tooltip or ''
+    document.root:add(string.format(
+        "<selectbox consumer='function(x) core.set_setting(\"%s\", x) end' checked='%s' tooltip='%s'>%s</checkbox>", 
+        id, core.str_setting(id), gui.str(tooltip, "settings"), gui.str(name, "settings")
+    ))
+end
+
 function on_open()
     create_setting("camera.fov", "FOV", 1, "°")
     create_setting("display.framerate", "Framerate", 1, "", "", true)
-    create_checkbox("display.fullscreen", "Fullscreen")
+    --create_checkbox("display.fullscreen", "Fullscreen")
     create_checkbox("camera.shaking", "Camera Shaking")
     create_checkbox("camera.inertia", "Camera Inertia")
     create_checkbox("camera.fov-effects", "Camera FOV Effects")
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 212765f3..d2a4eb20 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -135,10 +135,11 @@ void Engine::initializeClient() {
     if (ENGINE_DEBUG_BUILD) {
         menus::create_version_label(*gui);
     }
-    keepAlive(settings.display.fullscreen.observe(
-        [this](bool value) {
-            if (value != this->window->isFullscreen()) {
-                this->window->toggleFullscreen();
+    keepAlive(settings.display.windowMode.observe(
+        [this](int value) {
+            WindowMode mode = static_cast<WindowMode>(value);
+            if (mode != this->window->getMode()) {
+                this->window->setMode(mode);
             }
         },
         true
@@ -237,7 +238,11 @@ void Engine::updateHotkeys() {
         gui->toggleDebug();
     }
     if (input->jpressed(Keycode::F11)) {
-        settings.display.fullscreen.toggle();
+        if (settings.display.windowMode.get() != static_cast<int>(WindowMode::FULLSCREEN)) {
+            settings.display.windowMode.set(static_cast<int>(WindowMode::FULLSCREEN));
+        } else {
+            settings.display.windowMode.set(static_cast<int>(WindowMode::WINDOWED));
+        }
     }
 }
 
diff --git a/src/io/settings_io.cpp b/src/io/settings_io.cpp
index ea9a7bf5..5e1c8327 100644
--- a/src/io/settings_io.cpp
+++ b/src/io/settings_io.cpp
@@ -49,8 +49,8 @@ SettingsHandler::SettingsHandler(EngineSettings& settings) {
     builder.add("height", &settings.display.height);
     builder.add("samples", &settings.display.samples);
     builder.add("framerate", &settings.display.framerate);
-    builder.add("fullscreen", &settings.display.fullscreen);
     builder.add("limit-fps-iconified", &settings.display.limitFpsIconified);
+    builder.add("window-mode", &settings.display.windowMode);
 
     builder.section("camera");
     builder.add("sensitivity", &settings.camera.sensitivity);
diff --git a/src/settings.hpp b/src/settings.hpp
index 52827d1c..f97fb513 100644
--- a/src/settings.hpp
+++ b/src/settings.hpp
@@ -19,8 +19,8 @@ struct AudioSettings {
 };
 
 struct DisplaySettings {
-    /// @brief Is window in full screen mode
-    FlagSetting fullscreen {false};
+    /// @brief Window mode (windowed/fullscreen/borderless)
+    IntegerSetting windowMode {0, 0, 2};
     /// @brief Window width (pixels)
     IntegerSetting width {1280};
     /// @brief Window height (pixels)
diff --git a/src/window/Window.hpp b/src/window/Window.hpp
index 8800be8c..135e4f7d 100644
--- a/src/window/Window.hpp
+++ b/src/window/Window.hpp
@@ -10,6 +10,12 @@ class ImageData;
 class Input;
 struct DisplaySettings;
 
+enum class WindowMode {
+    WINDOWED,
+    FULLSCREEN,
+    BORDERLESS
+};
+
 class Window {
 public:
     Window(glm::ivec2 size) : size(std::move(size)) {}
@@ -25,8 +31,8 @@ public:
     virtual void setShouldClose(bool flag) = 0;
 
     virtual void setCursor(CursorShape shape) = 0;
-    virtual void toggleFullscreen() = 0;
-    virtual bool isFullscreen() const = 0;
+    virtual void setMode(WindowMode mode) = 0;
+    virtual WindowMode getMode() const = 0;
 
     virtual void setIcon(const ImageData* image) = 0;
 
@@ -51,6 +57,7 @@ public:
     > initialize(DisplaySettings* settings, std::string title);
 protected:
     glm::ivec2 size;
+    WindowMode mode = WindowMode::WINDOWED;
 };
 
 namespace display {
diff --git a/src/window/detail/GLFWWindow.cpp b/src/window/detail/GLFWWindow.cpp
index accd969f..7685be7c 100644
--- a/src/window/detail/GLFWWindow.cpp
+++ b/src/window/detail/GLFWWindow.cpp
@@ -406,21 +406,28 @@ public:
         glfwSetCursor(window, standard_cursors[static_cast<int>(shape)]);
     }
 
-    void toggleFullscreen() override {
-        fullscreen = !fullscreen;
-    
+    void setMode(WindowMode mode) override {
+        Window::mode = mode;
         GLFWmonitor* monitor = glfwGetPrimaryMonitor();
-        const GLFWvidmode* mode = glfwGetVideoMode(monitor);
+        const GLFWvidmode* glfwMode = glfwGetVideoMode(monitor);
     
         if (input.isCursorLocked()){
             input.toggleCursor();
         }
-    
-        if (fullscreen) {
+
+        if (mode == WindowMode::FULLSCREEN) {
+            const int width = glfwMode->width;
+            const int height = glfwMode->height;
+            const int refreshRate = glfwMode->refreshRate;
             glfwGetWindowPos(window, &posX, &posY);
-            glfwSetWindowMonitor(
-                window, monitor, 0, 0, mode->width, mode->height, mode->refreshRate
-            );
+            glfwSetWindowMonitor(window, monitor, 0, 0, width, height, refreshRate);
+        }
+        else if(mode == WindowMode::BORDERLESS) {
+            glfwGetWindowPos(window, &posX, &posY);
+            glfwSetWindowAttrib(window, GLFW_DECORATED, GLFW_FALSE);
+            glfwSetWindowAttrib(window, GLFW_RESIZABLE, GLFW_FALSE);
+            glfwSetWindowSize(window, glfwMode->width, glfwMode->height);
+            glfwSetWindowPos(window, 0, 0);
         } else {
             glfwSetWindowMonitor(
                 window,
@@ -431,6 +438,8 @@ public:
                 settings->height.get(),
                 GLFW_DONT_CARE
             );
+            glfwSetWindowAttrib(window, GLFW_DECORATED, GLFW_TRUE);
+            glfwSetWindowAttrib(window, GLFW_RESIZABLE, GLFW_TRUE);
             window_size_callback(window, settings->width.get(), settings->height.get());
         }
     
@@ -439,8 +448,8 @@ public:
         input.setCursorPosition(xPos, yPos);
     }
 
-    bool isFullscreen() const override {
-        return fullscreen;
+    WindowMode getMode() const override {
+        return mode;
     }
 
     void setIcon(const ImageData* image) override {
@@ -459,7 +468,7 @@ public:
         glViewport(0, 0, width, height);
         size = {width, height};
 
-        if (!isFullscreen() && !isMaximized()) {
+        if (mode == WindowMode::WINDOWED && !isMaximized()) {
             settings->width.set(width);
             settings->height.set(height);
         }
@@ -542,7 +551,6 @@ public:
 private:
     GLFWwindow* window;
     CursorShape cursor = CursorShape::ARROW;
-    bool fullscreen = false;
     int framerate = -1;
     std::stack<glm::vec4> scissorStack;
     glm::vec4 scissorArea;
@@ -600,7 +608,7 @@ static void cursor_pos_callback(GLFWwindow* window, double xpos, double ypos) {
 
 static void iconify_callback(GLFWwindow* window, int iconified) {
     auto handler = static_cast<GLFWWindow*>(glfwGetWindowUserPointer(window));
-    if (handler->isFullscreen() && iconified == 0) {
+    if (handler->getMode() == WindowMode::FULLSCREEN && iconified == 0) {
         GLFWmonitor* monitor = glfwGetPrimaryMonitor();
         const GLFWvidmode* mode = glfwGetVideoMode(monitor);
         glfwSetWindowMonitor(

From 070424077af47b49f242b9d5ffd8e930a569bc94 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 1 Oct 2025 00:06:07 +0300
Subject: [PATCH 009/133] add window type selection to settings menu

---
 res/layouts/pages/settings_display.xml.lua | 17 +++++++++--------
 res/texts/ru_RU.txt                        |  2 ++
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/res/layouts/pages/settings_display.xml.lua b/res/layouts/pages/settings_display.xml.lua
index 5dd88a88..6934cef6 100644
--- a/res/layouts/pages/settings_display.xml.lua
+++ b/res/layouts/pages/settings_display.xml.lua
@@ -53,18 +53,19 @@ function create_checkbox(id, name, tooltip)
     ))
 end
 
-function create_selectbox(id, name, tooltip)
-    tooltip = tooltip or ''
-    document.root:add(string.format(
-        "<selectbox consumer='function(x) core.set_setting(\"%s\", x) end' checked='%s' tooltip='%s'>%s</checkbox>", 
-        id, core.str_setting(id), gui.str(tooltip, "settings"), gui.str(name, "settings")
-    ))
-end
 
 function on_open()
     create_setting("camera.fov", "FOV", 1, "°")
     create_setting("display.framerate", "Framerate", 1, "", "", true)
-    --create_checkbox("display.fullscreen", "Fullscreen")
+
+    document.root:add(string.format(
+        "<select context='settings' onselect='function(opt) core.set_setting(\"display.window-mode\", tonumber(opt)) end' selected='%s'>"..
+            "<option value='0'>@Windowed</option>"..
+            "<option value='1'>@Fullscreen</option>"..
+            "<option value='2'>@Borderless</option>"..
+        "</select>", core.get_setting("display.window-mode"))
+    )
+
     create_checkbox("camera.shaking", "Camera Shaking")
     create_checkbox("camera.inertia", "Camera Inertia")
     create_checkbox("camera.fov-effects", "Camera FOV Effects")
diff --git a/res/texts/ru_RU.txt b/res/texts/ru_RU.txt
index 084e11b3..8d6a152c 100644
--- a/res/texts/ru_RU.txt
+++ b/res/texts/ru_RU.txt
@@ -102,6 +102,8 @@ settings.Limit Background FPS=Ограничить фоновую частоту
 settings.Advanced render=Продвинутый рендер
 settings.Shadows quality=Качество теней
 settings.Conflict=Найдены возможные конфликты
+settings.Windowed=Оконный
+settings.Borderless=Безрамочный
 
 # Управление
 chunks.reload=Перезагрузить Чанки

From 516e62eade2c310e63febc9493a9f19679db5db2 Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Wed, 1 Oct 2025 00:56:39 +0300
Subject: [PATCH 010/133] Fix file.gzip

---
 src/logic/scripting/lua/libs/libfile.cpp | 28 ++++++++++--------------
 1 file changed, 12 insertions(+), 16 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libfile.cpp b/src/logic/scripting/lua/libs/libfile.cpp
index f5cb2bfc..191f6371 100644
--- a/src/logic/scripting/lua/libs/libfile.cpp
+++ b/src/logic/scripting/lua/libs/libfile.cpp
@@ -189,30 +189,26 @@ static int l_list(lua::State* L) {
 }
 
 static int l_gzip_compress(lua::State* L) {
-    std::vector<ubyte> bytes;
+    auto string = lua::bytearray_as_string(L, 1);
 
-    lua::read_bytes_from_table(L, 1, bytes);
-    auto compressed_bytes = gzip::compress(bytes.data(), bytes.size());
-    int newTable = lua::gettop(L);
+    auto compressedBytes = gzip::compress(
+        reinterpret_cast<const ubyte*>(string.data()),
+        string.size()
+    );
 
-    for (size_t i = 0; i < compressed_bytes.size(); i++) {
-        lua::pushinteger(L, compressed_bytes.data()[i]);
-        lua::rawseti(L, i + 1, newTable);
-    }
+    lua::create_bytearray(L, std::move(compressedBytes));
     return 1;
 }
 
 static int l_gzip_decompress(lua::State* L) {
-    std::vector<ubyte> bytes;
+    auto string = lua::bytearray_as_string(L, 1);
 
-    lua::read_bytes_from_table(L, 1, bytes);
-    auto decompressed_bytes = gzip::decompress(bytes.data(), bytes.size());
-    int newTable = lua::gettop(L);
+    auto decompressedBytes = gzip::decompress(
+        reinterpret_cast<const ubyte*>(string.data()),
+        string.size()
+    );
 
-    for (size_t i = 0; i < decompressed_bytes.size(); i++) {
-        lua::pushinteger(L, decompressed_bytes.data()[i]);
-        lua::rawseti(L, i + 1, newTable);
-    }
+    lua::create_bytearray(L, std::move(decompressedBytes));
     return 1;
 }
 

From 1f049c2fd04586795a3013a2979064cea5fa002a Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Wed, 1 Oct 2025 01:05:30 +0300
Subject: [PATCH 011/133] change "get" to "is"

---
 doc/ru/scripting/builtins/libnetwork.md     | 2 +-
 res/scripts/classes.lua                     | 2 +-
 src/logic/scripting/lua/libs/libnetwork.cpp | 6 +++---
 src/network/Network.cpp                     | 2 +-
 src/network/Network.hpp                     | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/ru/scripting/builtins/libnetwork.md b/doc/ru/scripting/builtins/libnetwork.md
index 69fe42d5..bef8967c 100644
--- a/doc/ru/scripting/builtins/libnetwork.md
+++ b/doc/ru/scripting/builtins/libnetwork.md
@@ -95,7 +95,7 @@ socket:is_connected() --> bool
 socket:get_address() --> str, int
 
 -- Возвращает состояние NoDelay
-socket:get_nodelay() --> bool
+socket:is_nodelay() --> bool
 
 -- Устанавливает состояние NoDelay
 socket:set_nodelay(state: bool)
diff --git a/res/scripts/classes.lua b/res/scripts/classes.lua
index d7c93f31..3e102515 100644
--- a/res/scripts/classes.lua
+++ b/res/scripts/classes.lua
@@ -45,7 +45,7 @@ local Socket = {__index={
     is_connected=function(self) return network.__is_connected(self.id) end,
     get_address=function(self) return network.__get_address(self.id) end,
     set_nodelay=function(self, nodelay) return network.__set_nodelay(self.id, nodelay or false) end,
-    get_nodelay=function(self) return network.__get_nodelay(self.id) end,
+    is_nodelay=function(self) return network.__is_nodelay(self.id) end,
 }}
 
 local WriteableSocket = {__index={
diff --git a/src/logic/scripting/lua/libs/libnetwork.cpp b/src/logic/scripting/lua/libs/libnetwork.cpp
index 08542a54..a78f17db 100644
--- a/src/logic/scripting/lua/libs/libnetwork.cpp
+++ b/src/logic/scripting/lua/libs/libnetwork.cpp
@@ -413,11 +413,11 @@ static int l_set_nodelay(lua::State* L, network::Network& network) {
     return 0;
 }
 
-static int l_get_nodelay(lua::State* L, network::Network& network) {
+static int l_is_nodelay(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
     if (auto connection = network.getConnection(id)) {
         if (connection->getTransportType() == network::TransportType::TCP) {
-            bool noDelay = dynamic_cast<network::TcpConnection*>(connection)->getNoDelay();
+            bool noDelay = dynamic_cast<network::TcpConnection*>(connection)->isNoDelay();
             return lua::pushboolean(L, noDelay);
         }
     }
@@ -540,6 +540,6 @@ const luaL_Reg networklib[] = {
     {"__is_serveropen", wrap<l_is_serveropen>},
     {"__get_serverport", wrap<l_get_serverport>},
     {"__set_nodelay", wrap<l_set_nodelay>},
-    {"__get_nodelay", wrap<l_get_nodelay>},
+    {"__is_nodelay", wrap<l_is_nodelay>},
     {NULL, NULL}
 };
diff --git a/src/network/Network.cpp b/src/network/Network.cpp
index f999abdf..50534c9b 100644
--- a/src/network/Network.cpp
+++ b/src/network/Network.cpp
@@ -362,7 +362,7 @@ public:
         }
     }
 
-    bool getNoDelay() const override {
+    bool isNoDelay() const override {
         int opt = 0;
         socklen_t len = sizeof(opt);
         if (getsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, &len) < 0) {
diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index 40c8ed3f..3fec46e0 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -78,7 +78,7 @@ namespace network {
         virtual int recv(char* buffer, size_t length) = 0;
         virtual int available() = 0;
         virtual void setNoDelay(bool noDelay) = 0;
-        [[nodiscard]] virtual bool getNoDelay() const = 0;
+        [[nodiscard]] virtual bool isNoDelay() const = 0;
 
         [[nodiscard]] TransportType getTransportType() const noexcept override {
             return TransportType::TCP;

From fd8d2c22e5fb8ae4a392bab5bf6d721918ee7f43 Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Wed, 1 Oct 2025 19:01:53 +0300
Subject: [PATCH 012/133] fixes

---
 src/logic/scripting/lua/libs/libfile.cpp | 42 ++++++++++++++++++------
 1 file changed, 32 insertions(+), 10 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libfile.cpp b/src/logic/scripting/lua/libs/libfile.cpp
index 191f6371..eb81fd85 100644
--- a/src/logic/scripting/lua/libs/libfile.cpp
+++ b/src/logic/scripting/lua/libs/libfile.cpp
@@ -189,26 +189,48 @@ static int l_list(lua::State* L) {
 }
 
 static int l_gzip_compress(lua::State* L) {
-    auto string = lua::bytearray_as_string(L, 1);
-
+    char argc = lua_gettop(L);
+    auto str = lua::bytearray_as_string(L, 1);
     auto compressedBytes = gzip::compress(
-        reinterpret_cast<const ubyte*>(string.data()),
-        string.size()
+        reinterpret_cast<const ubyte*>(str.data()),
+        str.size()
     );
 
-    lua::create_bytearray(L, std::move(compressedBytes));
+    if (argc < 2 || !lua::toboolean(L, 2)) {
+        lua::create_bytearray(L, std::move(compressedBytes));
+    } else {
+        size_t length = compressedBytes.size();
+        lua::createtable(L, length, 0);
+        int newTable = lua::gettop(L);
+        for (size_t i = 0; i < length; i++) {
+            lua::pushinteger(L, compressedBytes.data()[i]);
+            lua::rawseti(L, i + 1, newTable);
+        }
+    }
+
     return 1;
 }
 
 static int l_gzip_decompress(lua::State* L) {
-    auto string = lua::bytearray_as_string(L, 1);
-
+    char argc = lua_gettop(L);
+    auto str = lua::bytearray_as_string(L, 1);
     auto decompressedBytes = gzip::decompress(
-        reinterpret_cast<const ubyte*>(string.data()),
-        string.size()
+        reinterpret_cast<const ubyte*>(str.data()),
+        str.size()
     );
 
-    lua::create_bytearray(L, std::move(decompressedBytes));
+    if (argc < 2 || !lua::toboolean(L, 2)) {
+        lua::create_bytearray(L, std::move(decompressedBytes));
+    } else {
+        size_t length = decompressedBytes.size();
+        lua::createtable(L, length, 0);
+        int newTable = lua::gettop(L);
+        for (size_t i = 0; i < length; i++) {
+            lua::pushinteger(L, decompressedBytes.data()[i]);
+            lua::rawseti(L, i + 1, newTable);
+        }
+    }
+
     return 1;
 }
 

From ab60e7b835a9de7a4897b974c969d272acfbdb1d Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Wed, 1 Oct 2025 19:05:25 +0300
Subject: [PATCH 013/133] Update libfile.md

---
 doc/ru/scripting/builtins/libfile.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/ru/scripting/builtins/libfile.md b/doc/ru/scripting/builtins/libfile.md
index e06e420c..1aa51f5e 100644
--- a/doc/ru/scripting/builtins/libfile.md
+++ b/doc/ru/scripting/builtins/libfile.md
@@ -43,6 +43,18 @@ file.write_bytes(путь: str, data: array of integers)
 
 Записывает массив байт в файл (с перезаписью)
 
+```python
+file.gzip_compress(data: array of integers, [опционально] usetable) -> array of integers
+```
+
+Сжимает массив байт алгоритмом gzip. При значении usetable = false возвращает Bytearray вместо table.
+
+```python
+file.gzip_decompress(data: array of integers, [опционально] usetable) -> array of integers
+```
+
+Разжимает массив байт, который был сжат алгоритмом gzip. При значении usetable = false возвращает Bytearray вместо table.
+
 ```python
 file.length(путь: str) -> int
 ```
@@ -205,4 +217,4 @@ file.open_named_pipe(имя: str, режим: str) -> io_stream
 
 `/tmp/` или `\\\\.\\pipe\\` добавлять не нужно - движок делает это автоматически.
 
-Доступные режимы такие же, как и в `file.open`, за исключением `+`
\ No newline at end of file
+Доступные режимы такие же, как и в `file.open`, за исключением `+`

From 8eeb9f5fdef801ef1d83fde78452ce32be2a4a13 Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Wed, 1 Oct 2025 19:14:43 +0300
Subject: [PATCH 014/133] change lua_gettop to lua::gettop

---
 src/logic/scripting/lua/libs/libfile.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libfile.cpp b/src/logic/scripting/lua/libs/libfile.cpp
index eb81fd85..a616718e 100644
--- a/src/logic/scripting/lua/libs/libfile.cpp
+++ b/src/logic/scripting/lua/libs/libfile.cpp
@@ -189,7 +189,7 @@ static int l_list(lua::State* L) {
 }
 
 static int l_gzip_compress(lua::State* L) {
-    char argc = lua_gettop(L);
+    char argc = lua::gettop(L);
     auto str = lua::bytearray_as_string(L, 1);
     auto compressedBytes = gzip::compress(
         reinterpret_cast<const ubyte*>(str.data()),
@@ -212,7 +212,7 @@ static int l_gzip_compress(lua::State* L) {
 }
 
 static int l_gzip_decompress(lua::State* L) {
-    char argc = lua_gettop(L);
+    char argc = lua::gettop(L);
     auto str = lua::bytearray_as_string(L, 1);
     auto decompressedBytes = gzip::decompress(
         reinterpret_cast<const ubyte*>(str.data()),
@@ -454,3 +454,4 @@ const luaL_Reg filelib[] = {
     {"__close_all_descriptors", lua::wrap<l_close_all_descriptors>},
     {NULL, NULL}
 };
+

From dbab645c94f128180e6066645e81b7927f111503 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 2 Oct 2025 19:40:05 +0300
Subject: [PATCH 015/133] add 'tps' command line argument

---
 src/engine/Engine.hpp         |  1 +
 src/engine/ServerMainloop.cpp |  4 +---
 src/util/ArgsReader.hpp       |  9 +++++++++
 src/util/command_line.cpp     | 33 +++++++++++++++++++++++----------
 4 files changed, 34 insertions(+), 13 deletions(-)

diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 98bcd497..1f9438c0 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -50,6 +50,7 @@ struct CoreParameters {
     std::filesystem::path userFolder = ".";
     std::filesystem::path scriptFile;
     std::filesystem::path projectFolder;
+    int tps = 20;
 };
 
 using OnWorldOpen = std::function<void(std::unique_ptr<Level>, int64_t)>;
diff --git a/src/engine/ServerMainloop.cpp b/src/engine/ServerMainloop.cpp
index 27c35bdd..2f446533 100644
--- a/src/engine/ServerMainloop.cpp
+++ b/src/engine/ServerMainloop.cpp
@@ -15,8 +15,6 @@ using namespace std::chrono;
 
 static debug::Logger logger("mainloop");
 
-inline constexpr int TPS = 20;
-
 ServerMainloop::ServerMainloop(Engine& engine) : engine(engine) {
 }
 
@@ -39,7 +37,7 @@ void ServerMainloop::run() {
         "script:" + coreParams.scriptFile.filename().u8string()
     );
 
-    double targetDelta = 1.0 / static_cast<double>(TPS);
+    double targetDelta = 1.0 / static_cast<double>(coreParams.tps);
     double delta = targetDelta;
     auto begin = system_clock::now();
     auto startupTime = begin;
diff --git a/src/util/ArgsReader.hpp b/src/util/ArgsReader.hpp
index 90d159f5..4c845376 100644
--- a/src/util/ArgsReader.hpp
+++ b/src/util/ArgsReader.hpp
@@ -33,5 +33,14 @@ namespace util {
             last = argv[pos];
             return argv[pos++];
         }
+
+        int nextInt() {
+            auto text = next();
+            try {
+                return std::stoi(text);
+            } catch (const std::exception& e) {
+                throw std::runtime_error(e.what());
+            }
+        }
     };
 }
diff --git a/src/util/command_line.cpp b/src/util/command_line.cpp
index 8f8c981b..6d84ab28 100644
--- a/src/util/command_line.cpp
+++ b/src/util/command_line.cpp
@@ -4,6 +4,7 @@
 #include <functional>
 #include <vector>
 #include <string>
+#include <iomanip>
 
 #include "io/engine_paths.hpp"
 #include "util/ArgsReader.hpp"
@@ -15,10 +16,17 @@ class ArgC {
     public:
         std::string keyword;
         std::function<bool()> execute;
+        std::string args;
         std::string help;
-        ArgC(const std::string& keyword, std::function<bool()> execute, const std::string& help) {
+        ArgC(
+            const std::string& keyword,
+            std::function<bool()> execute,
+            const std::string& args,
+            const std::string& help
+        ) {
             this->keyword = keyword;
             this->execute = execute;
+            this->args = args;
             this->help = help;
         }
 };
@@ -31,42 +39,47 @@ static bool perform_keyword(
         ArgC("--res", [&params, &reader]() -> bool {
             params.resFolder = reader.next();
             return true;
-        }, "<path> - set resources directory."),
+        }, "<path>", "set resources directory."),
         ArgC("--dir", [&params, &reader]() -> bool {
             params.userFolder = reader.next();
             return true;
-        }, "<path> - set userfiles directory."),
+        }, "<path>", "set userfiles directory."),
         ArgC("--project", [&params, &reader]() -> bool {
             params.projectFolder = reader.next();
             return true;
-        }, "<path> - set project directory."),
+        }, "<path>", "set project directory."),
         ArgC("--test", [&params, &reader]() -> bool {
             params.testMode = true;
             params.scriptFile = reader.next();
             return true;
-        }, "<path> - test script file."),
+        }, "<path>", "test script file."),
         ArgC("--script", [&params, &reader]() -> bool {
             params.testMode = false;
             params.scriptFile = reader.next();
             return true;
-        }, "<path> - main script file."),
+        }, "<path>", "main script file."),
         ArgC("--headless", [&params]() -> bool {
             params.headless = true;
             return true;
-        }, "- run in headless mode."),
+        }, "", "run in headless mode."),
+        ArgC("--tps", [&params, &reader]() -> bool {
+            params.tps = reader.nextInt();
+            return true;
+        }, "<tps>", "headless mode tick-rate (default - 20)."),
         ArgC("--version", []() -> bool {
             std::cout << ENGINE_VERSION_STRING << std::endl;
             return false;
-        }, "- display the engine version."),
+        }, "", "display the engine version."),
         ArgC("--help", []() -> bool {
             std::cout << "VoxelCore v" << ENGINE_VERSION_STRING << "\n\n";
             std::cout << "Command-line arguments:\n";
             for (auto& a : argumentsCommandline) {
-                std::cout << a.keyword << " " << a.help << std::endl;
+                std::cout << std::setw(20) << std::left << (a.keyword + " " + a.args);
+                std::cout << "- " << a.help << std::endl;
             }
             std::cout << std::endl;
             return false;
-        }, "- display this help.")
+        }, "", "display this help.")
     };
     for (auto& a : argumentsCommandline) {
         if (a.keyword == keyword) {

From b95d3f0779f7464842493e363c733244d76c85a2 Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Thu, 2 Oct 2025 22:41:53 +0300
Subject: [PATCH 016/133] make compression lib

---
 src/logic/scripting/lua/libs/api_lua.hpp      |  1 +
 .../scripting/lua/libs/libcompression.cpp     | 84 +++++++++++++++++++
 src/logic/scripting/lua/libs/libfile.cpp      | 48 -----------
 src/logic/scripting/lua/lua_engine.cpp        |  1 +
 4 files changed, 86 insertions(+), 48 deletions(-)
 create mode 100644 src/logic/scripting/lua/libs/libcompression.cpp

diff --git a/src/logic/scripting/lua/libs/api_lua.hpp b/src/logic/scripting/lua/libs/api_lua.hpp
index 6c24d9d4..e304d6dc 100644
--- a/src/logic/scripting/lua/libs/api_lua.hpp
+++ b/src/logic/scripting/lua/libs/api_lua.hpp
@@ -43,6 +43,7 @@ extern const luaL_Reg playerlib[];
 extern const luaL_Reg posteffectslib[]; // gfx.posteffects
 extern const luaL_Reg quatlib[];
 extern const luaL_Reg randomlib[];
+extern const luaL_Reg compressionlib[];
 extern const luaL_Reg text3dlib[]; // gfx.text3d
 extern const luaL_Reg timelib[];
 extern const luaL_Reg tomllib[];
diff --git a/src/logic/scripting/lua/libs/libcompression.cpp b/src/logic/scripting/lua/libs/libcompression.cpp
new file mode 100644
index 00000000..c212f42e
--- /dev/null
+++ b/src/logic/scripting/lua/libs/libcompression.cpp
@@ -0,0 +1,84 @@
+#include "api_lua.hpp"
+#include "coders/gzip.hpp"
+#include "../lua_engine.hpp"
+
+static int l_encode(lua::State* L) {
+    char argc = lua::gettop(L);
+    std::vector<unsigned char> compressedBytes;
+
+    std::string algo = "gzip";
+    if (argc >= 2) {
+        if (!lua::isstring(L, 2)) {
+            throw std::runtime_error("compression algorithm must be a string");
+        }
+        algo = lua::require_lstring(L, 2);
+    }
+
+    if (algo == "gzip") {
+        auto str = lua::bytearray_as_string(L, 1);
+        compressedBytes = gzip::compress(
+            reinterpret_cast<const ubyte*>(str.data()),
+            str.size()
+        );
+    } else {
+        throw std::runtime_error("unsupported compression algorithm");
+    }
+
+    if (argc < 3 || !lua::toboolean(L, 3)) {
+        lua::create_bytearray(L, std::move(compressedBytes));
+    } else {
+        size_t length = compressedBytes.size();
+        lua::createtable(L, length, 0);
+        int newTable = lua::gettop(L);
+        for (size_t i = 0; i < length; i++) {
+            lua::pushinteger(L, compressedBytes.data()[i]);
+            lua::rawseti(L, i + 1, newTable);
+        }
+    }
+
+    return 1;
+}
+
+static int l_decode(lua::State* L) {
+    char argc = lua::gettop(L);
+    std::vector<unsigned char> decompressedBytes;
+
+    std::string algo = "gzip";
+    if (argc >= 2) {
+        if (!lua::isstring(L, 2)) {
+            throw std::runtime_error("compression algorithm must be a string");
+        }
+        algo = lua::require_lstring(L, 2);
+    }
+
+    if (algo == "gzip") {
+        auto str = lua::bytearray_as_string(L, 1);
+        decompressedBytes = gzip::decompress(
+            reinterpret_cast<const ubyte*>(str.data()),
+            str.size()
+        );
+    } else {
+        throw std::runtime_error("unsupported compression algorithm");
+    }
+
+    if (argc < 3 || !lua::toboolean(L, 3)) {
+        lua::create_bytearray(L, std::move(decompressedBytes));
+    } else {
+        size_t length = decompressedBytes.size();
+        lua::createtable(L, length, 0);
+        int newTable = lua::gettop(L);
+        for (size_t i = 0; i < length; i++) {
+            lua::pushinteger(L, decompressedBytes.data()[i]);
+            lua::rawseti(L, i + 1, newTable);
+        }
+    }
+
+    return 1;
+}
+
+const luaL_Reg compressionlib[] = {
+    {"encode", lua::wrap<l_encode>},
+    {"decode", lua::wrap<l_decode>},
+    {NULL, NULL}
+};
+
diff --git a/src/logic/scripting/lua/libs/libfile.cpp b/src/logic/scripting/lua/libs/libfile.cpp
index a616718e..dae5e6d2 100644
--- a/src/logic/scripting/lua/libs/libfile.cpp
+++ b/src/logic/scripting/lua/libs/libfile.cpp
@@ -188,52 +188,6 @@ static int l_list(lua::State* L) {
     return 1;
 }
 
-static int l_gzip_compress(lua::State* L) {
-    char argc = lua::gettop(L);
-    auto str = lua::bytearray_as_string(L, 1);
-    auto compressedBytes = gzip::compress(
-        reinterpret_cast<const ubyte*>(str.data()),
-        str.size()
-    );
-
-    if (argc < 2 || !lua::toboolean(L, 2)) {
-        lua::create_bytearray(L, std::move(compressedBytes));
-    } else {
-        size_t length = compressedBytes.size();
-        lua::createtable(L, length, 0);
-        int newTable = lua::gettop(L);
-        for (size_t i = 0; i < length; i++) {
-            lua::pushinteger(L, compressedBytes.data()[i]);
-            lua::rawseti(L, i + 1, newTable);
-        }
-    }
-
-    return 1;
-}
-
-static int l_gzip_decompress(lua::State* L) {
-    char argc = lua::gettop(L);
-    auto str = lua::bytearray_as_string(L, 1);
-    auto decompressedBytes = gzip::decompress(
-        reinterpret_cast<const ubyte*>(str.data()),
-        str.size()
-    );
-
-    if (argc < 2 || !lua::toboolean(L, 2)) {
-        lua::create_bytearray(L, std::move(decompressedBytes));
-    } else {
-        size_t length = decompressedBytes.size();
-        lua::createtable(L, length, 0);
-        int newTable = lua::gettop(L);
-        for (size_t i = 0; i < length; i++) {
-            lua::pushinteger(L, decompressedBytes.data()[i]);
-            lua::rawseti(L, i + 1, newTable);
-        }
-    }
-
-    return 1;
-}
-
 static int l_read_combined_list(lua::State* L) {
     std::string path = lua::require_string(L, 1);
     if (path.find(':') != std::string::npos) {
@@ -437,8 +391,6 @@ const luaL_Reg filelib[] = {
     {"resolve", lua::wrap<l_resolve>},
     {"write_bytes", lua::wrap<l_write_bytes>},
     {"write", lua::wrap<l_write>},
-    {"gzip_compress", lua::wrap<l_gzip_compress>},
-    {"gzip_decompress", lua::wrap<l_gzip_decompress>},
     {"read_combined_list", lua::wrap<l_read_combined_list>},
     {"read_combined_object", lua::wrap<l_read_combined_object>},
     {"is_writeable", lua::wrap<l_is_writeable>},
diff --git a/src/logic/scripting/lua/lua_engine.cpp b/src/logic/scripting/lua/lua_engine.cpp
index 6ffa9057..665a9adf 100644
--- a/src/logic/scripting/lua/lua_engine.cpp
+++ b/src/logic/scripting/lua/lua_engine.cpp
@@ -52,6 +52,7 @@ static void create_libs(State* L, StateType stateType) {
     openlib(L, "pack", packlib);
     openlib(L, "quat", quatlib);
     openlib(L, "random", randomlib);
+    openlib(L, "compression", compressionlib);
     openlib(L, "toml", tomllib);
     openlib(L, "utf8", utf8lib);
     openlib(L, "vec2", vec2lib);

From 063e390c92b0ace148c41072534203398163264c Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Thu, 2 Oct 2025 22:50:15 +0300
Subject: [PATCH 017/133] make libcompression.md

---
 doc/ru/scripting/builtins/libcompression.md | 25 +++++++++++++++++++++
 doc/ru/scripting/builtins/libfile.md        | 12 ----------
 2 files changed, 25 insertions(+), 12 deletions(-)
 create mode 100644 doc/ru/scripting/builtins/libcompression.md

diff --git a/doc/ru/scripting/builtins/libcompression.md b/doc/ru/scripting/builtins/libcompression.md
new file mode 100644
index 00000000..52c70d27
--- /dev/null
+++ b/doc/ru/scripting/builtins/libcompression.md
@@ -0,0 +1,25 @@
+# Библиотека *compression*
+
+Библиотека функций для работы сжатия/разжатия массивов байт
+
+```lua
+-- Сжимает массив байт.
+compression.encode(
+    -- Массив байт
+    data: array of integers, 
+    -- Алгоритм сжатия (поддерживается только gzip)
+    [опционально] algorithm="gzip",
+    -- Вернуть результат в table?
+    [опционально] usetable=false,
+) -> array of integers
+
+-- Разжимает массив байт.
+compression.encode(
+    -- Массив байт
+    data: array of integers, 
+    -- Алгоритм разжатия (поддерживается только gzip)
+    [опционально] algorithm="gzip",
+    -- Вернуть результат в table?
+    [опционально] usetable=false,
+) -> array of integers
+```
\ No newline at end of file
diff --git a/doc/ru/scripting/builtins/libfile.md b/doc/ru/scripting/builtins/libfile.md
index 1aa51f5e..4afbe23c 100644
--- a/doc/ru/scripting/builtins/libfile.md
+++ b/doc/ru/scripting/builtins/libfile.md
@@ -43,18 +43,6 @@ file.write_bytes(путь: str, data: array of integers)
 
 Записывает массив байт в файл (с перезаписью)
 
-```python
-file.gzip_compress(data: array of integers, [опционально] usetable) -> array of integers
-```
-
-Сжимает массив байт алгоритмом gzip. При значении usetable = false возвращает Bytearray вместо table.
-
-```python
-file.gzip_decompress(data: array of integers, [опционально] usetable) -> array of integers
-```
-
-Разжимает массив байт, который был сжат алгоритмом gzip. При значении usetable = false возвращает Bytearray вместо table.
-
 ```python
 file.length(путь: str) -> int
 ```

From d1407404c169086b10e754f3affff43f73c4b57f Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Thu, 2 Oct 2025 22:52:11 +0300
Subject: [PATCH 018/133] Update libcompression.md

---
 doc/ru/scripting/builtins/libcompression.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/ru/scripting/builtins/libcompression.md b/doc/ru/scripting/builtins/libcompression.md
index 52c70d27..c309996a 100644
--- a/doc/ru/scripting/builtins/libcompression.md
+++ b/doc/ru/scripting/builtins/libcompression.md
@@ -14,7 +14,7 @@ compression.encode(
 ) -> array of integers
 
 -- Разжимает массив байт.
-compression.encode(
+compression.decode(
     -- Массив байт
     data: array of integers, 
     -- Алгоритм разжатия (поддерживается только gzip)

From d7c2ea43e5d7397d19b9d7a40830f7bb86cfeb54 Mon Sep 17 00:00:00 2001
From: Xertis <118364459+Xertis@users.noreply.github.com>
Date: Thu, 2 Oct 2025 22:53:45 +0300
Subject: [PATCH 019/133] Update libcompression x2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Перфекционизм мешает
---
 doc/ru/scripting/builtins/libcompression.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/ru/scripting/builtins/libcompression.md b/doc/ru/scripting/builtins/libcompression.md
index c309996a..276fbd29 100644
--- a/doc/ru/scripting/builtins/libcompression.md
+++ b/doc/ru/scripting/builtins/libcompression.md
@@ -10,7 +10,7 @@ compression.encode(
     -- Алгоритм сжатия (поддерживается только gzip)
     [опционально] algorithm="gzip",
     -- Вернуть результат в table?
-    [опционально] usetable=false,
+    [опционально] usetable=false
 ) -> array of integers
 
 -- Разжимает массив байт.
@@ -20,6 +20,6 @@ compression.decode(
     -- Алгоритм разжатия (поддерживается только gzip)
     [опционально] algorithm="gzip",
     -- Вернуть результат в table?
-    [опционально] usetable=false,
+    [опционально] usetable=false
 ) -> array of integers
 ```
\ No newline at end of file

From b14bad5d241362df3640bfda8fc58f90723e8a7b Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 3 Oct 2025 21:22:16 +0300
Subject: [PATCH 020/133] add platform::get_executable_path (#638)

---
 src/io/engine_paths.cpp        |  2 ++
 src/objects/rigging.cpp        |  2 +-
 src/util/platform.cpp          | 60 +++++++++++++++++++++++++++++++---
 src/util/platform.hpp          |  8 +++--
 src/util/platform_internal.cpp | 24 ++++++++++++++
 5 files changed, 88 insertions(+), 8 deletions(-)
 create mode 100644 src/util/platform_internal.cpp

diff --git a/src/io/engine_paths.cpp b/src/io/engine_paths.cpp
index 3526f387..98363d9b 100644
--- a/src/io/engine_paths.cpp
+++ b/src/io/engine_paths.cpp
@@ -6,6 +6,7 @@
 #include <stack>
 #include "typedefs.hpp"
 #include "util/stringutil.hpp"
+#include "util/platform.hpp"
 #include <utility>
 
 #include "io/devices/StdfsDevice.hpp"
@@ -44,6 +45,7 @@ void EnginePaths::prepare() {
             resourcesFolder.string() + " is not a directory"
         );
     }
+    logger.info() << "executable path: " << platform::get_executable_path().string();
     logger.info() << "resources folder: " << fs::canonical(resourcesFolder).u8string();
     logger.info() << "user files folder: " << fs::canonical(userFilesFolder).u8string();
     logger.info() << "project folder: " << fs::canonical(projectFolder).u8string();
diff --git a/src/objects/rigging.cpp b/src/objects/rigging.cpp
index 3f50e905..1c0e9218 100644
--- a/src/objects/rigging.cpp
+++ b/src/objects/rigging.cpp
@@ -141,7 +141,7 @@ void SkeletonConfig::update(
             build_matrix(rotation, interpolation.getCurrent())
         );
     } else {
-        update(0, skeleton, root.get(), rotation);
+        update(0, skeleton, root.get(), build_matrix(rotation, position));
     }
 }
 
diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index 2cdd0b89..7bb7f7f4 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -10,13 +10,22 @@
 #include "stringutil.hpp"
 #include "typedefs.hpp"
 #include "debug/Logger.hpp"
-
-static debug::Logger logger("platform");
+#include "frontend/locale.hpp"
 
 #ifdef _WIN32
 #include <Windows.h>
 #pragma comment(lib, "winmm.lib")
+#else
+#include <unistd.h>
+#endif
 
+namespace platform::internal {
+    std::filesystem::path get_executable_path();
+}
+
+static debug::Logger logger("platform");
+
+#ifdef _WIN32
 void platform::configure_encoding() {
     // set utf-8 encoding to console output
     SetConsoleOutputCP(CP_UTF8);
@@ -83,9 +92,6 @@ bool platform::open_url(const std::string& url) {
 
 #else // _WIN32
 
-#include <unistd.h>
-#include "frontend/locale.hpp"
-
 void platform::configure_encoding() {
 }
  
@@ -158,3 +164,47 @@ void platform::open_folder(const std::filesystem::path& folder) {
 
 #endif
 }
+
+std::filesystem::path platform::get_executable_path() {
+#ifdef _WIN32
+    wchar_t buffer[MAX_PATH];
+    DWORD result = GetModuleFileNameW(NULL, buffer, MAX_PATH);
+    if (result == 0) {
+        DWORD error = GetLastError();
+        throw std::runtime_error("GetModuleFileName failed with code: " + std::to_string(error));
+    }
+
+    int size = WideCharToMultiByte(
+        CP_UTF8, 0, buffer, -1, nullptr, 0, nullptr, nullptr
+    );
+    if (size == 0) {
+        throw std::runtime_error("could not get executable path");
+    }
+    std::string str(size, 0);
+    size = WideCharToMultiByte(
+        CP_UTF8, 0, buffer, -1, str.data(), size, nullptr, nullptr
+    );
+    if (size == 0) {
+        DWORD error = GetLastError();
+        throw std::runtime_error("WideCharToMultiByte failed with code: " + std::to_string(error));
+    }
+    str.resize(size - 1);
+    return std::filesystem::path(str);
+
+#elif defined(__APPLE__)
+    auto path = platform::internal::get_executable_path();
+    if (path.empty()) {
+        throw std::runtime_error("could not get executable path");
+    }
+    return path;
+#else
+    char buffer[1024];
+    ssize_t count = readlink("/proc/self/exe", buffer, sizeof(buffer));
+    if (count != -1) {
+        return std::filesystem::canonical(std::filesystem::path(
+            std::string(buffer, static_cast<size_t>(count))
+        ));
+    }
+    throw std::runtime_error("could not get executable path");
+#endif
+}
diff --git a/src/util/platform.hpp b/src/util/platform.hpp
index a638ee92..c4b45650 100644
--- a/src/util/platform.hpp
+++ b/src/util/platform.hpp
@@ -5,13 +5,17 @@
 
 namespace platform {
     void configure_encoding();
-    /// @return environment locale in ISO format ll_CC
+    /// @brief Get Environment locale in ISO format ll_CC
     std::string detect_locale();
     /// @brief Open folder using system file manager asynchronously
     /// @param folder target folder
     void open_folder(const std::filesystem::path& folder);
-    /// Makes the current thread sleep for the specified amount of milliseconds.
+    /// @brief Makes the current thread sleep for the specified amount of milliseconds.
     void sleep(size_t millis);
+    /// @brief Get current process id 
     int get_process_id();
+    /// @brief Get current process running executable path  
+    std::filesystem::path get_executable_path();
+    /// @brief Open URL in web browser 
     bool open_url(const std::string& url);
 }
diff --git a/src/util/platform_internal.cpp b/src/util/platform_internal.cpp
new file mode 100644
index 00000000..90168219
--- /dev/null
+++ b/src/util/platform_internal.cpp
@@ -0,0 +1,24 @@
+#include <filesystem>
+
+#ifndef _WIN32
+#include <unistd.h>
+#endif
+
+#ifdef __APPLE__
+#include <mach-o/dyld.h> 
+#endif
+
+namespace platform::internal {
+    std::filesystem::path get_executable_path() {
+#ifdef __APPLE__
+        char buffer[1024];
+        uint32_t size = sizeof(buffer);
+        if (_NSGetExecutablePath(buffer, &size) == 0) {
+            return std::filesystem::canonical(std::filesystem::path(buffer));
+        } else {
+            return std::filesystem::path();
+        }
+#endif
+        return std::filesystem::path();
+    }
+}

From 5a5bd5cb2ee2606d99aa904b34105c62d2f56091 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 3 Oct 2025 22:02:56 +0300
Subject: [PATCH 021/133] add platform::new_engine_instance

---
 src/util/platform.cpp | 67 +++++++++++++++++++++++++++++++++++++++++++
 src/util/platform.hpp |  3 ++
 2 files changed, 70 insertions(+)

diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index 7bb7f7f4..b36d5eb7 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -115,6 +115,73 @@ int platform::get_process_id() {
     return getpid();
 }
 
+void platform::new_engine_instance(const std::vector<std::string>& args) {
+    auto executable = get_executable_path();
+
+#ifdef _WIN32
+    std::stringstream ss;
+    for (int i = 0; i < args.size(); i++) {
+        ss << " " << util::quote(args[i]);
+    }
+
+    auto toWString = [](const std::string& src)  {
+        if (src.empty()) 
+            return L"";
+        int size = MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, nullptr, 0);
+        if (size == 0) {
+            throw std::runtime_error(
+                "MultiByteToWideChar failed with code: " +
+                std::to_string(GetLastError())
+            )
+        }
+        std::vector<wchar_t> buffer(size);
+        MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, buffer.data(), size);
+        return std::wstring(buffer.data());
+    };
+
+    auto executableString = toWString(executable.u8string());
+    auto argsString = toWString(ss.str());
+
+    STARTUPINFOW si = { sizeof(si) };
+    PROCESS_INFORMATION pi = { 0 };
+    DWORD flags = CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS;
+    // | CREATE_NO_WINDOW;
+    BOOL success = CreateProcessW(
+        executable.u8string().c_str(),
+        argsString.c_str(),
+        nullptr,
+        nullptr,
+        FALSE,
+        flags,
+        nullptr,
+        "",
+        &si,
+        &pi
+    );
+    if (!success) {
+        throw std::runtime_error(
+            "starting an engine instance failed with code: " +
+            std::to_string(GetLastError())
+        );
+    }
+#else
+    std::stringstream ss;
+    ss << executable;
+    for (int i = 0; i < args.size(); i++) {
+        ss << " " << util::quote(args[i]);
+    }
+    ss << " >/dev/null &";
+    
+    auto command = ss.str();
+    if (int res = system(command.c_str())) {
+        throw std::runtime_error(
+            "starting an engine instance failed with code: " +
+            std::to_string(res)
+        );
+    }
+#endif
+}
+
 bool platform::open_url(const std::string& url) {
     if (url.empty()) return false;
 
diff --git a/src/util/platform.hpp b/src/util/platform.hpp
index c4b45650..148c64c4 100644
--- a/src/util/platform.hpp
+++ b/src/util/platform.hpp
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <string>
+#include <vector>
 #include <filesystem>
 
 namespace platform {
@@ -16,6 +17,8 @@ namespace platform {
     int get_process_id();
     /// @brief Get current process running executable path  
     std::filesystem::path get_executable_path();
+    /// @brief Run a separate engine instance with specified arguments
+    void new_engine_instance(const std::vector<std::string>& args);
     /// @brief Open URL in web browser 
     bool open_url(const std::string& url);
 }

From 5e542225c79ceb6eac06466ffc164c19b8df0138 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 3 Oct 2025 22:03:27 +0300
Subject: [PATCH 022/133] update workflows

---
 .github/workflows/appimage.yml      | 2 +-
 .github/workflows/macos.yml         | 2 +-
 .github/workflows/windows-clang.yml | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/appimage.yml b/.github/workflows/appimage.yml
index 5a01a618..447e1280 100644
--- a/.github/workflows/appimage.yml
+++ b/.github/workflows/appimage.yml
@@ -46,7 +46,7 @@ jobs:
         run: |
             chmod +x build/VoxelEngine
             chmod +x AppDir/usr/bin/vctest
-            AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build
+            AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build --output-always
       - name: Build AppImage
         uses: AppImageCrafters/build-appimage-action@fe2205a4d6056be47051f7b1b3811106e9814910
         env:
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
index f8fe3dfa..ac9f8979 100644
--- a/.github/workflows/macos.yml
+++ b/.github/workflows/macos.yml
@@ -39,7 +39,7 @@ jobs:
         run: |
           chmod +x build/VoxelEngine
           chmod +x AppDir/usr/bin/vctest
-          AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build
+          AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build --output-always
       - name: Create DMG
         run: |
           mkdir VoxelEngineDmgContent
diff --git a/.github/workflows/windows-clang.yml b/.github/workflows/windows-clang.yml
index cdf354dd..5c26937e 100644
--- a/.github/workflows/windows-clang.yml
+++ b/.github/workflows/windows-clang.yml
@@ -66,4 +66,4 @@ jobs:
         shell: msys2 {0}
         working-directory: ${{ github.workspace }}
         run: |
-          packaged/vctest.exe -e packaged/VoxelCore.exe -d dev/tests -u build
+          packaged/vctest.exe -e packaged/VoxelCore.exe -d dev/tests -u build --output-always

From 317aa710c4d40a1fd59ae76b0c740eeea0893871 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 3 Oct 2025 23:41:53 +0300
Subject: [PATCH 023/133] test

---
 src/graphics/ui/GUI.cpp |   8 +++
 src/util/platform.cpp   | 135 ++++++++++++++++++++--------------------
 2 files changed, 76 insertions(+), 67 deletions(-)

diff --git a/src/graphics/ui/GUI.cpp b/src/graphics/ui/GUI.cpp
index 3ab438b1..9faed8f7 100644
--- a/src/graphics/ui/GUI.cpp
+++ b/src/graphics/ui/GUI.cpp
@@ -19,6 +19,7 @@
 #include "graphics/core/DrawContext.hpp"
 #include "graphics/core/Shader.hpp"
 #include "gui_util.hpp"
+#include "util/platform.hpp"
 #include "window/Camera.hpp"
 #include "window/Window.hpp"
 #include "window/input.hpp"
@@ -204,6 +205,13 @@ void GUI::act(float delta, const glm::uvec2& vp) {
     container->act(delta);
     auto prevfocus = focus;
 
+    if (input.jpressed(Keycode::BACKSPACE)) {
+        platform::new_engine_instance({
+            "--res", engine.getPaths().getResourcesFolder().u8string(),
+            "--dir", engine.getPaths().getUserFilesFolder().u8string()
+        });
+    }
+
     updateTooltip(delta);
 
     const auto& cursor = input.getCursor();
diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index b36d5eb7..b4d71db4 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -115,73 +115,6 @@ int platform::get_process_id() {
     return getpid();
 }
 
-void platform::new_engine_instance(const std::vector<std::string>& args) {
-    auto executable = get_executable_path();
-
-#ifdef _WIN32
-    std::stringstream ss;
-    for (int i = 0; i < args.size(); i++) {
-        ss << " " << util::quote(args[i]);
-    }
-
-    auto toWString = [](const std::string& src)  {
-        if (src.empty()) 
-            return L"";
-        int size = MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, nullptr, 0);
-        if (size == 0) {
-            throw std::runtime_error(
-                "MultiByteToWideChar failed with code: " +
-                std::to_string(GetLastError())
-            )
-        }
-        std::vector<wchar_t> buffer(size);
-        MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, buffer.data(), size);
-        return std::wstring(buffer.data());
-    };
-
-    auto executableString = toWString(executable.u8string());
-    auto argsString = toWString(ss.str());
-
-    STARTUPINFOW si = { sizeof(si) };
-    PROCESS_INFORMATION pi = { 0 };
-    DWORD flags = CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS;
-    // | CREATE_NO_WINDOW;
-    BOOL success = CreateProcessW(
-        executable.u8string().c_str(),
-        argsString.c_str(),
-        nullptr,
-        nullptr,
-        FALSE,
-        flags,
-        nullptr,
-        "",
-        &si,
-        &pi
-    );
-    if (!success) {
-        throw std::runtime_error(
-            "starting an engine instance failed with code: " +
-            std::to_string(GetLastError())
-        );
-    }
-#else
-    std::stringstream ss;
-    ss << executable;
-    for (int i = 0; i < args.size(); i++) {
-        ss << " " << util::quote(args[i]);
-    }
-    ss << " >/dev/null &";
-    
-    auto command = ss.str();
-    if (int res = system(command.c_str())) {
-        throw std::runtime_error(
-            "starting an engine instance failed with code: " +
-            std::to_string(res)
-        );
-    }
-#endif
-}
-
 bool platform::open_url(const std::string& url) {
     if (url.empty()) return false;
 
@@ -275,3 +208,71 @@ std::filesystem::path platform::get_executable_path() {
     throw std::runtime_error("could not get executable path");
 #endif
 }
+
+void platform::new_engine_instance(const std::vector<std::string>& args) {
+    auto executable = get_executable_path();
+
+#ifdef _WIN32
+    std::stringstream ss;
+    for (int i = 0; i < args.size(); i++) {
+        ss << " " << util::quote(args[i]);
+    }
+
+    auto toWString = [](const std::string& src) -> std::wstring {
+        if (src.empty()) 
+            return L"";
+        int size = MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, nullptr, 0);
+        if (size == 0) {
+            throw std::runtime_error(
+                "MultiByteToWideChar failed with code: " +
+                std::to_string(GetLastError())
+            );
+        }
+        std::vector<wchar_t> buffer(size + 1);
+        buffer[size] = 0;
+        MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, buffer.data(), size);
+        return std::wstring(buffer.data(), size);
+    };
+
+    auto executableString = toWString(executable.u8string());
+    auto argsString = toWString(ss.str());
+
+    STARTUPINFOW si = { sizeof(si) };
+    PROCESS_INFORMATION pi = { 0 };
+    DWORD flags = CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS;
+    // | CREATE_NO_WINDOW;
+    BOOL success = CreateProcessW(
+        executableString.c_str(),
+        argsString.data(),
+        nullptr,
+        nullptr,
+        FALSE,
+        flags,
+        nullptr,
+        L"",
+        &si,
+        &pi
+    );
+    if (!success) {
+        throw std::runtime_error(
+            "starting an engine instance failed with code: " +
+            std::to_string(GetLastError())
+        );
+    }
+#else
+    std::stringstream ss;
+    ss << executable;
+    for (int i = 0; i < args.size(); i++) {
+        ss << " " << util::quote(args[i]);
+    }
+    ss << " >/dev/null &";
+    
+    auto command = ss.str();
+    if (int res = system(command.c_str())) {
+        throw std::runtime_error(
+            "starting an engine instance failed with code: " +
+            std::to_string(res)
+        );
+    }
+#endif
+}

From 68bdcf07b28577a4b27c02eba97ce5bcc190d051 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 4 Oct 2025 01:51:47 +0300
Subject: [PATCH 024/133] fix CreateProcessW use

---
 src/util/platform.cpp | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index b4d71db4..55ac1630 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -214,6 +214,7 @@ void platform::new_engine_instance(const std::vector<std::string>& args) {
 
 #ifdef _WIN32
     std::stringstream ss;
+    ss << util::quote(executable.u8string());
     for (int i = 0; i < args.size(); i++) {
         ss << " " << util::quote(args[i]);
     }
@@ -230,30 +231,38 @@ void platform::new_engine_instance(const std::vector<std::string>& args) {
         }
         std::vector<wchar_t> buffer(size + 1);
         buffer[size] = 0;
-        MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, buffer.data(), size);
-        return std::wstring(buffer.data(), size);
+        size = MultiByteToWideChar(CP_UTF8, 0, src.c_str(), -1, buffer.data(), size);
+        if (size == 0) {
+            throw std::runtime_error(
+                "MultiByteToWideChar failed with code: " +
+                std::to_string(GetLastError())
+            );
+        }
+        return std::wstring(buffer.data(), size + 1);
     };
 
-    auto executableString = toWString(executable.u8string());
-    auto argsString = toWString(ss.str());
+    auto commandString = toWString(ss.str());
 
     STARTUPINFOW si = { sizeof(si) };
     PROCESS_INFORMATION pi = { 0 };
     DWORD flags = CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS;
     // | CREATE_NO_WINDOW;
     BOOL success = CreateProcessW(
-        executableString.c_str(),
-        argsString.data(),
+        nullptr,
+        commandString.data(),
         nullptr,
         nullptr,
         FALSE,
         flags,
         nullptr,
-        L"",
+        nullptr,
         &si,
         &pi
     );
-    if (!success) {
+    if (success) {
+        CloseHandle(pi.hProcess);
+        CloseHandle(pi.hThread);
+    } else {
         throw std::runtime_error(
             "starting an engine instance failed with code: " +
             std::to_string(GetLastError())

From 8ef1ccbb30a056318f48c44ebf70d49089b82568 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 4 Oct 2025 01:54:49 +0300
Subject: [PATCH 025/133] revert test

---
 src/graphics/ui/GUI.cpp | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/src/graphics/ui/GUI.cpp b/src/graphics/ui/GUI.cpp
index 9faed8f7..3ab438b1 100644
--- a/src/graphics/ui/GUI.cpp
+++ b/src/graphics/ui/GUI.cpp
@@ -19,7 +19,6 @@
 #include "graphics/core/DrawContext.hpp"
 #include "graphics/core/Shader.hpp"
 #include "gui_util.hpp"
-#include "util/platform.hpp"
 #include "window/Camera.hpp"
 #include "window/Window.hpp"
 #include "window/input.hpp"
@@ -205,13 +204,6 @@ void GUI::act(float delta, const glm::uvec2& vp) {
     container->act(delta);
     auto prevfocus = focus;
 
-    if (input.jpressed(Keycode::BACKSPACE)) {
-        platform::new_engine_instance({
-            "--res", engine.getPaths().getResourcesFolder().u8string(),
-            "--dir", engine.getPaths().getUserFilesFolder().u8string()
-        });
-    }
-
     updateTooltip(delta);
 
     const auto& cursor = input.getCursor();

From 72e98bf8cd1c1808ba76aef14afc721304a51e85 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 4 Oct 2025 01:56:55 +0300
Subject: [PATCH 026/133] revert workflows

---
 .github/workflows/appimage.yml      | 2 +-
 .github/workflows/macos.yml         | 2 +-
 .github/workflows/windows-clang.yml | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/appimage.yml b/.github/workflows/appimage.yml
index 447e1280..5a01a618 100644
--- a/.github/workflows/appimage.yml
+++ b/.github/workflows/appimage.yml
@@ -46,7 +46,7 @@ jobs:
         run: |
             chmod +x build/VoxelEngine
             chmod +x AppDir/usr/bin/vctest
-            AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build --output-always
+            AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build
       - name: Build AppImage
         uses: AppImageCrafters/build-appimage-action@fe2205a4d6056be47051f7b1b3811106e9814910
         env:
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
index ac9f8979..f8fe3dfa 100644
--- a/.github/workflows/macos.yml
+++ b/.github/workflows/macos.yml
@@ -39,7 +39,7 @@ jobs:
         run: |
           chmod +x build/VoxelEngine
           chmod +x AppDir/usr/bin/vctest
-          AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build --output-always
+          AppDir/usr/bin/vctest -e build/VoxelEngine -d dev/tests -u build
       - name: Create DMG
         run: |
           mkdir VoxelEngineDmgContent
diff --git a/.github/workflows/windows-clang.yml b/.github/workflows/windows-clang.yml
index 5c26937e..cdf354dd 100644
--- a/.github/workflows/windows-clang.yml
+++ b/.github/workflows/windows-clang.yml
@@ -66,4 +66,4 @@ jobs:
         shell: msys2 {0}
         working-directory: ${{ github.workspace }}
         run: |
-          packaged/vctest.exe -e packaged/VoxelCore.exe -d dev/tests -u build --output-always
+          packaged/vctest.exe -e packaged/VoxelCore.exe -d dev/tests -u build

From 2f15a1a8d4afe307e527cc4b96f902705c1d9bc7 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 4 Oct 2025 14:58:03 +0300
Subject: [PATCH 027/133] refactor Network.cpp

---
 src/logic/scripting/lua/libs/libnetwork.cpp |  26 +-
 src/network/Curl.cpp                        | 239 ++++++
 src/network/Network.cpp                     | 881 +-------------------
 src/network/Network.hpp                     |  82 +-
 src/network/Sockets.cpp                     | 679 +++++++++++++++
 src/network/commons.hpp                     |  91 ++
 6 files changed, 1055 insertions(+), 943 deletions(-)
 create mode 100644 src/network/Curl.cpp
 create mode 100644 src/network/Sockets.cpp
 create mode 100644 src/network/commons.hpp

diff --git a/src/logic/scripting/lua/libs/libnetwork.cpp b/src/logic/scripting/lua/libs/libnetwork.cpp
index a78f17db..4201348a 100644
--- a/src/logic/scripting/lua/libs/libnetwork.cpp
+++ b/src/logic/scripting/lua/libs/libnetwork.cpp
@@ -155,7 +155,7 @@ static int l_post(lua::State* L, network::Network& network) {
 
 static int l_close(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         connection->close(true);
     }
     return 0;
@@ -163,7 +163,7 @@ static int l_close(lua::State* L, network::Network& network) {
 
 static int l_closeserver(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto server = network.getServer(id)) {
+    if (auto server = network.getServer(id, false)) {
         server->close();
     }
     return 0;
@@ -171,7 +171,7 @@ static int l_closeserver(lua::State* L, network::Network& network) {
 
 static int l_send(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    auto connection = network.getConnection(id);
+    auto connection = network.getConnection(id, false);
     if (connection == nullptr ||
         connection->getState() == network::ConnectionState::CLOSED) {
         return 0;
@@ -201,7 +201,7 @@ static int l_send(lua::State* L, network::Network& network) {
 static int l_udp_server_send_to(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
 
-    if (auto server = network.getServer(id)) {
+    if (auto server = network.getServer(id, false)) {
         if (server->getTransportType() != network::TransportType::UDP)
             throw std::runtime_error("the server must work on UDP transport");
 
@@ -238,7 +238,7 @@ static int l_recv(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
     int length = lua::tointeger(L, 2);
 
-    auto connection = engine->getNetwork().getConnection(id);
+    auto connection = engine->getNetwork().getConnection(id, false);
 
     if (connection == nullptr || connection->getTransportType() != network::TransportType::TCP) {
         return 0;
@@ -268,7 +268,7 @@ static int l_recv(lua::State* L, network::Network& network) {
 static int l_available(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
 
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         return lua::pushinteger(L, dynamic_cast<network::TcpConnection*>(connection)->available());
     }
 
@@ -345,7 +345,7 @@ static int l_open_udp(lua::State* L, network::Network& network) {
 
 static int l_is_alive(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         return lua::pushboolean(
             L,
             connection->getState() != network::ConnectionState::CLOSED ||
@@ -360,7 +360,7 @@ static int l_is_alive(lua::State* L, network::Network& network) {
 
 static int l_is_connected(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         return lua::pushboolean(
             L, connection->getState() == network::ConnectionState::CONNECTED
         );
@@ -370,7 +370,7 @@ static int l_is_connected(lua::State* L, network::Network& network) {
 
 static int l_get_address(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         lua::pushstring(L, connection->getAddress());
         lua::pushinteger(L, connection->getPort());
         return 2;
@@ -380,7 +380,7 @@ static int l_get_address(lua::State* L, network::Network& network) {
 
 static int l_is_serveropen(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto server = network.getServer(id)) {
+    if (auto server = network.getServer(id, false)) {
         return lua::pushboolean(L, server->isOpen());
     }
     return lua::pushboolean(L, false);
@@ -388,7 +388,7 @@ static int l_is_serveropen(lua::State* L, network::Network& network) {
 
 static int l_get_serverport(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto server = network.getServer(id)) {
+    if (auto server = network.getServer(id, false)) {
         return lua::pushinteger(L, server->getPort());
     }
     return 0;
@@ -405,7 +405,7 @@ static int l_get_total_download(lua::State* L, network::Network& network) {
 static int l_set_nodelay(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
     bool noDelay = lua::toboolean(L, 2);
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         if (connection->getTransportType() == network::TransportType::TCP) {
             dynamic_cast<network::TcpConnection*>(connection)->setNoDelay(noDelay);
         }
@@ -415,7 +415,7 @@ static int l_set_nodelay(lua::State* L, network::Network& network) {
 
 static int l_is_nodelay(lua::State* L, network::Network& network) {
     u64id_t id = lua::tointeger(L, 1);
-    if (auto connection = network.getConnection(id)) {
+    if (auto connection = network.getConnection(id, false)) {
         if (connection->getTransportType() == network::TransportType::TCP) {
             bool noDelay = dynamic_cast<network::TcpConnection*>(connection)->isNoDelay();
             return lua::pushboolean(L, noDelay);
diff --git a/src/network/Curl.cpp b/src/network/Curl.cpp
new file mode 100644
index 00000000..bd40a478
--- /dev/null
+++ b/src/network/Curl.cpp
@@ -0,0 +1,239 @@
+#include "commons.hpp"
+
+#include "debug/Logger.hpp"
+
+#define NOMINMAX
+#include <curl/curl.h>
+#include <queue>
+
+using namespace network;
+
+static debug::Logger logger("curl");
+
+inline constexpr int HTTP_OK = 200;
+inline constexpr int HTTP_BAD_GATEWAY = 502;
+
+static size_t write_callback(
+    char* ptr, size_t size, size_t nmemb, void* userdata
+) {
+    auto& buffer = *reinterpret_cast<std::vector<char>*>(userdata);
+    size_t psize = buffer.size();
+    buffer.resize(psize + size * nmemb);
+    std::memcpy(buffer.data() + psize, ptr, size * nmemb);
+    return size * nmemb;
+}
+
+enum class RequestType {
+    GET, POST
+};
+
+struct Request {
+    RequestType type;
+    std::string url;
+    OnResponse onResponse;
+    OnReject onReject;
+    long maxSize;
+    bool followLocation = false;
+    std::string data;
+    std::vector<std::string> headers;
+};
+
+class CurlRequests : public Requests {
+    CURLM* multiHandle;
+    CURL* curl;
+
+    size_t totalUpload = 0;
+    size_t totalDownload = 0;
+
+    OnResponse onResponse;
+    OnReject onReject;
+    std::vector<char> buffer;
+    std::string url;
+
+    std::queue<Request> requests;
+public:
+    CurlRequests(CURLM* multiHandle, CURL* curl)
+        : multiHandle(multiHandle), curl(curl) {
+    }
+
+    virtual ~CurlRequests() {
+        curl_multi_remove_handle(multiHandle, curl);
+        curl_easy_cleanup(curl);
+        curl_multi_cleanup(multiHandle);
+    }
+    void get(
+        const std::string& url,
+        OnResponse onResponse,
+        OnReject onReject,
+        std::vector<std::string> headers,
+        long maxSize
+    ) override {
+        Request request {
+            RequestType::GET,
+            url,
+            onResponse,
+            onReject,
+            maxSize,
+            true,
+            "",
+            std::move(headers)};
+        processRequest(std::move(request));
+    }
+
+    void post(
+        const std::string& url,
+        const std::string& data,
+        OnResponse onResponse,
+        OnReject onReject=nullptr,
+        std::vector<std::string> headers = {},
+        long maxSize=0
+    ) override {
+        Request request {
+            RequestType::POST,
+            url,
+            onResponse,
+            onReject,
+            maxSize,
+            false,
+            "",
+            std::move(headers)};
+        request.data = data;
+        processRequest(std::move(request));
+    }
+
+    void processRequest(Request request) {
+        if (!url.empty()) {
+            requests.push(request);
+            return;
+        }
+        onResponse = request.onResponse;
+        onReject = request.onReject;
+        url = request.url;
+
+        buffer.clear();
+
+        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
+        curl_easy_setopt(curl, CURLOPT_POST, request.type == RequestType::POST);
+        
+        curl_slist* hs = NULL;
+        
+        for (const auto& header : request.headers) {
+            hs = curl_slist_append(hs, header.c_str());
+        }
+
+        switch (request.type) {
+            case RequestType::GET:
+                break;
+            case RequestType::POST: 
+                hs = curl_slist_append(hs, "Content-Type: application/json");
+                curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, request.data.length());
+                curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, request.data.c_str());
+                break;
+            default:
+                throw std::runtime_error("not implemented");
+        }
+        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, hs);
+        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, request.followLocation);
+        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
+        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &buffer);
+        curl_easy_setopt(curl, CURLOPT_USERAGENT, "curl/7.81.0");
+        if (request.maxSize == 0) {
+            curl_easy_setopt(
+                curl, CURLOPT_MAXFILESIZE, std::numeric_limits<long>::max()
+            );
+        } else {
+            curl_easy_setopt(curl, CURLOPT_MAXFILESIZE, request.maxSize);
+        }
+        curl_multi_add_handle(multiHandle, curl);
+        int running;
+        CURLMcode res = curl_multi_perform(multiHandle, &running);
+        if (res != CURLM_OK) {
+            auto message = curl_multi_strerror(res);
+            logger.error() << message << " (" << url << ")";
+            if (onReject) {
+                onReject(HTTP_BAD_GATEWAY, {});
+            }
+            url = "";
+        }
+    }
+
+    void update() override {
+        int messagesLeft;
+        int running;
+        CURLMsg* msg;
+        CURLMcode res = curl_multi_perform(multiHandle, &running);
+        if (res != CURLM_OK) {
+            auto message = curl_multi_strerror(res);
+            logger.error() << message << " (" << url << ")";
+            if (onReject) {
+                onReject(HTTP_BAD_GATEWAY, {});
+            }
+            curl_multi_remove_handle(multiHandle, curl);
+            url = "";
+            return;
+        }
+        if ((msg = curl_multi_info_read(multiHandle, &messagesLeft)) != NULL) {
+            if(msg->msg == CURLMSG_DONE) {
+                curl_multi_remove_handle(multiHandle, curl);
+            }
+            int response;
+            curl_easy_getinfo(msg->easy_handle, CURLINFO_RESPONSE_CODE, &response);
+            if (response == HTTP_OK) {
+                long size;
+                if (!curl_easy_getinfo(curl, CURLINFO_REQUEST_SIZE, &size)) {
+                    totalUpload += size;
+                }
+                if (!curl_easy_getinfo(curl, CURLINFO_HEADER_SIZE, &size)) {
+                    totalDownload += size;
+                }
+                totalDownload += buffer.size();
+                if (onResponse) {
+                    onResponse(std::move(buffer));
+                }
+            } else {
+                logger.error()
+                    << "response code " << response << " (" << url << ")"
+                    << (buffer.empty()
+                            ? ""
+                            : std::to_string(buffer.size()) + " byte(s)");
+                totalDownload += buffer.size();
+                if (onReject) {
+                    onReject(response, std::move(buffer));
+                }
+            }
+            url = "";
+        }
+        if (url.empty() && !requests.empty()) {
+            auto request = std::move(requests.front());
+            requests.pop();
+            processRequest(std::move(request));
+        }
+    }
+
+    size_t getTotalUpload() const override {
+        return totalUpload;
+    }
+
+    size_t getTotalDownload() const override {
+        return totalDownload;
+    }
+
+    static std::unique_ptr<CurlRequests> create() {
+        auto curl = curl_easy_init();
+        if (curl == nullptr) {
+            throw std::runtime_error("could not initialzie cURL");
+        }
+        auto multiHandle = curl_multi_init();
+        if (multiHandle == nullptr) {
+            curl_easy_cleanup(curl);
+            throw std::runtime_error("could not initialzie cURL-multi");
+        }
+        return std::make_unique<CurlRequests>(multiHandle, curl);
+    }
+};
+
+namespace network {
+    std::unique_ptr<Requests> create_curl_requests() {
+        return CurlRequests::create();
+    }
+}
diff --git a/src/network/Network.cpp b/src/network/Network.cpp
index f4e9db9b..04c8dbec 100644
--- a/src/network/Network.cpp
+++ b/src/network/Network.cpp
@@ -1,869 +1,44 @@
 #include "Network.hpp"
 
-#pragma comment(lib, "Ws2_32.lib")
-
-#define NOMINMAX
-#include <curl/curl.h>
 #include <stdexcept>
 #include <limits>
 #include <queue>
 #include <thread>
 
-#ifdef _WIN32
-/// included in curl.h
-#else
-#include <sys/types.h>
-#include <sys/socket.h>
-#include <netdb.h>
-#include <netinet/in.h>
-#include <netinet/tcp.h>
-#include <arpa/inet.h>
-#include <unistd.h>
-#include <fcntl.h>
-#include <errno.h>
-
-using SOCKET = int;
-#endif // _WIN32
-
 #include "debug/Logger.hpp"
 #include "util/stringutil.hpp"
 
 using namespace network;
 
-inline constexpr int HTTP_OK = 200;
-inline constexpr int HTTP_BAD_GATEWAY = 502;
-
 static debug::Logger logger("network");
 
-static size_t write_callback(
-    char* ptr, size_t size, size_t nmemb, void* userdata
-) {
-    auto& buffer = *reinterpret_cast<std::vector<char>*>(userdata);
-    size_t psize = buffer.size();
-    buffer.resize(psize + size * nmemb);
-    std::memcpy(buffer.data() + psize, ptr, size * nmemb);
-    return size * nmemb;
-}
+namespace network {
+    std::unique_ptr<Requests> create_curl_requests();
 
-enum class RequestType {
-    GET, POST
-};
-
-struct Request {
-    RequestType type;
-    std::string url;
-    OnResponse onResponse;
-    OnReject onReject;
-    long maxSize;
-    bool followLocation = false;
-    std::string data;
-    std::vector<std::string> headers;
-};
-
-class CurlRequests : public Requests {
-    CURLM* multiHandle;
-    CURL* curl;
-
-    size_t totalUpload = 0;
-    size_t totalDownload = 0;
-
-    OnResponse onResponse;
-    OnReject onReject;
-    std::vector<char> buffer;
-    std::string url;
-
-    std::queue<Request> requests;
-public:
-    CurlRequests(CURLM* multiHandle, CURL* curl)
-        : multiHandle(multiHandle), curl(curl) {
-    }
-
-    virtual ~CurlRequests() {
-        curl_multi_remove_handle(multiHandle, curl);
-        curl_easy_cleanup(curl);
-        curl_multi_cleanup(multiHandle);
-    }
-    void get(
-        const std::string& url,
-        OnResponse onResponse,
-        OnReject onReject,
-        std::vector<std::string> headers,
-        long maxSize
-    ) override {
-        Request request {
-            RequestType::GET,
-            url,
-            onResponse,
-            onReject,
-            maxSize,
-            true,
-            "",
-            std::move(headers)};
-        processRequest(std::move(request));
-    }
-
-    void post(
-        const std::string& url,
-        const std::string& data,
-        OnResponse onResponse,
-        OnReject onReject=nullptr,
-        std::vector<std::string> headers = {},
-        long maxSize=0
-    ) override {
-        Request request {
-            RequestType::POST,
-            url,
-            onResponse,
-            onReject,
-            maxSize,
-            false,
-            "",
-            std::move(headers)};
-        request.data = data;
-        processRequest(std::move(request));
-    }
-
-    void processRequest(Request request) {
-        if (!url.empty()) {
-            requests.push(request);
-            return;
-        }
-        onResponse = request.onResponse;
-        onReject = request.onReject;
-        url = request.url;
-
-        buffer.clear();
-
-        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
-        curl_easy_setopt(curl, CURLOPT_POST, request.type == RequestType::POST);
-        
-        curl_slist* hs = NULL;
-        
-        for (const auto& header : request.headers) {
-            hs = curl_slist_append(hs, header.c_str());
-        }
-
-        switch (request.type) {
-            case RequestType::GET:
-                break;
-            case RequestType::POST: 
-                hs = curl_slist_append(hs, "Content-Type: application/json");
-                curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, request.data.length());
-                curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, request.data.c_str());
-                break;
-            default:
-                throw std::runtime_error("not implemented");
-        }
-        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, hs);
-        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, request.followLocation);
-        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
-        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &buffer);
-        curl_easy_setopt(curl, CURLOPT_USERAGENT, "curl/7.81.0");
-        if (request.maxSize == 0) {
-            curl_easy_setopt(
-                curl, CURLOPT_MAXFILESIZE, std::numeric_limits<long>::max()
-            );
-        } else {
-            curl_easy_setopt(curl, CURLOPT_MAXFILESIZE, request.maxSize);
-        }
-        curl_multi_add_handle(multiHandle, curl);
-        int running;
-        CURLMcode res = curl_multi_perform(multiHandle, &running);
-        if (res != CURLM_OK) {
-            auto message = curl_multi_strerror(res);
-            logger.error() << message << " (" << url << ")";
-            if (onReject) {
-                onReject(HTTP_BAD_GATEWAY, {});
-            }
-            url = "";
-        }
-    }
-
-    void update() override {
-        int messagesLeft;
-        int running;
-        CURLMsg* msg;
-        CURLMcode res = curl_multi_perform(multiHandle, &running);
-        if (res != CURLM_OK) {
-            auto message = curl_multi_strerror(res);
-            logger.error() << message << " (" << url << ")";
-            if (onReject) {
-                onReject(HTTP_BAD_GATEWAY, {});
-            }
-            curl_multi_remove_handle(multiHandle, curl);
-            url = "";
-            return;
-        }
-        if ((msg = curl_multi_info_read(multiHandle, &messagesLeft)) != NULL) {
-            if(msg->msg == CURLMSG_DONE) {
-                curl_multi_remove_handle(multiHandle, curl);
-            }
-            int response;
-            curl_easy_getinfo(msg->easy_handle, CURLINFO_RESPONSE_CODE, &response);
-            if (response == HTTP_OK) {
-                long size;
-                if (!curl_easy_getinfo(curl, CURLINFO_REQUEST_SIZE, &size)) {
-                    totalUpload += size;
-                }
-                if (!curl_easy_getinfo(curl, CURLINFO_HEADER_SIZE, &size)) {
-                    totalDownload += size;
-                }
-                totalDownload += buffer.size();
-                if (onResponse) {
-                    onResponse(std::move(buffer));
-                }
-            } else {
-                logger.error()
-                    << "response code " << response << " (" << url << ")"
-                    << (buffer.empty()
-                            ? ""
-                            : std::to_string(buffer.size()) + " byte(s)");
-                totalDownload += buffer.size();
-                if (onReject) {
-                    onReject(response, std::move(buffer));
-                }
-            }
-            url = "";
-        }
-        if (url.empty() && !requests.empty()) {
-            auto request = std::move(requests.front());
-            requests.pop();
-            processRequest(std::move(request));
-        }
-    }
-
-    size_t getTotalUpload() const override {
-        return totalUpload;
-    }
-
-    size_t getTotalDownload() const override {
-        return totalDownload;
-    }
-
-    static std::unique_ptr<CurlRequests> create() {
-        auto curl = curl_easy_init();
-        if (curl == nullptr) {
-            throw std::runtime_error("could not initialzie cURL");
-        }
-        auto multiHandle = curl_multi_init();
-        if (multiHandle == nullptr) {
-            curl_easy_cleanup(curl);
-            throw std::runtime_error("could not initialzie cURL-multi");
-        }
-        return std::make_unique<CurlRequests>(multiHandle, curl);
-    }
-};
-
-#ifndef _WIN32
-static inline int closesocket(int descriptor) noexcept {
-    return close(descriptor);
-}
-static inline std::runtime_error handle_socket_error(const std::string& message) {
-    int err = errno;
-    return std::runtime_error(
-        message+" [errno=" + std::to_string(err) + "]: " + 
-        std::string(strerror(err))
-    );
-}
-#else
-static inline std::runtime_error handle_socket_error(const std::string& message) {
-    int errorCode = WSAGetLastError();
-    wchar_t* s = nullptr;
-    size_t size = FormatMessageW(
-        FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM |
-            FORMAT_MESSAGE_IGNORE_INSERTS,
-        nullptr,
-        errorCode,
-        MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
-        (LPWSTR)&s,
-        0,
-        nullptr
-    );
-    assert(s != nullptr);
-    while (size && isspace(s[size-1])) {
-        s[--size] = 0;
-    }
-    auto errorString = util::wstr2str_utf8(std::wstring(s));
-    LocalFree(s);
-    return std::runtime_error(message+" [WSA error=" + 
-           std::to_string(errorCode) + "]: "+errorString);
-}
-#endif
-
-static inline int connectsocket(
-    int descriptor, const sockaddr* addr, socklen_t len
-) noexcept {
-    return connect(descriptor, addr, len);
-}
-
-static inline int recvsocket(
-    int descriptor, char* buf, size_t len
-) noexcept {
-    return recv(descriptor, buf, len, 0);
-}
-
-static inline int sendsocket(
-    int descriptor, const char* buf, size_t len, int flags
-) noexcept {
-    return send(descriptor, buf, len, flags);
-}
-
-static std::string to_string(const sockaddr_in& addr, bool port=true) {
-    char ip[INET_ADDRSTRLEN];
-    if (inet_ntop(AF_INET, &(addr.sin_addr), ip, INET_ADDRSTRLEN)) {
-        return std::string(ip) +
-               (port ? (":" + std::to_string(htons(addr.sin_port))) : "");
-    }
-    return "";
-}
-
-class SocketTcpConnection : public TcpConnection {
-    SOCKET descriptor;
-    sockaddr_in addr;
-    size_t totalUpload = 0;
-    size_t totalDownload = 0;
-    ConnectionState state = ConnectionState::INITIAL;
-    std::unique_ptr<std::thread> thread = nullptr;
-    std::vector<char> readBatch;
-    util::Buffer<char> buffer;
-    std::mutex mutex;
-
-    void connectSocket() {
-        state = ConnectionState::CONNECTING;
-        logger.info() << "connecting to " << to_string(addr);
-        int res = connectsocket(descriptor, (const sockaddr*)&addr, sizeof(sockaddr_in));
-        if (res < 0) {
-            auto error = handle_socket_error("Connect failed");
-            closesocket(descriptor);
-            state = ConnectionState::CLOSED;
-            logger.error() << error.what();
-            return;
-        }
-        logger.info() << "connected to " << to_string(addr);
-        state = ConnectionState::CONNECTED;
-    }
-public:
-    SocketTcpConnection(SOCKET descriptor, sockaddr_in addr)
-        : descriptor(descriptor), addr(std::move(addr)), buffer(16'384) {}
-
-    ~SocketTcpConnection() {
-        if (state != ConnectionState::CLOSED) {
-            shutdown(descriptor, 2);
-        }
-        if (thread) {
-            thread->join();
-        }
-    }
-
-    void setNoDelay(bool noDelay) override {
-        int opt = noDelay ? 1 : 0;
-        if (setsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, sizeof(opt)) < 0) {
-            throw handle_socket_error("setsockopt(TCP_NODELAY) failed");
-        }
-    }
-
-    bool isNoDelay() const override {
-        int opt = 0;
-        socklen_t len = sizeof(opt);
-        if (getsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, &len) < 0) {
-            throw handle_socket_error("getsockopt(TCP_NODELAY) failed");
-        }
-        return opt != 0;
-    }
-
-    void startListen() {
-        while (state == ConnectionState::CONNECTED) {
-            int size = recvsocket(descriptor, buffer.data(), buffer.size());
-            if (size == 0) {
-                logger.info() << "closed connection with " << to_string(addr);
-                closesocket(descriptor);
-                state = ConnectionState::CLOSED;
-                break;
-            } else if (size < 0) {
-                logger.warning() << "an error ocurred while receiving from "
-                            << to_string(addr);
-                auto error = handle_socket_error("recv(...) error");
-                closesocket(descriptor);
-                state = ConnectionState::CLOSED;
-                logger.error() << error.what();
-                break;
-            }
-            {
-                std::lock_guard lock(mutex);
-                for (size_t i = 0; i < size; i++) {
-                    readBatch.emplace_back(buffer[i]);
-                }
-                totalDownload += size;
-            }
-        }
-    }
-
-    void startClient() {
-        state = ConnectionState::CONNECTED;
-        thread = std::make_unique<std::thread>([this]() { startListen();});
-    }
-
-    void connect(runnable callback) override {
-        thread = std::make_unique<std::thread>([this, callback]() {
-            connectSocket();
-            if (state == ConnectionState::CONNECTED) {
-                callback();
-            }
-            startListen();
-        });
-    }
-
-    int recv(char* buffer, size_t length) override {
-        std::lock_guard lock(mutex);
-
-        if (state != ConnectionState::CONNECTED && readBatch.empty()) {
-            return -1;
-        }
-        int size = std::min(readBatch.size(), length);
-        std::memcpy(buffer, readBatch.data(), size);
-        readBatch.erase(readBatch.begin(), readBatch.begin() + size);
-        return size;
-    }
-
-    int send(const char* buffer, size_t length) override {
-        if (state == ConnectionState::CLOSED) {
-            return 0;
-        }
-        int len = sendsocket(descriptor, buffer, length, 0);
-        if (len == -1) {
-            int err = errno;
-            close();
-            throw std::runtime_error(
-                "Send failed [errno=" + std::to_string(err) + "]: "
-                 + std::string(strerror(err))
-            );
-        }
-        totalUpload += len;
-        return len;
-    }
-
-    int available() override {
-        std::lock_guard lock(mutex);
-        return readBatch.size();
-    }
-
-    void close(bool discardAll=false) override {
-        {
-            std::lock_guard lock(mutex);
-            readBatch.clear();
-
-            if (state != ConnectionState::CLOSED) {
-                shutdown(descriptor, 2);
-                closesocket(descriptor);
-            }
-        }
-        if (thread) {
-            thread->join();
-            thread = nullptr;
-        }
-    }
-
-    size_t pullUpload() override {
-        size_t size = totalUpload;
-        totalUpload = 0;
-        return size;
-    }
-
-    size_t pullDownload() override {
-        size_t size = totalDownload;
-        totalDownload = 0;
-        return size;
-    }
-
-    int getPort() const override {
-        return htons(addr.sin_port);
-    }
-
-    std::string getAddress() const override {
-        return to_string(addr, false);
-    }
-
-    static std::shared_ptr<SocketTcpConnection> connect(
+    std::shared_ptr<TcpConnection> connect_tcp(
         const std::string& address, int port, runnable callback
-    ) {
-        addrinfo hints {};
+    );
 
-        hints.ai_family = AF_INET;
-        hints.ai_socktype = SOCK_STREAM;
-
-        addrinfo* addrinfo = nullptr;
-        if (int res = getaddrinfo(
-            address.c_str(), nullptr, &hints, &addrinfo
-        )) {
-            throw std::runtime_error(gai_strerror(res));
-        }
-
-        sockaddr_in serverAddress;
-        std::memcpy(&serverAddress, addrinfo->ai_addr, sizeof(sockaddr_in));
-        serverAddress.sin_port = htons(port);
-        freeaddrinfo(addrinfo);
-
-        SOCKET descriptor = socket(AF_INET, SOCK_STREAM, 0);
-        if (descriptor == -1) {
-            throw std::runtime_error("Could not create socket");
-        }
-        auto socket = std::make_shared<SocketTcpConnection>(descriptor, std::move(serverAddress));
-        socket->connect(std::move(callback));
-        return socket;
-    }
-
-    ConnectionState getState() const override {
-        return state;
-    }
-};
-
-class SocketTcpServer : public TcpServer {
-    u64id_t id;
-    Network* network;
-    SOCKET descriptor;
-    std::vector<u64id_t> clients;
-    std::mutex clientsMutex;
-    bool open = true;
-    std::unique_ptr<std::thread> thread = nullptr;
-    int port;
-public:
-    SocketTcpServer(u64id_t id, Network* network, SOCKET descriptor, int port)
-    : id(id), network(network), descriptor(descriptor), port(port) {}
-
-    ~SocketTcpServer() {
-        closeSocket();
-    }
-
-    void startListen(ConnectCallback handler) override {
-        thread = std::make_unique<std::thread>([this, handler]() {
-            while (open) {
-                logger.info() << "listening for connections";
-                if (listen(descriptor, 2) < 0) {
-                    close();
-                    break;
-                }
-                socklen_t addrlen = sizeof(sockaddr_in);
-                SOCKET clientDescriptor;
-                sockaddr_in address;
-                logger.info() << "accepting clients";
-                if ((clientDescriptor = accept(descriptor, (sockaddr*)&address, &addrlen)) == -1) {
-                    close();
-                    break;
-                }
-                logger.info() << "client connected: " << to_string(address);
-                auto socket = std::make_shared<SocketTcpConnection>(
-                    clientDescriptor, address
-                );
-                socket->startClient();
-                u64id_t id = network->addConnection(socket);
-                {
-                    std::lock_guard lock(clientsMutex);
-                    clients.push_back(id);
-                }
-                handler(this->id, id);
-            }
-        });
-    }
-    
-    void closeSocket() {
-        if (!open) {
-            return;
-        }
-        logger.info() << "closing server";
-        open = false;
-
-        {
-            std::lock_guard lock(clientsMutex);
-            for (u64id_t clientid : clients) {
-                if (auto client = network->getConnection(clientid)) {
-                    client->close();
-                }
-            }
-        }
-        clients.clear();
-
-        shutdown(descriptor, 2);
-        closesocket(descriptor);
-        thread->join();
-    }
-
-    void close() override {
-        closeSocket();
-    }
-    
-    bool isOpen() override {
-        return open;
-    }
-
-    int getPort() const override {
-        return port;
-    }
-
-    static std::shared_ptr<SocketTcpServer> openServer(
+    std::shared_ptr<TcpServer> open_tcp_server(
         u64id_t id, Network* network, int port, ConnectCallback handler
-    ) {
-        SOCKET descriptor = socket(
-            AF_INET, SOCK_STREAM, 0
-        );
-        if (descriptor == -1) {
-            throw std::runtime_error("Could not create server socket");
-        }
-        int opt = 1;
-        int flags = SO_REUSEADDR;
-#       if !defined(_WIN32) && !defined(__APPLE__)
-            flags |= SO_REUSEPORT;
-#       endif
-        if (setsockopt(descriptor, SOL_SOCKET, flags, (const char*)&opt, sizeof(opt))) {
-            logger.error() << "setsockopt(SO_REUSEADDR) failed with errno: "
-             << errno << "(" << std::strerror(errno) << ")";
-            closesocket(descriptor);
-            throw std::runtime_error("setsockopt");
-        }
-        sockaddr_in address;
-        address.sin_family = AF_INET;
-        address.sin_addr.s_addr = INADDR_ANY;
-        address.sin_port = htons(port);
-        if (bind(descriptor, (sockaddr*)&address, sizeof(address)) < 0) {
-            closesocket(descriptor);
-            throw std::runtime_error("could not bind port "+std::to_string(port));
-        }
-        logger.info() << "opened server at port " << port;
-        auto server =
-            std::make_shared<SocketTcpServer>(id, network, descriptor, port);
-        server->startListen(std::move(handler));
-        return server;
-    }
-};
+    );
 
-static sockaddr_in resolve_address_dgram(const std::string& address, int port) {
-    sockaddr_in serverAddr{};
-    addrinfo hints {};
-
-    hints.ai_family = AF_INET;
-    hints.ai_socktype = SOCK_DGRAM;
-
-    addrinfo* addrinfo = nullptr;
-    if (int res = getaddrinfo(
-        address.c_str(), nullptr, &hints, &addrinfo
-    )) {
-        throw std::runtime_error(gai_strerror(res));
-    }
-
-    std::memcpy(&serverAddr, addrinfo->ai_addr, sizeof(sockaddr_in));
-    serverAddr.sin_port = htons(port);
-    freeaddrinfo(addrinfo);
-    return serverAddr;
-}
-
-class SocketUdpConnection : public UdpConnection {
-    u64id_t id;
-    SOCKET descriptor;
-    sockaddr_in addr{};
-    bool open = true;
-    std::unique_ptr<std::thread> thread;
-    ClientDatagramCallback callback;
-
-    size_t totalUpload = 0;
-    size_t totalDownload = 0;
-    ConnectionState state = ConnectionState::INITIAL;
-
-public:
-    SocketUdpConnection(u64id_t id, SOCKET descriptor, sockaddr_in addr)
-        : id(id), descriptor(descriptor), addr(std::move(addr)) {}
-
-    ~SocketUdpConnection() override {
-        SocketUdpConnection::close();
-    }
-
-    static std::shared_ptr<SocketUdpConnection> connect(
+    std::shared_ptr<UdpConnection> connect_udp(
         u64id_t id,
         const std::string& address,
         int port,
         ClientDatagramCallback handler,
         runnable callback
-    ) {
-        SOCKET descriptor = socket(AF_INET, SOCK_DGRAM, 0);
-        if (descriptor == -1) {
-            throw std::runtime_error("could not create udp socket");
-        }
+    );
 
-        sockaddr_in serverAddr = resolve_address_dgram(address, port);
+    std::shared_ptr<UdpServer> open_udp_server(
+        u64id_t id,
+        Network* network,
+        int port,
+        const ServerDatagramCallback& handler
+    );
+}
 
-        if (::connect(descriptor, (sockaddr*)&serverAddr, sizeof(serverAddr)) < 0) {
-            auto err = handle_socket_error("udp connect failed");
-            closesocket(descriptor);
-            throw err;
-        }
-
-        auto socket = std::make_shared<SocketUdpConnection>(id, descriptor, serverAddr);
-        socket->connect(std::move(handler));
-
-        callback();
-
-        return socket;
-    }
-
-    void connect(ClientDatagramCallback handler) override {
-        callback = std::move(handler);
-        state = ConnectionState::CONNECTED;
-
-        thread = std::make_unique<std::thread>([this]() {
-            util::Buffer<char> buffer(16'384);
-            while (open) {
-                int size = recv(descriptor, buffer.data(), buffer.size(), 0);
-                if (size <= 0) {
-                    logger.error() << "udp connection " << id
-                                   << handle_socket_error(" recv error").what();
-                    if (!open) break;
-                    closesocket(descriptor);
-                    state = ConnectionState::CLOSED;
-                    break;
-                }
-                totalDownload += size;
-                if (callback) {
-                    callback(id, buffer.data(), size);
-                }
-            }
-        });
-    }
-
-    int send(const char* buffer, size_t length) override {
-        int len = ::send(descriptor, buffer, length, 0);
-        if (len < 0) {
-            auto err = handle_socket_error(" send failed");
-            closesocket(descriptor);
-            state = ConnectionState::CLOSED;
-            logger.error() << "udp connection " << id << err.what();
-        } else totalUpload += len;
-
-        return len;
-    }
-
-    void close(bool discardAll=false) override {
-        if (!open) return;
-        open = false;
-        logger.info() << "closing udp connection "<< id;
-
-        if (state != ConnectionState::CLOSED) {
-            shutdown(descriptor, 2);
-            closesocket(descriptor);
-        }
-
-        if (thread) {
-            thread->join();
-            thread.reset();
-        }
-        state = ConnectionState::CLOSED;
-    }
-
-    size_t pullUpload() override {
-        size_t s = totalUpload;
-        totalUpload = 0;
-        return s;
-    }
-
-    size_t pullDownload() override {
-        size_t s = totalDownload;
-        totalDownload = 0;
-        return s;
-    }
-
-    [[nodiscard]] int getPort() const override {
-        return ntohs(addr.sin_port);
-    }
-
-    [[nodiscard]] std::string getAddress() const override {
-        return to_string(addr, false);
-    }
-
-    [[nodiscard]] ConnectionState getState() const override {
-        return state;
-    }
-};
-
-class SocketUdpServer : public UdpServer {
-    u64id_t id;
-    SOCKET descriptor;
-    bool open = true;
-    std::unique_ptr<std::thread> thread = nullptr;
-    int port;
-    ServerDatagramCallback callback;
-
-public:
-    SocketUdpServer(u64id_t id, Network* network, SOCKET descriptor, int port)
-        : id(id), descriptor(descriptor), port(port) {}
-
-    ~SocketUdpServer() override {
-        SocketUdpServer::close();
-    }
-
-    void startListen(ServerDatagramCallback handler) override {
-        callback = std::move(handler);
-
-        thread = std::make_unique<std::thread>([this]() {
-            util::Buffer<char> buffer(16384);
-            sockaddr_in clientAddr{};
-            socklen_t addrlen = sizeof(clientAddr);
-
-            while (open) {
-                int size = recvfrom(descriptor, buffer.data(), buffer.size(), 0,
-                                    reinterpret_cast<sockaddr*>(&clientAddr), &addrlen);
-                if (size <= 0) {
-                    if (!open) break;
-                    continue;
-                }
-
-                std::string addrStr = to_string(clientAddr, false);
-                int port = ntohs(clientAddr.sin_port);
-
-                callback(id, addrStr, port, buffer.data(), size);
-            }
-        });
-    }
-
-    void sendTo(const std::string& addr, int port, const char* buffer, size_t length) override {
-        sockaddr_in client = resolve_address_dgram(addr, port);
-        if (sendto(descriptor, buffer, length, 0,
-               reinterpret_cast<sockaddr*>(&client), sizeof(client)) < 0) {
-            logger.error() << handle_socket_error("sendto").what();
-        }
-    }
-
-    void close() override {
-        if (!open) return;
-        open = false;
-        shutdown(descriptor, 2);
-        closesocket(descriptor);
-        if (thread) {
-            thread->join();
-            thread = nullptr;
-        }
-    }
-
-    bool isOpen() override { return open; }
-    int getPort() const override { return port; }
-
-    static std::shared_ptr<SocketUdpServer> openServer(
-        u64id_t id, Network* network, int port, const ServerDatagramCallback& handler
-    ) {
-        SOCKET descriptor = socket(AF_INET, SOCK_DGRAM, 0);
-        if (descriptor == -1) throw std::runtime_error("could not create udp socket");
-
-        sockaddr_in address{};
-        address.sin_family = AF_INET;
-        address.sin_addr.s_addr = INADDR_ANY;
-        address.sin_port = htons(port);
-
-        if (bind(descriptor, (sockaddr*)&address, sizeof(address)) < 0) {
-            closesocket(descriptor);
-            throw std::runtime_error("could not bind udp port " + std::to_string(port));
-        }
-
-        auto server = std::make_shared<SocketUdpServer>(id, network, descriptor, port);
-        server->startListen(std::move(handler));
-        return server;
-    }
-};
 
 Network::Network(std::unique_ptr<Requests> requests)
 : requests(std::move(requests)) {
@@ -894,19 +69,19 @@ void Network::post(
     );
 }
 
-Connection* Network::getConnection(u64id_t id) {
+Connection* Network::getConnection(u64id_t id, bool includePrivate) {
     std::lock_guard lock(connectionsMutex);
 
     const auto& found = connections.find(id);
-    if (found == connections.end()) {
+    if (found == connections.end() || (!includePrivate && found->second->isPrivate())) {
         return nullptr;
     }
     return found->second.get();
 }
 
-Server* Network::getServer(u64id_t id) const {
+Server* Network::getServer(u64id_t id, bool includePrivate) const {
     const auto& found = servers.find(id);
-    if (found == servers.end()) {
+    if (found == servers.end() || (!includePrivate && found->second->isPrivate())) {
         return nullptr;
     }
     return found->second.get();
@@ -916,7 +91,7 @@ u64id_t Network::connectTcp(const std::string& address, int port, consumer<u64id
     std::lock_guard lock(connectionsMutex);
     
     u64id_t id = nextConnection++;
-    auto socket = SocketTcpConnection::connect(address, port, [id, callback]() {
+    auto socket = connect_tcp(address, port, [id, callback]() {
         callback(id);
     });
     connections[id] = std::move(socket);
@@ -925,16 +100,21 @@ u64id_t Network::connectTcp(const std::string& address, int port, consumer<u64id
 
 u64id_t Network::openTcpServer(int port, ConnectCallback handler) {
     u64id_t id = nextServer++;
-    auto server = SocketTcpServer::openServer(id, this, port, handler);
+    auto server = open_tcp_server(id, this, port, handler);
     servers[id] = std::move(server);
     return id;
 }
 
-u64id_t Network::connectUdp(const std::string& address, int port, const consumer<u64id_t>& callback, ClientDatagramCallback handler) {
+u64id_t Network::connectUdp(
+    const std::string& address,
+    int port,
+    const consumer<u64id_t>& callback,
+    ClientDatagramCallback handler
+) {
     std::lock_guard lock(connectionsMutex);
 
     u64id_t id = nextConnection++;
-    auto socket = SocketUdpConnection::connect(id, address, port, std::move(handler), [id, callback]() {
+    auto socket = connect_udp(id, address, port, std::move(handler), [id, callback]() {
         callback(id);
     });
     connections[id] = std::move(socket);
@@ -943,7 +123,7 @@ u64id_t Network::connectUdp(const std::string& address, int port, const consumer
 
 u64id_t Network::openUdpServer(int port, const ServerDatagramCallback& handler) {
     u64id_t id = nextServer++;
-    auto server = SocketUdpServer::openServer(id, this, port, handler);
+    auto server = open_udp_server(id, this, port, handler);
     servers[id] = std::move(server);
     return id;
 }
@@ -997,6 +177,5 @@ void Network::update() {
 }
 
 std::unique_ptr<Network> Network::create(const NetworkSettings& settings) {
-    auto requests = CurlRequests::create();
-    return std::make_unique<Network>(std::move(requests));
+    return std::make_unique<Network>(network::create_curl_requests());
 }
diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index 3fec46e0..a6c2fca2 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -1,75 +1,8 @@
 #pragma once
 
-#include <memory>
-#include <vector>
-#include <mutex>
-
-#include "typedefs.hpp"
-#include "settings.hpp"
-#include "util/Buffer.hpp"
-#include "delegates.hpp"
+#include "commons.hpp"
 
 namespace network {
-    using OnResponse = std::function<void(std::vector<char>)>;
-    using OnReject = std::function<void(int, std::vector<char>)>;
-    using ConnectCallback = std::function<void(u64id_t, u64id_t)>;
-    using ServerDatagramCallback = std::function<void(u64id_t sid, const std::string& addr, int port, const char* buffer, size_t length)>;
-    using ClientDatagramCallback = std::function<void(u64id_t cid, const char* buffer, size_t length)>;
-
-    class Requests {
-    public:
-        virtual ~Requests() {}
-
-        virtual void get(
-            const std::string& url,
-            OnResponse onResponse,
-            OnReject onReject=nullptr,
-            std::vector<std::string> headers = {},
-            long maxSize=0
-        ) = 0;
-
-        virtual void post(
-            const std::string& url,
-            const std::string& data,
-            OnResponse onResponse,
-            OnReject onReject=nullptr,
-            std::vector<std::string> headers = {},
-            long maxSize=0
-        ) = 0;
-
-        [[nodiscard]] virtual size_t getTotalUpload() const = 0;
-        [[nodiscard]] virtual size_t getTotalDownload() const = 0;
-
-        virtual void update() = 0;
-    };
-
-    enum class ConnectionState {
-        INITIAL, CONNECTING, CONNECTED, CLOSED
-    };
-
-    enum class TransportType {
-        TCP, UDP
-    };
-
-    class Connection {
-    public:
-        virtual ~Connection() = default;
-
-        virtual void close(bool discardAll=false) = 0;
-
-        virtual int send(const char* buffer, size_t length) = 0;
-
-        virtual size_t pullUpload() = 0;
-        virtual size_t pullDownload() = 0;
-
-        [[nodiscard]] virtual int getPort() const = 0;
-        [[nodiscard]] virtual std::string getAddress() const = 0;
-
-        [[nodiscard]] virtual ConnectionState getState() const = 0;
-
-        [[nodiscard]] virtual TransportType getTransportType() const noexcept = 0;
-    };
-
     class TcpConnection : public Connection {
     public:
         ~TcpConnection() override = default;
@@ -96,15 +29,6 @@ namespace network {
         }
     };
 
-    class Server {
-    public:
-        virtual ~Server() = default;
-        virtual void close() = 0;
-        virtual bool isOpen() = 0;
-        [[nodiscard]] virtual TransportType getTransportType() const noexcept = 0;
-        [[nodiscard]] virtual int getPort() const = 0;
-    };
-
     class TcpServer : public Server {
     public:
         ~TcpServer() override {}
@@ -160,8 +84,8 @@ namespace network {
             long maxSize=0
         );
 
-        [[nodiscard]] Connection* getConnection(u64id_t id);
-        [[nodiscard]] Server* getServer(u64id_t id) const;
+        [[nodiscard]] Connection* getConnection(u64id_t id, bool includePrivate);
+        [[nodiscard]] Server* getServer(u64id_t id, bool includePrivate) const;
 
         u64id_t connectTcp(const std::string& address, int port, consumer<u64id_t> callback);
         u64id_t connectUdp(const std::string& address, int port, const consumer<u64id_t>& callback, ClientDatagramCallback handler);
diff --git a/src/network/Sockets.cpp b/src/network/Sockets.cpp
new file mode 100644
index 00000000..5152028b
--- /dev/null
+++ b/src/network/Sockets.cpp
@@ -0,0 +1,679 @@
+#include "commons.hpp"
+
+#pragma comment(lib, "Ws2_32.lib")
+
+#define NOMINMAX
+#include <stdexcept>
+#include <limits>
+#include <queue>
+#include <thread>
+
+#ifdef _WIN32
+#include <curl/curl.h>
+#else
+#include <sys/types.h>
+#include <sys/socket.h>
+#include <netdb.h>
+#include <netinet/in.h>
+#include <netinet/tcp.h>
+#include <arpa/inet.h>
+#include <unistd.h>
+#include <fcntl.h>
+#include <errno.h>
+
+using SOCKET = int;
+#endif // _WIN32
+
+#include "Network.hpp"
+#include "util/stringutil.hpp"
+#include "debug/Logger.hpp"
+
+using namespace network;
+
+static debug::Logger logger("sockets");
+
+#ifndef _WIN32
+static inline int closesocket(int descriptor) noexcept {
+    return close(descriptor);
+}
+static inline std::runtime_error handle_socket_error(const std::string& message) {
+    int err = errno;
+    return std::runtime_error(
+        message+" [errno=" + std::to_string(err) + "]: " + 
+        std::string(strerror(err))
+    );
+}
+#else
+static inline std::runtime_error handle_socket_error(const std::string& message) {
+    int errorCode = WSAGetLastError();
+    wchar_t* s = nullptr;
+    size_t size = FormatMessageW(
+        FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM |
+            FORMAT_MESSAGE_IGNORE_INSERTS,
+        nullptr,
+        errorCode,
+        MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
+        (LPWSTR)&s,
+        0,
+        nullptr
+    );
+    assert(s != nullptr);
+    while (size && isspace(s[size-1])) {
+        s[--size] = 0;
+    }
+    auto errorString = util::wstr2str_utf8(std::wstring(s));
+    LocalFree(s);
+    return std::runtime_error(message+" [WSA error=" + 
+           std::to_string(errorCode) + "]: "+errorString);
+}
+#endif
+
+static inline int connectsocket(
+    int descriptor, const sockaddr* addr, socklen_t len
+) noexcept {
+    return connect(descriptor, addr, len);
+}
+
+static inline int recvsocket(
+    int descriptor, char* buf, size_t len
+) noexcept {
+    return recv(descriptor, buf, len, 0);
+}
+
+static inline int sendsocket(
+    int descriptor, const char* buf, size_t len, int flags
+) noexcept {
+    return send(descriptor, buf, len, flags);
+}
+
+static std::string to_string(const sockaddr_in& addr, bool port=true) {
+    char ip[INET_ADDRSTRLEN];
+    if (inet_ntop(AF_INET, &(addr.sin_addr), ip, INET_ADDRSTRLEN)) {
+        return std::string(ip) +
+               (port ? (":" + std::to_string(htons(addr.sin_port))) : "");
+    }
+    return "";
+}
+
+class SocketTcpConnection : public TcpConnection {
+    SOCKET descriptor;
+    sockaddr_in addr;
+    size_t totalUpload = 0;
+    size_t totalDownload = 0;
+    ConnectionState state = ConnectionState::INITIAL;
+    std::unique_ptr<std::thread> thread = nullptr;
+    std::vector<char> readBatch;
+    util::Buffer<char> buffer;
+    std::mutex mutex;
+
+    void connectSocket() {
+        state = ConnectionState::CONNECTING;
+        logger.info() << "connecting to " << to_string(addr);
+        int res = connectsocket(descriptor, (const sockaddr*)&addr, sizeof(sockaddr_in));
+        if (res < 0) {
+            auto error = handle_socket_error("Connect failed");
+            closesocket(descriptor);
+            state = ConnectionState::CLOSED;
+            logger.error() << error.what();
+            return;
+        }
+        logger.info() << "connected to " << to_string(addr);
+        state = ConnectionState::CONNECTED;
+    }
+public:
+    SocketTcpConnection(SOCKET descriptor, sockaddr_in addr)
+        : descriptor(descriptor), addr(std::move(addr)), buffer(16'384) {}
+
+    ~SocketTcpConnection() {
+        if (state != ConnectionState::CLOSED) {
+            shutdown(descriptor, 2);
+        }
+        if (thread) {
+            thread->join();
+        }
+    }
+
+    void setNoDelay(bool noDelay) override {
+        int opt = noDelay ? 1 : 0;
+        if (setsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, sizeof(opt)) < 0) {
+            throw handle_socket_error("setsockopt(TCP_NODELAY) failed");
+        }
+    }
+
+    bool isNoDelay() const override {
+        int opt = 0;
+        socklen_t len = sizeof(opt);
+        if (getsockopt(descriptor, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, &len) < 0) {
+            throw handle_socket_error("getsockopt(TCP_NODELAY) failed");
+        }
+        return opt != 0;
+    }
+
+    void startListen() {
+        while (state == ConnectionState::CONNECTED) {
+            int size = recvsocket(descriptor, buffer.data(), buffer.size());
+            if (size == 0) {
+                logger.info() << "closed connection with " << to_string(addr);
+                closesocket(descriptor);
+                state = ConnectionState::CLOSED;
+                break;
+            } else if (size < 0) {
+                logger.warning() << "an error ocurred while receiving from "
+                            << to_string(addr);
+                auto error = handle_socket_error("recv(...) error");
+                closesocket(descriptor);
+                state = ConnectionState::CLOSED;
+                logger.error() << error.what();
+                break;
+            }
+            {
+                std::lock_guard lock(mutex);
+                for (size_t i = 0; i < size; i++) {
+                    readBatch.emplace_back(buffer[i]);
+                }
+                totalDownload += size;
+            }
+        }
+    }
+
+    void startClient() {
+        state = ConnectionState::CONNECTED;
+        thread = std::make_unique<std::thread>([this]() { startListen();});
+    }
+
+    void connect(runnable callback) override {
+        thread = std::make_unique<std::thread>([this, callback]() {
+            connectSocket();
+            if (state == ConnectionState::CONNECTED) {
+                callback();
+            }
+            startListen();
+        });
+    }
+
+    int recv(char* buffer, size_t length) override {
+        std::lock_guard lock(mutex);
+
+        if (state != ConnectionState::CONNECTED && readBatch.empty()) {
+            return -1;
+        }
+        int size = std::min(readBatch.size(), length);
+        std::memcpy(buffer, readBatch.data(), size);
+        readBatch.erase(readBatch.begin(), readBatch.begin() + size);
+        return size;
+    }
+
+    int send(const char* buffer, size_t length) override {
+        if (state == ConnectionState::CLOSED) {
+            return 0;
+        }
+        int len = sendsocket(descriptor, buffer, length, 0);
+        if (len == -1) {
+            int err = errno;
+            close();
+            throw std::runtime_error(
+                "Send failed [errno=" + std::to_string(err) + "]: "
+                 + std::string(strerror(err))
+            );
+        }
+        totalUpload += len;
+        return len;
+    }
+
+    int available() override {
+        std::lock_guard lock(mutex);
+        return readBatch.size();
+    }
+
+    void close(bool discardAll=false) override {
+        {
+            std::lock_guard lock(mutex);
+            readBatch.clear();
+
+            if (state != ConnectionState::CLOSED) {
+                shutdown(descriptor, 2);
+                closesocket(descriptor);
+            }
+        }
+        if (thread) {
+            thread->join();
+            thread = nullptr;
+        }
+    }
+
+    size_t pullUpload() override {
+        size_t size = totalUpload;
+        totalUpload = 0;
+        return size;
+    }
+
+    size_t pullDownload() override {
+        size_t size = totalDownload;
+        totalDownload = 0;
+        return size;
+    }
+
+    int getPort() const override {
+        return htons(addr.sin_port);
+    }
+
+    std::string getAddress() const override {
+        return to_string(addr, false);
+    }
+
+    static std::shared_ptr<SocketTcpConnection> connect(
+        const std::string& address, int port, runnable callback
+    ) {
+        addrinfo hints {};
+
+        hints.ai_family = AF_INET;
+        hints.ai_socktype = SOCK_STREAM;
+
+        addrinfo* addrinfo = nullptr;
+        if (int res = getaddrinfo(
+            address.c_str(), nullptr, &hints, &addrinfo
+        )) {
+            throw std::runtime_error(gai_strerror(res));
+        }
+
+        sockaddr_in serverAddress;
+        std::memcpy(&serverAddress, addrinfo->ai_addr, sizeof(sockaddr_in));
+        serverAddress.sin_port = htons(port);
+        freeaddrinfo(addrinfo);
+
+        SOCKET descriptor = socket(AF_INET, SOCK_STREAM, 0);
+        if (descriptor == -1) {
+            throw std::runtime_error("Could not create socket");
+        }
+        auto socket = std::make_shared<SocketTcpConnection>(descriptor, std::move(serverAddress));
+        socket->connect(std::move(callback));
+        return socket;
+    }
+
+    ConnectionState getState() const override {
+        return state;
+    }
+};
+
+class SocketTcpServer : public TcpServer {
+    u64id_t id;
+    Network* network;
+    SOCKET descriptor;
+    std::vector<u64id_t> clients;
+    std::mutex clientsMutex;
+    bool open = true;
+    std::unique_ptr<std::thread> thread = nullptr;
+    int port;
+public:
+    SocketTcpServer(u64id_t id, Network* network, SOCKET descriptor, int port)
+    : id(id), network(network), descriptor(descriptor), port(port) {}
+
+    ~SocketTcpServer() {
+        closeSocket();
+    }
+
+    void startListen(ConnectCallback handler) override {
+        thread = std::make_unique<std::thread>([this, handler]() {
+            while (open) {
+                logger.info() << "listening for connections";
+                if (listen(descriptor, 2) < 0) {
+                    close();
+                    break;
+                }
+                socklen_t addrlen = sizeof(sockaddr_in);
+                SOCKET clientDescriptor;
+                sockaddr_in address;
+                logger.info() << "accepting clients";
+                if ((clientDescriptor = accept(descriptor, (sockaddr*)&address, &addrlen)) == -1) {
+                    close();
+                    break;
+                }
+                logger.info() << "client connected: " << to_string(address);
+                auto socket = std::make_shared<SocketTcpConnection>(
+                    clientDescriptor, address
+                );
+                socket->startClient();
+                u64id_t id = network->addConnection(socket);
+                {
+                    std::lock_guard lock(clientsMutex);
+                    clients.push_back(id);
+                }
+                handler(this->id, id);
+            }
+        });
+    }
+    
+    void closeSocket() {
+        if (!open) {
+            return;
+        }
+        logger.info() << "closing server";
+        open = false;
+
+        {
+            std::lock_guard lock(clientsMutex);
+            for (u64id_t clientid : clients) {
+                if (auto client = network->getConnection(clientid, true)) {
+                    client->close();
+                }
+            }
+        }
+        clients.clear();
+
+        shutdown(descriptor, 2);
+        closesocket(descriptor);
+        thread->join();
+    }
+
+    void close() override {
+        closeSocket();
+    }
+    
+    bool isOpen() override {
+        return open;
+    }
+
+    int getPort() const override {
+        return port;
+    }
+
+    static std::shared_ptr<SocketTcpServer> openServer(
+        u64id_t id, Network* network, int port, ConnectCallback handler
+    ) {
+        SOCKET descriptor = socket(
+            AF_INET, SOCK_STREAM, 0
+        );
+        if (descriptor == -1) {
+            throw std::runtime_error("Could not create server socket");
+        }
+        int opt = 1;
+        int flags = SO_REUSEADDR;
+#       if !defined(_WIN32) && !defined(__APPLE__)
+            flags |= SO_REUSEPORT;
+#       endif
+        if (setsockopt(descriptor, SOL_SOCKET, flags, (const char*)&opt, sizeof(opt))) {
+            logger.error() << "setsockopt(SO_REUSEADDR) failed with errno: "
+             << errno << "(" << std::strerror(errno) << ")";
+            closesocket(descriptor);
+            throw std::runtime_error("setsockopt");
+        }
+        sockaddr_in address;
+        address.sin_family = AF_INET;
+        address.sin_addr.s_addr = INADDR_ANY;
+        address.sin_port = htons(port);
+        if (bind(descriptor, (sockaddr*)&address, sizeof(address)) < 0) {
+            closesocket(descriptor);
+            throw std::runtime_error("could not bind port "+std::to_string(port));
+        }
+        logger.info() << "opened server at port " << port;
+        auto server =
+            std::make_shared<SocketTcpServer>(id, network, descriptor, port);
+        server->startListen(std::move(handler));
+        return server;
+    }
+};
+
+static sockaddr_in resolve_address_dgram(const std::string& address, int port) {
+    sockaddr_in serverAddr{};
+    addrinfo hints {};
+
+    hints.ai_family = AF_INET;
+    hints.ai_socktype = SOCK_DGRAM;
+
+    addrinfo* addrinfo = nullptr;
+    if (int res = getaddrinfo(
+        address.c_str(), nullptr, &hints, &addrinfo
+    )) {
+        throw std::runtime_error(gai_strerror(res));
+    }
+
+    std::memcpy(&serverAddr, addrinfo->ai_addr, sizeof(sockaddr_in));
+    serverAddr.sin_port = htons(port);
+    freeaddrinfo(addrinfo);
+    return serverAddr;
+}
+
+class SocketUdpConnection : public UdpConnection {
+    u64id_t id;
+    SOCKET descriptor;
+    sockaddr_in addr{};
+    bool open = true;
+    std::unique_ptr<std::thread> thread;
+    ClientDatagramCallback callback;
+
+    size_t totalUpload = 0;
+    size_t totalDownload = 0;
+    ConnectionState state = ConnectionState::INITIAL;
+
+public:
+    SocketUdpConnection(u64id_t id, SOCKET descriptor, sockaddr_in addr)
+        : id(id), descriptor(descriptor), addr(std::move(addr)) {}
+
+    ~SocketUdpConnection() override {
+        SocketUdpConnection::close();
+    }
+
+    static std::shared_ptr<SocketUdpConnection> connect(
+        u64id_t id,
+        const std::string& address,
+        int port,
+        ClientDatagramCallback handler,
+        runnable callback
+    ) {
+        SOCKET descriptor = socket(AF_INET, SOCK_DGRAM, 0);
+        if (descriptor == -1) {
+            throw std::runtime_error("could not create udp socket");
+        }
+
+        sockaddr_in serverAddr = resolve_address_dgram(address, port);
+
+        if (::connect(descriptor, (sockaddr*)&serverAddr, sizeof(serverAddr)) < 0) {
+            auto err = handle_socket_error("udp connect failed");
+            closesocket(descriptor);
+            throw err;
+        }
+
+        auto socket = std::make_shared<SocketUdpConnection>(id, descriptor, serverAddr);
+        socket->connect(std::move(handler));
+
+        callback();
+
+        return socket;
+    }
+
+    void connect(ClientDatagramCallback handler) override {
+        callback = std::move(handler);
+        state = ConnectionState::CONNECTED;
+
+        thread = std::make_unique<std::thread>([this]() {
+            util::Buffer<char> buffer(16'384);
+            while (open) {
+                int size = recv(descriptor, buffer.data(), buffer.size(), 0);
+                if (size <= 0) {
+                    logger.error() << "udp connection " << id
+                                   << handle_socket_error(" recv error").what();
+                    if (!open) break;
+                    closesocket(descriptor);
+                    state = ConnectionState::CLOSED;
+                    break;
+                }
+                totalDownload += size;
+                if (callback) {
+                    callback(id, buffer.data(), size);
+                }
+            }
+        });
+    }
+
+    int send(const char* buffer, size_t length) override {
+        int len = ::send(descriptor, buffer, length, 0);
+        if (len < 0) {
+            auto err = handle_socket_error(" send failed");
+            closesocket(descriptor);
+            state = ConnectionState::CLOSED;
+            logger.error() << "udp connection " << id << err.what();
+        } else totalUpload += len;
+
+        return len;
+    }
+
+    void close(bool discardAll=false) override {
+        if (!open) return;
+        open = false;
+        logger.info() << "closing udp connection "<< id;
+
+        if (state != ConnectionState::CLOSED) {
+            shutdown(descriptor, 2);
+            closesocket(descriptor);
+        }
+
+        if (thread) {
+            thread->join();
+            thread.reset();
+        }
+        state = ConnectionState::CLOSED;
+    }
+
+    size_t pullUpload() override {
+        size_t s = totalUpload;
+        totalUpload = 0;
+        return s;
+    }
+
+    size_t pullDownload() override {
+        size_t s = totalDownload;
+        totalDownload = 0;
+        return s;
+    }
+
+    [[nodiscard]] int getPort() const override {
+        return ntohs(addr.sin_port);
+    }
+
+    [[nodiscard]] std::string getAddress() const override {
+        return to_string(addr, false);
+    }
+
+    [[nodiscard]] ConnectionState getState() const override {
+        return state;
+    }
+};
+
+class SocketUdpServer : public UdpServer {
+    u64id_t id;
+    SOCKET descriptor;
+    bool open = true;
+    std::unique_ptr<std::thread> thread = nullptr;
+    int port;
+    ServerDatagramCallback callback;
+
+public:
+    SocketUdpServer(u64id_t id, Network* network, SOCKET descriptor, int port)
+        : id(id), descriptor(descriptor), port(port) {}
+
+    ~SocketUdpServer() override {
+        SocketUdpServer::close();
+    }
+
+    void startListen(ServerDatagramCallback handler) override {
+        callback = std::move(handler);
+
+        thread = std::make_unique<std::thread>([this]() {
+            util::Buffer<char> buffer(16384);
+            sockaddr_in clientAddr{};
+            socklen_t addrlen = sizeof(clientAddr);
+
+            while (open) {
+                int size = recvfrom(descriptor, buffer.data(), buffer.size(), 0,
+                                    reinterpret_cast<sockaddr*>(&clientAddr), &addrlen);
+                if (size <= 0) {
+                    if (!open) break;
+                    continue;
+                }
+
+                std::string addrStr = to_string(clientAddr, false);
+                int port = ntohs(clientAddr.sin_port);
+
+                callback(id, addrStr, port, buffer.data(), size);
+            }
+        });
+    }
+
+    void sendTo(const std::string& addr, int port, const char* buffer, size_t length) override {
+        sockaddr_in client = resolve_address_dgram(addr, port);
+        if (sendto(descriptor, buffer, length, 0,
+               reinterpret_cast<sockaddr*>(&client), sizeof(client)) < 0) {
+            logger.error() << handle_socket_error("sendto").what();
+        }
+    }
+
+    void close() override {
+        if (!open) return;
+        open = false;
+        shutdown(descriptor, 2);
+        closesocket(descriptor);
+        if (thread) {
+            thread->join();
+            thread = nullptr;
+        }
+    }
+
+    bool isOpen() override { return open; }
+    int getPort() const override { return port; }
+
+    static std::shared_ptr<SocketUdpServer> openServer(
+        u64id_t id, Network* network, int port, const ServerDatagramCallback& handler
+    ) {
+        SOCKET descriptor = socket(AF_INET, SOCK_DGRAM, 0);
+        if (descriptor == -1) throw std::runtime_error("could not create udp socket");
+
+        sockaddr_in address{};
+        address.sin_family = AF_INET;
+        address.sin_addr.s_addr = INADDR_ANY;
+        address.sin_port = htons(port);
+
+        if (bind(descriptor, (sockaddr*)&address, sizeof(address)) < 0) {
+            closesocket(descriptor);
+            throw std::runtime_error("could not bind udp port " + std::to_string(port));
+        }
+
+        auto server = std::make_shared<SocketUdpServer>(id, network, descriptor, port);
+        server->startListen(std::move(handler));
+        return server;
+    }
+};
+
+namespace network {
+    std::shared_ptr<TcpConnection> connect_tcp(
+        const std::string& address, int port, runnable callback
+    ) {
+        return SocketTcpConnection::connect(address, port, std::move(callback));
+    }
+
+    std::shared_ptr<TcpServer> open_tcp_server(
+        u64id_t id, Network* network, int port, ConnectCallback handler
+    ) {
+        return SocketTcpServer::openServer(id, network, port, std::move(handler));
+    }
+
+    std::shared_ptr<UdpConnection> connect_udp(
+        u64id_t id,
+        const std::string& address,
+        int port,
+        ClientDatagramCallback handler,
+        runnable callback
+    ) {
+        return SocketUdpConnection::connect(
+            id, address, port, std::move(handler), std::move(callback)
+        );
+    }
+
+    std::shared_ptr<UdpServer> open_udp_server(
+        u64id_t id,
+        Network* network,
+        int port,
+        const ServerDatagramCallback& handler
+    ) {
+        return SocketUdpServer::openServer(id, network, port, handler);
+    }
+}
diff --git a/src/network/commons.hpp b/src/network/commons.hpp
new file mode 100644
index 00000000..83881c52
--- /dev/null
+++ b/src/network/commons.hpp
@@ -0,0 +1,91 @@
+#pragma once
+
+#include "typedefs.hpp"
+#include "settings.hpp"
+#include "util/Buffer.hpp"
+#include "delegates.hpp"
+
+#include <memory>
+#include <vector>
+#include <mutex>
+
+namespace network {
+    using OnResponse = std::function<void(std::vector<char>)>;
+    using OnReject = std::function<void(int, std::vector<char>)>;
+    using ConnectCallback = std::function<void(u64id_t, u64id_t)>;
+    using ServerDatagramCallback = std::function<void(u64id_t sid, const std::string& addr, int port, const char* buffer, size_t length)>;
+    using ClientDatagramCallback = std::function<void(u64id_t cid, const char* buffer, size_t length)>;
+
+    class Requests {
+    public:
+        virtual ~Requests() {}
+
+        virtual void get(
+            const std::string& url,
+            OnResponse onResponse,
+            OnReject onReject=nullptr,
+            std::vector<std::string> headers = {},
+            long maxSize=0
+        ) = 0;
+
+        virtual void post(
+            const std::string& url,
+            const std::string& data,
+            OnResponse onResponse,
+            OnReject onReject=nullptr,
+            std::vector<std::string> headers = {},
+            long maxSize=0
+        ) = 0;
+
+        [[nodiscard]] virtual size_t getTotalUpload() const = 0;
+        [[nodiscard]] virtual size_t getTotalDownload() const = 0;
+
+        virtual void update() = 0;
+    };
+
+    enum class ConnectionState {
+        INITIAL, CONNECTING, CONNECTED, CLOSED
+    };
+
+    enum class TransportType {
+        TCP, UDP
+    };
+
+    class Connection {
+    public:
+        virtual ~Connection() = default;
+
+        virtual void close(bool discardAll=false) = 0;
+
+        virtual int send(const char* buffer, size_t length) = 0;
+
+        virtual size_t pullUpload() = 0;
+        virtual size_t pullDownload() = 0;
+
+        bool isPrivate() const { return isprivate; }
+        void setPrivate(bool flag) {isprivate = flag;}
+
+        [[nodiscard]] virtual int getPort() const = 0;
+        [[nodiscard]] virtual std::string getAddress() const = 0;
+
+        [[nodiscard]] virtual ConnectionState getState() const = 0;
+
+        [[nodiscard]] virtual TransportType getTransportType() const noexcept = 0;
+    protected:
+        bool isprivate = false;
+    };
+
+    class Server {
+    public:
+        virtual ~Server() = default;
+        virtual void close() = 0;
+        virtual bool isOpen() = 0;
+        [[nodiscard]] virtual TransportType getTransportType() const noexcept = 0;
+        [[nodiscard]] virtual int getPort() const = 0;
+
+        bool isPrivate() const { return isprivate; }
+        void setPrivate(bool flag) { isprivate = flag; }
+    protected:
+        bool isprivate = false;
+    };
+}

From 2895cff5f246ad11f48f829d1af3fdddecd4aa92 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 5 Oct 2025 22:52:55 +0300
Subject: [PATCH 028/133] feat: max clients connected limit in TcpServer

---
 src/network/Network.cpp | 17 +++++++++--------
 src/network/Network.hpp |  2 ++
 src/network/Sockets.cpp | 24 ++++++++++++++++++++++++
 src/network/commons.hpp |  2 ++
 4 files changed, 37 insertions(+), 8 deletions(-)

diff --git a/src/network/Network.cpp b/src/network/Network.cpp
index 04c8dbec..be3f8d33 100644
--- a/src/network/Network.cpp
+++ b/src/network/Network.cpp
@@ -164,15 +164,16 @@ void Network::update() {
             }
             ++socketiter;
         }
-        auto serveriter = servers.begin();
-        while (serveriter != servers.end()) {
-            auto server = serveriter->second.get();
-            if (!server->isOpen()) {
-                serveriter = servers.erase(serveriter);
-                continue;
-            }
-            ++serveriter;
+    }
+    auto serveriter = servers.begin();
+    while (serveriter != servers.end()) {
+        auto server = serveriter->second.get();
+        if (!server->isOpen()) {
+            serveriter = servers.erase(serveriter);
+            continue;
         }
+        server->update();
+        ++serveriter;
     }
 }
 
diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index a6c2fca2..047e07b4 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -37,6 +37,8 @@ namespace network {
         [[nodiscard]] TransportType getTransportType() const noexcept override {
             return TransportType::TCP;
         }
+
+        virtual void setMaxClientsConnected(int count) = 0;
     };
 
     class UdpServer : public Server {
diff --git a/src/network/Sockets.cpp b/src/network/Sockets.cpp
index 5152028b..9e145da0 100644
--- a/src/network/Sockets.cpp
+++ b/src/network/Sockets.cpp
@@ -304,6 +304,7 @@ class SocketTcpServer : public TcpServer {
     bool open = true;
     std::unique_ptr<std::thread> thread = nullptr;
     int port;
+    int maxConnected = -1;
 public:
     SocketTcpServer(u64id_t id, Network* network, SOCKET descriptor, int port)
     : id(id), network(network), descriptor(descriptor), port(port) {}
@@ -312,6 +313,22 @@ public:
         closeSocket();
     }
 
+    void setMaxClientsConnected(int count) override {
+        maxConnected = count;
+    }
+
+    void update() override {
+        std::vector<u64id_t> clients;
+        for (u64id_t cid : this->clients) {
+            if (auto client = network->getConnection(cid, true)) {
+                if (client->getState() != ConnectionState::CLOSED) {
+                    clients.emplace_back(cid);
+                }
+            }
+        }
+        std::swap(clients, this->clients);
+    }
+
     void startListen(ConnectCallback handler) override {
         thread = std::make_unique<std::thread>([this, handler]() {
             while (open) {
@@ -328,6 +345,11 @@ public:
                     close();
                     break;
                 }
+                if (maxConnected >= 0 && clients.size() >= maxConnected) {
+                    logger.info() << "refused connection attempt from " << to_string(address);
+                    closesocket(clientDescriptor);
+                    continue;
+                }
                 logger.info() << "client connected: " << to_string(address);
                 auto socket = std::make_shared<SocketTcpConnection>(
                     clientDescriptor, address
@@ -575,6 +597,8 @@ public:
         SocketUdpServer::close();
     }
 
+    void update() override {}
+
     void startListen(ServerDatagramCallback handler) override {
         callback = std::move(handler);
 
diff --git a/src/network/commons.hpp b/src/network/commons.hpp
index 83881c52..ad3c0806 100644
--- a/src/network/commons.hpp
+++ b/src/network/commons.hpp
@@ -78,6 +78,8 @@ namespace network {
     class Server {
     public:
         virtual ~Server() = default;
+
+        virtual void update() = 0;
         virtual void close() = 0;
         virtual bool isOpen() = 0;
         [[nodiscard]] virtual TransportType getTransportType() const noexcept = 0;

From 80cd187c6ff8d55cc6461896ad7ef542a1beab88 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 5 Oct 2025 23:54:29 +0300
Subject: [PATCH 029/133] add '--dbg-server' command-line argument & add
 debugging server draft

---
 src/devtools/DebuggingServer.cpp     | 77 ++++++++++++++++++++++++++++
 src/devtools/DebuggingServer.hpp     | 29 +++++++++++
 src/engine/Engine.cpp                | 23 ++++++++-
 src/engine/Engine.hpp                |  3 ++
 src/logic/scripting/lua/lua_util.hpp |  4 +-
 src/main.cpp                         |  5 +-
 src/util/command_line.cpp            |  6 ++-
 7 files changed, 142 insertions(+), 5 deletions(-)
 create mode 100644 src/devtools/DebuggingServer.cpp
 create mode 100644 src/devtools/DebuggingServer.hpp

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
new file mode 100644
index 00000000..9cdb6427
--- /dev/null
+++ b/src/devtools/DebuggingServer.cpp
@@ -0,0 +1,77 @@
+#include "DebuggingServer.hpp"
+
+#include "engine/Engine.hpp"
+#include "network/Network.hpp"
+#include "debug/Logger.hpp"
+
+using namespace devtools;
+
+static debug::Logger logger("debug-server");
+
+static network::Server& create_tcp_server(
+    DebuggingServer& dbgServer, Engine& engine, int port
+) {
+    auto& network = engine.getNetwork();
+    u64id_t serverId = network.openTcpServer(
+        port,
+        [&network, &dbgServer](u64id_t sid, u64id_t id) {
+            auto& connection = *network.getConnection(id, true);
+            connection.setPrivate(true);
+            logger.info() << "connected client " << id << ": "
+                          << connection.getAddress() << ":"
+                          << connection.getPort();
+            dbgServer.setClient(connection);
+        }
+    );
+    auto& server = *network.getServer(serverId, true);
+    server.setPrivate(true);
+
+    auto& tcpServer = dynamic_cast<network::TcpServer&>(server);
+    tcpServer.setMaxClientsConnected(1);
+
+    logger.info() << "tcp debugging server open at port " << server.getPort();
+
+    return tcpServer;
+}
+
+static network::Server& create_server(
+    DebuggingServer& dbgServer, Engine& engine, const std::string& serverString
+) {
+    logger.info() << "starting debugging server";
+
+    size_t sepPos = serverString.find(':');
+    if (sepPos == std::string::npos) {
+        throw std::runtime_error("invalid debugging server configuration string");
+    }
+    auto transport = serverString.substr(0, sepPos);
+    if (transport == "tcp") {
+        int port;
+        try {
+            port = std::stoi(serverString.substr(sepPos + 1));
+        } catch (const std::exception& err) {
+            throw std::runtime_error("invalid tcp port");
+        }
+        return create_tcp_server(dbgServer, engine, port);
+    } else {
+        throw std::runtime_error(
+            "unsupported debugging server transport '" + transport + "'"
+        );
+    }
+}
+
+DebuggingServer::DebuggingServer(
+    Engine& engine, const std::string& serverString
+)
+    : engine(engine),
+      server(create_server(*this, engine, serverString)),
+      client(nullptr) {
+}
+
+DebuggingServer::~DebuggingServer() {
+    logger.info() << "stopping debugging server";
+}
+
+
+bool DebuggingServer::update() {
+    return false;
+}
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
new file mode 100644
index 00000000..7f557935
--- /dev/null
+++ b/src/devtools/DebuggingServer.hpp
@@ -0,0 +1,29 @@
+#pragma once
+
+#include <memory>
+#include <string>
+
+namespace network {
+    class Server;
+    class Connection;
+}
+
+class Engine;
+
+namespace devtools {
+    class DebuggingServer {
+    public:
+        DebuggingServer(Engine& engine, const std::string& serverString);
+        ~DebuggingServer();
+
+        bool update();
+
+        void setClient(network::Connection& client) {
+            this->client = &client;
+        }
+    private:
+        Engine& engine;
+        network::Server& server;
+        network::Connection* client;
+    };
+}
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index d2a4eb20..23018946 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -14,6 +14,7 @@
 #include "coders/commons.hpp"
 #include "devtools/Editor.hpp"
 #include "devtools/Project.hpp"
+#include "devtools/DebuggingServer.hpp"
 #include "content/ContentControl.hpp"
 #include "core_defs.hpp"
 #include "io/io.hpp"
@@ -115,6 +116,9 @@ void Engine::initializeClient() {
     if (ENGINE_DEBUG_BUILD) {
         title += " [debug]";
     }
+    if (debuggingServer) {
+        title = "[debugging] " + title;
+    }
     auto [window, input] = Window::initialize(&settings.display, title);
     if (!window || !input){
         throw initialize_error("could not initialize window");
@@ -173,6 +177,18 @@ void Engine::initialize(CoreParameters coreParameters) {
     cmd = std::make_unique<cmd::CommandsInterpreter>();
     network = network::Network::create(settings.network);
 
+    if (!params.debugServerString.empty()) {
+        try {
+            debuggingServer = std::make_unique<devtools::DebuggingServer>(
+                *this, params.debugServerString
+            );
+        } catch (const std::runtime_error& err) {
+            throw initialize_error(
+                "debugging server error: " + std::string(err.what())
+            );
+        }
+    }
+
     if (!params.scriptFile.empty()) {
         paths.setScriptFolder(params.scriptFile.parent_path());
     }
@@ -299,7 +315,11 @@ void Engine::saveSettings() {
     io::write_string(EnginePaths::SETTINGS_FILE, toml::stringify(*settingsHandler));
     if (!params.headless) {
         logger.info() << "saving bindings";
-        io::write_string(EnginePaths::CONTROLS_FILE, input->getBindings().write());
+        if (input) {
+            io::write_string(
+                EnginePaths::CONTROLS_FILE, input->getBindings().write()
+            );
+        }
     }
 }
 
@@ -318,6 +338,7 @@ void Engine::close() {
         logger.info() << "gui finished";
     }
     audio::close();
+    debuggingServer.reset();
     network.reset();
     clearKeepedObjects();
     project.reset();
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 1f9438c0..c523acb8 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -36,6 +36,7 @@ namespace network {
 
 namespace devtools {
     class Editor;
+    class DebuggingServer;
 }
 
 class initialize_error : public std::runtime_error {
@@ -50,6 +51,7 @@ struct CoreParameters {
     std::filesystem::path userFolder = ".";
     std::filesystem::path scriptFile;
     std::filesystem::path projectFolder;
+    std::string debugServerString;
     int tps = 20;
 };
 
@@ -72,6 +74,7 @@ class Engine : public util::ObjectsKeeper {
     std::unique_ptr<Input> input;
     std::unique_ptr<gui::GUI> gui;
     std::unique_ptr<devtools::Editor> editor;
+    std::unique_ptr<devtools::DebuggingServer> debuggingServer;
     PostRunnables postRunnables;
     Time time;
     OnWorldOpen levelConsumer;
diff --git a/src/logic/scripting/lua/lua_util.hpp b/src/logic/scripting/lua/lua_util.hpp
index d7aed664..e72b56eb 100644
--- a/src/logic/scripting/lua/lua_util.hpp
+++ b/src/logic/scripting/lua/lua_util.hpp
@@ -617,7 +617,9 @@ namespace lua {
     void remove_environment(lua::State*, int id);
 
     inline void close(lua::State* L) {
-        lua_close(L);
+        if (L) {
+            lua_close(L);
+        }
     }
 
     inline void addfunc(
diff --git a/src/main.cpp b/src/main.cpp
index 40e9665a..256818c3 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -25,7 +25,7 @@ int main(int argc, char** argv) {
     }
     std::signal(SIGTERM, sigterm_handler);
     
-    debug::Logger::init(coreParameters.userFolder.string()+"/latest.log");
+    debug::Logger::init(coreParameters.userFolder.string() + "/latest.log");
     platform::configure_encoding();
 
     auto& engine = Engine::getInstance();
@@ -33,7 +33,8 @@ int main(int argc, char** argv) {
         engine.initialize(std::move(coreParameters));
         engine.run();
     } catch (const initialize_error& err) {
-        logger.error() << "could not to initialize engine\n" << err.what();
+        logger.error() << err.what();
+        logger.error() << "could not to initialize engine";
     }
 #if defined(NDEBUG) and defined(_WIN32)
     catch (const std::exception& err) {
diff --git a/src/util/command_line.cpp b/src/util/command_line.cpp
index 6d84ab28..3691b77b 100644
--- a/src/util/command_line.cpp
+++ b/src/util/command_line.cpp
@@ -70,11 +70,15 @@ static bool perform_keyword(
             std::cout << ENGINE_VERSION_STRING << std::endl;
             return false;
         }, "", "display the engine version."),
+        ArgC("--dbg-server", [&params, &reader]() -> bool {
+            params.debugServerString = reader.next();
+            return true;
+        }, "<serv>", "open debugging server where <serv> is {transport}:{port}"),
         ArgC("--help", []() -> bool {
             std::cout << "VoxelCore v" << ENGINE_VERSION_STRING << "\n\n";
             std::cout << "Command-line arguments:\n";
             for (auto& a : argumentsCommandline) {
-                std::cout << std::setw(20) << std::left << (a.keyword + " " + a.args);
+                std::cout << std::setw(24) << std::left << (a.keyword + " " + a.args);
                 std::cout << "- " << a.help << std::endl;
             }
             std::cout << std::endl;

From 44bf4a2f9ec31b301f2cc38bd7ee6553373df2ff Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 6 Oct 2025 01:49:13 +0300
Subject: [PATCH 030/133] add ReadableConnection interface

---
 src/network/Network.hpp | 5 ++---
 src/network/Sockets.cpp | 2 +-
 src/network/commons.hpp | 6 ++++++
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index 047e07b4..1110c750 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -3,13 +3,12 @@
 #include "commons.hpp"
 
 namespace network {
-    class TcpConnection : public Connection {
+    class TcpConnection : public ReadableConnection {
     public:
         ~TcpConnection() override = default;
 
         virtual void connect(runnable callback) = 0;
-        virtual int recv(char* buffer, size_t length) = 0;
-        virtual int available() = 0;
+
         virtual void setNoDelay(bool noDelay) = 0;
         [[nodiscard]] virtual bool isNoDelay() const = 0;
 
diff --git a/src/network/Sockets.cpp b/src/network/Sockets.cpp
index 9e145da0..37d1190d 100644
--- a/src/network/Sockets.cpp
+++ b/src/network/Sockets.cpp
@@ -231,7 +231,7 @@ public:
             readBatch.clear();
 
             if (state != ConnectionState::CLOSED) {
-                shutdown(descriptor, 2);
+                shutdown(descriptor, SHUT_RDWR);
                 closesocket(descriptor);
             }
         }
diff --git a/src/network/commons.hpp b/src/network/commons.hpp
index ad3c0806..150bde25 100644
--- a/src/network/commons.hpp
+++ b/src/network/commons.hpp
@@ -75,6 +75,12 @@ namespace network {
         bool isprivate = false;
     };
 
+    class ReadableConnection : public Connection {
+    public:
+        virtual int recv(char* buffer, size_t length) = 0;
+        virtual int available() = 0;
+    };
+
     class Server {
     public:
         virtual ~Server() = default;

From 3fef284a02de5718eda19b64bebde45b3a264dc6 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 6 Oct 2025 01:54:35 +0300
Subject: [PATCH 031/133] test debugger commands

---
 src/devtools/DebuggingServer.cpp | 102 +++++++++++++++++++++++++++++--
 src/devtools/DebuggingServer.hpp |  32 ++++++++--
 src/engine/Engine.cpp            |   6 ++
 src/engine/Engine.hpp            |   2 +-
 4 files changed, 133 insertions(+), 9 deletions(-)

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 9cdb6427..86e2bdae 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -3,11 +3,62 @@
 #include "engine/Engine.hpp"
 #include "network/Network.hpp"
 #include "debug/Logger.hpp"
+#include "coders/json.hpp"
 
 using namespace devtools;
 
 static debug::Logger logger("debug-server");
 
+ClientConnection::~ClientConnection() {
+    if (auto connection = dynamic_cast<network::ReadableConnection*>(
+        network.getConnection(this->connection, true)
+    )) {
+        connection->close();
+    }
+}
+
+std::string ClientConnection::read() {
+    auto connection = dynamic_cast<network::ReadableConnection*>(
+        network.getConnection(this->connection, true)
+    );
+    if (connection == nullptr) {
+        return "";
+    }
+    if (messageLength == 0) {
+        if (connection->available() >= sizeof(int32_t)) {
+            int32_t length = 0;
+            connection->recv(reinterpret_cast<char*>(&length), sizeof(int32_t));
+            if (length <= 0) {
+                logger.error() << "invalid message length " << length;
+            } else {
+                messageLength = length;
+            }
+        }
+    } else if (connection->available() >= messageLength) {
+        std::string string(messageLength, 0);
+        connection->recv(string.data(), messageLength);
+        return string;
+    }
+    return "";
+}
+
+void ClientConnection::send(const dv::value& object) {
+    auto connection = dynamic_cast<network::ReadableConnection*>(
+        network.getConnection(this->connection, true)
+    );
+    if (connection == nullptr) {
+        return;
+    }
+    auto message = json::stringify(object, false);
+    int32_t length = message.length();
+    connection->send(reinterpret_cast<char*>(&length), sizeof(int32_t));
+    connection->send(message.data(), length);
+}
+
+void ClientConnection::sendResponse(const std::string& type) {
+    send(dv::object({{"type", type}}));
+}
+
 static network::Server& create_tcp_server(
     DebuggingServer& dbgServer, Engine& engine, int port
 ) {
@@ -15,12 +66,14 @@ static network::Server& create_tcp_server(
     u64id_t serverId = network.openTcpServer(
         port,
         [&network, &dbgServer](u64id_t sid, u64id_t id) {
-            auto& connection = *network.getConnection(id, true);
+            auto& connection = dynamic_cast<network::ReadableConnection&>(
+                *network.getConnection(id, true)
+            );
             connection.setPrivate(true);
             logger.info() << "connected client " << id << ": "
                           << connection.getAddress() << ":"
                           << connection.getPort();
-            dbgServer.setClient(connection);
+            dbgServer.setClient(id);
         }
     );
     auto& server = *network.getServer(serverId, true);
@@ -64,14 +117,55 @@ DebuggingServer::DebuggingServer(
 )
     : engine(engine),
       server(create_server(*this, engine, serverString)),
-      client(nullptr) {
+      connection(nullptr) {
 }
 
 DebuggingServer::~DebuggingServer() {
     logger.info() << "stopping debugging server";
+    server.close();
 }
 
 
 bool DebuggingServer::update() {
-    return false;
+    if (connection == nullptr) {
+        return true;
+    }
+    std::string message = connection->read();
+    if (message.empty()) {
+        return true;
+    }
+    logger.debug() << "received: " << message;
+    try {
+        auto obj = json::parse(message);
+        if (!obj.has("type")) {
+            logger.error() << "missing message type";
+            return true;
+        }
+        const auto& type = obj["type"].asString();
+        return performCommand(type, obj);
+    } catch (const std::runtime_error& err) {
+        logger.error() << "could not to parse message: " << err.what();
+    }
+    return true;
+}
+
+bool DebuggingServer::performCommand(
+    const std::string& type, const dv::value& map
+) {
+    if (type == "terminate") {
+        engine.quit();
+        connection->sendResponse("success");
+    } else if (type == "detach") {
+        connection->sendResponse("success");
+        connection.reset();
+        return false;
+    } else {
+        logger.error() << "unsupported command '" << type << "'";
+    }
+    return true;
+}
+
+void DebuggingServer::setClient(u64id_t client) {
+    this->connection =
+        std::make_unique<ClientConnection>(engine.getNetwork(), client);
 }
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index 7f557935..b8b103b8 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -3,14 +3,38 @@
 #include <memory>
 #include <string>
 
+#include "typedefs.hpp"
+
 namespace network {
     class Server;
     class Connection;
+    class ReadableConnection;
+    class Network;
+}
+
+namespace dv {
+    class value;
 }
 
 class Engine;
 
 namespace devtools {
+    class ClientConnection {
+    public:
+        ClientConnection(network::Network& network, u64id_t connection)
+            : network(network), connection(connection) {
+        }
+        ~ClientConnection();
+
+        std::string read();
+        void send(const dv::value& message);
+        void sendResponse(const std::string& type);
+    private:
+        network::Network& network;
+        size_t messageLength = 0;
+        u64id_t connection;
+    };
+
     class DebuggingServer {
     public:
         DebuggingServer(Engine& engine, const std::string& serverString);
@@ -18,12 +42,12 @@ namespace devtools {
 
         bool update();
 
-        void setClient(network::Connection& client) {
-            this->client = &client;
-        }
+        void setClient(u64id_t client);
     private:
         Engine& engine;
         network::Server& server;
-        network::Connection* client;
+        std::unique_ptr<ClientConnection> connection;
+
+        bool performCommand(const std::string& type, const dv::value& map);
     };
 }
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 23018946..65a0be87 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -282,6 +282,12 @@ void Engine::postUpdate() {
     network->update();
     postRunnables.run();
     scripting::process_post_runnables();
+
+    if (debuggingServer) {
+        if (!debuggingServer->update()) {
+            debuggingServer.reset();
+        }
+    }
 }
 
 void Engine::updateFrontend() {
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index c523acb8..b0f0918d 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -51,7 +51,7 @@ struct CoreParameters {
     std::filesystem::path userFolder = ".";
     std::filesystem::path scriptFile;
     std::filesystem::path projectFolder;
-    std::string debugServerString;
+    std::string debugServerString = "tcp:9030";
     int tps = 20;
 };
 

From b2e03a6d1821d42bc12e528d25d61a72c615add1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 6 Oct 2025 02:08:37 +0300
Subject: [PATCH 032/133] fix windows build

---
 src/network/Sockets.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/network/Sockets.cpp b/src/network/Sockets.cpp
index 37d1190d..c1b6285f 100644
--- a/src/network/Sockets.cpp
+++ b/src/network/Sockets.cpp
@@ -10,6 +10,7 @@
 
 #ifdef _WIN32
 #include <curl/curl.h>
+#define SHUT_RDWR SD_BOTH
 #else
 #include <sys/types.h>
 #include <sys/socket.h>

From c152cfc03fa0d47faa837a1a585d8ed8ba977d88 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 6 Oct 2025 21:47:53 +0300
Subject: [PATCH 033/133] add debug.breakpoint

---
 src/devtools/DebuggingServer.cpp           |   5 +
 src/devtools/DebuggingServer.hpp           |   1 +
 src/engine/Engine.hpp                      |   4 +
 src/logic/scripting/lua/lua_extensions.cpp | 120 +++++++++++++++++++++
 4 files changed, 130 insertions(+)

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 86e2bdae..26a2ecfa 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -165,6 +165,11 @@ bool DebuggingServer::performCommand(
     return true;
 }
 
+void DebuggingServer::onHitBreakpoint(dv::value&& stackTrace) {
+    logger.info() << "hit breakpoint:\n"
+                  << json::stringify(stackTrace, true, "    ");
+}
+
 void DebuggingServer::setClient(u64id_t client) {
     this->connection =
         std::make_unique<ClientConnection>(engine.getNetwork(), client);
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index b8b103b8..b379c3e3 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -41,6 +41,7 @@ namespace devtools {
         ~DebuggingServer();
 
         bool update();
+        void onHitBreakpoint(dv::value&& stackTrace);
 
         void setClient(u64id_t client);
     private:
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index b0f0918d..6d04da5c 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -185,4 +185,8 @@ public:
     const Project& getProject() {
         return *project;
     }
+
+    devtools::DebuggingServer* getDebuggingServer() {
+        return debuggingServer.get();
+    }
 };
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index b9c25fc6..74be96de 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -1,9 +1,12 @@
 #include <iostream>
 #include <iomanip>
 #include <random>
+#include <sstream>
 
 #include "libs/api_lua.hpp"
 #include "debug/Logger.hpp"
+#include "engine/Engine.hpp"
+#include "devtools/DebuggingServer.hpp"
 #include "logic/scripting/scripting.hpp"
 
 using namespace scripting;
@@ -159,6 +162,120 @@ static int l_math_normal_random(lua::State* L) {
     return lua::pushnumber(L, randomFloats(generator));
 }
 
+constexpr inline int MAX_SHORT_STRING_LEN = 50;
+
+static dv::value create_stack_trace(lua_State* L, int initFrame = 2) {
+    auto entriesList = dv::list();
+
+    lua_Debug frame;
+    int level = initFrame;
+    
+    while (lua_getstack(L, level, &frame)) {
+        auto entry = dv::object();
+        if (lua_getinfo(L, "nSlf", &frame) == 0) {
+            level++;
+            entriesList.add(std::move(entry));
+            continue;
+        }
+        if (frame.name) {
+            entry["function"] = frame.name;
+        }
+        if (frame.source) {
+            const char* src =
+                (frame.source[0] == '@') ? frame.source + 1 : frame.source;
+            entry["source"] = src;
+            entry["line"] = frame.currentline;
+        }
+        entry["what"] = frame.what;
+
+        auto locals = dv::object();
+
+        int localIndex = 1;
+        const char* name;
+        while ((name = lua_getlocal(L, &frame, localIndex++))) {
+            if (name[0] == '(') {
+                lua::pop(L);
+                continue;
+            }
+            auto local = dv::object();
+
+            int type = lua::type(L, -1);
+            switch (type) {
+                case LUA_TNIL:
+                    local["short"] = "nil";
+                    local["type"] = "nil";
+                    break;
+                case LUA_TBOOLEAN:
+                    local["short"] = lua::toboolean(L, -1) ? "true" : "false";
+                    local["type"] = "boolean";
+                    break;
+                case LUA_TNUMBER: {
+                    std::stringstream ss;
+                    ss << lua::tonumber(L, -1);
+                    local["short"] = ss.str();
+                    local["type"] = "number";
+                    break;
+                }
+                case LUA_TSTRING: {
+                    const char* str = lua::tostring(L, -1);
+                    if (strlen(str) > MAX_SHORT_STRING_LEN) {
+                        local["short"] = std::string(str, MAX_SHORT_STRING_LEN);
+                    } else {
+                        local["short"] = str;
+                    }
+                    local["type"] = "string";
+                    break;
+                }
+                case LUA_TTABLE:
+                    local["short"] = "{...}";
+                    local["type"] = "table";
+                    break;
+                case LUA_TFUNCTION: {
+                    std::stringstream ss;
+                    ss << "function: 0x" << std::hex << lua::topointer(L, -1);
+                    local["short"] = ss.str();
+                    local["type"] = "function";
+                    break;
+                }
+                case LUA_TUSERDATA: {
+                    std::stringstream ss;
+                    ss << "userdata: 0x" << std::hex << lua::topointer(L, -1);
+                    local["short"] = ss.str();
+                    local["type"] = "userdata";
+                    break;
+                }
+                case LUA_TTHREAD: {
+                    std::stringstream ss;
+                    ss << "thread: 0x" << std::hex << lua::topointer(L, -1);
+                    local["short"] = ss.str();
+                    local["type"] = "thread";
+                    break;
+                }
+                default: {
+                    std::stringstream ss;
+                    ss << "cdata: 0x" << std::hex << lua::topointer(L, -1);
+                    local["short"] = ss.str();
+                    local["type"] = "cdata";
+                    break;
+                }
+            }
+            locals[name] = std::move(local);
+            lua::pop(L);
+        }
+        entry["locals"] = std::move(locals);
+        entriesList.add(std::move(entry));
+        level++;
+    }
+    return entriesList;
+}
+
+static int l_debug_breakpoint(lua::State* L) {
+    if (auto server = engine->getDebuggingServer()) {
+        server->onHitBreakpoint(create_stack_trace(L));
+    }
+    return 0;
+}
+
 void initialize_libs_extends(lua::State* L) {
     if (lua::getglobal(L, "debug")) {
         lua::pushcfunction(L, lua::wrap<l_debug_error>);
@@ -173,6 +290,9 @@ void initialize_libs_extends(lua::State* L) {
         lua::pushcfunction(L, lua::wrap<l_debug_print>);
         lua::setfield(L, "print");
 
+        lua::pushcfunction(L, lua::wrap<l_debug_breakpoint>);
+        lua::setfield(L, "breakpoint");
+
         lua::pop(L);
     }
     if (lua::getglobal(L, "math")) {

From 95f30da49b6bee2cf4a0e1f98051d8b236a93290 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 7 Oct 2025 18:02:06 +0300
Subject: [PATCH 034/133] add engine pause mode

---
 src/devtools/DebuggingServer.cpp           |   9 ++
 src/engine/Engine.cpp                      |  24 ++++
 src/engine/Engine.hpp                      |   1 +
 src/logic/scripting/lua/lua_extensions.cpp | 157 +++++++++++----------
 4 files changed, 114 insertions(+), 77 deletions(-)

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 26a2ecfa..88466dd3 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -168,6 +168,15 @@ bool DebuggingServer::performCommand(
 void DebuggingServer::onHitBreakpoint(dv::value&& stackTrace) {
     logger.info() << "hit breakpoint:\n"
                   << json::stringify(stackTrace, true, "    ");
+    if (connection == nullptr) {
+        return;
+    }
+    connection->send(dv::object({
+        {"type", std::string("hit-breakpoint")},
+        {"stack", std::move(stackTrace)}
+    }));
+
+    engine.startPauseLoop();
 }
 
 void DebuggingServer::setClient(u64id_t client) {
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 65a0be87..64a89fb5 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -309,6 +309,30 @@ void Engine::nextFrame() {
     input->pollEvents();
 }
 
+void Engine::startPauseLoop() {
+    bool initialCursorLocked = false;
+    if (!isHeadless()) {
+        initialCursorLocked = input->isCursorLocked();
+        if (initialCursorLocked) {
+            input->toggleCursor();
+        }
+    }
+    while (!isQuitSignal()) {
+        if (!debuggingServer->update()) {
+            debuggingServer.reset();
+            break;
+        }
+        if (isHeadless()) {
+            platform::sleep(1.0 / params.tps * 1000);
+        } else {
+            nextFrame();
+        }
+    }
+    if (initialCursorLocked) {
+        input->toggleCursor();
+    }
+}
+
 void Engine::renderFrame() {
     screen->draw(time.getDelta());
 
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 6d04da5c..a9fb62ea 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -108,6 +108,7 @@ public:
     void updateFrontend();
     void renderFrame();
     void nextFrame();
+    void startPauseLoop();
     
     /// @brief Set screen (scene).
     /// nullptr may be used to delete previous screen before creating new one,
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index 74be96de..15749b47 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -164,7 +164,85 @@ static int l_math_normal_random(lua::State* L) {
 
 constexpr inline int MAX_SHORT_STRING_LEN = 50;
 
-static dv::value create_stack_trace(lua_State* L, int initFrame = 2) {
+static dv::value collect_locals(lua::State* L, lua_Debug& frame) {
+    auto locals = dv::object();
+
+    int localIndex = 1;
+    const char* name;
+    while ((name = lua_getlocal(L, &frame, localIndex++))) {
+        if (name[0] == '(') {
+            lua::pop(L);
+            continue;
+        }
+        auto local = dv::object();
+
+        int type = lua::type(L, -1);
+        switch (type) {
+            case LUA_TNIL:
+                local["short"] = "nil";
+                local["type"] = "nil";
+                break;
+            case LUA_TBOOLEAN:
+                local["short"] = lua::toboolean(L, -1) ? "true" : "false";
+                local["type"] = "boolean";
+                break;
+            case LUA_TNUMBER: {
+                std::stringstream ss;
+                ss << lua::tonumber(L, -1);
+                local["short"] = ss.str();
+                local["type"] = "number";
+                break;
+            }
+            case LUA_TSTRING: {
+                const char* str = lua::tostring(L, -1);
+                if (strlen(str) > MAX_SHORT_STRING_LEN) {
+                    local["short"] = std::string(str, MAX_SHORT_STRING_LEN);
+                } else {
+                    local["short"] = str;
+                }
+                local["type"] = "string";
+                break;
+            }
+            case LUA_TTABLE:
+                local["short"] = "{...}";
+                local["type"] = "table";
+                break;
+            case LUA_TFUNCTION: {
+                std::stringstream ss;
+                ss << "function: 0x" << std::hex << lua::topointer(L, -1);
+                local["short"] = ss.str();
+                local["type"] = "function";
+                break;
+            }
+            case LUA_TUSERDATA: {
+                std::stringstream ss;
+                ss << "userdata: 0x" << std::hex << lua::topointer(L, -1);
+                local["short"] = ss.str();
+                local["type"] = "userdata";
+                break;
+            }
+            case LUA_TTHREAD: {
+                std::stringstream ss;
+                ss << "thread: 0x" << std::hex << lua::topointer(L, -1);
+                local["short"] = ss.str();
+                local["type"] = "thread";
+                break;
+            }
+            default: {
+                std::stringstream ss;
+                ss << "cdata: 0x" << std::hex << lua::topointer(L, -1);
+                local["short"] = ss.str();
+                local["type"] = "cdata";
+                break;
+            }
+        }
+        locals[name] = std::move(local);
+        lua::pop(L);
+    }
+    return locals;
+}
+
+static dv::value create_stack_trace(lua::State* L, int initFrame = 2) {
     auto entriesList = dv::list();
 
     lua_Debug frame;
@@ -187,82 +265,7 @@ static dv::value create_stack_trace(lua_State* L, int initFrame = 2) {
             entry["line"] = frame.currentline;
         }
         entry["what"] = frame.what;
-
-        auto locals = dv::object();
-
-        int localIndex = 1;
-        const char* name;
-        while ((name = lua_getlocal(L, &frame, localIndex++))) {
-            if (name[0] == '(') {
-                lua::pop(L);
-                continue;
-            }
-            auto local = dv::object();
-
-            int type = lua::type(L, -1);
-            switch (type) {
-                case LUA_TNIL:
-                    local["short"] = "nil";
-                    local["type"] = "nil";
-                    break;
-                case LUA_TBOOLEAN:
-                    local["short"] = lua::toboolean(L, -1) ? "true" : "false";
-                    local["type"] = "boolean";
-                    break;
-                case LUA_TNUMBER: {
-                    std::stringstream ss;
-                    ss << lua::tonumber(L, -1);
-                    local["short"] = ss.str();
-                    local["type"] = "number";
-                    break;
-                }
-                case LUA_TSTRING: {
-                    const char* str = lua::tostring(L, -1);
-                    if (strlen(str) > MAX_SHORT_STRING_LEN) {
-                        local["short"] = std::string(str, MAX_SHORT_STRING_LEN);
-                    } else {
-                        local["short"] = str;
-                    }
-                    local["type"] = "string";
-                    break;
-                }
-                case LUA_TTABLE:
-                    local["short"] = "{...}";
-                    local["type"] = "table";
-                    break;
-                case LUA_TFUNCTION: {
-                    std::stringstream ss;
-                    ss << "function: 0x" << std::hex << lua::topointer(L, -1);
-                    local["short"] = ss.str();
-                    local["type"] = "function";
-                    break;
-                }
-                case LUA_TUSERDATA: {
-                    std::stringstream ss;
-                    ss << "userdata: 0x" << std::hex << lua::topointer(L, -1);
-                    local["short"] = ss.str();
-                    local["type"] = "userdata";
-                    break;
-                }
-                case LUA_TTHREAD: {
-                    std::stringstream ss;
-                    ss << "thread: 0x" << std::hex << lua::topointer(L, -1);
-                    local["short"] = ss.str();
-                    local["type"] = "thread";
-                    break;
-                }
-                default: {
-                    std::stringstream ss;
-                    ss << "cdata: 0x" << std::hex << lua::topointer(L, -1);
-                    local["short"] = ss.str();
-                    local["type"] = "cdata";
-                    break;
-                }
-            }
-            locals[name] = std::move(local);
-            lua::pop(L);
-        }
-        entry["locals"] = std::move(locals);
+        entry["locals"] = collect_locals(L, frame);
         entriesList.add(std::move(entry));
         level++;
     }

From 5972bc769b9664166c28ce5f765932e9d6c4c060 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 7 Oct 2025 21:07:02 +0300
Subject: [PATCH 035/133] add 'set-breakpoint', 'remove-breakpoint' commands

---
 res/scripts/stdlib.lua                     |  1 +
 res/scripts/stdmin.lua                     | 52 ++++++++++++++++++++++
 src/devtools/DebuggingServer.cpp           | 19 +++++++-
 src/devtools/DebuggingServer.hpp           | 13 ++++++
 src/engine/Engine.cpp                      |  1 +
 src/logic/scripting/lua/lua_extensions.cpp | 30 +++++++++++++
 6 files changed, 114 insertions(+), 2 deletions(-)

diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index b08e8c02..3f732e07 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -587,6 +587,7 @@ function __process_post_runnables()
         __vc_named_coroutines[name] = nil
     end
 
+    debug.pull_events()
     network.__process_events()
     block.__process_register_events()
     block.__perform_ticks(time.delta())
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 26d5d813..eb3ddbde 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -1,5 +1,57 @@
 -- Lua has no parallelizm, also _set_data does not call any lua functions so
 -- may be reused one global ffi buffer per lua_State
+
+local breakpoints = {}
+
+debug.sethook(function (e, line)
+    local bps = breakpoints[line]
+    if not bps then
+        return
+    end
+    local source = debug.getinfo(2).source
+    if not bps[source] then
+        return
+    end
+    debug.breakpoint()
+    debug.pull_events()
+end, "l")
+
+local DBG_EVENT_SET_BREAKPOINT = 1
+local DBG_EVENT_RM_BREAKPOINT = 2
+local __pull_events = debug.__pull_events
+debug.__pull_events = nil
+
+function debug.pull_events()
+    local events = __pull_events()
+    if not events then
+        return
+    end
+    for i, event in ipairs(events) do
+        if event[1] == DBG_EVENT_SET_BREAKPOINT then
+            debug.set_breakpoint(event[2], event[3])
+        elseif event[1] == DBG_EVENT_RM_BREAKPOINT then
+            debug.remove_breakpoint(event[2], event[3])
+        end
+    end
+end
+
+function debug.set_breakpoint(source, line)
+    local bps = breakpoints[line]
+    if not bps then
+        bps = {}
+        breakpoints[line] = bps
+    end
+    bps[source] = true
+end
+
+function debug.remove_breakpoint(source, line)
+    local bps = breakpoints[line]
+    if not bps then
+        return
+    end
+    bps[source] = nil
+end
+
 local canvas_ffi_buffer
 local canvas_ffi_buffer_size = 0
 
diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 88466dd3..09c8c18f 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -31,12 +31,14 @@ std::string ClientConnection::read() {
             if (length <= 0) {
                 logger.error() << "invalid message length " << length;
             } else {
+                logger.info() << "message length " << length;
                 messageLength = length;
             }
         }
     } else if (connection->available() >= messageLength) {
         std::string string(messageLength, 0);
         connection->recv(string.data(), messageLength);
+        messageLength = 0;
         return string;
     }
     return "";
@@ -156,9 +158,20 @@ bool DebuggingServer::performCommand(
         engine.quit();
         connection->sendResponse("success");
     } else if (type == "detach") {
+        logger.info() << "detach received";
         connection->sendResponse("success");
         connection.reset();
         return false;
+    } else if (type == "set-breakpoint" || type == "remove-breakpoint") {
+        if (!map.has("source") || !map.has("line"))
+            return true;
+        breakpointEvents.push_back(BreakpointEvent {
+            type[0] == 's' 
+            ? BreakpointEventType::SET_BREAKPOINT
+            : BreakpointEventType::REMOVE_BREAKPOINT,
+            map["source"].asString(),
+            static_cast<int>(map["line"].asInteger()),
+        });
     } else {
         logger.error() << "unsupported command '" << type << "'";
     }
@@ -166,8 +179,6 @@ bool DebuggingServer::performCommand(
 }
 
 void DebuggingServer::onHitBreakpoint(dv::value&& stackTrace) {
-    logger.info() << "hit breakpoint:\n"
-                  << json::stringify(stackTrace, true, "    ");
     if (connection == nullptr) {
         return;
     }
@@ -183,3 +194,7 @@ void DebuggingServer::setClient(u64id_t client) {
     this->connection =
         std::make_unique<ClientConnection>(engine.getNetwork(), client);
 }
+
+std::vector<BreakpointEvent> DebuggingServer::pullBreakpointEvents() {
+    return std::move(breakpointEvents);
+}
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index b379c3e3..308cee87 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -2,6 +2,7 @@
 
 #include <memory>
 #include <string>
+#include <vector>
 
 #include "typedefs.hpp"
 
@@ -35,6 +36,16 @@ namespace devtools {
         u64id_t connection;
     };
 
+    enum class BreakpointEventType {
+        SET_BREAKPOINT = 1,
+        REMOVE_BREAKPOINT,
+    };
+    struct BreakpointEvent {
+        BreakpointEventType type;
+        std::string source;
+        int line;
+    };
+
     class DebuggingServer {
     public:
         DebuggingServer(Engine& engine, const std::string& serverString);
@@ -44,10 +55,12 @@ namespace devtools {
         void onHitBreakpoint(dv::value&& stackTrace);
 
         void setClient(u64id_t client);
+        std::vector<BreakpointEvent> pullBreakpointEvents();
     private:
         Engine& engine;
         network::Server& server;
         std::unique_ptr<ClientConnection> connection;
+        std::vector<BreakpointEvent> breakpointEvents;
 
         bool performCommand(const std::string& type, const dv::value& map);
     };
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 64a89fb5..2a7820a6 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -318,6 +318,7 @@ void Engine::startPauseLoop() {
         }
     }
     while (!isQuitSignal()) {
+        network->update();
         if (!debuggingServer->update()) {
             debuggingServer.reset();
             break;
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index 15749b47..e845f925 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -279,6 +279,33 @@ static int l_debug_breakpoint(lua::State* L) {
     return 0;
 }
 
+static int l_debug_pull_events(lua::State* L) {
+    if (auto server = engine->getDebuggingServer()) {
+        auto events = server->pullBreakpointEvents();
+        if (events.empty()) {
+            return 0;
+        }
+        lua::createtable(L, events.size(), 0);
+        for (int i = 0; i < events.size(); i++) {
+            const auto& event = events[i];
+            lua::createtable(L, 3, 0);
+
+            lua::pushinteger(L, static_cast<int>(event.type));
+            lua::rawseti(L, 1);
+
+            lua::pushstring(L, event.source);
+            lua::rawseti(L, 2);
+
+            lua::pushinteger(L, event.line);
+            lua::rawseti(L, 3);
+
+            lua::rawseti(L, i + 1);
+        }
+        return 1;
+    }
+    return 0;
+}
+
 void initialize_libs_extends(lua::State* L) {
     if (lua::getglobal(L, "debug")) {
         lua::pushcfunction(L, lua::wrap<l_debug_error>);
@@ -296,6 +323,9 @@ void initialize_libs_extends(lua::State* L) {
         lua::pushcfunction(L, lua::wrap<l_debug_breakpoint>);
         lua::setfield(L, "breakpoint");
 
+        lua::pushcfunction(L, lua::wrap<l_debug_pull_events>);
+        lua::setfield(L, "__pull_events");
+
         lua::pop(L);
     }
     if (lua::getglobal(L, "math")) {

From 9372a5226ebbc01ecb37866f3c1640ce8ac642d8 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 7 Oct 2025 21:53:46 +0300
Subject: [PATCH 036/133] add 'step' and 'resume' commands

---
 res/scripts/stdmin.lua                     | 15 ++++++++
 src/devtools/DebuggingServer.cpp           | 40 +++++++++++++++-------
 src/devtools/DebuggingServer.hpp           | 26 ++++++++++----
 src/engine/Engine.cpp                      | 13 +++----
 src/engine/Engine.hpp                      |  2 ++
 src/logic/scripting/lua/lua_extensions.cpp | 37 +++++++++++---------
 6 files changed, 91 insertions(+), 42 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index eb3ddbde..46976f77 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -2,8 +2,16 @@
 -- may be reused one global ffi buffer per lua_State
 
 local breakpoints = {}
+local dbg_steps_mode = false
+local hook_lock = false
 
 debug.sethook(function (e, line)
+    if dbg_steps_mode and not hook_lock then
+        hook_lock = true
+        debug.breakpoint()
+        debug.pull_events()
+    end
+    hook_lock = false
     local bps = breakpoints[line]
     if not bps then
         return
@@ -18,6 +26,9 @@ end, "l")
 
 local DBG_EVENT_SET_BREAKPOINT = 1
 local DBG_EVENT_RM_BREAKPOINT = 2
+local DBG_EVENT_STEP = 3
+local DBG_EVENT_STEP_INTO_FUNCTION = 4
+local DBG_EVENT_RESUME = 5
 local __pull_events = debug.__pull_events
 debug.__pull_events = nil
 
@@ -31,6 +42,10 @@ function debug.pull_events()
             debug.set_breakpoint(event[2], event[3])
         elseif event[1] == DBG_EVENT_RM_BREAKPOINT then
             debug.remove_breakpoint(event[2], event[3])
+        elseif event[1] == DBG_EVENT_STEP then
+            dbg_steps_mode = true
+        elseif event[1] == DBG_EVENT_RESUME then
+            dbg_steps_mode = false
         end
     end
 end
diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 09c8c18f..9ef677e3 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -130,25 +130,25 @@ DebuggingServer::~DebuggingServer() {
 
 bool DebuggingServer::update() {
     if (connection == nullptr) {
-        return true;
+        return false;
     }
     std::string message = connection->read();
     if (message.empty()) {
-        return true;
+        return false;
     }
     logger.debug() << "received: " << message;
     try {
         auto obj = json::parse(message);
         if (!obj.has("type")) {
             logger.error() << "missing message type";
-            return true;
+            return false;
         }
         const auto& type = obj["type"].asString();
         return performCommand(type, obj);
     } catch (const std::runtime_error& err) {
         logger.error() << "could not to parse message: " << err.what();
     }
-    return true;
+    return false;
 }
 
 bool DebuggingServer::performCommand(
@@ -158,24 +158,38 @@ bool DebuggingServer::performCommand(
         engine.quit();
         connection->sendResponse("success");
     } else if (type == "detach") {
-        logger.info() << "detach received";
         connection->sendResponse("success");
         connection.reset();
+        engine.detachDebugger();
         return false;
     } else if (type == "set-breakpoint" || type == "remove-breakpoint") {
         if (!map.has("source") || !map.has("line"))
-            return true;
-        breakpointEvents.push_back(BreakpointEvent {
+            return false;
+        breakpointEvents.push_back(DebuggingEvent {
             type[0] == 's' 
-            ? BreakpointEventType::SET_BREAKPOINT
-            : BreakpointEventType::REMOVE_BREAKPOINT,
-            map["source"].asString(),
-            static_cast<int>(map["line"].asInteger()),
+            ? DebuggingEventType::SET_BREAKPOINT
+            : DebuggingEventType::REMOVE_BREAKPOINT,
+            BreakpointEventDto {
+                map["source"].asString(),
+                static_cast<int>(map["line"].asInteger()),
+            }
         });
+    } else if (type == "step" || type == "step-into-function") {
+        breakpointEvents.push_back(DebuggingEvent {
+            type == "step"
+            ? DebuggingEventType::STEP
+            : DebuggingEventType::STEP_INTO_FUNCTION,
+            SignalEventDto {}
+        });
+        return true;
+    } else if (type == "resume") {
+        breakpointEvents.push_back(DebuggingEvent {
+            DebuggingEventType::RESUME, SignalEventDto {}});
+        return true;
     } else {
         logger.error() << "unsupported command '" << type << "'";
     }
-    return true;
+    return false;
 }
 
 void DebuggingServer::onHitBreakpoint(dv::value&& stackTrace) {
@@ -195,6 +209,6 @@ void DebuggingServer::setClient(u64id_t client) {
         std::make_unique<ClientConnection>(engine.getNetwork(), client);
 }
 
-std::vector<BreakpointEvent> DebuggingServer::pullBreakpointEvents() {
+std::vector<DebuggingEvent> DebuggingServer::pullEvents() {
     return std::move(breakpointEvents);
 }
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index 308cee87..d7be32cf 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -3,6 +3,7 @@
 #include <memory>
 #include <string>
 #include <vector>
+#include <variant>
 
 #include "typedefs.hpp"
 
@@ -36,16 +37,27 @@ namespace devtools {
         u64id_t connection;
     };
 
-    enum class BreakpointEventType {
+    enum class DebuggingEventType {
         SET_BREAKPOINT = 1,
         REMOVE_BREAKPOINT,
+        STEP,
+        STEP_INTO_FUNCTION,
+        RESUME,
     };
-    struct BreakpointEvent {
-        BreakpointEventType type;
+
+    struct BreakpointEventDto {
         std::string source;
         int line;
     };
 
+    struct SignalEventDto {
+    };
+
+    struct DebuggingEvent {
+        DebuggingEventType type;
+        std::variant<BreakpointEventDto, SignalEventDto> data;
+    };
+
     class DebuggingServer {
     public:
         DebuggingServer(Engine& engine, const std::string& serverString);
@@ -55,13 +67,15 @@ namespace devtools {
         void onHitBreakpoint(dv::value&& stackTrace);
 
         void setClient(u64id_t client);
-        std::vector<BreakpointEvent> pullBreakpointEvents();
+        std::vector<DebuggingEvent> pullEvents();
     private:
         Engine& engine;
         network::Server& server;
         std::unique_ptr<ClientConnection> connection;
-        std::vector<BreakpointEvent> breakpointEvents;
+        std::vector<DebuggingEvent> breakpointEvents;
 
-        bool performCommand(const std::string& type, const dv::value& map);
+        bool performCommand(
+            const std::string& type, const dv::value& map
+        );
     };
 }
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 2a7820a6..a977f354 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -284,12 +284,14 @@ void Engine::postUpdate() {
     scripting::process_post_runnables();
 
     if (debuggingServer) {
-        if (!debuggingServer->update()) {
-            debuggingServer.reset();
-        }
+        debuggingServer->update();
     }
 }
 
+void Engine::detachDebugger() {
+    debuggingServer.reset();
+}
+
 void Engine::updateFrontend() {
     double delta = time.getDelta();
     updateHotkeys();
@@ -317,10 +319,9 @@ void Engine::startPauseLoop() {
             input->toggleCursor();
         }
     }
-    while (!isQuitSignal()) {
+    while (!isQuitSignal() && debuggingServer) {
         network->update();
-        if (!debuggingServer->update()) {
-            debuggingServer.reset();
+        if (debuggingServer->update()) {
             break;
         }
         if (isHeadless()) {
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index a9fb62ea..67acc498 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -190,4 +190,6 @@ public:
     devtools::DebuggingServer* getDebuggingServer() {
         return debuggingServer.get();
     }
+
+    void detachDebugger();
 };
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index e845f925..fc312820 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -280,30 +280,33 @@ static int l_debug_breakpoint(lua::State* L) {
 }
 
 static int l_debug_pull_events(lua::State* L) {
-    if (auto server = engine->getDebuggingServer()) {
-        auto events = server->pullBreakpointEvents();
-        if (events.empty()) {
-            return 0;
-        }
-        lua::createtable(L, events.size(), 0);
-        for (int i = 0; i < events.size(); i++) {
-            const auto& event = events[i];
-            lua::createtable(L, 3, 0);
+    auto server = engine->getDebuggingServer();
+    if (!server) {
+        return 0;
+    }
+    auto events = server->pullEvents();
+    if (events.empty()) {
+        return 0;
+    }
+    lua::createtable(L, events.size(), 0);
+    for (int i = 0; i < events.size(); i++) {
+        const auto& event = events[i];
+        lua::createtable(L, 3, 0);
 
-            lua::pushinteger(L, static_cast<int>(event.type));
-            lua::rawseti(L, 1);
+        lua::pushinteger(L, static_cast<int>(event.type));
+        lua::rawseti(L, 1);
 
-            lua::pushstring(L, event.source);
+        if (auto dto = std::get_if<devtools::BreakpointEventDto>(&event.data)) {
+            lua::pushstring(L, dto->source);
             lua::rawseti(L, 2);
 
-            lua::pushinteger(L, event.line);
+            lua::pushinteger(L, dto->line);
             lua::rawseti(L, 3);
-
-            lua::rawseti(L, i + 1);
         }
-        return 1;
+
+        lua::rawseti(L, i + 1);
     }
-    return 0;
+    return 1;
 }
 
 void initialize_libs_extends(lua::State* L) {

From aa42fb1e39154194a4dd72b79fcf757ef2f83be8 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 7 Oct 2025 23:51:02 +0300
Subject: [PATCH 037/133] add 'step-into-function' command

---
 res/scripts/stdmin.lua | 46 ++++++++++++++++++++++++++++++++++++++----
 1 file changed, 42 insertions(+), 4 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 46976f77..adf78fcf 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -3,11 +3,44 @@
 
 local breakpoints = {}
 local dbg_steps_mode = false
+local dbg_step_into_func = false
 local hook_lock = false
+local current_func
+local current_func_stack_size
+
+local _debug_getinfo = debug.getinfo
+
+-- 'return' hook not called for some functions
+-- todo: speedup
+local function calc_stack_size()
+    local s = debug.traceback("", 2)
+    local count = 0
+    for i in s:gmatch("\n") do
+        count = count + 1
+    end
+    return count
+end
 
 debug.sethook(function (e, line)
+    if e == "return" then
+        local info = _debug_getinfo(2)
+        if info.func == current_func then
+            current_func = nil
+        end
+    end
     if dbg_steps_mode and not hook_lock then
         hook_lock = true
+
+        if not dbg_step_into_func then
+            local func = _debug_getinfo(2).func
+            if func ~= current_func then
+                return
+            end
+            if current_func_stack_size ~= calc_stack_size() then
+                return
+            end
+        end
+        current_func = func
         debug.breakpoint()
         debug.pull_events()
     end
@@ -16,13 +49,15 @@ debug.sethook(function (e, line)
     if not bps then
         return
     end
-    local source = debug.getinfo(2).source
+    local source = _debug_getinfo(2).source
     if not bps[source] then
         return
     end
+    current_func = _debug_getinfo(2).func
+    current_func_stack_size = calc_stack_size()
     debug.breakpoint()
     debug.pull_events()
-end, "l")
+end, "lr")
 
 local DBG_EVENT_SET_BREAKPOINT = 1
 local DBG_EVENT_RM_BREAKPOINT = 2
@@ -44,8 +79,13 @@ function debug.pull_events()
             debug.remove_breakpoint(event[2], event[3])
         elseif event[1] == DBG_EVENT_STEP then
             dbg_steps_mode = true
+            dbg_step_into_func = false
+        elseif event[1] == DBG_EVENT_STEP_INTO_FUNCTION then
+            dbg_steps_mode = true
+            dbg_step_into_func = true
         elseif event[1] == DBG_EVENT_RESUME then
             dbg_steps_mode = false
+            dbg_step_into_func = false
         end
     end
 end
@@ -540,8 +580,6 @@ function file.readlines(path)
     return lines
 end
 
-local _debug_getinfo = debug.getinfo
-
 function debug.count_frames()
     local frames = 1
     while true do

From 8f569699979808aeb12cf03f09801e596d604bd7 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 8 Oct 2025 21:35:37 +0300
Subject: [PATCH 038/133] add 'get-value' command

---
 res/scripts/stdmin.lua                     |  19 ++-
 src/devtools/DebuggingServer.cpp           |  45 ++++++
 src/devtools/DebuggingServer.hpp           |  14 +-
 src/logic/scripting/lua/lua_extensions.cpp | 180 ++++++++++++++-------
 src/logic/scripting/lua/lua_util.hpp       |   2 +-
 src/logic/scripting/lua/lua_wrapper.hpp    |   4 +-
 6 files changed, 195 insertions(+), 69 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index adf78fcf..5854f428 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -1,6 +1,3 @@
--- Lua has no parallelizm, also _set_data does not call any lua functions so
--- may be reused one global ffi buffer per lua_State
-
 local breakpoints = {}
 local dbg_steps_mode = false
 local dbg_step_into_func = false
@@ -9,6 +6,7 @@ local current_func
 local current_func_stack_size
 
 local _debug_getinfo = debug.getinfo
+local _debug_getlocal = debug.getlocal
 
 -- 'return' hook not called for some functions
 -- todo: speedup
@@ -64,8 +62,11 @@ local DBG_EVENT_RM_BREAKPOINT = 2
 local DBG_EVENT_STEP = 3
 local DBG_EVENT_STEP_INTO_FUNCTION = 4
 local DBG_EVENT_RESUME = 5
+local DBG_EVENT_GET_VALUE = 6
 local __pull_events = debug.__pull_events
+local __sendvalue = debug.__sendvalue
 debug.__pull_events = nil
+debug.__sendvalue = nil
 
 function debug.pull_events()
     local events = __pull_events()
@@ -86,6 +87,16 @@ function debug.pull_events()
         elseif event[1] == DBG_EVENT_RESUME then
             dbg_steps_mode = false
             dbg_step_into_func = false
+        elseif event[1] == DBG_EVENT_GET_VALUE then
+            local _, value = _debug_getlocal(event[2] + 3, event[3])
+            for _, key in ipairs(event[4]) do
+                if value == nil then
+                    value = "error: index nil value"
+                    break
+                end
+                value = value[key]
+            end
+            __sendvalue(value, event[2], event[3], event[4])
         end
     end
 end
@@ -107,6 +118,8 @@ function debug.remove_breakpoint(source, line)
     bps[source] = nil
 end
 
+-- Lua has no parallelizm, also _set_data does not call any lua functions so
+-- may be reused one global ffi buffer per lua_State
 local canvas_ffi_buffer
 local canvas_ffi_buffer_size = 0
 
diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 9ef677e3..d6777db7 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -186,6 +186,27 @@ bool DebuggingServer::performCommand(
         breakpointEvents.push_back(DebuggingEvent {
             DebuggingEventType::RESUME, SignalEventDto {}});
         return true;
+    } else if (type == "get-value") {
+        if (!map.has("frame") || !map.has("local") || !map.has("path"))
+            return false;
+
+        int frame = map["frame"].asInteger();
+        int localIndex = map["local"].asInteger();
+
+        ValuePath path;
+        for (const auto& segment : map["path"]) {
+            if (segment.isString()) {
+                path.emplace_back(segment.asString());
+            } else {
+                path.emplace_back(static_cast<int>(segment.asInteger()));
+            }
+        }
+        breakpointEvents.push_back(DebuggingEvent {
+            DebuggingEventType::GET_VALUE, GetValueEventDto {
+                frame, localIndex, std::move(path)
+            }
+        });
+        return true;
     } else {
         logger.error() << "unsupported command '" << type << "'";
     }
@@ -204,6 +225,30 @@ void DebuggingServer::onHitBreakpoint(dv::value&& stackTrace) {
     engine.startPauseLoop();
 }
 
+void DebuggingServer::sendValue(
+    dv::value&& value, int frame, int local, ValuePath&& path
+) {
+    auto pathValue = dv::list();
+    for (const auto& segment : path) {
+        if (auto string = std::get_if<std::string>(&segment)) {
+            pathValue.add(*string);
+        } else {
+            pathValue.add(std::get<int>(segment));
+        }
+    }
+    connection->send(dv::object({
+        {"type", std::string("value")},
+        {"frame", frame},
+        {"local", local},
+        {"path", std::move(pathValue)},
+        {"value", std::move(value)},
+    }));
+}
+
+void DebuggingServer::pause() {
+    engine.startPauseLoop();
+}
+
 void DebuggingServer::setClient(u64id_t client) {
     this->connection =
         std::make_unique<ClientConnection>(engine.getNetwork(), client);
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index d7be32cf..a4557a7a 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -43,6 +43,7 @@ namespace devtools {
         STEP,
         STEP_INTO_FUNCTION,
         RESUME,
+        GET_VALUE,
     };
 
     struct BreakpointEventDto {
@@ -53,9 +54,17 @@ namespace devtools {
     struct SignalEventDto {
     };
 
+    using ValuePath = std::vector<std::variant<std::string, int>>;
+
+    struct GetValueEventDto {
+        int frame;
+        int localIndex;
+        ValuePath path;
+    };
+
     struct DebuggingEvent {
         DebuggingEventType type;
-        std::variant<BreakpointEventDto, SignalEventDto> data;
+        std::variant<BreakpointEventDto, SignalEventDto, GetValueEventDto> data;
     };
 
     class DebuggingServer {
@@ -65,6 +74,9 @@ namespace devtools {
 
         bool update();
         void onHitBreakpoint(dv::value&& stackTrace);
+        void pause();
+
+        void sendValue(dv::value&& value, int frame, int local, ValuePath&& path);
 
         void setClient(u64id_t client);
         std::vector<DebuggingEvent> pullEvents();
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index fc312820..e791a87d 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -9,6 +9,7 @@
 #include "devtools/DebuggingServer.hpp"
 #include "logic/scripting/scripting.hpp"
 
+using namespace devtools;
 using namespace scripting;
 
 static debug::Logger logger("lua-debug");
@@ -164,8 +165,52 @@ static int l_math_normal_random(lua::State* L) {
 
 constexpr inline int MAX_SHORT_STRING_LEN = 50;
 
+static std::string get_short_value(lua::State* L, int idx, int type) {
+    switch (type) {
+        case LUA_TNIL:
+            return "nil";
+        case LUA_TBOOLEAN:
+            return lua::toboolean(L, idx) ? "true" : "false";
+        case LUA_TNUMBER: {
+            std::stringstream ss;
+            ss << lua::tonumber(L, idx);
+            return ss.str();
+        }
+        case LUA_TSTRING: {
+            const char* str = lua::tostring(L, idx);
+            if (strlen(str) > MAX_SHORT_STRING_LEN) {
+                return std::string(str, MAX_SHORT_STRING_LEN);
+            } else {
+                return str;
+            }
+        }
+        case LUA_TTABLE:
+            return "{...}";
+        case LUA_TFUNCTION: {
+            std::stringstream ss;
+            ss << "function: 0x" << std::hex << lua::topointer(L, idx);
+            return ss.str();
+        }
+        case LUA_TUSERDATA: {
+            std::stringstream ss;
+            ss << "userdata: 0x" << std::hex << lua::topointer(L, idx);
+            return ss.str();
+        }
+        case LUA_TTHREAD: {
+            std::stringstream ss;
+            ss << "thread: 0x" << std::hex << lua::topointer(L, idx);
+            return ss.str();
+        }
+        default: {
+            std::stringstream ss;
+            ss << "cdata: 0x" << std::hex << lua::topointer(L, idx);
+            return ss.str();
+        }
+    }
+}
+
 static dv::value collect_locals(lua::State* L, lua_Debug& frame) {
-    auto locals = dv::object();
+    auto locals = dv::list();
 
     int localIndex = 1;
     const char* name;
@@ -175,68 +220,13 @@ static dv::value collect_locals(lua::State* L, lua_Debug& frame) {
             continue;
         }
         auto local = dv::object();
+        local["name"] = name;
+        local["index"] = localIndex - 1;
 
         int type = lua::type(L, -1);
-        switch (type) {
-            case LUA_TNIL:
-                local["short"] = "nil";
-                local["type"] = "nil";
-                break;
-            case LUA_TBOOLEAN:
-                local["short"] = lua::toboolean(L, -1) ? "true" : "false";
-                local["type"] = "boolean";
-                break;
-            case LUA_TNUMBER: {
-                std::stringstream ss;
-                ss << lua::tonumber(L, -1);
-                local["short"] = ss.str();
-                local["type"] = "number";
-                break;
-            }
-            case LUA_TSTRING: {
-                const char* str = lua::tostring(L, -1);
-                if (strlen(str) > MAX_SHORT_STRING_LEN) {
-                    local["short"] = std::string(str, MAX_SHORT_STRING_LEN);
-                } else {
-                    local["short"] = str;
-                }
-                local["type"] = "string";
-                break;
-            }
-            case LUA_TTABLE:
-                local["short"] = "{...}";
-                local["type"] = "table";
-                break;
-            case LUA_TFUNCTION: {
-                std::stringstream ss;
-                ss << "function: 0x" << std::hex << lua::topointer(L, -1);
-                local["short"] = ss.str();
-                local["type"] = "function";
-                break;
-            }
-            case LUA_TUSERDATA: {
-                std::stringstream ss;
-                ss << "userdata: 0x" << std::hex << lua::topointer(L, -1);
-                local["short"] = ss.str();
-                local["type"] = "userdata";
-                break;
-            }
-            case LUA_TTHREAD: {
-                std::stringstream ss;
-                ss << "thread: 0x" << std::hex << lua::topointer(L, -1);
-                local["short"] = ss.str();
-                local["type"] = "thread";
-                break;
-            }
-            default: {
-                std::stringstream ss;
-                ss << "cdata: 0x" << std::hex << lua::topointer(L, -1);
-                local["short"] = ss.str();
-                local["type"] = "cdata";
-                break;
-            }
-        }
-        locals[name] = std::move(local);
+        local["type"] = lua::type_name(L, type);
+        local["short"] = get_short_value(L, -1, type);
+        locals.add(std::move(local));
         lua::pop(L);
     }
     return locals;
@@ -279,6 +269,51 @@ static int l_debug_breakpoint(lua::State* L) {
     return 0;
 }
 
+static int l_debug_sendvalue(lua::State* L) {
+    auto server = engine->getDebuggingServer();
+    if (!server) {
+        return 0;
+    }
+    int frame = lua::tointeger(L, 2);
+    int local = lua::tointeger(L, 3);
+
+    ValuePath path;
+    int pathSectors = lua::objlen(L, 4);
+    for (int i = 0; i < pathSectors; i++) {
+        lua::rawgeti(L, i + 1, 4);
+        if (lua::isstring(L, -1)) {
+            path.emplace_back(lua::tostring(L, -1));
+        } else {
+            path.emplace_back(static_cast<int>(lua::tointeger(L, -1)));
+        }
+        lua::pop(L);
+    }
+
+    dv::value value = nullptr;
+    if (lua::istable(L, 1)) {
+        auto table = dv::object();
+
+        lua::pushnil(L);
+        while (lua::next(L, 1)) {
+            auto key = lua::tolstring(L, -2);
+
+            int type = lua::type(L, -1);
+            table[std::string(key)] = dv::object({
+                {"type", std::string(lua::type_name(L, type))},
+                {"short", get_short_value(L, -1, type)},
+            });
+            lua::pop(L);
+        }
+        lua::pop(L);
+        value = std::move(table);
+    } else {
+        value = lua::tovalue(L, 1);
+    }
+
+    server->sendValue(std::move(value), frame, local, std::move(path));
+    return 0;
+}
+
 static int l_debug_pull_events(lua::State* L) {
     auto server = engine->getDebuggingServer();
     if (!server) {
@@ -296,12 +331,30 @@ static int l_debug_pull_events(lua::State* L) {
         lua::pushinteger(L, static_cast<int>(event.type));
         lua::rawseti(L, 1);
 
-        if (auto dto = std::get_if<devtools::BreakpointEventDto>(&event.data)) {
+        if (auto dto = std::get_if<BreakpointEventDto>(&event.data)) {
             lua::pushstring(L, dto->source);
             lua::rawseti(L, 2);
 
             lua::pushinteger(L, dto->line);
             lua::rawseti(L, 3);
+        } else if (auto dto = std::get_if<GetValueEventDto>(&event.data)) {
+            lua::pushinteger(L, dto->frame);
+            lua::rawseti(L, 2);
+
+            lua::pushinteger(L, dto->localIndex);
+            lua::rawseti(L, 3);
+
+            lua::createtable(L, dto->path.size(), 0);
+            for (int i = 0; i < dto->path.size(); i++) {
+                const auto& segment = dto->path[i];
+                if (auto string = std::get_if<std::string>(&segment)) {
+                    lua::pushstring(L, *string);
+                } else {
+                    lua::pushinteger(L, std::get<int>(segment));
+                }
+                lua::rawseti(L, i + 1);
+            }
+            lua::rawseti(L, 4);
         }
 
         lua::rawseti(L, i + 1);
@@ -329,6 +382,9 @@ void initialize_libs_extends(lua::State* L) {
         lua::pushcfunction(L, lua::wrap<l_debug_pull_events>);
         lua::setfield(L, "__pull_events");
 
+        lua::pushcfunction(L, lua::wrap<l_debug_sendvalue>);
+        lua::setfield(L, "__sendvalue");
+
         lua::pop(L);
     }
     if (lua::getglobal(L, "math")) {
diff --git a/src/logic/scripting/lua/lua_util.hpp b/src/logic/scripting/lua/lua_util.hpp
index e72b56eb..a8fb246e 100644
--- a/src/logic/scripting/lua/lua_util.hpp
+++ b/src/logic/scripting/lua/lua_util.hpp
@@ -249,7 +249,7 @@ namespace lua {
     inline lua::Number tonumber(lua::State* L, int idx) {
 #ifndef NDEBUG
         if (lua_type(L, idx) != LUA_TNUMBER && !lua_isnoneornil(L, idx)) {
-            throw std::runtime_error("integer expected");
+            throw std::runtime_error("number expected");
         }
 #endif
         return lua_tonumber(L, idx);
diff --git a/src/logic/scripting/lua/lua_wrapper.hpp b/src/logic/scripting/lua/lua_wrapper.hpp
index f82f5bd4..df130af1 100644
--- a/src/logic/scripting/lua/lua_wrapper.hpp
+++ b/src/logic/scripting/lua/lua_wrapper.hpp
@@ -50,8 +50,8 @@ namespace lua {
     inline int type(lua::State* L, int idx) {
         return lua_type(L, idx);
     }
-    inline const char* type_name(lua::State* L, int idx) {
-        return lua_typename(L, idx);
+    inline const char* type_name(lua::State* L, int tp) {
+        return lua_typename(L, tp);
     }
     inline int rawget(lua::State* L, int idx = -2) {
         lua_rawget(L, idx);

From 4f6a443fa3e59e0304315b274a1b31544701a76a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 8 Oct 2025 23:11:10 +0300
Subject: [PATCH 039/133] replace 'debug.breakpoint' with 'debug.pause'

---
 res/scripts/stdmin.lua                     |  6 ++++--
 src/devtools/DebuggingServer.cpp           | 18 ++++++++----------
 src/devtools/DebuggingServer.hpp           |  3 +--
 src/logic/scripting/lua/lua_extensions.cpp | 12 ++++++++----
 4 files changed, 21 insertions(+), 18 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 5854f428..60961653 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -39,7 +39,7 @@ debug.sethook(function (e, line)
             end
         end
         current_func = func
-        debug.breakpoint()
+        debug.pause()
         debug.pull_events()
     end
     hook_lock = false
@@ -53,7 +53,7 @@ debug.sethook(function (e, line)
     end
     current_func = _debug_getinfo(2).func
     current_func_stack_size = calc_stack_size()
-    debug.breakpoint()
+    debug.pause()
     debug.pull_events()
 end, "lr")
 
@@ -65,6 +65,7 @@ local DBG_EVENT_RESUME = 5
 local DBG_EVENT_GET_VALUE = 6
 local __pull_events = debug.__pull_events
 local __sendvalue = debug.__sendvalue
+local __pause = debug.pause
 debug.__pull_events = nil
 debug.__sendvalue = nil
 
@@ -97,6 +98,7 @@ function debug.pull_events()
                 value = value[key]
             end
             __sendvalue(value, event[2], event[3], event[4])
+            __pause()
         end
     end
 end
diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index d6777db7..2cf67f48 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -213,15 +213,17 @@ bool DebuggingServer::performCommand(
     return false;
 }
 
-void DebuggingServer::onHitBreakpoint(dv::value&& stackTrace) {
+void DebuggingServer::pause(std::string&& message, dv::value&& stackTrace) {
     if (connection == nullptr) {
         return;
     }
-    connection->send(dv::object({
-        {"type", std::string("hit-breakpoint")},
-        {"stack", std::move(stackTrace)}
-    }));
-
+    if (stackTrace != nullptr) {
+        connection->send(dv::object({
+            {"type", std::string("hit-breakpoint")},
+            {"message", std::move(message)},
+            {"stack", std::move(stackTrace)}
+        }));
+    }
     engine.startPauseLoop();
 }
 
@@ -245,10 +247,6 @@ void DebuggingServer::sendValue(
     }));
 }
 
-void DebuggingServer::pause() {
-    engine.startPauseLoop();
-}
-
 void DebuggingServer::setClient(u64id_t client) {
     this->connection =
         std::make_unique<ClientConnection>(engine.getNetwork(), client);
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index a4557a7a..0f3b4566 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -73,8 +73,7 @@ namespace devtools {
         ~DebuggingServer();
 
         bool update();
-        void onHitBreakpoint(dv::value&& stackTrace);
-        void pause();
+        void pause(std::string&& message, dv::value&& stackTrace);
 
         void sendValue(dv::value&& value, int frame, int local, ValuePath&& path);
 
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index e791a87d..88d8427f 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -262,9 +262,13 @@ static dv::value create_stack_trace(lua::State* L, int initFrame = 2) {
     return entriesList;
 }
 
-static int l_debug_breakpoint(lua::State* L) {
+static int l_debug_pause(lua::State* L) {
     if (auto server = engine->getDebuggingServer()) {
-        server->onHitBreakpoint(create_stack_trace(L));
+        std::string message;
+        if (lua::isstring(L, 1)) {
+            message = lua::tolstring(L, 1);
+        }
+        server->pause(std::move(message), create_stack_trace(L));
     }
     return 0;
 }
@@ -376,8 +380,8 @@ void initialize_libs_extends(lua::State* L) {
         lua::pushcfunction(L, lua::wrap<l_debug_print>);
         lua::setfield(L, "print");
 
-        lua::pushcfunction(L, lua::wrap<l_debug_breakpoint>);
-        lua::setfield(L, "breakpoint");
+        lua::pushcfunction(L, lua::wrap<l_debug_pause>);
+        lua::setfield(L, "pause");
 
         lua::pushcfunction(L, lua::wrap<l_debug_pull_events>);
         lua::setfield(L, "__pull_events");

From ddc56b46ce413c3481a9d1c3cd147203deea3a2f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 8 Oct 2025 23:20:41 +0300
Subject: [PATCH 040/133] cleanup

---
 res/scripts/stdmin.lua | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 60961653..b0410bc2 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -7,6 +7,7 @@ local current_func_stack_size
 
 local _debug_getinfo = debug.getinfo
 local _debug_getlocal = debug.getlocal
+local __pause = debug.pause
 
 -- 'return' hook not called for some functions
 -- todo: speedup
@@ -39,7 +40,7 @@ debug.sethook(function (e, line)
             end
         end
         current_func = func
-        debug.pause()
+        __pause()
         debug.pull_events()
     end
     hook_lock = false
@@ -53,7 +54,7 @@ debug.sethook(function (e, line)
     end
     current_func = _debug_getinfo(2).func
     current_func_stack_size = calc_stack_size()
-    debug.pause()
+    __pause("paused on breakpoint")
     debug.pull_events()
 end, "lr")
 
@@ -65,7 +66,6 @@ local DBG_EVENT_RESUME = 5
 local DBG_EVENT_GET_VALUE = 6
 local __pull_events = debug.__pull_events
 local __sendvalue = debug.__sendvalue
-local __pause = debug.pause
 debug.__pull_events = nil
 debug.__sendvalue = nil
 

From 972181022a2fc1e9c3fc1826c9e756cc153c7ddf Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 8 Oct 2025 23:50:36 +0300
Subject: [PATCH 041/133] feat: pause on exception caused by 'error' function
 call

---
 res/scripts/stdmin.lua                     |  6 ++++++
 src/logic/scripting/lua/lua_extensions.cpp | 12 ++++++++----
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index b0410bc2..4487860f 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -8,6 +8,7 @@ local current_func_stack_size
 local _debug_getinfo = debug.getinfo
 local _debug_getlocal = debug.getlocal
 local __pause = debug.pause
+local __error = error
 
 -- 'return' hook not called for some functions
 -- todo: speedup
@@ -120,6 +121,11 @@ function debug.remove_breakpoint(source, line)
     bps[source] = nil
 end
 
+function error(message, level)
+    __pause("paused on exception: " .. message)
+    __error(message, level)
+end
+
 -- Lua has no parallelizm, also _set_data does not call any lua functions so
 -- may be reused one global ffi buffer per lua_State
 local canvas_ffi_buffer
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index 88d8427f..f1b7638f 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -188,22 +188,26 @@ static std::string get_short_value(lua::State* L, int idx, int type) {
             return "{...}";
         case LUA_TFUNCTION: {
             std::stringstream ss;
-            ss << "function: 0x" << std::hex << lua::topointer(L, idx);
+            ss << "function: 0x" << std::hex
+               << reinterpret_cast<ptrdiff_t>(lua::topointer(L, idx));
             return ss.str();
         }
         case LUA_TUSERDATA: {
             std::stringstream ss;
-            ss << "userdata: 0x" << std::hex << lua::topointer(L, idx);
+            ss << "userdata: 0x" << std::hex
+               << reinterpret_cast<ptrdiff_t>(lua::topointer(L, idx));
             return ss.str();
         }
         case LUA_TTHREAD: {
             std::stringstream ss;
-            ss << "thread: 0x" << std::hex << lua::topointer(L, idx);
+            ss << "thread: 0x" << std::hex
+               << reinterpret_cast<ptrdiff_t>(lua::topointer(L, idx));
             return ss.str();
         }
         default: {
             std::stringstream ss;
-            ss << "cdata: 0x" << std::hex << lua::topointer(L, idx);
+            ss << "cdata: 0x" << std::hex
+               << reinterpret_cast<ptrdiff_t>(lua::topointer(L, idx));
             return ss.str();
         }
     }

From 33a5410ca2b23299768663cdc8eb12037c21cf7a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 00:23:54 +0300
Subject: [PATCH 042/133] add 'reason' argument to debug.pause

---
 res/scripts/stdmin.lua                     |  4 ++--
 src/devtools/DebuggingServer.cpp           |  5 ++++-
 src/devtools/DebuggingServer.hpp           |  4 +++-
 src/logic/scripting/lua/lua_extensions.cpp | 10 ++++++++--
 4 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 4487860f..3e07c26b 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -55,7 +55,7 @@ debug.sethook(function (e, line)
     end
     current_func = _debug_getinfo(2).func
     current_func_stack_size = calc_stack_size()
-    __pause("paused on breakpoint")
+    __pause("breakpoint")
     debug.pull_events()
 end, "lr")
 
@@ -122,7 +122,7 @@ function debug.remove_breakpoint(source, line)
 end
 
 function error(message, level)
-    __pause("paused on exception: " .. message)
+    __pause("exception", message)
     __error(message, level)
 end
 
diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 2cf67f48..505f1ff5 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -213,13 +213,16 @@ bool DebuggingServer::performCommand(
     return false;
 }
 
-void DebuggingServer::pause(std::string&& message, dv::value&& stackTrace) {
+void DebuggingServer::pause(
+    std::string&& reason, std::string&& message, dv::value&& stackTrace
+) {
     if (connection == nullptr) {
         return;
     }
     if (stackTrace != nullptr) {
         connection->send(dv::object({
             {"type", std::string("hit-breakpoint")},
+            {"reason", std::move(reason)},
             {"message", std::move(message)},
             {"stack", std::move(stackTrace)}
         }));
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index 0f3b4566..cd4931cb 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -73,7 +73,9 @@ namespace devtools {
         ~DebuggingServer();
 
         bool update();
-        void pause(std::string&& message, dv::value&& stackTrace);
+        void pause(
+            std::string&& reason, std::string&& message, dv::value&& stackTrace
+        );
 
         void sendValue(dv::value&& value, int frame, int local, ValuePath&& path);
 
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index f1b7638f..b2224104 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -268,11 +268,17 @@ static dv::value create_stack_trace(lua::State* L, int initFrame = 2) {
 
 static int l_debug_pause(lua::State* L) {
     if (auto server = engine->getDebuggingServer()) {
+        std::string reason;
         std::string message;
         if (lua::isstring(L, 1)) {
-            message = lua::tolstring(L, 1);
+            reason = lua::tolstring(L, 1);
         }
-        server->pause(std::move(message), create_stack_trace(L));
+        if (lua::isstring(L, 2)) {
+            message = lua::tolstring(L, 2);
+        }
+        server->pause(
+            std::move(reason), std::move(message), create_stack_trace(L)
+        );
     }
     return 0;
 }

From f4c3b53cd13aa3b3983fe05abb026a19d597df66 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 00:28:06 +0300
Subject: [PATCH 043/133] replace 'hit-breakpoint' with 'paused'

---
 res/scripts/stdmin.lua           |  2 +-
 src/devtools/DebuggingServer.cpp | 14 ++++++--------
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 3e07c26b..8c9e0a42 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -41,7 +41,7 @@ debug.sethook(function (e, line)
             end
         end
         current_func = func
-        __pause()
+        __pause("step")
         debug.pull_events()
     end
     hook_lock = false
diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 505f1ff5..a9a32667 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -219,14 +219,12 @@ void DebuggingServer::pause(
     if (connection == nullptr) {
         return;
     }
-    if (stackTrace != nullptr) {
-        connection->send(dv::object({
-            {"type", std::string("hit-breakpoint")},
-            {"reason", std::move(reason)},
-            {"message", std::move(message)},
-            {"stack", std::move(stackTrace)}
-        }));
-    }
+    connection->send(dv::object({
+        {"type", std::string("paused")},
+        {"reason", std::move(reason)},
+        {"message", std::move(message)},
+        {"stack", std::move(stackTrace)}
+    }));
     engine.startPauseLoop();
 }
 

From a33e3068c8d30567517b3cf73b48789432784d0a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 00:42:19 +0300
Subject: [PATCH 044/133] feat: resume on disconnect &  add 'resumed' response

---
 src/devtools/DebuggingServer.cpp | 30 +++++++++++++++++++++++-------
 src/devtools/DebuggingServer.hpp |  2 ++
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index a9a32667..2baebf47 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -61,6 +61,10 @@ void ClientConnection::sendResponse(const std::string& type) {
     send(dv::object({{"type", type}}));
 }
 
+bool ClientConnection::alive() const {
+    return network.getConnection(this->connection, true) != nullptr;
+}
+
 static network::Server& create_tcp_server(
     DebuggingServer& dbgServer, Engine& engine, int port
 ) {
@@ -134,6 +138,10 @@ bool DebuggingServer::update() {
     }
     std::string message = connection->read();
     if (message.empty()) {
+        if (!connection->alive()) {
+            connection.reset();
+            return true;
+        }
         return false;
     }
     logger.debug() << "received: " << message;
@@ -144,7 +152,10 @@ bool DebuggingServer::update() {
             return false;
         }
         const auto& type = obj["type"].asString();
-        return performCommand(type, obj);
+        if (performCommand(type, obj)) {
+            connection->sendResponse("resumed");
+            return true;
+        }
     } catch (const std::runtime_error& err) {
         logger.error() << "could not to parse message: " << err.what();
     }
@@ -219,12 +230,17 @@ void DebuggingServer::pause(
     if (connection == nullptr) {
         return;
     }
-    connection->send(dv::object({
-        {"type", std::string("paused")},
-        {"reason", std::move(reason)},
-        {"message", std::move(message)},
-        {"stack", std::move(stackTrace)}
-    }));
+    auto response = dv::object({{"type", std::string("paused")}});
+    if (!reason.empty()) {
+        response["reason"] = std::move(reason);
+    }
+    if (!message.empty()) {
+        response["message"] = std::move(message);
+    }
+    if (stackTrace != nullptr) {
+        response["stack"] = std::move(stackTrace);
+    }
+    connection->send(std::move(response));
     engine.startPauseLoop();
 }
 
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index cd4931cb..13c9282b 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -31,6 +31,8 @@ namespace devtools {
         std::string read();
         void send(const dv::value& message);
         void sendResponse(const std::string& type);
+
+        bool alive() const;
     private:
         network::Network& network;
         size_t messageLength = 0;

From 1a7bcf986517c32ffd622f1e455d98baaff5f3a6 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 01:04:08 +0300
Subject: [PATCH 045/133] add 'connect' command & feat: disconnect-action

---
 src/devtools/DebuggingServer.cpp | 16 +++++++++++++++-
 src/devtools/DebuggingServer.hpp |  4 ++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index 2baebf47..b6a67c7e 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -139,8 +139,9 @@ bool DebuggingServer::update() {
     std::string message = connection->read();
     if (message.empty()) {
         if (!connection->alive()) {
+            bool status = performCommand(disconnectAction, dv::object());
             connection.reset();
-            return true;
+            return status;
         }
         return false;
     }
@@ -165,6 +166,15 @@ bool DebuggingServer::update() {
 bool DebuggingServer::performCommand(
     const std::string& type, const dv::value& map
 ) {
+    if (type == "connect" && !connectionEstablished) {
+        map.at("disconnect-action").get(disconnectAction);
+        connectionEstablished = true;
+        logger.info() << "client connection established";
+        connection->sendResponse("success");
+    }
+    if (!connectionEstablished) {
+        return false;
+    }
     if (type == "terminate") {
         engine.quit();
         connection->sendResponse("success");
@@ -272,3 +282,7 @@ void DebuggingServer::setClient(u64id_t client) {
 std::vector<DebuggingEvent> DebuggingServer::pullEvents() {
     return std::move(breakpointEvents);
 }
+
+void DebuggingServer::setDisconnectAction(const std::string& action) {
+    disconnectAction = action;
+}
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index 13c9282b..533453d7 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -83,11 +83,15 @@ namespace devtools {
 
         void setClient(u64id_t client);
         std::vector<DebuggingEvent> pullEvents();
+
+        void setDisconnectAction(const std::string& action);
     private:
         Engine& engine;
         network::Server& server;
         std::unique_ptr<ClientConnection> connection;
+        bool connectionEstablished = false;
         std::vector<DebuggingEvent> breakpointEvents;
+        std::string disconnectAction = "resume";
 
         bool performCommand(
             const std::string& type, const dv::value& map

From d861595f784601f72551d8f2dfcb1a2da52c5b2e Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 01:14:49 +0300
Subject: [PATCH 046/133] disable debugging if server is not running & make
 detach complete

---
 res/scripts/stdmin.lua                     | 79 +++++++++++++---------
 src/logic/scripting/lua/lua_extensions.cpp |  7 ++
 2 files changed, 53 insertions(+), 33 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 8c9e0a42..df5c7ce2 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -9,6 +9,7 @@ local _debug_getinfo = debug.getinfo
 local _debug_getlocal = debug.getlocal
 local __pause = debug.pause
 local __error = error
+local __sethook = debug.sethook
 
 -- 'return' hook not called for some functions
 -- todo: speedup
@@ -21,43 +22,46 @@ local function calc_stack_size()
     return count
 end
 
-debug.sethook(function (e, line)
-    if e == "return" then
-        local info = _debug_getinfo(2)
-        if info.func == current_func then
-            current_func = nil
+local is_debugging = debug.is_debugging()
+if is_debugging then
+    __sethook(function (e, line)
+        if e == "return" then
+            local info = _debug_getinfo(2)
+            if info.func == current_func then
+                current_func = nil
+            end
         end
-    end
-    if dbg_steps_mode and not hook_lock then
-        hook_lock = true
+        if dbg_steps_mode and not hook_lock then
+            hook_lock = true
 
-        if not dbg_step_into_func then
-            local func = _debug_getinfo(2).func
-            if func ~= current_func then
-                return
-            end
-            if current_func_stack_size ~= calc_stack_size() then
-                return
+            if not dbg_step_into_func then
+                local func = _debug_getinfo(2).func
+                if func ~= current_func then
+                    return
+                end
+                if current_func_stack_size ~= calc_stack_size() then
+                    return
+                end
             end
+            current_func = func
+            __pause("step")
+            debug.pull_events()
         end
-        current_func = func
-        __pause("step")
+        hook_lock = false
+        local bps = breakpoints[line]
+        if not bps then
+            return
+        end
+        local source = _debug_getinfo(2).source
+        if not bps[source] then
+            return
+        end
+        current_func = _debug_getinfo(2).func
+        current_func_stack_size = calc_stack_size()
+        __pause("breakpoint")
         debug.pull_events()
-    end
-    hook_lock = false
-    local bps = breakpoints[line]
-    if not bps then
-        return
-    end
-    local source = _debug_getinfo(2).source
-    if not bps[source] then
-        return
-    end
-    current_func = _debug_getinfo(2).func
-    current_func_stack_size = calc_stack_size()
-    __pause("breakpoint")
-    debug.pull_events()
-end, "lr")
+    end, "lr")
+end
 
 local DBG_EVENT_SET_BREAKPOINT = 1
 local DBG_EVENT_RM_BREAKPOINT = 2
@@ -71,6 +75,13 @@ debug.__pull_events = nil
 debug.__sendvalue = nil
 
 function debug.pull_events()
+    if not is_debugging then
+        return
+    end
+    if not debug.is_debugging() then
+        is_debugging = false
+        __sethook()
+    end
     local events = __pull_events()
     if not events then
         return
@@ -122,7 +133,9 @@ function debug.remove_breakpoint(source, line)
 end
 
 function error(message, level)
-    __pause("exception", message)
+    if is_debugging then
+        __pause("exception", message)
+    end
     __error(message, level)
 end
 
diff --git a/src/logic/scripting/lua/lua_extensions.cpp b/src/logic/scripting/lua/lua_extensions.cpp
index b2224104..27b47fae 100644
--- a/src/logic/scripting/lua/lua_extensions.cpp
+++ b/src/logic/scripting/lua/lua_extensions.cpp
@@ -376,6 +376,10 @@ static int l_debug_pull_events(lua::State* L) {
     return 1;
 }
 
+static int l_debug_is_debugging(lua::State* L) {
+    return lua::pushboolean(L, engine->getDebuggingServer() != nullptr);
+}
+
 void initialize_libs_extends(lua::State* L) {
     if (lua::getglobal(L, "debug")) {
         lua::pushcfunction(L, lua::wrap<l_debug_error>);
@@ -399,6 +403,9 @@ void initialize_libs_extends(lua::State* L) {
         lua::pushcfunction(L, lua::wrap<l_debug_sendvalue>);
         lua::setfield(L, "__sendvalue");
 
+        lua::pushcfunction(L, lua::wrap<l_debug_is_debugging>);
+        lua::setfield(L, "is_debugging");
+
         lua::pop(L);
     }
     if (lua::getglobal(L, "math")) {

From e83b3b3ce1697fd08b5ebcb8375698508e15352c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 02:13:03 +0300
Subject: [PATCH 047/133] add protocol version check

---
 src/devtools/DebuggingServer.cpp | 31 +++++++++++++++++++++++++++++--
 src/devtools/DebuggingServer.hpp |  6 ++++++
 2 files changed, 35 insertions(+), 2 deletions(-)

diff --git a/src/devtools/DebuggingServer.cpp b/src/devtools/DebuggingServer.cpp
index b6a67c7e..09a2b368 100644
--- a/src/devtools/DebuggingServer.cpp
+++ b/src/devtools/DebuggingServer.cpp
@@ -17,6 +17,27 @@ ClientConnection::~ClientConnection() {
     }
 }
 
+bool ClientConnection::initiate(network::ReadableConnection* connection) {
+    if (connection->available() < 8) {
+        return false;
+    }
+    char buffer[8] {};
+    char expected[8] {};
+    std::memcpy(expected, VCDBG_MAGIC, sizeof(VCDBG_MAGIC));
+    expected[6] = VCDBG_VERSION >> 8;
+    expected[7] = VCDBG_VERSION & 0xFF;
+    connection->recv(buffer, sizeof(VCDBG_MAGIC));
+
+    connection->send(expected, sizeof(VCDBG_MAGIC));
+    if (std::memcmp(expected, buffer, sizeof(VCDBG_MAGIC)) == 0) {
+        initiated = true;
+        return false;
+    } else {
+        connection->close(true);
+        return true;
+    }
+}
+
 std::string ClientConnection::read() {
     auto connection = dynamic_cast<network::ReadableConnection*>(
         network.getConnection(this->connection, true)
@@ -24,6 +45,11 @@ std::string ClientConnection::read() {
     if (connection == nullptr) {
         return "";
     }
+    if (!initiated) {
+        if (initiate(connection)) {
+            return "";
+        }
+    }
     if (messageLength == 0) {
         if (connection->available() >= sizeof(int32_t)) {
             int32_t length = 0;
@@ -166,7 +192,7 @@ bool DebuggingServer::update() {
 bool DebuggingServer::performCommand(
     const std::string& type, const dv::value& map
 ) {
-    if (type == "connect" && !connectionEstablished) {
+    if (!connectionEstablished && type == "connect") {
         map.at("disconnect-action").get(disconnectAction);
         connectionEstablished = true;
         logger.info() << "client connection established";
@@ -275,8 +301,9 @@ void DebuggingServer::sendValue(
 }
 
 void DebuggingServer::setClient(u64id_t client) {
-    this->connection =
+    connection =
         std::make_unique<ClientConnection>(engine.getNetwork(), client);
+    connectionEstablished = false;
 }
 
 std::vector<DebuggingEvent> DebuggingServer::pullEvents() {
diff --git a/src/devtools/DebuggingServer.hpp b/src/devtools/DebuggingServer.hpp
index 533453d7..b02229c6 100644
--- a/src/devtools/DebuggingServer.hpp
+++ b/src/devtools/DebuggingServer.hpp
@@ -21,6 +21,9 @@ namespace dv {
 class Engine;
 
 namespace devtools {
+    inline constexpr const char VCDBG_MAGIC[8] = "vc-dbg\0";
+    inline constexpr int VCDBG_VERSION = 1;
+
     class ClientConnection {
     public:
         ClientConnection(network::Network& network, u64id_t connection)
@@ -37,6 +40,9 @@ namespace devtools {
         network::Network& network;
         size_t messageLength = 0;
         u64id_t connection;
+        bool initiated = false;
+    
+        bool initiate(network::ReadableConnection* connection);
     };
 
     enum class DebuggingEventType {

From 7877cf78d59c34a0dc0d8f2061805ae7a75c1d71 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 9 Oct 2025 12:26:54 +0300
Subject: [PATCH 048/133] disable test debugging server

---
 src/engine/Engine.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 67acc498..98a2c3ef 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -51,7 +51,7 @@ struct CoreParameters {
     std::filesystem::path userFolder = ".";
     std::filesystem::path scriptFile;
     std::filesystem::path projectFolder;
-    std::string debugServerString = "tcp:9030";
+    std::string debugServerString;
     int tps = 20;
 };
 

From b55879116f3309e7ed92e35144f2ab973fb04651 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 13:20:18 +0300
Subject: [PATCH 049/133] disable msvc warning C4459

---
 src/CMakeLists.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 5e8fc44b..dd87247a 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -92,6 +92,7 @@ target_compile_options(
                    # mismatch
            /wd4100 # unreferenced formal parameter
            /wd4458 # declaration of 'var' hides class member
+           /wd4459 # declaration of 'var' hides global declaration 
            /wd4101 # 'var': unreferenced local variable
            /wd4388 # 'token' : signed/unsigned mismatch
            /wd4018 # '>': signed/unsigned mismatch

From c6c08e1efb3ebac9a23ebe3a085358fb8dcfd3b3 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 13:31:36 +0300
Subject: [PATCH 050/133] add -Wpedantic

---
 src/CMakeLists.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index dd87247a..6375b858 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -100,6 +100,7 @@ target_compile_options(
            $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:
            -Wall
            -Wextra
+           -Wpedantic
            # additional warnings
            -Wformat-nonliteral
            -Wcast-align

From 31f3c2de6a2e9e56711e483428c1d3599f043f4a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 13:50:50 +0300
Subject: [PATCH 051/133] disable msvc warning C4457

---
 src/CMakeLists.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 6375b858..1b508852 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -91,6 +91,7 @@ target_compile_options(
            /wd4245 # conversion from 'int' to 'const size_t', signed/unsigned
                    # mismatch
            /wd4100 # unreferenced formal parameter
+           /wd4457 # declaration of 'var' hides function parameter 
            /wd4458 # declaration of 'var' hides class member
            /wd4459 # declaration of 'var' hides global declaration 
            /wd4101 # 'var': unreferenced local variable

From 8e52ad4e3b063f700dfcdd5d0a4dfd882a39acc0 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 13:58:29 +0300
Subject: [PATCH 052/133] enable more clang/gcc warnings

---
 src/CMakeLists.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 1b508852..d18fafe1 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -104,6 +104,11 @@ target_compile_options(
            -Wpedantic
            # additional warnings
            -Wformat-nonliteral
+           -Wctor-dtor-privacy
+           -Wduplicated-branches
+           -Wduplicated-cond
+           -Wzero-as-null-pointer-constant
+           -Wsign-conversion
            -Wcast-align
            -Wpointer-arith
            -Wundef
@@ -111,6 +116,7 @@ target_compile_options(
            -Wno-unused-parameter
            -Wno-sign-compare
            -Wno-unknown-pragmas
+           -Wno-gnu-anonymous-struct
            >)
 
 target_link_options(

From 8f3e5e880cfb800ff3bd3e7f6eb1a89e46573e15 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 14:32:07 +0300
Subject: [PATCH 053/133] temporary disable -Wsign-conversion

---
 src/CMakeLists.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index d18fafe1..55210fda 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -108,7 +108,7 @@ target_compile_options(
            -Wduplicated-branches
            -Wduplicated-cond
            -Wzero-as-null-pointer-constant
-           -Wsign-conversion
+           #-Wsign-conversion
            -Wcast-align
            -Wpointer-arith
            -Wundef

From 24931770d3aa198ab7194b16a2a31f53455c2a6d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 23:12:01 +0300
Subject: [PATCH 054/133] fix warnings (#648)

* fix unknown command line argument

* fix warnings settings for gcc

* fix -Wzero-as-null-pointer-constant

* revert CMakeLists.txt
---
 src/CMakeLists.txt                              | 10 ++++------
 src/graphics/core/Cubemap.cpp                   |  2 +-
 src/graphics/core/Shadows.cpp                   |  2 +-
 src/graphics/ui/gui_util.hpp                    |  2 +-
 src/logic/scripting/lua/libs/lib__rigidbody.cpp |  3 ++-
 src/logic/scripting/lua/libs/lib__skeleton.cpp  |  2 +-
 src/logic/scripting/lua/libs/lib__transform.cpp |  3 ++-
 src/logic/scripting/lua/libs/libapp.cpp         |  2 +-
 src/logic/scripting/lua/libs/libassets.cpp      |  2 +-
 src/logic/scripting/lua/libs/libaudio.cpp       |  3 ++-
 src/logic/scripting/lua/libs/libbase64.cpp      |  2 +-
 src/logic/scripting/lua/libs/libbjson.cpp       |  2 +-
 src/logic/scripting/lua/libs/libblock.cpp       |  2 +-
 src/logic/scripting/lua/libs/libblockwraps.cpp  |  2 +-
 src/logic/scripting/lua/libs/libbyteutil.cpp    |  2 +-
 src/logic/scripting/lua/libs/libcamera.cpp      |  3 ++-
 src/logic/scripting/lua/libs/libcompression.cpp |  2 +-
 src/logic/scripting/lua/libs/libconsole.cpp     |  3 ++-
 src/logic/scripting/lua/libs/libcore.cpp        |  2 +-
 src/logic/scripting/lua/libs/libentity.cpp      |  2 +-
 src/logic/scripting/lua/libs/libfile.cpp        |  2 +-
 src/logic/scripting/lua/libs/libgeneration.cpp  |  2 +-
 src/logic/scripting/lua/libs/libgui.cpp         |  2 +-
 src/logic/scripting/lua/libs/libhud.cpp         |  2 +-
 src/logic/scripting/lua/libs/libinput.cpp       |  2 +-
 src/logic/scripting/lua/libs/libinventory.cpp   |  2 +-
 src/logic/scripting/lua/libs/libitem.cpp        |  2 +-
 src/logic/scripting/lua/libs/libjson.cpp        |  2 +-
 src/logic/scripting/lua/libs/libmat4.cpp        |  3 ++-
 src/logic/scripting/lua/libs/libnetwork.cpp     |  2 +-
 src/logic/scripting/lua/libs/libpack.cpp        |  2 +-
 src/logic/scripting/lua/libs/libparticles.cpp   |  2 +-
 src/logic/scripting/lua/libs/libpathfinding.cpp |  2 +-
 src/logic/scripting/lua/libs/libplayer.cpp      |  2 +-
 src/logic/scripting/lua/libs/libposteffects.cpp |  2 +-
 src/logic/scripting/lua/libs/libquat.cpp        |  3 ++-
 src/logic/scripting/lua/libs/librandom.cpp      |  2 +-
 src/logic/scripting/lua/libs/libtext3d.cpp      |  2 +-
 src/logic/scripting/lua/libs/libtime.cpp        |  2 +-
 src/logic/scripting/lua/libs/libtoml.cpp        |  2 +-
 src/logic/scripting/lua/libs/libutf8.cpp        |  2 +-
 src/logic/scripting/lua/libs/libvecn.cpp        |  9 ++++++---
 src/logic/scripting/lua/libs/libweather.cpp     |  2 +-
 src/logic/scripting/lua/libs/libworld.cpp       |  2 +-
 src/logic/scripting/lua/libs/libyaml.cpp        |  2 +-
 src/logic/scripting/lua/lua_overrides.cpp       |  2 +-
 src/maths/util.hpp                              |  2 +-
 src/network/Curl.cpp                            |  4 ++--
 src/util/platform.cpp                           |  6 +++---
 src/window/detail/GLFWWindow.cpp                |  4 ++--
 50 files changed, 69 insertions(+), 61 deletions(-)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 55210fda..4e1cf260 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -101,13 +101,8 @@ target_compile_options(
            $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:
            -Wall
            -Wextra
-           -Wpedantic
            # additional warnings
            -Wformat-nonliteral
-           -Wctor-dtor-privacy
-           -Wduplicated-branches
-           -Wduplicated-cond
-           -Wzero-as-null-pointer-constant
            #-Wsign-conversion
            -Wcast-align
            -Wpointer-arith
@@ -116,7 +111,10 @@ target_compile_options(
            -Wno-unused-parameter
            -Wno-sign-compare
            -Wno-unknown-pragmas
-           -Wno-gnu-anonymous-struct
+           >
+           $<$<CXX_COMPILER_ID:MSVC>:
+           -Wduplicated-branches
+           -Wduplicated-cond
            >)
 
 target_link_options(
diff --git a/src/graphics/core/Cubemap.cpp b/src/graphics/core/Cubemap.cpp
index 13bba31b..631a8d7e 100644
--- a/src/graphics/core/Cubemap.cpp
+++ b/src/graphics/core/Cubemap.cpp
@@ -25,7 +25,7 @@ Cubemap::Cubemap(uint width, uint height, ImageFormat imageFormat)
             0, 
             format, 
             GL_UNSIGNED_BYTE, 
-            NULL
+            nullptr
         );
     }
 }
diff --git a/src/graphics/core/Shadows.cpp b/src/graphics/core/Shadows.cpp
index c47b8a6a..b6a95580 100644
--- a/src/graphics/core/Shadows.cpp
+++ b/src/graphics/core/Shadows.cpp
@@ -23,7 +23,7 @@ public:
         glGenTextures(1, &depthMap);
         glBindTexture(GL_TEXTURE_2D, depthMap);
         glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT,
-            resolution, resolution, 0, GL_DEPTH_COMPONENT, GL_FLOAT, NULL);
+            resolution, resolution, 0, GL_DEPTH_COMPONENT, GL_FLOAT, nullptr);
         glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
         glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
         glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_BORDER);
diff --git a/src/graphics/ui/gui_util.hpp b/src/graphics/ui/gui_util.hpp
index 31d7525c..ac4d9eb6 100644
--- a/src/graphics/ui/gui_util.hpp
+++ b/src/graphics/ui/gui_util.hpp
@@ -17,7 +17,7 @@ namespace guiutil {
     /// @brief Create element from XML
     /// @param source XML
     std::shared_ptr<gui::UINode> create(
-        gui::GUI& gui, const std::string& source, scriptenv env = 0
+        gui::GUI& gui, const std::string& source, scriptenv env = nullptr
     );
 
     void alert(
diff --git a/src/logic/scripting/lua/libs/lib__rigidbody.cpp b/src/logic/scripting/lua/libs/lib__rigidbody.cpp
index 726b7193..f32e9d98 100644
--- a/src/logic/scripting/lua/libs/lib__rigidbody.cpp
+++ b/src/logic/scripting/lua/libs/lib__rigidbody.cpp
@@ -169,4 +169,5 @@ const luaL_Reg rigidbodylib[] = {
     {"set_crouching", lua::wrap<l_set_crouching>},
     {"get_body_type", lua::wrap<l_get_body_type>},
     {"set_body_type", lua::wrap<l_set_body_type>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/lib__skeleton.cpp b/src/logic/scripting/lua/libs/lib__skeleton.cpp
index 12f9ac2d..3fd24872 100644
--- a/src/logic/scripting/lua/libs/lib__skeleton.cpp
+++ b/src/logic/scripting/lua/libs/lib__skeleton.cpp
@@ -169,5 +169,5 @@ const luaL_Reg skeletonlib[] = {
     {"is_interpolated", lua::wrap<l_is_interpolated>},
     {"set_interpolated", lua::wrap<l_set_interpolated>},
     {"exists", lua::wrap<l_exists>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/lib__transform.cpp b/src/logic/scripting/lua/libs/lib__transform.cpp
index 99534964..1edbaa5c 100644
--- a/src/logic/scripting/lua/libs/lib__transform.cpp
+++ b/src/logic/scripting/lua/libs/lib__transform.cpp
@@ -51,4 +51,5 @@ const luaL_Reg transformlib[] = {
     {"set_size", lua::wrap<l_set_size>},
     {"get_rot", lua::wrap<l_get_rot>},
     {"set_rot", lua::wrap<l_set_rot>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/libapp.cpp b/src/logic/scripting/lua/libs/libapp.cpp
index bd61bc7a..4bd38f4b 100644
--- a/src/logic/scripting/lua/libs/libapp.cpp
+++ b/src/logic/scripting/lua/libs/libapp.cpp
@@ -2,5 +2,5 @@
 
 const luaL_Reg applib[] = {
     // see libcore.cpp an stdlib.lua
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libassets.cpp b/src/logic/scripting/lua/libs/libassets.cpp
index 047b6330..3f9ab456 100644
--- a/src/logic/scripting/lua/libs/libassets.cpp
+++ b/src/logic/scripting/lua/libs/libassets.cpp
@@ -65,5 +65,5 @@ static int l_parse_model(lua::State* L) {
 const luaL_Reg assetslib[] = {
     {"load_texture", lua::wrap<l_load_texture>},
     {"parse_model", lua::wrap<l_parse_model>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index 41362fe7..db868c57 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -394,4 +394,5 @@ const luaL_Reg audiolib[] = {
     {"get_velocity", lua::wrap<l_audio_get_velocity>},
     {"count_speakers", lua::wrap<l_audio_count_speakers>},
     {"count_streams", lua::wrap<l_audio_count_streams>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/libbase64.cpp b/src/logic/scripting/lua/libs/libbase64.cpp
index faf718de..2ebad9c5 100644
--- a/src/logic/scripting/lua/libs/libbase64.cpp
+++ b/src/logic/scripting/lua/libs/libbase64.cpp
@@ -49,5 +49,5 @@ const luaL_Reg base64lib[] = {
     {"decode", lua::wrap<l_decode<util::base64_decode>>},
     {"encode_urlsafe", lua::wrap<l_encode<util::base64_urlsafe_encode>>},
     {"decode_urlsafe", lua::wrap<l_decode<util::base64_urlsafe_decode>>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libbjson.cpp b/src/logic/scripting/lua/libs/libbjson.cpp
index f9acd077..71498dbc 100644
--- a/src/logic/scripting/lua/libs/libbjson.cpp
+++ b/src/logic/scripting/lua/libs/libbjson.cpp
@@ -35,5 +35,5 @@ static int l_frombytes(lua::State* L) {
 const luaL_Reg bjsonlib[] = {
     {"tobytes", lua::wrap<l_tobytes>},
     {"frombytes", lua::wrap<l_frombytes>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libblock.cpp b/src/logic/scripting/lua/libs/libblock.cpp
index e72bf96f..8ac548e5 100644
--- a/src/logic/scripting/lua/libs/libblock.cpp
+++ b/src/logic/scripting/lua/libs/libblock.cpp
@@ -783,5 +783,5 @@ const luaL_Reg blocklib[] = {
     {"has_tag", lua::wrap<l_has_tag>},
     {"__get_tags", lua::wrap<l_get_tags>},
     {"__pull_register_events", lua::wrap<l_pull_register_events>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libblockwraps.cpp b/src/logic/scripting/lua/libs/libblockwraps.cpp
index fec1c5d7..ceeec744 100644
--- a/src/logic/scripting/lua/libs/libblockwraps.cpp
+++ b/src/logic/scripting/lua/libs/libblockwraps.cpp
@@ -39,5 +39,5 @@ const luaL_Reg blockwrapslib[] = {
     {"unwrap", lua::wrap<l_unwrap>},
     {"set_pos", lua::wrap<l_set_pos>},
     {"set_texture", lua::wrap<l_set_texture>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libbyteutil.cpp b/src/logic/scripting/lua/libs/libbyteutil.cpp
index 54485fc1..448212e7 100644
--- a/src/logic/scripting/lua/libs/libbyteutil.cpp
+++ b/src/logic/scripting/lua/libs/libbyteutil.cpp
@@ -208,5 +208,5 @@ const luaL_Reg byteutillib[] = {
     {"tpack", lua::wrap<l_tpack>},
     {"unpack", lua::wrap<l_unpack>},
     {"get_size", lua::wrap<l_get_size>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libcamera.cpp b/src/logic/scripting/lua/libs/libcamera.cpp
index 9f3e1c8e..6ec6ef96 100644
--- a/src/logic/scripting/lua/libs/libcamera.cpp
+++ b/src/logic/scripting/lua/libs/libcamera.cpp
@@ -125,4 +125,5 @@ const luaL_Reg cameralib[] = {
     {"get_right", lua::wrap<l_camera_getter<getter_right>>},
     {"get_up", lua::wrap<l_camera_getter<getter_up>>},
     {"look_at", lua::wrap<l_look_at>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/libcompression.cpp b/src/logic/scripting/lua/libs/libcompression.cpp
index c212f42e..e4e9f6f4 100644
--- a/src/logic/scripting/lua/libs/libcompression.cpp
+++ b/src/logic/scripting/lua/libs/libcompression.cpp
@@ -79,6 +79,6 @@ static int l_decode(lua::State* L) {
 const luaL_Reg compressionlib[] = {
     {"encode", lua::wrap<l_encode>},
     {"decode", lua::wrap<l_decode>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
 
diff --git a/src/logic/scripting/lua/libs/libconsole.cpp b/src/logic/scripting/lua/libs/libconsole.cpp
index e577e952..28e71b4b 100644
--- a/src/logic/scripting/lua/libs/libconsole.cpp
+++ b/src/logic/scripting/lua/libs/libconsole.cpp
@@ -126,4 +126,5 @@ const luaL_Reg consolelib[] = {
     {"set", lua::wrap<l_set>},
     {"get_commands_list", lua::wrap<l_get_commands_list>},
     {"get_command_info", lua::wrap<l_get_command_info>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/libcore.cpp b/src/logic/scripting/lua/libs/libcore.cpp
index 09a192c7..9f14e2a0 100644
--- a/src/logic/scripting/lua/libs/libcore.cpp
+++ b/src/logic/scripting/lua/libs/libcore.cpp
@@ -310,5 +310,5 @@ const luaL_Reg corelib[] = {
     {"open_url", lua::wrap<l_open_url>},
     {"quit", lua::wrap<l_quit>},
     {"capture_output", lua::wrap<l_capture_output>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libentity.cpp b/src/logic/scripting/lua/libs/libentity.cpp
index 45e4e14e..26d3ea61 100644
--- a/src/logic/scripting/lua/libs/libentity.cpp
+++ b/src/logic/scripting/lua/libs/libentity.cpp
@@ -255,5 +255,5 @@ const luaL_Reg entitylib[] = {
     {"get_all_in_radius", lua::wrap<l_get_all_in_radius>},
     {"raycast", lua::wrap<l_raycast>},
     {"reload_component", lua::wrap<l_reload_component>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libfile.cpp b/src/logic/scripting/lua/libs/libfile.cpp
index dae5e6d2..28ed5a6e 100644
--- a/src/logic/scripting/lua/libs/libfile.cpp
+++ b/src/logic/scripting/lua/libs/libfile.cpp
@@ -404,6 +404,6 @@ const luaL_Reg filelib[] = {
     {"__flush_descriptor", lua::wrap<l_flush_descriptor>},
     {"__close_descriptor", lua::wrap<l_close_descriptor>},
     {"__close_all_descriptors", lua::wrap<l_close_all_descriptors>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
 
diff --git a/src/logic/scripting/lua/libs/libgeneration.cpp b/src/logic/scripting/lua/libs/libgeneration.cpp
index ed406bf7..e215b4fb 100644
--- a/src/logic/scripting/lua/libs/libgeneration.cpp
+++ b/src/logic/scripting/lua/libs/libgeneration.cpp
@@ -104,5 +104,5 @@ const luaL_Reg generationlib[] = {
     {"load_fragment", lua::wrap<l_load_fragment>},
     {"get_generators", lua::wrap<l_get_generators>},
     {"get_default_generator", lua::wrap<l_get_default_generator>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index 2f37bcb2..6395dc5b 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -1053,5 +1053,5 @@ const luaL_Reg guilib[] = {
     {"alert", lua::wrap<l_gui_alert>},
     {"load_document", lua::wrap<l_gui_load_document>},
     {"__reindex", lua::wrap<l_gui_reindex>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libhud.cpp b/src/logic/scripting/lua/libs/libhud.cpp
index 432d8eb6..e3d29783 100644
--- a/src/logic/scripting/lua/libs/libhud.cpp
+++ b/src/logic/scripting/lua/libs/libhud.cpp
@@ -208,5 +208,5 @@ const luaL_Reg hudlib[] = {
     {"_set_debug_cheats", wrap_hud<l_set_debug_cheats>},
     {"set_allow_pause", wrap_hud<l_set_allow_pause>},
     {"reload_script", wrap_hud<l_reload_script>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libinput.cpp b/src/logic/scripting/lua/libs/libinput.cpp
index 3537cd36..6d75fd4b 100644
--- a/src/logic/scripting/lua/libs/libinput.cpp
+++ b/src/logic/scripting/lua/libs/libinput.cpp
@@ -177,5 +177,5 @@ const luaL_Reg inputlib[] = {
     {"is_pressed", lua::wrap<l_is_pressed>},
     {"reset_bindings", lua::wrap<l_reset_bindings>},
     {"set_enabled", lua::wrap<l_set_enabled>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libinventory.cpp b/src/logic/scripting/lua/libs/libinventory.cpp
index 5ed3f8cc..fda9d4f0 100644
--- a/src/logic/scripting/lua/libs/libinventory.cpp
+++ b/src/logic/scripting/lua/libs/libinventory.cpp
@@ -256,5 +256,5 @@ const luaL_Reg inventorylib[] = {
     {"create", lua::wrap<l_create>},
     {"remove", lua::wrap<l_remove>},
     {"clone", lua::wrap<l_clone>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libitem.cpp b/src/logic/scripting/lua/libs/libitem.cpp
index 79c03c2a..3a0f77ec 100644
--- a/src/logic/scripting/lua/libs/libitem.cpp
+++ b/src/logic/scripting/lua/libs/libitem.cpp
@@ -147,5 +147,5 @@ const luaL_Reg itemlib[] = {
     {"reload_script", lua::wrap<l_reload_script>},
     {"has_tag", lua::wrap<l_has_tag>},
     {"__get_tags", lua::wrap<l_get_tags>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libjson.cpp b/src/logic/scripting/lua/libs/libjson.cpp
index ed929d3d..a0caa4c3 100644
--- a/src/logic/scripting/lua/libs/libjson.cpp
+++ b/src/logic/scripting/lua/libs/libjson.cpp
@@ -19,5 +19,5 @@ static int l_json_parse(lua::State* L) {
 const luaL_Reg jsonlib[] = {
     {"tostring", lua::wrap<l_json_stringify>},
     {"parse", lua::wrap<l_json_parse>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libmat4.cpp b/src/logic/scripting/lua/libs/libmat4.cpp
index fb3d9c25..081d99b5 100644
--- a/src/logic/scripting/lua/libs/libmat4.cpp
+++ b/src/logic/scripting/lua/libs/libmat4.cpp
@@ -282,4 +282,5 @@ const luaL_Reg mat4lib[] = {
     {"look_at", lua::wrap<l_look_at>},
     {"from_quat", lua::wrap<l_from_quat>},
     {"tostring", lua::wrap<l_tostring>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/libnetwork.cpp b/src/logic/scripting/lua/libs/libnetwork.cpp
index 4201348a..78abda63 100644
--- a/src/logic/scripting/lua/libs/libnetwork.cpp
+++ b/src/logic/scripting/lua/libs/libnetwork.cpp
@@ -541,5 +541,5 @@ const luaL_Reg networklib[] = {
     {"__get_serverport", wrap<l_get_serverport>},
     {"__set_nodelay", wrap<l_set_nodelay>},
     {"__is_nodelay", wrap<l_is_nodelay>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libpack.cpp b/src/logic/scripting/lua/libs/libpack.cpp
index 77eed4f0..f23e96b3 100644
--- a/src/logic/scripting/lua/libs/libpack.cpp
+++ b/src/logic/scripting/lua/libs/libpack.cpp
@@ -268,5 +268,5 @@ const luaL_Reg packlib[] = {
     {"get_base_packs", lua::wrap<l_pack_get_base_packs>},
     {"assemble", lua::wrap<l_pack_assemble>},
     {"request_writeable", lua::wrap<l_pack_request_writeable>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libparticles.cpp b/src/logic/scripting/lua/libs/libparticles.cpp
index 53506ba9..563f2f2e 100644
--- a/src/logic/scripting/lua/libs/libparticles.cpp
+++ b/src/logic/scripting/lua/libs/libparticles.cpp
@@ -82,5 +82,5 @@ const luaL_Reg particleslib[] = {
     {"is_alive", wrap_hud<l_is_alive>},
     {"get_origin", wrap_hud<l_get_origin>},
     {"set_origin", wrap_hud<l_set_origin>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libpathfinding.cpp b/src/logic/scripting/lua/libs/libpathfinding.cpp
index e5a94abe..ae880912 100644
--- a/src/logic/scripting/lua/libs/libpathfinding.cpp
+++ b/src/logic/scripting/lua/libs/libpathfinding.cpp
@@ -126,5 +126,5 @@ const luaL_Reg pathfindinglib[] = {
     {"set_max_visited", lua::wrap<l_set_max_visited_blocks>},
     {"set_jump_height", lua::wrap<l_set_jump_height>},
     {"avoid_tag", lua::wrap<l_avoid_tag>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index 12c13b3c..320db362 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -358,5 +358,5 @@ const luaL_Reg playerlib[] = {
     {"set_name", lua::wrap<l_set_name>},
     {"create", lua::wrap<l_create>},
     {"delete", lua::wrap<l_delete>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libposteffects.cpp b/src/logic/scripting/lua/libs/libposteffects.cpp
index f4e1e252..d16e0c85 100644
--- a/src/logic/scripting/lua/libs/libposteffects.cpp
+++ b/src/logic/scripting/lua/libs/libposteffects.cpp
@@ -84,5 +84,5 @@ const luaL_Reg posteffectslib[] = {
     {"is_active", lua::wrap<l_is_active>},
     {"set_params", lua::wrap<l_set_params>},
     {"set_array", lua::wrap<l_set_array>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libquat.cpp b/src/logic/scripting/lua/libs/libquat.cpp
index 49aebce2..2316360a 100644
--- a/src/logic/scripting/lua/libs/libquat.cpp
+++ b/src/logic/scripting/lua/libs/libquat.cpp
@@ -48,4 +48,5 @@ const luaL_Reg quatlib[] = {
     {"from_mat4", lua::wrap<l_from_mat4>},
     {"slerp", lua::wrap<l_slerp>},
     {"tostring", lua::wrap<l_tostring>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/librandom.cpp b/src/logic/scripting/lua/libs/librandom.cpp
index 192f83d1..b384916e 100644
--- a/src/logic/scripting/lua/libs/librandom.cpp
+++ b/src/logic/scripting/lua/libs/librandom.cpp
@@ -42,5 +42,5 @@ const luaL_Reg randomlib[] = {
     {"random", lua::wrap<l_random>},
     {"bytes", lua::wrap<l_bytes>},
     {"uuid", lua::wrap<l_uuid>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libtext3d.cpp b/src/logic/scripting/lua/libs/libtext3d.cpp
index 4529fc0c..310f5d78 100644
--- a/src/logic/scripting/lua/libs/libtext3d.cpp
+++ b/src/logic/scripting/lua/libs/libtext3d.cpp
@@ -108,5 +108,5 @@ const luaL_Reg text3dlib[] = {
     {"set_axis_y", wrap_hud<l_set_axis_y>},
     {"set_rotation", wrap_hud<l_set_rotation>},
     {"update_settings", wrap_hud<l_update_settings>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libtime.cpp b/src/logic/scripting/lua/libs/libtime.cpp
index dc878455..f953955b 100644
--- a/src/logic/scripting/lua/libs/libtime.cpp
+++ b/src/logic/scripting/lua/libs/libtime.cpp
@@ -68,5 +68,5 @@ const luaL_Reg timelib[] = {
     {"utc_time", lua::wrap<l_utc_time>},
     {"utc_offset", lua::wrap<l_utc_offset>},
     {"local_time", lua::wrap<l_local_time>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libtoml.cpp b/src/logic/scripting/lua/libs/libtoml.cpp
index bf5461c0..4626ee3b 100644
--- a/src/logic/scripting/lua/libs/libtoml.cpp
+++ b/src/logic/scripting/lua/libs/libtoml.cpp
@@ -23,5 +23,5 @@ static int l_toml_parse(lua::State* L) {
 const luaL_Reg tomllib[] = {
     {"tostring", lua::wrap<l_toml_stringify>},
     {"parse", lua::wrap<l_toml_parse>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libutf8.cpp b/src/logic/scripting/lua/libs/libutf8.cpp
index d9164784..ec746caa 100644
--- a/src/logic/scripting/lua/libs/libutf8.cpp
+++ b/src/logic/scripting/lua/libs/libutf8.cpp
@@ -99,5 +99,5 @@ const luaL_Reg utf8lib[] = {
     {"lower", lua::wrap<l_lower>},
     {"encode", lua::wrap<l_encode>},
     {"escape", lua::wrap<l_escape>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libvecn.cpp b/src/logic/scripting/lua/libs/libvecn.cpp
index ee2a3136..e0a5ac3d 100644
--- a/src/logic/scripting/lua/libs/libvecn.cpp
+++ b/src/logic/scripting/lua/libs/libvecn.cpp
@@ -228,7 +228,8 @@ const luaL_Reg vec2lib[] = {
     {"angle", lua::wrap<l_vec2_angle>},
     {"mix", lua::wrap<l_mix<2>>},
     {"rotate", lua::wrap<l_vec2_rotate>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
 
 const luaL_Reg vec3lib[] = {
     {"add", lua::wrap<l_binop<3, std::plus>>},
@@ -246,7 +247,8 @@ const luaL_Reg vec3lib[] = {
     {"dot", lua::wrap<l_dot<3>>},
     {"spherical_rand", lua::wrap<l_spherical_rand>},
     {"mix", lua::wrap<l_mix<3>>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
 
 const luaL_Reg vec4lib[] = {
     {"add", lua::wrap<l_binop<4, std::plus>>},
@@ -263,4 +265,5 @@ const luaL_Reg vec4lib[] = {
     {"pow", lua::wrap<l_pow<4>>},
     {"dot", lua::wrap<l_dot<4>>},
     {"mix", lua::wrap<l_mix<4>>},
-    {NULL, NULL}};
+    {nullptr, nullptr}
+};
diff --git a/src/logic/scripting/lua/libs/libweather.cpp b/src/logic/scripting/lua/libs/libweather.cpp
index 0028ae5e..76a94a68 100644
--- a/src/logic/scripting/lua/libs/libweather.cpp
+++ b/src/logic/scripting/lua/libs/libweather.cpp
@@ -64,5 +64,5 @@ const luaL_Reg weatherlib[] = {
     {"get_current_data", lua::wrap<l_get_current_data>},
     {"get_fall_intensity", lua::wrap<l_get_fall_intensity>},
     {"is_transition", lua::wrap<l_is_transition>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libworld.cpp b/src/logic/scripting/lua/libs/libworld.cpp
index 3e107f0e..41778204 100644
--- a/src/logic/scripting/lua/libs/libworld.cpp
+++ b/src/logic/scripting/lua/libs/libworld.cpp
@@ -251,5 +251,5 @@ const luaL_Reg worldlib[] = {
     {"save_chunk_data", lua::wrap<l_save_chunk_data>},
     {"count_chunks", lua::wrap<l_count_chunks>},
     {"reload_script", lua::wrap<l_reload_script>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/libs/libyaml.cpp b/src/logic/scripting/lua/libs/libyaml.cpp
index 3b625ddb..42c9906c 100644
--- a/src/logic/scripting/lua/libs/libyaml.cpp
+++ b/src/logic/scripting/lua/libs/libyaml.cpp
@@ -16,5 +16,5 @@ static int l_parse(lua::State* L) {
 const luaL_Reg yamllib[] = {
     {"tostring", lua::wrap<l_stringify>},
     {"parse", lua::wrap<l_parse>},
-    {NULL, NULL}
+    {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/lua_overrides.cpp b/src/logic/scripting/lua/lua_overrides.cpp
index 3af2fa65..4233247b 100644
--- a/src/logic/scripting/lua/lua_overrides.cpp
+++ b/src/logic/scripting/lua/lua_overrides.cpp
@@ -14,7 +14,7 @@ int l_print(lua::State* L) {
         lua::pushvalue(L, i);  /* value to print */
         lua::call(L, 1, 1);
         const char* s = lua::tostring(L, -1); /* get result */
-        if (s == NULL)
+        if (s == nullptr)
             return luaL_error(
                 L,
                 LUA_QL("tostring") " must return a string to " LUA_QL("print")
diff --git a/src/maths/util.hpp b/src/maths/util.hpp
index 00345942..22ac9882 100644
--- a/src/maths/util.hpp
+++ b/src/maths/util.hpp
@@ -23,7 +23,7 @@ namespace util {
         PseudoRandom(unsigned short seed) : seed(seed) {}
 
         PseudoRandom() {
-            seed = static_cast<unsigned short>(time(0));
+            seed = static_cast<unsigned short>(time(nullptr));
         }
 
         int rand() {
diff --git a/src/network/Curl.cpp b/src/network/Curl.cpp
index bd40a478..1caafde7 100644
--- a/src/network/Curl.cpp
+++ b/src/network/Curl.cpp
@@ -115,7 +115,7 @@ public:
         curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
         curl_easy_setopt(curl, CURLOPT_POST, request.type == RequestType::POST);
         
-        curl_slist* hs = NULL;
+        curl_slist* hs = nullptr;
         
         for (const auto& header : request.headers) {
             hs = curl_slist_append(hs, header.c_str());
@@ -172,7 +172,7 @@ public:
             url = "";
             return;
         }
-        if ((msg = curl_multi_info_read(multiHandle, &messagesLeft)) != NULL) {
+        if ((msg = curl_multi_info_read(multiHandle, &messagesLeft)) != nullptr) {
             if(msg->msg == CURLMSG_DONE) {
                 curl_multi_remove_handle(multiHandle, curl);
             }
diff --git a/src/util/platform.cpp b/src/util/platform.cpp
index 55ac1630..81ddaa8b 100644
--- a/src/util/platform.cpp
+++ b/src/util/platform.cpp
@@ -126,7 +126,7 @@ bool platform::open_url(const std::string& url) {
         return false;
     }
 #elif defined(_WIN32)
-    auto res = ShellExecuteW(NULL, L"open", util::quote(url).c_str(), NULL, NULL, SW_SHOWDEFAULT);
+    auto res = ShellExecuteW(nullptr, L"open", util::quote(url).c_str(), nullptr, nullptr, SW_SHOWDEFAULT);
     if (res <= 32) {
         logger.warning() << "'open' returned code " << res;
     } else {
@@ -155,7 +155,7 @@ void platform::open_folder(const std::filesystem::path& folder) {
         logger.warning() << "'" << cmd << "' returned code " << res;
     }
 #elif defined(_WIN32)
-    ShellExecuteW(NULL, L"open", folder.wstring().c_str(), NULL, NULL, SW_SHOWDEFAULT);
+    ShellExecuteW(nullptr, L"open", folder.wstring().c_str(), nullptr, nullptr, SW_SHOWDEFAULT);
 #else
     auto cmd = "xdg-open " + util::quote(folder.u8string());
     if (int res = system(cmd.c_str())) {
@@ -168,7 +168,7 @@ void platform::open_folder(const std::filesystem::path& folder) {
 std::filesystem::path platform::get_executable_path() {
 #ifdef _WIN32
     wchar_t buffer[MAX_PATH];
-    DWORD result = GetModuleFileNameW(NULL, buffer, MAX_PATH);
+    DWORD result = GetModuleFileNameW(nullptr, buffer, MAX_PATH);
     if (result == 0) {
         DWORD error = GetLastError();
         throw std::runtime_error("GetModuleFileName failed with code: " + std::to_string(error));
diff --git a/src/window/detail/GLFWWindow.cpp b/src/window/detail/GLFWWindow.cpp
index 7685be7c..27f56d3c 100644
--- a/src/window/detail/GLFWWindow.cpp
+++ b/src/window/detail/GLFWWindow.cpp
@@ -99,7 +99,7 @@ static bool initialize_gl(int width, int height) {
 
 #ifndef __APPLE__
     glEnable(GL_DEBUG_OUTPUT);
-    glDebugMessageCallback(gl_message_callback, 0);
+    glDebugMessageCallback(gl_message_callback, nullptr);
 #endif
 
     glViewport(0, 0, width, height);
@@ -402,7 +402,7 @@ public:
             return;
         }
         cursor = shape;
-        // NULL cursor is valid for GLFW
+        // nullptr cursor is valid for GLFW
         glfwSetCursor(window, standard_cursors[static_cast<int>(shape)]);
     }
 

From 48b8c3e9b42331c8fbd1fd6173ae67870490b9e1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 10 Oct 2025 23:22:47 +0300
Subject: [PATCH 055/133] fix

---
 src/CMakeLists.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 4e1cf260..000f2c3c 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -112,7 +112,7 @@ target_compile_options(
            -Wno-sign-compare
            -Wno-unknown-pragmas
            >
-           $<$<CXX_COMPILER_ID:MSVC>:
+           $<$<CXX_COMPILER_ID:Clang>:
            -Wduplicated-branches
            -Wduplicated-cond
            >)

From 81d21d6e8b5c4f3437bf78f318088d75e81f3b19 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 11 Oct 2025 00:11:25 +0300
Subject: [PATCH 056/133] refactor lua usertypes

---
 src/logic/scripting/lua/libs/libbjson.cpp     |   1 -
 .../scripting/lua/libs/libgeneration.cpp      |   2 +-
 src/logic/scripting/lua/libs/libgui.cpp       |   1 +
 src/logic/scripting/lua/libs/libutf8.cpp      |   1 -
 src/logic/scripting/lua/lua_commons.hpp       |   5 +
 src/logic/scripting/lua/lua_custom_types.hpp  | 134 ------------------
 src/logic/scripting/lua/lua_engine.cpp        |   5 +-
 src/logic/scripting/lua/lua_util.hpp          |   1 -
 .../lua/usertypes/lua_type_canvas.cpp         |   5 +-
 .../lua/usertypes/lua_type_canvas.hpp         |  46 ++++++
 .../lua/usertypes/lua_type_heightmap.cpp      |  13 +-
 .../lua/usertypes/lua_type_heightmap.hpp      |  44 ++++++
 .../lua/usertypes/lua_type_random.cpp         |   2 +-
 .../lua/usertypes/lua_type_random.hpp         |  23 +++
 .../lua/usertypes/lua_type_voxelfragment.cpp  |   3 +-
 .../lua/usertypes/lua_type_voxelfragment.hpp  |  29 ++++
 src/logic/scripting/scripting.cpp             |   1 -
 .../scripting/scripting_world_generation.cpp  |   2 +-
 18 files changed, 166 insertions(+), 152 deletions(-)
 delete mode 100644 src/logic/scripting/lua/lua_custom_types.hpp
 create mode 100644 src/logic/scripting/lua/usertypes/lua_type_canvas.hpp
 create mode 100644 src/logic/scripting/lua/usertypes/lua_type_heightmap.hpp
 create mode 100644 src/logic/scripting/lua/usertypes/lua_type_random.hpp
 create mode 100644 src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp

diff --git a/src/logic/scripting/lua/libs/libbjson.cpp b/src/logic/scripting/lua/libs/libbjson.cpp
index 71498dbc..8c28f04e 100644
--- a/src/logic/scripting/lua/libs/libbjson.cpp
+++ b/src/logic/scripting/lua/libs/libbjson.cpp
@@ -1,7 +1,6 @@
 #include "coders/binary_json.hpp"
 #include "api_lua.hpp"
 #include "util/Buffer.hpp"
-#include "../lua_custom_types.hpp"
 
 static int l_tobytes(lua::State* L) {
     auto value = lua::tovalue(L, 1);
diff --git a/src/logic/scripting/lua/libs/libgeneration.cpp b/src/logic/scripting/lua/libs/libgeneration.cpp
index e215b4fb..15bdad5c 100644
--- a/src/logic/scripting/lua/libs/libgeneration.cpp
+++ b/src/logic/scripting/lua/libs/libgeneration.cpp
@@ -9,7 +9,7 @@
 #include "content/Content.hpp"
 #include "content/ContentControl.hpp"
 #include "engine/Engine.hpp"
-#include "../lua_custom_types.hpp"
+#include "../usertypes/lua_type_voxelfragment.hpp"
 
 using namespace scripting;
 
diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index 6395dc5b..fc3732a1 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -22,6 +22,7 @@
 #include "items/Inventories.hpp"
 #include "util/stringutil.hpp"
 #include "world/Level.hpp"
+#include "../usertypes/lua_type_canvas.hpp"
 
 using namespace gui;
 using namespace scripting;
diff --git a/src/logic/scripting/lua/libs/libutf8.cpp b/src/logic/scripting/lua/libs/libutf8.cpp
index ec746caa..e6538c2e 100644
--- a/src/logic/scripting/lua/libs/libutf8.cpp
+++ b/src/logic/scripting/lua/libs/libutf8.cpp
@@ -3,7 +3,6 @@
 #include <vector>
 #include <cwctype>
 
-#include "../lua_custom_types.hpp"
 #include "util/stringutil.hpp"
 
 static int l_tobytes(lua::State* L) {
diff --git a/src/logic/scripting/lua/lua_commons.hpp b/src/logic/scripting/lua/lua_commons.hpp
index f272dbf0..bb3163c8 100644
--- a/src/logic/scripting/lua/lua_commons.hpp
+++ b/src/logic/scripting/lua/lua_commons.hpp
@@ -48,4 +48,9 @@ namespace lua {
 
     void log_error(const std::string& text);
 
+    class Userdata {
+    public:
+        virtual ~Userdata() {};
+        virtual const std::string& getTypeName() const = 0;
+    };
 }
diff --git a/src/logic/scripting/lua/lua_custom_types.hpp b/src/logic/scripting/lua/lua_custom_types.hpp
deleted file mode 100644
index c17a78bc..00000000
--- a/src/logic/scripting/lua/lua_custom_types.hpp
+++ /dev/null
@@ -1,134 +0,0 @@
-#pragma once
-
-#include <string>
-#include <vector>
-#include <array>
-#include <random>
-
-#include "lua_commons.hpp"
-
-struct fnl_state;
-class Heightmap;
-class VoxelFragment;
-class Texture;
-class ImageData;
-
-namespace lua {
-    class Userdata {
-    public:
-        virtual ~Userdata() {};
-        virtual const std::string& getTypeName() const = 0;
-    };
-
-    class LuaHeightmap : public Userdata {
-        std::shared_ptr<Heightmap> map;
-        std::unique_ptr<fnl_state> noise;
-    public:
-        LuaHeightmap(const std::shared_ptr<Heightmap>& map);
-        LuaHeightmap(uint width, uint height);
-
-        virtual ~LuaHeightmap();
-
-        uint getWidth() const;
-
-        uint getHeight() const;
-
-        float* getValues();
-
-        const float* getValues() const;
-
-        const std::string& getTypeName() const override {
-            return TYPENAME;
-        }
-
-        const std::shared_ptr<Heightmap>& getHeightmap() const {
-            return map;
-        }
-
-        fnl_state* getNoise() {
-            return noise.get();
-        }
-
-        void setSeed(int64_t seed);
-
-        static int createMetatable(lua::State*);
-        inline static std::string TYPENAME = "Heightmap";
-    };
-    static_assert(!std::is_abstract<LuaHeightmap>());
-
-    class LuaVoxelFragment : public Userdata {
-        std::array<std::shared_ptr<VoxelFragment>, 4> fragmentVariants;
-    public:
-        LuaVoxelFragment(
-            std::array<std::shared_ptr<VoxelFragment>, 4> fragmentVariants
-        );
-
-        virtual ~LuaVoxelFragment();
-
-        std::shared_ptr<VoxelFragment> getFragment(size_t rotation) const {
-            return fragmentVariants.at(rotation & 0b11);
-        }
-
-        const std::string& getTypeName() const override {
-            return TYPENAME;
-        }
-
-        static int createMetatable(lua::State*);
-        inline static std::string TYPENAME = "VoxelFragment";
-    };
-    static_assert(!std::is_abstract<LuaVoxelFragment>());
-
-    class LuaCanvas : public Userdata {
-    public:
-        explicit LuaCanvas(
-            std::shared_ptr<Texture> inTexture,
-            std::shared_ptr<ImageData> inData
-        );
-        ~LuaCanvas() override = default;
-
-        const std::string& getTypeName() const override {
-            return TYPENAME;
-        }
-
-        [[nodiscard]] auto& texture() const {
-            return *mTexture;
-        }
-
-        [[nodiscard]] auto& data() const {
-            return *mData;
-        }
-
-        [[nodiscard]] bool hasTexture() const {
-            return mTexture != nullptr;
-        }
-
-        auto shareTexture() const {
-            return mTexture;
-        }
-
-        void createTexture();
-
-        static int createMetatable(lua::State*);
-        inline static std::string TYPENAME = "Canvas";
-    private:
-        std::shared_ptr<Texture> mTexture; // nullable
-        std::shared_ptr<ImageData> mData;
-    };
-    static_assert(!std::is_abstract<LuaCanvas>());
-
-    class LuaRandom : public Userdata {
-    public:
-        std::mt19937 rng;
-        
-        explicit LuaRandom(uint64_t seed) : rng(seed) {}
-        virtual ~LuaRandom() override = default;
-
-        const std::string& getTypeName() const override {
-            return TYPENAME;
-        }
-
-        static int createMetatable(lua::State*);
-        inline static std::string TYPENAME = "__vc_Random";
-    };
-    static_assert(!std::is_abstract<LuaRandom>());
-}
diff --git a/src/logic/scripting/lua/lua_engine.cpp b/src/logic/scripting/lua/lua_engine.cpp
index 08d2eb85..05adb354 100644
--- a/src/logic/scripting/lua/lua_engine.cpp
+++ b/src/logic/scripting/lua/lua_engine.cpp
@@ -8,7 +8,10 @@
 #include "debug/Logger.hpp"
 #include "util/stringutil.hpp"
 #include "libs/api_lua.hpp"
-#include "lua_custom_types.hpp"
+#include "usertypes/lua_type_heightmap.hpp"
+#include "usertypes/lua_type_voxelfragment.hpp"
+#include "usertypes/lua_type_canvas.hpp"
+#include "usertypes/lua_type_random.hpp"
 #include "engine/Engine.hpp"
 
 static debug::Logger logger("lua-state");
diff --git a/src/logic/scripting/lua/lua_util.hpp b/src/logic/scripting/lua/lua_util.hpp
index a8fb246e..29f25f34 100644
--- a/src/logic/scripting/lua/lua_util.hpp
+++ b/src/logic/scripting/lua/lua_util.hpp
@@ -6,7 +6,6 @@
 #include <unordered_map>
 
 #include "data/dv.hpp"
-#include "lua_custom_types.hpp"
 #include "lua_wrapper.hpp"
 #define GLM_ENABLE_EXPERIMENTAL
 #include <glm/gtx/quaternion.hpp>
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index ec086904..3343fe71 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -1,12 +1,13 @@
-#include <unordered_map>
+#include "lua_type_canvas.hpp"
 
 #include "graphics/core/ImageData.hpp"
 #include "graphics/core/Texture.hpp"
-#include "logic/scripting/lua/lua_custom_types.hpp"
 #include "logic/scripting/lua/lua_util.hpp"
 #include "engine/Engine.hpp"
 #include "assets/Assets.hpp"
 
+#include <unordered_map>
+
 using namespace lua;
 
 LuaCanvas::LuaCanvas(
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp
new file mode 100644
index 00000000..43fbbd10
--- /dev/null
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp
@@ -0,0 +1,46 @@
+#pragma once
+
+#include "../lua_commons.hpp"
+
+class Texture;
+class ImageData;
+
+namespace lua {
+    class LuaCanvas : public Userdata {
+    public:
+        explicit LuaCanvas(
+            std::shared_ptr<Texture> inTexture,
+            std::shared_ptr<ImageData> inData
+        );
+        ~LuaCanvas() override = default;
+
+        const std::string& getTypeName() const override {
+            return TYPENAME;
+        }
+
+        [[nodiscard]] auto& texture() const {
+            return *mTexture;
+        }
+
+        [[nodiscard]] auto& data() const {
+            return *mData;
+        }
+
+        [[nodiscard]] bool hasTexture() const {
+            return mTexture != nullptr;
+        }
+
+        auto shareTexture() const {
+            return mTexture;
+        }
+
+        void createTexture();
+
+        static int createMetatable(lua::State*);
+        inline static std::string TYPENAME = "Canvas";
+    private:
+        std::shared_ptr<Texture> mTexture; // nullable
+        std::shared_ptr<ImageData> mData;
+    };
+    static_assert(!std::is_abstract<LuaCanvas>());
+}
diff --git a/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp b/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp
index 290e1345..4e2f05a9 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp
@@ -1,9 +1,4 @@
-#include "../lua_custom_types.hpp"
-
-#include <cstring>
-#include <sstream>
-#include <iomanip>
-#include <filesystem>
+#include "lua_type_heightmap.hpp"
 
 #include "util/functional_util.hpp"
 #define FNL_IMPL
@@ -14,6 +9,12 @@
 #include "maths/Heightmap.hpp"
 #include "engine/Engine.hpp"
 #include "../lua_util.hpp"
+#include "lua_type_heightmap.hpp"
+
+#include <cstring>
+#include <sstream>
+#include <iomanip>
+#include <filesystem>
 
 using namespace lua;
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_heightmap.hpp b/src/logic/scripting/lua/usertypes/lua_type_heightmap.hpp
new file mode 100644
index 00000000..4109be67
--- /dev/null
+++ b/src/logic/scripting/lua/usertypes/lua_type_heightmap.hpp
@@ -0,0 +1,44 @@
+#pragma once
+
+#include "../lua_commons.hpp"
+
+struct fnl_state;
+class Heightmap;
+
+namespace lua {
+    class LuaHeightmap : public Userdata {
+        std::shared_ptr<Heightmap> map;
+        std::unique_ptr<fnl_state> noise;
+    public:
+        LuaHeightmap(const std::shared_ptr<Heightmap>& map);
+        LuaHeightmap(uint width, uint height);
+
+        virtual ~LuaHeightmap();
+
+        uint getWidth() const;
+
+        uint getHeight() const;
+
+        float* getValues();
+
+        const float* getValues() const;
+
+        const std::string& getTypeName() const override {
+            return TYPENAME;
+        }
+
+        const std::shared_ptr<Heightmap>& getHeightmap() const {
+            return map;
+        }
+
+        fnl_state* getNoise() {
+            return noise.get();
+        }
+
+        void setSeed(int64_t seed);
+
+        static int createMetatable(lua::State*);
+        inline static std::string TYPENAME = "Heightmap";
+    };
+    static_assert(!std::is_abstract<LuaHeightmap>());
+}
diff --git a/src/logic/scripting/lua/usertypes/lua_type_random.cpp b/src/logic/scripting/lua/usertypes/lua_type_random.cpp
index 99177056..bdbe4a1a 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_random.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_random.cpp
@@ -1,5 +1,5 @@
-#include "../lua_custom_types.hpp"
 #include "../lua_util.hpp"
+#include "lua_type_random.hpp"
 
 #include <chrono>
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_random.hpp b/src/logic/scripting/lua/usertypes/lua_type_random.hpp
new file mode 100644
index 00000000..06ab24f8
--- /dev/null
+++ b/src/logic/scripting/lua/usertypes/lua_type_random.hpp
@@ -0,0 +1,23 @@
+#pragma once
+
+#include "../lua_commons.hpp"
+
+#include <random>
+
+namespace lua {
+    class LuaRandom : public Userdata {
+    public:
+        std::mt19937 rng;
+        
+        explicit LuaRandom(uint64_t seed) : rng(seed) {}
+        virtual ~LuaRandom() override = default;
+
+        const std::string& getTypeName() const override {
+            return TYPENAME;
+        }
+
+        static int createMetatable(lua::State*);
+        inline static std::string TYPENAME = "__vc_Random";
+    };
+    static_assert(!std::is_abstract<LuaRandom>());
+}
diff --git a/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.cpp b/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.cpp
index 271a2a5a..17cf37d1 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.cpp
@@ -1,7 +1,6 @@
-#include "../lua_custom_types.hpp"
+#include "lua_type_voxelfragment.hpp"
 
 #include "../lua_util.hpp"
-
 #include "world/generator/VoxelFragment.hpp"
 #include "util/stringutil.hpp"
 #include "world/Level.hpp"
diff --git a/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp b/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp
new file mode 100644
index 00000000..789076cc
--- /dev/null
+++ b/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp
@@ -0,0 +1,29 @@
+#pragma once
+
+#include "../lua_commons.hpp"
+
+class VoxelFragment;
+
+namespace lua {
+    class LuaVoxelFragment : public Userdata {
+        std::array<std::shared_ptr<VoxelFragment>, 4> fragmentVariants;
+    public:
+        LuaVoxelFragment(
+            std::array<std::shared_ptr<VoxelFragment>, 4> fragmentVariants
+        );
+
+        virtual ~LuaVoxelFragment();
+
+        std::shared_ptr<VoxelFragment> getFragment(size_t rotation) const {
+            return fragmentVariants.at(rotation & 0b11);
+        }
+
+        const std::string& getTypeName() const override {
+            return TYPENAME;
+        }
+
+        static int createMetatable(lua::State*);
+        inline static std::string TYPENAME = "VoxelFragment";
+    };
+    static_assert(!std::is_abstract<LuaVoxelFragment>());
+}
diff --git a/src/logic/scripting/scripting.cpp b/src/logic/scripting/scripting.cpp
index 997b5f82..a4eccbe3 100644
--- a/src/logic/scripting/scripting.cpp
+++ b/src/logic/scripting/scripting.cpp
@@ -17,7 +17,6 @@
 #include "logic/BlocksController.hpp"
 #include "logic/LevelController.hpp"
 #include "lua/lua_engine.hpp"
-#include "lua/lua_custom_types.hpp"
 #include "maths/Heightmap.hpp"
 #include "objects/Player.hpp"
 #include "util/stringutil.hpp"
diff --git a/src/logic/scripting/scripting_world_generation.cpp b/src/logic/scripting/scripting_world_generation.cpp
index bf6c1dd1..3199b46c 100644
--- a/src/logic/scripting/scripting_world_generation.cpp
+++ b/src/logic/scripting/scripting_world_generation.cpp
@@ -6,7 +6,7 @@
 #include "scripting_commons.hpp"
 #include "typedefs.hpp"
 #include "lua/lua_engine.hpp"
-#include "lua/lua_custom_types.hpp"
+#include "lua/usertypes/lua_type_heightmap.hpp"
 #include "content/Content.hpp"
 #include "voxels/Block.hpp"
 #include "voxels/Chunk.hpp"

From 53b89cdb8e59162ad914d3cab30e5f771de0aaf2 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 11 Oct 2025 00:34:16 +0300
Subject: [PATCH 057/133] fix windows build

---
 src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp b/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp
index 789076cc..21c41c04 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_voxelfragment.hpp
@@ -1,5 +1,7 @@
 #pragma once
 
+#include <array>
+
 #include "../lua_commons.hpp"
 
 class VoxelFragment;

From 4b19c29a29621853a858137e51ea2814e784bf83 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 13 Oct 2025 23:34:56 +0300
Subject: [PATCH 058/133] add util::span

---
 src/util/span.hpp | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 src/util/span.hpp

diff --git a/src/util/span.hpp b/src/util/span.hpp
new file mode 100644
index 00000000..a9ab79b2
--- /dev/null
+++ b/src/util/span.hpp
@@ -0,0 +1,42 @@
+#pragma once
+
+#include <stdexcept>
+
+namespace util {
+    template <typename T>
+    class span {
+    public:
+        constexpr span(const T* ptr, size_t length)
+         : ptr(ptr), length(length) {}
+
+        const T& operator[](size_t index) const {
+            return ptr[index];
+        }
+
+        const T& at(size_t index) const {
+            if (index >= length) {
+                throw std::out_of_range();
+            }
+            return ptr[index];
+        }
+
+        auto begin() const {
+            return ptr;
+        }
+
+        auto end() const {
+            return ptr + length;
+        }
+
+        const T* data() const {
+            return ptr;
+        }
+
+        size_t size() const {
+            return length;
+        }
+    private:
+        const T* ptr;
+        size_t length;
+    };
+}

From 31137f83b6d563d857b8e640d7dd31ed02dbea03 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 14 Oct 2025 00:50:23 +0300
Subject: [PATCH 059/133] add MemoryPCMStream

---
 src/audio/MemoryPCMStream.cpp | 63 +++++++++++++++++++++++++++++++++++
 src/audio/MemoryPCMStream.hpp | 42 +++++++++++++++++++++++
 2 files changed, 105 insertions(+)
 create mode 100644 src/audio/MemoryPCMStream.cpp
 create mode 100644 src/audio/MemoryPCMStream.hpp

diff --git a/src/audio/MemoryPCMStream.cpp b/src/audio/MemoryPCMStream.cpp
new file mode 100644
index 00000000..7fcf4b0c
--- /dev/null
+++ b/src/audio/MemoryPCMStream.cpp
@@ -0,0 +1,63 @@
+#include "MemoryPCMStream.hpp"
+
+#include <cstring>
+
+using namespace audio;
+
+MemoryPCMStream::MemoryPCMStream(
+    uint sampleRate, uint channels, uint bitsPerSample
+)
+    : sampleRate(sampleRate), channels(channels), bitsPerSample(bitsPerSample) {
+}
+
+void MemoryPCMStream::feed(util::span<ubyte> bytes) {
+    buffer.insert(buffer.end(), bytes.begin(), bytes.end());
+}
+
+bool MemoryPCMStream::isOpen() const {
+    return open;
+}
+
+void MemoryPCMStream::close() {
+    open = false;
+    buffer = {};
+}
+
+size_t MemoryPCMStream::read(char* dst, size_t bufferSize) {
+    if (!open) {
+        return PCMStream::ERROR;
+    }
+    if (buffer.empty()) {
+        return 0;
+    }
+    size_t count = std::min<size_t>(bufferSize, buffer.size());
+    std::memcpy(dst, buffer.data(), count);
+    buffer.erase(buffer.begin(), buffer.begin() + count);
+    return count;
+}
+
+size_t MemoryPCMStream::getTotalSamples() const {
+    return 0;
+}
+
+duration_t MemoryPCMStream::getTotalDuration() const {
+    return 0.0;
+}
+
+uint MemoryPCMStream::getChannels() const {
+    return channels;
+}
+
+uint MemoryPCMStream::getSampleRate() const {
+    return sampleRate;
+}
+
+uint MemoryPCMStream::getBitsPerSample() const {
+    return bitsPerSample;
+}
+
+bool MemoryPCMStream::isSeekable() const {
+    return false;
+}
+
+void MemoryPCMStream::seek(size_t position) {}
diff --git a/src/audio/MemoryPCMStream.hpp b/src/audio/MemoryPCMStream.hpp
new file mode 100644
index 00000000..1f94d27e
--- /dev/null
+++ b/src/audio/MemoryPCMStream.hpp
@@ -0,0 +1,42 @@
+#pragma once
+
+#include <vector>
+
+#include "audio.hpp"
+#include "util/span.hpp"
+
+namespace audio {
+    class MemoryPCMStream : public PCMStream {
+    public:
+        MemoryPCMStream(uint sampleRate, uint channels, uint bitsPerSample);
+
+        void feed(util::span<ubyte> bytes);
+
+        bool isOpen() const override;
+
+        void close() override;
+
+        size_t read(char* buffer, size_t bufferSize) override;
+
+        size_t getTotalSamples() const override;
+
+        duration_t getTotalDuration() const override;
+
+        uint getChannels() const override;
+
+        uint getSampleRate() const override;
+
+        uint getBitsPerSample() const override;
+
+        bool isSeekable() const override;
+
+        void seek(size_t position) override;
+    private:
+        uint sampleRate;
+        uint channels;
+        uint bitsPerSample;
+        bool open = true;
+
+        std::vector<ubyte> buffer;
+    };
+}

From 84f087049dfcc4cf25f25a87890d31a9934bb857 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 14 Oct 2025 00:51:04 +0300
Subject: [PATCH 060/133] add test PCMStream lua use

---
 res/scripts/hud.lua                           | 11 +++
 src/audio/audio.hpp                           |  4 +
 src/logic/scripting/lua/libs/libaudio.cpp     | 20 ++++
 src/logic/scripting/lua/lua_engine.cpp        |  2 +
 .../lua/usertypes/lua_type_pcmstream.cpp      | 94 +++++++++++++++++++
 .../lua/usertypes/lua_type_pcmstream.hpp      | 26 +++++
 6 files changed, 157 insertions(+)
 create mode 100644 src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
 create mode 100644 src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp

diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index 90883d94..cec5fc07 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -116,6 +116,17 @@ function on_hud_open()
     configure_SSAO()
 
     hud.default_hand_controller = update_hand
+
+    local stream = PCMStream(44100, 1, 8)
+    stream:share("test-stream")
+    local bytes = Bytearray(44100 * 16)
+    for i=1,#bytes do
+        local x = math.sin(i * 0.08) * 127 + 128
+        bytes[i] = x
+    end
+    stream:feed(bytes)
+
+    audio.play_stream_2d("test-stream", 0.05, 1.0)
 end
 
 function on_hud_render()
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index 5893c334..a3553b38 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -121,6 +121,10 @@ namespace audio {
         /// (always equals bufferSize if seekable and looped)
         virtual size_t readFully(char* buffer, size_t bufferSize, bool loop);
 
+        /// @brief Read available data to buffer
+        /// @param buffer destination buffer
+        /// @param bufferSize destination buffer size
+        /// @return count of received bytes or PCMStream::ERROR
         virtual size_t read(char* buffer, size_t bufferSize) = 0;
 
         /// @brief Close stream
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index db868c57..4d4ad6a6 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -67,6 +67,26 @@ inline audio::speakerid_t play_stream(
     if (channel == -1) {
         return 0;
     }
+    if (!scripting::engine->isHeadless()) {
+        auto assets = scripting::engine->getAssets();
+
+        auto stream = assets->getShared<audio::PCMStream>(filename);
+        if (stream) {
+            return audio::play(
+                audio::open_stream(std::move(stream), true),
+                glm::vec3(
+                    static_cast<float>(x),
+                    static_cast<float>(y),
+                    static_cast<float>(z)
+                ),
+                relative,
+                volume,
+                pitch,
+                loop,
+                channel
+            );
+        }
+    }
     io::path file;
     if (std::strchr(filename, ':')) {
         file = std::string(filename);
diff --git a/src/logic/scripting/lua/lua_engine.cpp b/src/logic/scripting/lua/lua_engine.cpp
index 05adb354..c4507bb1 100644
--- a/src/logic/scripting/lua/lua_engine.cpp
+++ b/src/logic/scripting/lua/lua_engine.cpp
@@ -12,6 +12,7 @@
 #include "usertypes/lua_type_voxelfragment.hpp"
 #include "usertypes/lua_type_canvas.hpp"
 #include "usertypes/lua_type_random.hpp"
+#include "usertypes/lua_type_pcmstream.hpp"
 #include "engine/Engine.hpp"
 
 static debug::Logger logger("lua-state");
@@ -130,6 +131,7 @@ void lua::init_state(State* L, StateType stateType) {
     newusertype<LuaHeightmap>(L);
     newusertype<LuaVoxelFragment>(L);
     newusertype<LuaCanvas>(L);
+    newusertype<LuaPCMStream>(L);
 }
 
 void lua::initialize(const EnginePaths& paths, const CoreParameters& params) {
diff --git a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
new file mode 100644
index 00000000..04c585cf
--- /dev/null
+++ b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
@@ -0,0 +1,94 @@
+#include "../lua_util.hpp"
+#include "lua_type_pcmstream.hpp"
+#include "assets/Assets.hpp"
+#include "audio/MemoryPCMStream.hpp"
+#include "engine/Engine.hpp"
+
+using namespace lua;
+using namespace audio;
+using namespace scripting;
+
+LuaPCMStream::LuaPCMStream(std::shared_ptr<audio::MemoryPCMStream>&& stream)
+    : stream(std::move(stream)) {
+}
+
+LuaPCMStream::~LuaPCMStream() = default;
+
+const std::shared_ptr<audio::MemoryPCMStream>& LuaPCMStream::getStream() const {
+    return stream;
+}
+
+#include <iostream>
+
+static int l_feed(lua::State* L) {
+    std::cout << "feed" << std::endl;
+    auto stream = touserdata<LuaPCMStream>(L, 1);
+    if (stream == nullptr) {
+        return 0;
+    }
+    auto bytes = bytearray_as_string(L, 2);
+    stream->getStream()->feed(
+        {reinterpret_cast<const ubyte*>(bytes.data()), bytes.size()}
+    );
+    return 0;
+}
+
+static int l_share(lua::State* L) {
+    auto stream = touserdata<LuaPCMStream>(L, 1);
+    if (stream == nullptr) {
+        return 0;
+    }
+    auto alias = require_lstring(L, 2);
+    if (engine->isHeadless()) {
+        return 0;
+    }
+    auto assets = engine->getAssets();
+    assets->store<PCMStream>(stream->getStream(), std::string(alias));
+    return 0;
+}
+
+static std::unordered_map<std::string, lua_CFunction> methods {
+    {"feed", lua::wrap<l_feed>},
+    {"share", lua::wrap<l_share>},
+};
+
+static int l_meta_meta_call(lua::State* L) {
+    auto sampleRate = touinteger(L, 2);
+    auto channels = touinteger(L, 3);
+    auto bitsPerSample = touinteger(L, 4);
+    auto stream =
+        std::make_shared<MemoryPCMStream>(sampleRate, channels, bitsPerSample);
+    return newuserdata<LuaPCMStream>(L, std::move(stream));
+}
+
+static int l_meta_tostring(lua::State* L) {
+    return pushstring(L, "PCMStream");
+}
+
+static int l_meta_index(lua::State* L) {
+    auto stream = touserdata<LuaPCMStream>(L, 1);
+    if (stream == nullptr) {
+        return 0;
+    }
+    if (isstring(L, 2)) {
+        auto found = methods.find(tostring(L, 2));
+        if (found != methods.end()) {
+            return pushcfunction(L, found->second);
+        }
+    }
+    return 0;
+}
+
+int LuaPCMStream::createMetatable(lua::State* L) {
+    createtable(L, 0, 3);
+    pushcfunction(L, lua::wrap<l_meta_tostring>);
+    setfield(L, "__tostring");
+    pushcfunction(L, lua::wrap<l_meta_index>);
+    setfield(L, "__index");
+
+    createtable(L, 0, 1);
+    pushcfunction(L, lua::wrap<l_meta_meta_call>);
+    setfield(L, "__call");
+    setmetatable(L);
+    return 1;
+}
diff --git a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp
new file mode 100644
index 00000000..47979693
--- /dev/null
+++ b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp
@@ -0,0 +1,26 @@
+#pragma once
+
+#include "../lua_commons.hpp"
+
+namespace audio {
+    class MemoryPCMStream;
+}
+
+namespace lua {
+    class LuaPCMStream : public Userdata {
+    public:
+        explicit LuaPCMStream(std::shared_ptr<audio::MemoryPCMStream>&& stream);
+        virtual ~LuaPCMStream() override;
+
+        const std::shared_ptr<audio::MemoryPCMStream>& getStream() const;
+
+        const std::string& getTypeName() const override {
+            return TYPENAME;
+        }
+        static int createMetatable(lua::State*);
+        inline static std::string TYPENAME = "PCMStream";
+    private:
+        std::shared_ptr<audio::MemoryPCMStream> stream;
+    };
+    static_assert(!std::is_abstract<LuaPCMStream>());
+}

From 2b72f87c6488dee0a5cc899ee753148b07c1b2e4 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 14 Oct 2025 00:53:51 +0300
Subject: [PATCH 061/133] fix

---
 src/util/span.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/util/span.hpp b/src/util/span.hpp
index a9ab79b2..7c97f5ac 100644
--- a/src/util/span.hpp
+++ b/src/util/span.hpp
@@ -15,7 +15,7 @@ namespace util {
 
         const T& at(size_t index) const {
             if (index >= length) {
-                throw std::out_of_range();
+                throw std::out_of_range("index is out of range");
             }
             return ptr[index];
         }

From 27416ab0cd8508324aa3d4fab8c5c5bd4b619275 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 14 Oct 2025 12:43:51 +0300
Subject: [PATCH 062/133] add audio::InputDevice

---
 src/audio/AL/ALAudio.cpp | 47 ++++++++++++++++++++++++++++++++++++++++
 src/audio/AL/ALAudio.hpp | 25 +++++++++++++++++++++
 src/audio/NoAudio.hpp    |  7 ++++++
 src/audio/audio.hpp      | 17 +++++++++++++++
 4 files changed, 96 insertions(+)

diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 7f28882b..92dd209a 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -37,6 +37,38 @@ std::unique_ptr<Speaker> ALSound::newInstance(int priority, int channel) const {
     return speaker;
 }
 
+ALInputDevice::ALInputDevice(
+    ALAudio* al, ALCdevice* device, uint channels, uint bitsPerSample
+)
+    : al(al), device(device), channels(channels), bitsPerSample(bitsPerSample) {
+}
+
+ALInputDevice::~ALInputDevice() {
+    alcCaptureCloseDevice(device);
+}
+
+void ALInputDevice::startCapture() {
+    AL_CHECK(alcCaptureStart(device));
+}
+
+void ALInputDevice::stopCapture() {
+    AL_CHECK(alcCaptureStop(device));
+}
+
+uint ALInputDevice::getChannels() const {
+    return channels;
+}
+
+size_t ALInputDevice::read(char* buffer, size_t bufferSize) {
+    ALCint samplesCount;
+    AL_CHECK(alcGetIntegerv(device, ALC_CAPTURE_SAMPLES, 1, &samplesCount));
+    size_t samplesRead = std::min<ALCsizei>(
+        samplesCount, bufferSize / channels / (bitsPerSample >> 3)
+    );
+    AL_CHECK(alcCaptureSamples(device, buffer, samplesRead));
+    return samplesRead;
+}
+
 ALStream::ALStream(
     ALAudio* al, std::shared_ptr<PCMStream> source, bool keepSource
 )
@@ -411,6 +443,21 @@ std::unique_ptr<Stream> ALAudio::openStream(
     return std::make_unique<ALStream>(this, stream, keepSource);
 }
 
+std::unique_ptr<InputDevice> ALAudio::openInputDevice(
+    uint sampleRate, uint channels, uint bitsPerSample
+) {
+    uint bps = bitsPerSample >> 3;
+    AL_CHECK(
+        ALCdevice* device = alcCaptureOpenDevice(
+            nullptr,
+            sampleRate,
+            AL::to_al_format(channels, bps),
+            sampleRate * channels * bps
+        )
+    );
+    return std::make_unique<ALInputDevice>(this, device, channels, bps);
+}
+
 std::unique_ptr<ALAudio> ALAudio::create() {
     ALCdevice* device = alcOpenDevice(nullptr);
     if (device == nullptr) return nullptr;
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index 7e0f0c29..d04d45b6 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -82,6 +82,26 @@ namespace audio {
         static inline constexpr uint STREAM_BUFFERS = 3;
     };
 
+    class ALInputDevice : public InputDevice {
+    public:
+        ALInputDevice(
+            ALAudio* al, ALCdevice* device, uint channels, uint bitsPerSample
+        );
+        ~ALInputDevice() override;
+
+        void startCapture() override;
+        void stopCapture() override;
+
+        uint getChannels() const override;
+
+        size_t read(char* buffer, size_t bufferSize) override;
+    private:
+        ALAudio* al;
+        ALCdevice* device;
+        uint channels;
+        uint bitsPerSample;
+    };
+
     /// @brief AL source adapter
     class ALSpeaker : public Speaker {
         ALAudio* al;
@@ -157,10 +177,15 @@ namespace audio {
         std::unique_ptr<Sound> createSound(
             std::shared_ptr<PCM> pcm, bool keepPCM
         ) override;
+
         std::unique_ptr<Stream> openStream(
             std::shared_ptr<PCMStream> stream, bool keepSource
         ) override;
 
+        std::unique_ptr<InputDevice> openInputDevice(
+            uint sampleRate, uint channels, uint bitsPerSample
+        ) override;
+
         void setListener(
             glm::vec3 position,
             glm::vec3 velocity,
diff --git a/src/audio/NoAudio.hpp b/src/audio/NoAudio.hpp
index edfc3319..bc2e6b49 100644
--- a/src/audio/NoAudio.hpp
+++ b/src/audio/NoAudio.hpp
@@ -71,10 +71,17 @@ namespace audio {
         std::unique_ptr<Sound> createSound(
             std::shared_ptr<PCM> pcm, bool keepPCM
         ) override;
+
         std::unique_ptr<Stream> openStream(
             std::shared_ptr<PCMStream> stream, bool keepSource
         ) override;
 
+        std::unique_ptr<InputDevice> openInputDevice(
+            uint sampleRate, uint channels, uint bitsPerSample
+        ) override {
+            return nullptr;
+        }
+
         void setListener(
             glm::vec3 position, glm::vec3 velocity, glm::vec3 at, glm::vec3 up
         ) override {
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index a3553b38..56de29ad 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -108,6 +108,20 @@ namespace audio {
         }
     };
 
+    class InputDevice {
+    public:
+        virtual ~InputDevice() {};
+
+        virtual void startCapture() = 0;
+        virtual void stopCapture() = 0;
+
+        /// @brief Get number of audio channels
+        /// @return 1 if mono, 2 if stereo
+        virtual uint getChannels() const = 0;
+
+        virtual size_t read(char* buffer, size_t bufferSize) = 0;
+    };
+
     /// @brief audio::PCMStream is a data source for audio::Stream
     class PCMStream {
     public:
@@ -345,6 +359,9 @@ namespace audio {
         virtual std::unique_ptr<Stream> openStream(
             std::shared_ptr<PCMStream> stream, bool keepSource
         ) = 0;
+        virtual std::unique_ptr<InputDevice> openInputDevice(
+            uint sampleRate, uint channels, uint bitsPerSample
+        ) = 0;
         virtual void setListener(
             glm::vec3 position,
             glm::vec3 velocity,

From 7dca9255dfc3d4ecc393a5a1b60b0c00ba035505 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 15 Oct 2025 22:13:16 +0300
Subject: [PATCH 063/133] add test audio input fetch function

---
 res/scripts/hud.lua                           | 13 ++--
 src/audio/AL/ALAudio.cpp                      | 69 ++++++++++++++-----
 src/audio/audio.cpp                           | 10 +++
 src/audio/audio.hpp                           | 13 ++++
 src/logic/scripting/lua/libs/libaudio.cpp     | 24 ++++++-
 .../lua/usertypes/lua_type_pcmstream.cpp      |  3 -
 6 files changed, 107 insertions(+), 25 deletions(-)

diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index cec5fc07..ba828491 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -55,6 +55,8 @@ local function update_hand()
     skeleton.set_model("hand", bone, item.model_name(itemid))
 end
 
+local stream
+
 function on_hud_open()
     input.add_callback("player.pick", function ()
         if hud.is_paused() or hud.is_inventory_open() then
@@ -117,16 +119,16 @@ function on_hud_open()
 
     hud.default_hand_controller = update_hand
 
-    local stream = PCMStream(44100, 1, 8)
+    stream = PCMStream(44100, 1, 16)
     stream:share("test-stream")
-    local bytes = Bytearray(44100 * 16)
+    local bytes = Bytearray(44100 / 8)
     for i=1,#bytes do
-        local x = math.sin(i * 0.08) * 127 + 128
+        local x = math.sin(i * 0.08) * 1 + 0
         bytes[i] = x
     end
     stream:feed(bytes)
 
-    audio.play_stream_2d("test-stream", 0.05, 1.0)
+    audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
 end
 
 function on_hud_render()
@@ -135,4 +137,7 @@ function on_hud_render()
     else
         update_hand()
     end
+
+    local bytes = audio.fetch_input()
+    stream:feed(bytes)
 end
diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 92dd209a..23dfeaa8 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -5,11 +5,40 @@
 
 #include "debug/Logger.hpp"
 #include "alutil.hpp"
+#include "../MemoryPCMStream.hpp"
 
 static debug::Logger logger("al-audio");
 
 using namespace audio;
 
+const char* alc_error_to_string(ALCenum error) {
+    switch (error) {
+        case ALC_NO_ERROR:
+            return "no error";
+        case ALC_INVALID_DEVICE:
+            return "invalid device handle";
+        case ALC_INVALID_CONTEXT:
+            return "invalid context handle";
+        case ALC_INVALID_ENUM:
+            return "invalid enum parameter passed to an ALC call";
+        case ALC_INVALID_VALUE:
+            return "invalid value parameter passed to an ALC call";
+        case ALC_OUT_OF_MEMORY:
+            return "out of memory";
+        default:
+            return "unknown ALC error";
+    }
+}
+
+static void check_alc_errors(ALCdevice* device, const char* context) {
+    ALCenum error = alcGetError(device);
+    if (error == ALC_NO_ERROR) {
+        return;
+    }
+    logger.error() << context << ": " << alc_error_to_string(error) << "("
+                   << error << ")";
+}
+
 ALSound::ALSound(
     ALAudio* al, uint buffer, const std::shared_ptr<PCM>& pcm, bool keepPCM
 )
@@ -45,14 +74,17 @@ ALInputDevice::ALInputDevice(
 
 ALInputDevice::~ALInputDevice() {
     alcCaptureCloseDevice(device);
+    check_alc_errors(device, "alcCaptureCloseDevice");
 }
 
 void ALInputDevice::startCapture() {
-    AL_CHECK(alcCaptureStart(device));
+    alcCaptureStart(device);
+    check_alc_errors(device, "alcCaptureStart");
 }
 
 void ALInputDevice::stopCapture() {
-    AL_CHECK(alcCaptureStop(device));
+    alcCaptureStop(device);
+    check_alc_errors(device, "alcCaptureStop");
 }
 
 uint ALInputDevice::getChannels() const {
@@ -60,13 +92,15 @@ uint ALInputDevice::getChannels() const {
 }
 
 size_t ALInputDevice::read(char* buffer, size_t bufferSize) {
-    ALCint samplesCount;
-    AL_CHECK(alcGetIntegerv(device, ALC_CAPTURE_SAMPLES, 1, &samplesCount));
+    ALCint samplesCount = 0;
+    alcGetIntegerv(device, ALC_CAPTURE_SAMPLES, sizeof(samplesCount), &samplesCount);
+    check_alc_errors(device, "alcGetIntegerv(ALC_CAPTURE_SAMPLES)");
     size_t samplesRead = std::min<ALCsizei>(
         samplesCount, bufferSize / channels / (bitsPerSample >> 3)
     );
-    AL_CHECK(alcCaptureSamples(device, buffer, samplesRead));
-    return samplesRead;
+    alcCaptureSamples(device, buffer, samplesRead);
+    check_alc_errors(device, "alcCaptureSamples");
+    return samplesRead * channels * (bitsPerSample >> 3);
 }
 
 ALStream::ALStream(
@@ -195,7 +229,7 @@ void ALStream::update(double delta) {
 
     // alspeaker->stopped is assigned to false at ALSpeaker::play(...)
     if (p_speaker->isStopped() && !alspeaker->stopped) { //TODO: -V560 false-positive?
-        if (preloaded) {
+        if (preloaded || dynamic_cast<MemoryPCMStream*>(source.get())) {
             p_speaker->play();
         } else {
             p_speaker->stop();
@@ -417,8 +451,10 @@ ALAudio::~ALAudio() {
         AL_CHECK(alDeleteBuffers(1, &buffer));
     }
 
-    AL_CHECK(alcMakeContextCurrent(context));
+    alcMakeContextCurrent(nullptr);
+    check_alc_errors(device, "alcMakeContextCurrent");
     alcDestroyContext(context);
+    check_alc_errors(device, "alcDestroyContext");
     if (!alcCloseDevice(device)) {
         logger.error() << "device not closed!";
     }
@@ -447,15 +483,16 @@ std::unique_ptr<InputDevice> ALAudio::openInputDevice(
     uint sampleRate, uint channels, uint bitsPerSample
 ) {
     uint bps = bitsPerSample >> 3;
-    AL_CHECK(
-        ALCdevice* device = alcCaptureOpenDevice(
-            nullptr,
-            sampleRate,
-            AL::to_al_format(channels, bps),
-            sampleRate * channels * bps
-        )
+    ALCdevice* device = alcCaptureOpenDevice(
+        nullptr,
+        sampleRate,
+        AL::to_al_format(channels, bitsPerSample),
+        sampleRate * channels * bps / 8
+    );
+    check_alc_errors(device, "alcCaptureOpenDevice");
+    return std::make_unique<ALInputDevice>(
+        this, device, channels, bitsPerSample
     );
-    return std::make_unique<ALInputDevice>(this, device, channels, bps);
 }
 
 std::unique_ptr<ALAudio> ALAudio::create() {
diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index f98c436e..130e6fac 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -151,6 +151,8 @@ public:
     }
 };
 
+static std::unique_ptr<InputDevice> input_device = nullptr;
+
 void audio::initialize(bool enabled, AudioSettings& settings) {
     enabled = enabled && settings.enabled.get();
     if (enabled) {
@@ -180,6 +182,13 @@ void audio::initialize(bool enabled, AudioSettings& settings) {
             audio::get_channel(channel.name)->setVolume(value * value);
         }, true));
     }
+
+    input_device = backend->openInputDevice(44100, 1, 16);
+    input_device->startCapture();
+}
+
+InputDevice* audio::get_input_device() {
+    return input_device.get();
 }
 
 std::unique_ptr<PCM> audio::load_PCM(const io::path& file, bool headerOnly) {
@@ -458,6 +467,7 @@ void audio::reset_channel(int index) {
 }
 
 void audio::close() {
+    input_device->stopCapture();
     speakers.clear();
     delete backend;
     backend = nullptr;
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index 56de29ad..e1c19d25 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -24,6 +24,8 @@ namespace audio {
     /// @brief streams and important sounds
     constexpr inline int PRIORITY_HIGH = 10;
 
+    constexpr inline size_t MAX_INPUT_SAMPLES = 22050;
+
     class Speaker;
 
     /// @brief Audio speaker states
@@ -423,6 +425,15 @@ namespace audio {
         std::shared_ptr<PCMStream> stream, bool keepSource
     );
 
+    /// @brief Open audio input device
+    /// @param sampleRate sample rate
+    /// @param channels channels count (1 - mono, 2 - stereo)
+    /// @param bitsPerSample number of bits per sample (8 or 16)
+    /// @return new InputDevice instance or nullptr
+    std::unique_ptr<InputDevice> open_input_device(
+        uint sampleRate, uint channels, uint bitsPerSample
+    );
+
     /// @brief Configure 3D listener
     /// @param position listener position
     /// @param velocity listener velocity (used for Doppler effect)
@@ -536,6 +547,8 @@ namespace audio {
     /// @brief Stop all playing audio in channel, reset channel state
     void reset_channel(int channel);
 
+    InputDevice* get_input_device();
+
     /// @brief Finalize audio system
     void close();
 };
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index 4d4ad6a6..7f68bd6d 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -379,16 +379,35 @@ static int l_audio_get_velocity(lua::State* L) {
     return 0;
 }
 
-// @brief audio.count_speakers() -> integer
+/// @brief audio.count_speakers() -> integer
 static int l_audio_count_speakers(lua::State* L) {
     return lua::pushinteger(L, audio::count_speakers());
 }
 
-// @brief audio.count_streams() -> integer
+/// @brief audio.count_streams() -> integer
 static int l_audio_count_streams(lua::State* L) {
     return lua::pushinteger(L, audio::count_streams());
 }
 
+/// @brief audio.fetch_input(size) -> Bytearray
+static int l_audio_fetch_input(lua::State* L) {
+    auto device = audio::get_input_device();
+    if (device == nullptr) {
+        return 0;
+    }
+    size_t size = lua::touinteger(L, 1);
+    const size_t MAX_BUFFER_SIZE = audio::MAX_INPUT_SAMPLES * 4;
+    if (size == 0) {
+        size = MAX_BUFFER_SIZE;
+    }
+    size = std::min<size_t>(size, MAX_BUFFER_SIZE);
+    ubyte buffer[MAX_BUFFER_SIZE];
+    size = device->read(reinterpret_cast<char*>(buffer), size);
+
+    std::vector<ubyte> bytes(buffer, buffer + size);
+    return lua::create_bytearray(L, std::move(bytes));
+}
+
 const luaL_Reg audiolib[] = {
     {"play_sound", lua::wrap<l_audio_play_sound>},
     {"play_sound_2d", lua::wrap<l_audio_play_sound_2d>},
@@ -414,5 +433,6 @@ const luaL_Reg audiolib[] = {
     {"get_velocity", lua::wrap<l_audio_get_velocity>},
     {"count_speakers", lua::wrap<l_audio_count_speakers>},
     {"count_streams", lua::wrap<l_audio_count_streams>},
+    {"fetch_input", lua::wrap<l_audio_fetch_input>},
     {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
index 04c585cf..3367813e 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
@@ -18,10 +18,7 @@ const std::shared_ptr<audio::MemoryPCMStream>& LuaPCMStream::getStream() const {
     return stream;
 }
 
-#include <iostream>
-
 static int l_feed(lua::State* L) {
-    std::cout << "feed" << std::endl;
     auto stream = touserdata<LuaPCMStream>(L, 1);
     if (stream == nullptr) {
         return 0;

From d41167fd727404e0087eb1272741dc352167406f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 15 Oct 2025 22:40:00 +0300
Subject: [PATCH 064/133] fix

---
 src/audio/audio.cpp | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index 130e6fac..b45242bb 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -184,7 +184,9 @@ void audio::initialize(bool enabled, AudioSettings& settings) {
     }
 
     input_device = backend->openInputDevice(44100, 1, 16);
-    input_device->startCapture();
+    if (input_device) {
+        input_device->startCapture();
+    }
 }
 
 InputDevice* audio::get_input_device() {
@@ -467,7 +469,9 @@ void audio::reset_channel(int index) {
 }
 
 void audio::close() {
-    input_device->stopCapture();
+    if (input_device) {
+        input_device->stopCapture();
+    }
     speakers.clear();
     delete backend;
     backend = nullptr;

From b0499ced14574891fbb3df72175f3eee56c4d71d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 21:10:06 +0300
Subject: [PATCH 065/133] add glm includes to Shadows.cpp

---
 src/graphics/core/Shadows.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/graphics/core/Shadows.cpp b/src/graphics/core/Shadows.cpp
index b6a95580..343a4e6b 100644
--- a/src/graphics/core/Shadows.cpp
+++ b/src/graphics/core/Shadows.cpp
@@ -3,6 +3,8 @@
 #include <GL/glew.h>
 #define GLM_ENABLE_EXPERIMENTAL
 #include <glm/gtx/norm.hpp>
+#include <glm/gtc/constants.hpp>
+#include "glm/gtc/matrix_transform.hpp"
 
 #include "assets/Assets.hpp"
 #include "graphics/core/DrawContext.hpp"

From 348113f6ea29ab4e172774e8d7e5933eae4b532d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 21:26:05 +0300
Subject: [PATCH 066/133] update Shadows.cpp

---
 src/graphics/core/Shadows.cpp | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/graphics/core/Shadows.cpp b/src/graphics/core/Shadows.cpp
index 343a4e6b..4427f643 100644
--- a/src/graphics/core/Shadows.cpp
+++ b/src/graphics/core/Shadows.cpp
@@ -1,11 +1,12 @@
-#include "Shadows.hpp"
-
-#include <GL/glew.h>
 #define GLM_ENABLE_EXPERIMENTAL
 #include <glm/gtx/norm.hpp>
 #include <glm/gtc/constants.hpp>
 #include "glm/gtc/matrix_transform.hpp"
 
+#include "Shadows.hpp"
+
+#include <GL/glew.h>
+
 #include "assets/Assets.hpp"
 #include "graphics/core/DrawContext.hpp"
 #include "graphics/core/Shader.hpp"

From 2210ba8218535c0925e81176b6f0bd82b110753a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 21:43:02 +0300
Subject: [PATCH 067/133] add includes

---
 src/graphics/render/Emitter.cpp | 2 ++
 src/objects/Transform.cpp       | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/src/graphics/render/Emitter.cpp b/src/graphics/render/Emitter.cpp
index 483a6339..7e10daae 100644
--- a/src/graphics/render/Emitter.cpp
+++ b/src/graphics/render/Emitter.cpp
@@ -1,6 +1,8 @@
 #include "Emitter.hpp"
 
 #include <glm/gtc/random.hpp>
+#include <glm/gtc/constants.hpp>
+#include <glm/gtc/matrix_transform.hpp>
 #define GLM_ENABLE_EXPERIMENTAL
 #include <glm/gtx/norm.hpp>
 
diff --git a/src/objects/Transform.cpp b/src/objects/Transform.cpp
index 87ed4a73..8779e220 100644
--- a/src/objects/Transform.cpp
+++ b/src/objects/Transform.cpp
@@ -2,6 +2,8 @@
 
 #include "data/dv_util.hpp"
 
+#include <glm/gtc/matrix_transform.hpp>
+
 void Transform::refresh() {
     combined = glm::mat4(1.0f);
     combined = glm::translate(combined, pos);

From 9cb9b095e8c6ce4cf6e7e5a226314ff4ec5db2b5 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 20:43:03 +0300
Subject: [PATCH 068/133] add new players finding functions

---
 src/logic/scripting/lua/libs/libplayer.cpp | 35 +++++++++++++++++
 src/objects/Players.cpp                    | 45 ++++++++++++++++++++++
 src/objects/Players.hpp                    |  6 +++
 3 files changed, 86 insertions(+)

diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index 320db362..45c396fe 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -322,6 +322,38 @@ static int l_set_suspended(lua::State* L) {
     return 0;
 }
 
+static int l_get_all_in_radius(lua::State* L) {
+    auto center = lua::tovec3(L, 1);
+    auto radius = static_cast<float>(lua::tonumber(L, 2));
+
+    auto players = level->players->getAllInRadius(center, radius);
+    lua::createtable(L, players.size(), 0);
+    for (size_t i = 0; i < players.size(); i++) {
+        lua::pushinteger(L, players[i]->getId());
+        lua::rawseti(L, i + 1);
+    }
+    return 1;
+}
+
+static int l_get_all(lua::State* L) {
+    auto players = level->players->getAll();
+    lua::createtable(L, players.size(), 0);
+    for (size_t i = 0; i < players.size(); i++) {
+        lua::pushinteger(L, players[i]->getId());
+        lua::rawseti(L, i + 1);
+    }
+    return 1;
+}
+
+static int l_get_nearest(lua::State* L) {
+    auto position = lua::tovec3(L, 1);
+    if (auto player = level->players->getNearest(position)) {
+        lua::pushinteger(L, player->getId());
+        return 1;
+    }
+    return 0;
+}
+
 const luaL_Reg playerlib[] = {
     {"get_pos", lua::wrap<l_get_pos>},
     {"set_pos", lua::wrap<l_set_pos>},
@@ -358,5 +390,8 @@ const luaL_Reg playerlib[] = {
     {"set_name", lua::wrap<l_set_name>},
     {"create", lua::wrap<l_create>},
     {"delete", lua::wrap<l_delete>},
+    {"get_all_in_radius", lua::wrap<l_get_all_in_radius>},
+    {"get_all", lua::wrap<l_get_all>},
+    {"get_nearest", lua::wrap<l_get_nearest>},
     {nullptr, nullptr}
 };
diff --git a/src/objects/Players.cpp b/src/objects/Players.cpp
index 9c0e2603..5fc59f40 100644
--- a/src/objects/Players.cpp
+++ b/src/objects/Players.cpp
@@ -1,5 +1,8 @@
 #include "Players.hpp"
 
+#define GLM_ENABLE_EXPERIMENTAL
+#include <glm/gtx/norm.hpp>
+
 #include "Player.hpp"
 #include "items/Inventories.hpp"
 #include "world/Level.hpp"
@@ -20,6 +23,48 @@ Player* Players::get(int64_t id) const {
     return found->second.get();
 }
 
+std::vector<Player*> Players::getAllInRadius(
+    const glm::vec3& center, float radius
+) const {
+    std::vector<Player*> foundPlayers;
+
+    for (const auto& pair : players) {
+        auto player = pair.second.get();
+        auto relativePos = player->getPosition() - center;
+        if (!player->isSuspended() && glm::length2(relativePos) <= radius) {
+            foundPlayers.emplace_back(player);
+        }
+    }
+    return foundPlayers;
+}
+
+std::vector<Player*> Players::getAll() const {
+    std::vector<Player*> allPlayers;
+    allPlayers.reserve(players.size());
+    for (const auto& pair : players) {
+        allPlayers.emplace_back(pair.second.get());
+    }
+    return allPlayers;
+}
+
+Player* Players::getNearest(const glm::vec3& position) const {
+    Player* nearest = nullptr;
+    float nearestDist2 = std::numeric_limits<float>::max();
+    for (const auto& pair : players) {
+        auto player = pair.second.get();
+        if (player->isSuspended()) {
+            continue;
+        }
+        auto relativePos = player->getPosition() - position;
+        auto dist2 = glm::length2(relativePos);
+        if (dist2 < nearestDist2) {
+            nearestDist2 = dist2;
+            nearest = player;
+        }
+    }
+    return nearest;
+}
+
 Player* Players::create(int64_t id) {
     int64_t& nextPlayerID = level.getWorld()->getInfo().nextPlayerId;
     if (id == NONE) {
diff --git a/src/objects/Players.hpp b/src/objects/Players.hpp
index 5c657a50..16803340 100644
--- a/src/objects/Players.hpp
+++ b/src/objects/Players.hpp
@@ -1,7 +1,9 @@
 #pragma once
 
 #include <memory>
+#include <vector>
 #include <unordered_map>
+#include <glm/vec3.hpp>
 
 #include "typedefs.hpp"
 #include "interfaces/Serializable.hpp"
@@ -34,6 +36,10 @@ public:
 
     void remove(int64_t id);
 
+    std::vector<Player*> getAllInRadius(const glm::vec3& center, float radius) const;
+    std::vector<Player*> getAll() const;
+    Player* getNearest(const glm::vec3& position) const;
+
     dv::value serialize() const override;
 
     void deserialize(const dv::value& src) override;

From c0196ef092c1ebcc1e9357dcb9518a159c05d113 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 20:48:28 +0300
Subject: [PATCH 069/133] update doc/*/scripting/builtins/libplayer.md

---
 doc/en/scripting/builtins/libplayer.md | 18 ++++++++++++++++++
 doc/ru/scripting/builtins/libplayer.md | 18 ++++++++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/doc/en/scripting/builtins/libplayer.md b/doc/en/scripting/builtins/libplayer.md
index b406f694..4bc81424 100644
--- a/doc/en/scripting/builtins/libplayer.md
+++ b/doc/en/scripting/builtins/libplayer.md
@@ -142,3 +142,21 @@ player.get_entity(playerid: int) -> int
 ```
 
 Returns unique identifier of the player entity
+
+```lua
+player.get_all_in_radius(center: vec3, radius: number) -> table<int>
+```
+
+Returns an array of player IDs within a sphere with center `center` and radius `radius`.
+
+```lua
+player.get_all() -> table<int>
+```
+
+Returns an array of all active player IDs.
+
+```lua
+player.get_nearest(position: vec3) -> int
+```
+
+Returns the ID of the player closest to the specified position, or nil if there are no players.
diff --git a/doc/ru/scripting/builtins/libplayer.md b/doc/ru/scripting/builtins/libplayer.md
index c40cd86d..c038ecae 100644
--- a/doc/ru/scripting/builtins/libplayer.md
+++ b/doc/ru/scripting/builtins/libplayer.md
@@ -142,3 +142,21 @@ player.get_entity(playerid: int) -> int
 ```
 
 Возвращает уникальный идентификатор сущности игрока
+
+```lua
+player.get_all_in_radius(center: vec3, radius: number) -> table<int>
+```
+
+Возвращает массив id игроков в пределах сферы с центром `center` и радиусом `radius`.
+
+```lua
+player.get_all() -> table<int>
+```
+
+Возвращает массив id всех активных игроков.
+
+```lua
+player.get_nearest(position: vec3) -> int
+```
+
+Возвращает id ближайшего к указанной позиции игрока, либо nil если игроков нет.

From 18d4cff67882159265776d4bbdc9775765c01f93 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 22:57:45 +0300
Subject: [PATCH 070/133] add 'rotate' and 'origin' box modifier to vcm

---
 src/coders/vcm.cpp             | 29 ++++++++++++++-
 src/graphics/commons/Model.cpp | 67 ++++++++++++++++++++--------------
 src/graphics/commons/Model.hpp | 13 ++++++-
 3 files changed, 78 insertions(+), 31 deletions(-)

diff --git a/src/coders/vcm.cpp b/src/coders/vcm.cpp
index 337d721f..b7d93b57 100644
--- a/src/coders/vcm.cpp
+++ b/src/coders/vcm.cpp
@@ -1,6 +1,8 @@
 #include "vcm.hpp"
 
-#include <iostream>
+#include <algorithm>
+#include <glm/gtc/quaternion.hpp>
+#include <glm/gtc/matrix_transform.hpp>
 
 #include "xml.hpp"
 #include "util/stringutil.hpp"
@@ -73,6 +75,29 @@ static void perform_box(const xmlelement& root, model::Model& model) {
     auto from = root.attr("from").asVec3();
     auto to = root.attr("to").asVec3();
 
+    glm::vec3 origin = (from + to) * 0.5f;
+    if (root.has("origin")) {
+        origin = root.attr("origin").asVec3();
+    }
+
+    glm::mat4 tsf(1.0f);
+    from -= origin;
+    to -= origin;
+    tsf = glm::translate(tsf, origin);
+
+    if (root.has("rotate")) {
+        auto text = root.attr("rotate").getText();
+        if (std::count(text.begin(), text.end(), ',') == 3) {
+            auto quat = root.attr("rotate").asVec4();
+            tsf *= glm::mat4_cast(glm::quat(quat.w, quat.x, quat.y, quat.z));
+        } else {
+            auto rot = root.attr("rotate").asVec3();
+            tsf = glm::rotate(tsf, glm::radians(rot.x), glm::vec3(1, 0, 0));
+            tsf = glm::rotate(tsf, glm::radians(rot.y), glm::vec3(0, 1, 0));
+            tsf = glm::rotate(tsf, glm::radians(rot.z), glm::vec3(0, 0, 1));
+        }
+    }
+
     UVRegion regions[6] {};
     regions[0].scale(to.x - from.x, to.y - from.y);
     regions[1].scale(from.x - to.x, to.y - from.y);
@@ -142,7 +167,7 @@ static void perform_box(const xmlelement& root, model::Model& model) {
         bool enabled[6] {};
         enabled[i] = true;
         auto& mesh = model.addMesh(texfaces[i], shading);
-        mesh.addBox(center, halfsize, regions, enabled);
+        mesh.addBox(center, halfsize, regions, enabled, tsf);
     }
 }
 
diff --git a/src/graphics/commons/Model.cpp b/src/graphics/commons/Model.cpp
index 20d90eb4..386ae1cc 100644
--- a/src/graphics/commons/Model.cpp
+++ b/src/graphics/commons/Model.cpp
@@ -8,21 +8,6 @@ inline constexpr glm::vec3 X(1, 0, 0);
 inline constexpr glm::vec3 Y(0, 1, 0);
 inline constexpr glm::vec3 Z(0, 0, 1);
 
-void Mesh::addPlane(
-    const glm::vec3& pos,
-    const glm::vec3& right,
-    const glm::vec3& up,
-    const glm::vec3& norm
-) {
-    vertices.push_back({pos-right-up, {0,0}, norm});
-    vertices.push_back({pos+right-up, {1,0}, norm});
-    vertices.push_back({pos+right+up, {1,1}, norm});
-
-    vertices.push_back({pos-right-up, {0,0}, norm});
-    vertices.push_back({pos+right+up, {1,1}, norm});
-    vertices.push_back({pos-right+up, {0,1}, norm});
-}
-
 void Mesh::addPlane(
     const glm::vec3& pos,
     const glm::vec3& right,
@@ -39,6 +24,23 @@ void Mesh::addPlane(
     vertices.push_back({pos-right+up, {uv.u1, uv.v2}, norm});
 }
 
+void Mesh::addPlane(
+    const glm::vec3& pos,
+    const glm::vec3& right,
+    const glm::vec3& up,
+    const glm::vec3& norm,
+    const UVRegion& region,
+    const glm::mat4& transform
+) {
+    addPlane(
+        glm::vec3(transform * glm::vec4(pos, 1.0f)),
+        glm::vec3(transform * glm::vec4(right, 0.0f)),
+        glm::vec3(transform * glm::vec4(up, 0.0f)),
+        glm::normalize(glm::vec3(transform * glm::vec4(norm, 0.0f))),
+        region
+    );
+}
+
 void Mesh::addRect(
     const glm::vec3& pos,
     const glm::vec3& right,
@@ -56,14 +58,15 @@ void Mesh::addRect(
 }
 
 void Mesh::addBox(const glm::vec3& pos, const glm::vec3& size) {
-    addPlane(pos+Z*size, X*size, Y*size, Z);
-    addPlane(pos-Z*size, -X*size, Y*size, -Z);
+    UVRegion fullRegion (0, 0, 1, 1);
+    addPlane(pos+Z*size, X*size, Y*size, Z, fullRegion);
+    addPlane(pos-Z*size, -X*size, Y*size, -Z, fullRegion);
 
-    addPlane(pos+Y*size, X*size, -Z*size, Y);
-    addPlane(pos-Y*size, X*size, Z*size, -Y);
+    addPlane(pos+Y*size, X*size, -Z*size, Y, fullRegion);
+    addPlane(pos-Y*size, X*size, Z*size, -Y, fullRegion);
 
-    addPlane(pos+X*size, -Z*size, Y*size, X);
-    addPlane(pos-X*size, Z*size, Y*size, -X);
+    addPlane(pos+X*size, -Z*size, Y*size, X, fullRegion);
+    addPlane(pos-X*size, Z*size, Y*size, -X, fullRegion);
 }
 
 void Mesh::addBox(
@@ -71,19 +74,29 @@ void Mesh::addBox(
     const glm::vec3& size,
     const UVRegion (&uvs)[6],
     const bool enabledSides[6]
+) {
+    addBox(pos, size, uvs, enabledSides, glm::mat4(1.0f));
+}
+
+void Mesh::addBox(
+    const glm::vec3& pos,
+    const glm::vec3& size,
+    const UVRegion (&uvs)[6],
+    const bool enabledSides[6],
+    const glm::mat4& transform
 ) {
     if (enabledSides[0]) // north
-        addPlane(pos+Z*size, X*size, Y*size, Z, uvs[0]);
+        addPlane(pos+Z*size, X*size, Y*size, Z, uvs[0], transform);
     if (enabledSides[1]) // south
-        addPlane(pos-Z*size, -X*size, Y*size, -Z, uvs[1]);
+        addPlane(pos-Z*size, -X*size, Y*size, -Z, uvs[1], transform);
     if (enabledSides[2]) // top
-        addPlane(pos+Y*size, X*size, -Z*size, Y, uvs[2] * glm::vec2(-1));
+        addPlane(pos+Y*size, X*size, -Z*size, Y, uvs[2] * glm::vec2(-1), transform);
     if (enabledSides[3]) // bottom
-        addPlane(pos-Y*size, X*size, Z*size, -Y, uvs[3] * glm::vec2(-1, 1));
+        addPlane(pos-Y*size, X*size, Z*size, -Y, uvs[3] * glm::vec2(-1, 1), transform);
     if (enabledSides[4]) // west
-        addPlane(pos+X*size, -Z*size, Y*size, X, uvs[4]);
+        addPlane(pos+X*size, -Z*size, Y*size, X, uvs[4], transform);
     if (enabledSides[5]) // east
-        addPlane(pos-X*size, Z*size, Y*size, -X, uvs[5] * glm::vec2(-1, 1));
+        addPlane(pos-X*size, Z*size, Y*size, -X, uvs[5] * glm::vec2(-1, 1), transform);
 }
 
 void Mesh::scale(const glm::vec3& size) {
diff --git a/src/graphics/commons/Model.hpp b/src/graphics/commons/Model.hpp
index 73bee359..bbb0d398 100644
--- a/src/graphics/commons/Model.hpp
+++ b/src/graphics/commons/Model.hpp
@@ -22,14 +22,16 @@ namespace model {
             const glm::vec3& pos,
             const glm::vec3& right,
             const glm::vec3& up,
-            const glm::vec3& norm
+            const glm::vec3& norm,
+            const UVRegion& region
         );
         void addPlane(
             const glm::vec3& pos,
             const glm::vec3& right,
             const glm::vec3& up,
             const glm::vec3& norm,
-            const UVRegion& region
+            const UVRegion& region,
+            const glm::mat4& transform
         );
         void addRect(
             const glm::vec3& pos,
@@ -45,6 +47,13 @@ namespace model {
             const UVRegion (&texfaces)[6],
             const bool enabledSides[6]
         );
+        void addBox(
+            const glm::vec3& pos,
+            const glm::vec3& size,
+            const UVRegion (&texfaces)[6],
+            const bool enabledSides[6],
+            const glm::mat4& transform
+        );
         void scale(const glm::vec3& size);
     };
 

From 1b0d51a2f6e1b22de1f4d2b0549ae8b27ac1b237 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Oct 2025 23:07:09 +0300
Subject: [PATCH 071/133] update doc/ru/vcm.md

---
 doc/ru/vcm.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/ru/vcm.md b/doc/ru/vcm.md
index 0eb555b4..379e0328 100644
--- a/doc/ru/vcm.md
+++ b/doc/ru/vcm.md
@@ -42,6 +42,8 @@
 
 - `from` - точка начала примитива. Пример: `from (0,0,0)`
 - `to` - противоположная от начала точка. Пример: `to (1,1,1)`
+- `origin` - точка, относительно которой будет применено вращение. По-умолчанию: центр примитива. Пример: `origin (0.5,0.5,0.5)`
+- `rotate` - вращение вокруг осей (x,y,z) в градусах, или кватернион (x,y,z,w). Пример: `rotate (45,0,0)` или `rotate (0.3826834, 0, 0, 0.9238795)`
 - `texture` - отображаемая текстура для всех сторон по-умолчанию.
 - `shading` определяет возможность затенения на примитиве. Пример: `shading off`
 - `delete` удаляет стороны по именам (top, bottom, east, west, north, south)

From b11bdf0bcc3b56ed2cfb3eaa5d8c1a6afcaa79c3 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 23 Oct 2025 22:08:30 +0300
Subject: [PATCH 072/133] add audio.get_input_devices_names()

---
 src/audio/AL/ALAudio.cpp                  | 22 ++++++++++++++++++++++
 src/audio/AL/ALAudio.hpp                  |  2 ++
 src/audio/NoAudio.hpp                     |  4 ++++
 src/audio/audio.cpp                       | 10 ++++++++++
 src/audio/audio.hpp                       |  5 +++++
 src/logic/scripting/lua/libs/libaudio.cpp | 12 ++++++++++++
 6 files changed, 55 insertions(+)

diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 23dfeaa8..ce73823c 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -479,6 +479,27 @@ std::unique_ptr<Stream> ALAudio::openStream(
     return std::make_unique<ALStream>(this, stream, keepSource);
 }
 
+std::vector<std::string> ALAudio::getInputDeviceNames() {
+    std::vector<std::string> devices;
+    
+    if (alcIsExtensionPresent(nullptr, "ALC_ENUMERATION_EXT")) {
+        auto deviceList = alcGetString(nullptr, ALC_CAPTURE_DEVICE_SPECIFIER);
+        if (deviceList == nullptr) {
+            logger.warning() << "no input devices found";
+            return devices;
+        }
+        while (*deviceList) {
+            std::string deviceName(deviceList);
+            devices.push_back(deviceName);
+            deviceList += deviceName.length() + 1;
+        }
+    } else {
+        logger.warning() << "enumeration extension is not available";
+    }
+    
+    return devices;
+}
+
 std::unique_ptr<InputDevice> ALAudio::openInputDevice(
     uint sampleRate, uint channels, uint bitsPerSample
 ) {
@@ -490,6 +511,7 @@ std::unique_ptr<InputDevice> ALAudio::openInputDevice(
         sampleRate * channels * bps / 8
     );
     check_alc_errors(device, "alcCaptureOpenDevice");
+
     return std::make_unique<ALInputDevice>(
         this, device, channels, bitsPerSample
     );
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index d04d45b6..8e4ad02c 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -186,6 +186,8 @@ namespace audio {
             uint sampleRate, uint channels, uint bitsPerSample
         ) override;
 
+        std::vector<std::string> getInputDeviceNames() override;
+
         void setListener(
             glm::vec3 position,
             glm::vec3 velocity,
diff --git a/src/audio/NoAudio.hpp b/src/audio/NoAudio.hpp
index bc2e6b49..c5dbae41 100644
--- a/src/audio/NoAudio.hpp
+++ b/src/audio/NoAudio.hpp
@@ -82,6 +82,10 @@ namespace audio {
             return nullptr;
         }
 
+        std::vector<std::string> getInputDeviceNames() override {
+            return {};
+        }
+
         void setListener(
             glm::vec3 position, glm::vec3 velocity, glm::vec3 at, glm::vec3 up
         ) override {
diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index b45242bb..72b22df5 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -253,6 +253,16 @@ std::unique_ptr<Stream> audio::open_stream(
     return backend->openStream(std::move(stream), keepSource);
 }
 
+std::unique_ptr<InputDevice> audio::open_input_device(
+    uint sampleRate, uint channels, uint bitsPerSample
+) {
+    return backend->openInputDevice(sampleRate, channels, bitsPerSample);
+}
+
+std::vector<std::string> audio::get_input_devices_names() {
+    return backend->getInputDeviceNames();
+}
+
 void audio::set_listener(
     glm::vec3 position, glm::vec3 velocity, glm::vec3 lookAt, glm::vec3 up
 ) {
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index e1c19d25..3364d89e 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -370,6 +370,7 @@ namespace audio {
             glm::vec3 lookAt,
             glm::vec3 up
         ) = 0;
+        virtual std::vector<std::string> getInputDeviceNames() = 0;
         virtual void update(double delta) = 0;
 
         /// @brief Check if backend is an abstraction that does not internally
@@ -434,6 +435,10 @@ namespace audio {
         uint sampleRate, uint channels, uint bitsPerSample
     );
 
+    /// @brief Retrieve names of available audio input devices
+    /// @return list of device names
+    std::vector<std::string> get_input_devices_names();
+
     /// @brief Configure 3D listener
     /// @param position listener position
     /// @param velocity listener velocity (used for Doppler effect)
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index 7f68bd6d..951522d9 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -408,6 +408,17 @@ static int l_audio_fetch_input(lua::State* L) {
     return lua::create_bytearray(L, std::move(bytes));
 }
 
+static int l_audio_get_input_devices_names(lua::State* L) {
+    auto device_names = audio::get_input_devices_names();
+    lua::createtable(L, device_names.size(), 0);
+    int index = 1;
+    for (const auto& name : device_names) {
+        lua::pushstring(L, name.c_str());
+        lua::rawseti(L, index++);
+    }
+    return 1;
+}
+
 const luaL_Reg audiolib[] = {
     {"play_sound", lua::wrap<l_audio_play_sound>},
     {"play_sound_2d", lua::wrap<l_audio_play_sound_2d>},
@@ -434,5 +445,6 @@ const luaL_Reg audiolib[] = {
     {"count_speakers", lua::wrap<l_audio_count_speakers>},
     {"count_streams", lua::wrap<l_audio_count_streams>},
     {"fetch_input", lua::wrap<l_audio_fetch_input>},
+    {"get_input_devices_names", lua::wrap<l_audio_get_input_devices_names>},
     {nullptr, nullptr}
 };

From 6df27b89921e822311759b837529ea0a91f74cc0 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 23 Oct 2025 22:54:05 +0300
Subject: [PATCH 073/133] add audio.get_output_devices_names, set_input_device,
 set_output_device

---
 src/audio/AL/ALAudio.cpp                  | 114 +++++++++++++++-------
 src/audio/AL/ALAudio.hpp                  |  10 +-
 src/audio/NoAudio.hpp                     |   8 +-
 src/audio/audio.cpp                       |  34 ++++++-
 src/audio/audio.hpp                       |  19 +++-
 src/logic/scripting/lua/libs/libaudio.cpp |  26 +++++
 6 files changed, 169 insertions(+), 42 deletions(-)

diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index ce73823c..9e555133 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -30,13 +30,14 @@ const char* alc_error_to_string(ALCenum error) {
     }
 }
 
-static void check_alc_errors(ALCdevice* device, const char* context) {
+static bool check_alc_errors(ALCdevice* device, const char* context) {
     ALCenum error = alcGetError(device);
     if (error == ALC_NO_ERROR) {
-        return;
+        return false;
     }
     logger.error() << context << ": " << alc_error_to_string(error) << "("
                    << error << ")";
+    return true;
 }
 
 ALSound::ALSound(
@@ -419,6 +420,8 @@ int ALSpeaker::getPriority() const {
     return priority;
 }
 
+static bool alc_enumeration_ext = false;
+
 ALAudio::ALAudio(ALCdevice* device, ALCcontext* context)
     : device(device), context(context) {
     ALCint size;
@@ -431,9 +434,15 @@ ALAudio::ALAudio(ALCdevice* device, ALCcontext* context)
             maxSources = attrs[i + 1];
         }
     }
-    auto devices = getAvailableDevices();
-    logger.info() << "devices:";
-    for (auto& name : devices) {
+    auto outputDevices = getOutputDeviceNames();
+    logger.info() << "output devices:";
+    for (auto& name : outputDevices) {
+        logger.info() << "  " << name;
+    }
+
+    auto inputDevices = getInputDeviceNames();
+    logger.info() << "input devices:";
+    for (auto& name : inputDevices) {
         logger.info() << "  " << name;
     }
 }
@@ -482,35 +491,59 @@ std::unique_ptr<Stream> ALAudio::openStream(
 std::vector<std::string> ALAudio::getInputDeviceNames() {
     std::vector<std::string> devices;
     
-    if (alcIsExtensionPresent(nullptr, "ALC_ENUMERATION_EXT")) {
-        auto deviceList = alcGetString(nullptr, ALC_CAPTURE_DEVICE_SPECIFIER);
-        if (deviceList == nullptr) {
-            logger.warning() << "no input devices found";
-            return devices;
-        }
-        while (*deviceList) {
-            std::string deviceName(deviceList);
-            devices.push_back(deviceName);
-            deviceList += deviceName.length() + 1;
-        }
-    } else {
+    if (!alc_enumeration_ext) {
         logger.warning() << "enumeration extension is not available";
+        return devices;
+    }
+
+    auto deviceList = alcGetString(nullptr, ALC_CAPTURE_DEVICE_SPECIFIER);
+    if (deviceList == nullptr) {
+        logger.warning() << "no input devices found";
+        return devices;
+    }
+    while (*deviceList) {
+        std::string deviceName(deviceList);
+        devices.push_back(deviceName);
+        deviceList += deviceName.length() + 1;
+    }
+    
+    return devices;
+}
+
+std::vector<std::string> ALAudio::getOutputDeviceNames() {
+    std::vector<std::string> devices;
+    
+    if (!alc_enumeration_ext) {
+        logger.warning() << "enumeration extension is not available";
+        return devices;
+    }
+
+    auto deviceList = alcGetString(nullptr, ALC_ALL_DEVICES_SPECIFIER);
+    if (deviceList == nullptr) {
+        logger.warning() << "no input devices found";
+        return devices;
+    }
+    while (*deviceList) {
+        std::string deviceName(deviceList);
+        devices.push_back(deviceName);
+        deviceList += deviceName.length() + 1;
     }
     
     return devices;
 }
 
 std::unique_ptr<InputDevice> ALAudio::openInputDevice(
-    uint sampleRate, uint channels, uint bitsPerSample
+    const char* deviceName, uint sampleRate, uint channels, uint bitsPerSample
 ) {
     uint bps = bitsPerSample >> 3;
     ALCdevice* device = alcCaptureOpenDevice(
-        nullptr,
+        deviceName,
         sampleRate,
         AL::to_al_format(channels, bitsPerSample),
         sampleRate * channels * bps / 8
     );
-    check_alc_errors(device, "alcCaptureOpenDevice");
+    if (check_alc_errors(device, "alcCaptureOpenDevice"))
+        return nullptr;
 
     return std::make_unique<ALInputDevice>(
         this, device, channels, bitsPerSample
@@ -518,6 +551,8 @@ std::unique_ptr<InputDevice> ALAudio::openInputDevice(
 }
 
 std::unique_ptr<ALAudio> ALAudio::create() {
+    alc_enumeration_ext = alcIsExtensionPresent(nullptr, "ALC_ENUMERATION_EXT");
+
     ALCdevice* device = alcOpenDevice(nullptr);
     if (device == nullptr) return nullptr;
     ALCcontext* context = alcCreateContext(device, nullptr);
@@ -574,22 +609,35 @@ void ALAudio::freeBuffer(uint buffer) {
     freebuffers.push_back(buffer);
 }
 
-std::vector<std::string> ALAudio::getAvailableDevices() const {
-    std::vector<std::string> devicesVec;
-
-    const ALCchar* devices;
-    devices = alcGetString(device, ALC_DEVICE_SPECIFIER);
-    if (!AL_GET_ERROR()) {
-        return devicesVec;
+void ALAudio::setOutputDevice(const std::string& deviceName) {
+    ALCdevice* newDevice = alcOpenDevice(deviceName.c_str());
+    if (newDevice == nullptr) {
+        logger.error() << "failed to open output device: " << deviceName;
+        return;
     }
 
-    const char* ptr = devices;
-    do {
-        devicesVec.emplace_back(ptr);
-        ptr += devicesVec.back().size() + 1;
-    } while (ptr[0]);
+    ALCcontext* newContext = alcCreateContext(newDevice, nullptr);
+    if (!alcMakeContextCurrent(newContext)) {
+        logger.error() << "failed to make context current for device: "
+                       << deviceName;
+        alcCloseDevice(newDevice);
+        return;
+    }
 
-    return devicesVec;
+    // Clean up old device and context
+    alcMakeContextCurrent(nullptr);
+    check_alc_errors(device, "alcMakeContextCurrent");
+    alcDestroyContext(context);
+    check_alc_errors(device, "alcDestroyContext");
+    if (!alcCloseDevice(device)) {
+        logger.error() << "old device not closed";
+    }
+
+    // Update to new device and context
+    device = newDevice;
+    context = newContext;
+
+    logger.info() << "switched output device to: " << deviceName;
 }
 
 void ALAudio::setListener(
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index 8e4ad02c..d8fe2000 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -172,8 +172,6 @@ namespace audio {
         void freeSource(uint source);
         void freeBuffer(uint buffer);
 
-        std::vector<std::string> getAvailableDevices() const;
-
         std::unique_ptr<Sound> createSound(
             std::shared_ptr<PCM> pcm, bool keepPCM
         ) override;
@@ -183,11 +181,17 @@ namespace audio {
         ) override;
 
         std::unique_ptr<InputDevice> openInputDevice(
-            uint sampleRate, uint channels, uint bitsPerSample
+            const char* deviceName,
+            uint sampleRate,
+            uint channels,
+            uint bitsPerSample
         ) override;
 
+        std::vector<std::string> getOutputDeviceNames() override;
         std::vector<std::string> getInputDeviceNames() override;
 
+        void setOutputDevice(const std::string& deviceName) override;
+
         void setListener(
             glm::vec3 position,
             glm::vec3 velocity,
diff --git a/src/audio/NoAudio.hpp b/src/audio/NoAudio.hpp
index c5dbae41..a7b4232c 100644
--- a/src/audio/NoAudio.hpp
+++ b/src/audio/NoAudio.hpp
@@ -77,7 +77,7 @@ namespace audio {
         ) override;
 
         std::unique_ptr<InputDevice> openInputDevice(
-            uint sampleRate, uint channels, uint bitsPerSample
+            const char* deviceName, uint sampleRate, uint channels, uint bitsPerSample
         ) override {
             return nullptr;
         }
@@ -85,6 +85,12 @@ namespace audio {
         std::vector<std::string> getInputDeviceNames() override {
             return {};
         }
+        std::vector<std::string> getOutputDeviceNames() override {
+            return {};
+        }
+
+        void setOutputDevice(const std::string& deviceName) override {
+        }
 
         void setListener(
             glm::vec3 position, glm::vec3 velocity, glm::vec3 at, glm::vec3 up
diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index 72b22df5..06a36c06 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -183,7 +183,7 @@ void audio::initialize(bool enabled, AudioSettings& settings) {
         }, true));
     }
 
-    input_device = backend->openInputDevice(44100, 1, 16);
+    input_device = backend->openInputDevice(nullptr, 44100, 1, 16);
     if (input_device) {
         input_device->startCapture();
     }
@@ -254,15 +254,43 @@ std::unique_ptr<Stream> audio::open_stream(
 }
 
 std::unique_ptr<InputDevice> audio::open_input_device(
-    uint sampleRate, uint channels, uint bitsPerSample
+    const char* deviceName, uint sampleRate, uint channels, uint bitsPerSample
 ) {
-    return backend->openInputDevice(sampleRate, channels, bitsPerSample);
+    return backend->openInputDevice(
+        deviceName, sampleRate, channels, bitsPerSample
+    );
 }
 
 std::vector<std::string> audio::get_input_devices_names() {
     return backend->getInputDeviceNames();
 }
 
+std::vector<std::string> audio::get_output_devices_names() {
+    return backend->getOutputDeviceNames();
+}
+
+void audio::set_input_device(const std::string& deviceName) {
+    auto newDevice = backend->openInputDevice(
+        deviceName.empty() ? nullptr : deviceName.c_str(), 44100, 1, 16
+    );
+    if (newDevice == nullptr) {
+        logger.error() << "could not open input device: " << deviceName;
+        return;
+    }
+
+    if (input_device) {
+        input_device->stopCapture();
+    }
+    input_device = std::move(newDevice);
+    if (input_device) {
+        input_device->startCapture();
+    }
+}
+
+void audio::set_output_device(const std::string& deviceName) {
+    backend->setOutputDevice(deviceName);
+}
+
 void audio::set_listener(
     glm::vec3 position, glm::vec3 velocity, glm::vec3 lookAt, glm::vec3 up
 ) {
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index 3364d89e..47fab4f5 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -362,7 +362,10 @@ namespace audio {
             std::shared_ptr<PCMStream> stream, bool keepSource
         ) = 0;
         virtual std::unique_ptr<InputDevice> openInputDevice(
-            uint sampleRate, uint channels, uint bitsPerSample
+            const char* deviceName,
+            uint sampleRate,
+            uint channels,
+            uint bitsPerSample
         ) = 0;
         virtual void setListener(
             glm::vec3 position,
@@ -371,6 +374,8 @@ namespace audio {
             glm::vec3 up
         ) = 0;
         virtual std::vector<std::string> getInputDeviceNames() = 0;
+        virtual std::vector<std::string> getOutputDeviceNames() = 0;
+        virtual void setOutputDevice(const std::string& deviceName) = 0;
         virtual void update(double delta) = 0;
 
         /// @brief Check if backend is an abstraction that does not internally
@@ -432,13 +437,23 @@ namespace audio {
     /// @param bitsPerSample number of bits per sample (8 or 16)
     /// @return new InputDevice instance or nullptr
     std::unique_ptr<InputDevice> open_input_device(
-        uint sampleRate, uint channels, uint bitsPerSample
+        const char* deviceName,
+        uint sampleRate,
+        uint channels,
+        uint bitsPerSample
     );
 
     /// @brief Retrieve names of available audio input devices
     /// @return list of device names
     std::vector<std::string> get_input_devices_names();
 
+    /// @brief Retrieve names of available audio output devices
+    /// @return list of device names
+    std::vector<std::string> get_output_devices_names();
+
+    void set_input_device(const std::string& deviceName);
+    void set_output_device(const std::string& deviceName);
+
     /// @brief Configure 3D listener
     /// @param position listener position
     /// @param velocity listener velocity (used for Doppler effect)
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index 951522d9..d240ec2e 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -419,6 +419,29 @@ static int l_audio_get_input_devices_names(lua::State* L) {
     return 1;
 }
 
+static int l_audio_get_output_devices_names(lua::State* L) {
+    auto device_names = audio::get_output_devices_names();
+    lua::createtable(L, device_names.size(), 0);
+    int index = 1;
+    for (const auto& name : device_names) {
+        lua::pushstring(L, name.c_str());
+        lua::rawseti(L, index++);
+    }
+    return 1;
+}
+
+static int l_audio_set_input_device(lua::State* L) {
+    auto device_name = lua::tostring(L, 1);
+    audio::set_input_device(device_name);
+    return 0;
+}
+
+static int l_audio_set_output_device(lua::State* L) {
+    auto device_name = lua::tostring(L, 1);
+    audio::set_output_device(device_name);
+    return 0;
+}
+
 const luaL_Reg audiolib[] = {
     {"play_sound", lua::wrap<l_audio_play_sound>},
     {"play_sound_2d", lua::wrap<l_audio_play_sound_2d>},
@@ -446,5 +469,8 @@ const luaL_Reg audiolib[] = {
     {"count_streams", lua::wrap<l_audio_count_streams>},
     {"fetch_input", lua::wrap<l_audio_fetch_input>},
     {"get_input_devices_names", lua::wrap<l_audio_get_input_devices_names>},
+    {"get_output_devices_names", lua::wrap<l_audio_get_output_devices_names>},
+    {"set_input_device", lua::wrap<l_audio_set_input_device>},
+    {"set_output_device", lua::wrap<l_audio_set_output_device>},
     {nullptr, nullptr}
 };

From 001c1b430bddd728ec5add68ec802902f075760a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 23 Oct 2025 23:45:55 +0300
Subject: [PATCH 074/133] minor refactor

---
 src/audio/AL/ALAudio.cpp | 4 ++--
 src/audio/AL/ALAudio.hpp | 2 +-
 src/audio/NoAudio.hpp    | 2 +-
 src/audio/audio.cpp      | 8 +++-----
 src/audio/audio.hpp      | 4 ++--
 5 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 9e555133..4215f3a1 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -533,11 +533,11 @@ std::vector<std::string> ALAudio::getOutputDeviceNames() {
 }
 
 std::unique_ptr<InputDevice> ALAudio::openInputDevice(
-    const char* deviceName, uint sampleRate, uint channels, uint bitsPerSample
+    const std::string& deviceName, uint sampleRate, uint channels, uint bitsPerSample
 ) {
     uint bps = bitsPerSample >> 3;
     ALCdevice* device = alcCaptureOpenDevice(
-        deviceName,
+        deviceName.empty() ? nullptr : deviceName.c_str(),
         sampleRate,
         AL::to_al_format(channels, bitsPerSample),
         sampleRate * channels * bps / 8
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index d8fe2000..99ca7be1 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -181,7 +181,7 @@ namespace audio {
         ) override;
 
         std::unique_ptr<InputDevice> openInputDevice(
-            const char* deviceName,
+            const std::string& deviceName,
             uint sampleRate,
             uint channels,
             uint bitsPerSample
diff --git a/src/audio/NoAudio.hpp b/src/audio/NoAudio.hpp
index a7b4232c..cc0c240d 100644
--- a/src/audio/NoAudio.hpp
+++ b/src/audio/NoAudio.hpp
@@ -77,7 +77,7 @@ namespace audio {
         ) override;
 
         std::unique_ptr<InputDevice> openInputDevice(
-            const char* deviceName, uint sampleRate, uint channels, uint bitsPerSample
+            const std::string& deviceName, uint sampleRate, uint channels, uint bitsPerSample
         ) override {
             return nullptr;
         }
diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index 06a36c06..313deed8 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -183,7 +183,7 @@ void audio::initialize(bool enabled, AudioSettings& settings) {
         }, true));
     }
 
-    input_device = backend->openInputDevice(nullptr, 44100, 1, 16);
+    input_device = backend->openInputDevice("", 44100, 1, 16);
     if (input_device) {
         input_device->startCapture();
     }
@@ -254,7 +254,7 @@ std::unique_ptr<Stream> audio::open_stream(
 }
 
 std::unique_ptr<InputDevice> audio::open_input_device(
-    const char* deviceName, uint sampleRate, uint channels, uint bitsPerSample
+    const std::string& deviceName, uint sampleRate, uint channels, uint bitsPerSample
 ) {
     return backend->openInputDevice(
         deviceName, sampleRate, channels, bitsPerSample
@@ -270,9 +270,7 @@ std::vector<std::string> audio::get_output_devices_names() {
 }
 
 void audio::set_input_device(const std::string& deviceName) {
-    auto newDevice = backend->openInputDevice(
-        deviceName.empty() ? nullptr : deviceName.c_str(), 44100, 1, 16
-    );
+    auto newDevice = backend->openInputDevice(deviceName, 44100, 1, 16);
     if (newDevice == nullptr) {
         logger.error() << "could not open input device: " << deviceName;
         return;
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index 47fab4f5..8b3a1326 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -362,7 +362,7 @@ namespace audio {
             std::shared_ptr<PCMStream> stream, bool keepSource
         ) = 0;
         virtual std::unique_ptr<InputDevice> openInputDevice(
-            const char* deviceName,
+            const std::string& deviceName,
             uint sampleRate,
             uint channels,
             uint bitsPerSample
@@ -437,7 +437,7 @@ namespace audio {
     /// @param bitsPerSample number of bits per sample (8 or 16)
     /// @return new InputDevice instance or nullptr
     std::unique_ptr<InputDevice> open_input_device(
-        const char* deviceName,
+        const std::string& deviceName,
         uint sampleRate,
         uint channels,
         uint bitsPerSample

From 6c558eb3d5128e31dd89ac6ebd2a22549470af1a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 24 Oct 2025 01:19:07 +0300
Subject: [PATCH 075/133] add audio.get_input_info()

---
 src/audio/AL/ALAudio.cpp                  | 22 +++++++++++++++++++---
 src/audio/AL/ALAudio.hpp                  |  9 ++++++++-
 src/audio/audio.hpp                       |  6 ++++++
 src/logic/scripting/lua/libs/libaudio.cpp | 16 ++++++++++++++++
 4 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 4215f3a1..28877485 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -68,9 +68,17 @@ std::unique_ptr<Speaker> ALSound::newInstance(int priority, int channel) const {
 }
 
 ALInputDevice::ALInputDevice(
-    ALAudio* al, ALCdevice* device, uint channels, uint bitsPerSample
+    ALAudio* al,
+    ALCdevice* device,
+    uint channels,
+    uint bitsPerSample,
+    uint sampleRate
 )
-    : al(al), device(device), channels(channels), bitsPerSample(bitsPerSample) {
+    : al(al),
+      device(device),
+      channels(channels),
+      bitsPerSample(bitsPerSample),
+      sampleRate(sampleRate) {
 }
 
 ALInputDevice::~ALInputDevice() {
@@ -92,6 +100,14 @@ uint ALInputDevice::getChannels() const {
     return channels;
 }
 
+uint ALInputDevice::getSampleRate() const {
+    return sampleRate;
+}
+
+uint ALInputDevice::getBitsPerSample() const {
+    return bitsPerSample;
+}
+
 size_t ALInputDevice::read(char* buffer, size_t bufferSize) {
     ALCint samplesCount = 0;
     alcGetIntegerv(device, ALC_CAPTURE_SAMPLES, sizeof(samplesCount), &samplesCount);
@@ -546,7 +562,7 @@ std::unique_ptr<InputDevice> ALAudio::openInputDevice(
         return nullptr;
 
     return std::make_unique<ALInputDevice>(
-        this, device, channels, bitsPerSample
+        this, device, channels, bitsPerSample, sampleRate
     );
 }
 
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index 99ca7be1..3c108b6f 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -85,7 +85,11 @@ namespace audio {
     class ALInputDevice : public InputDevice {
     public:
         ALInputDevice(
-            ALAudio* al, ALCdevice* device, uint channels, uint bitsPerSample
+            ALAudio* al,
+            ALCdevice* device,
+            uint channels,
+            uint bitsPerSample,
+            uint sampleRate
         );
         ~ALInputDevice() override;
 
@@ -93,6 +97,8 @@ namespace audio {
         void stopCapture() override;
 
         uint getChannels() const override;
+        uint getSampleRate() const override;
+        uint getBitsPerSample() const override;
 
         size_t read(char* buffer, size_t bufferSize) override;
     private:
@@ -100,6 +106,7 @@ namespace audio {
         ALCdevice* device;
         uint channels;
         uint bitsPerSample;
+        uint sampleRate;
     };
 
     /// @brief AL source adapter
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index 8b3a1326..dd648027 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -120,6 +120,12 @@ namespace audio {
         /// @brief Get number of audio channels
         /// @return 1 if mono, 2 if stereo
         virtual uint getChannels() const = 0;
+        /// @brief Get audio sampling frequency
+        /// @return number of mono samples per second
+        virtual uint getSampleRate() const = 0;
+        /// @brief Get number of bits per mono sample
+        /// @return 8 or 16
+        virtual uint getBitsPerSample() const = 0;
 
         virtual size_t read(char* buffer, size_t bufferSize) = 0;
     };
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index d240ec2e..4551af0b 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -442,6 +442,21 @@ static int l_audio_set_output_device(lua::State* L) {
     return 0;
 }
 
+static int l_audio_get_input_info(lua::State* L) {
+    auto device = audio::get_input_device();
+    if (device == nullptr) {
+        return 0;
+    }
+    lua::createtable(L, 0, 3);
+    lua::pushinteger(L, device->getChannels());
+    lua::setfield(L, "channels");
+    lua::pushinteger(L, device->getSampleRate());
+    lua::setfield(L, "sample_rate");
+    lua::pushinteger(L, device->getBitsPerSample());
+    lua::setfield(L, "bits_per_sample");
+    return 1;
+}
+
 const luaL_Reg audiolib[] = {
     {"play_sound", lua::wrap<l_audio_play_sound>},
     {"play_sound_2d", lua::wrap<l_audio_play_sound_2d>},
@@ -472,5 +487,6 @@ const luaL_Reg audiolib[] = {
     {"get_output_devices_names", lua::wrap<l_audio_get_output_devices_names>},
     {"set_input_device", lua::wrap<l_audio_set_input_device>},
     {"set_output_device", lua::wrap<l_audio_set_output_device>},
+    {"get_input_info", lua::wrap<l_audio_get_input_info>},
     {nullptr, nullptr}
 };

From ab7bf9c709108e29916cf36fa69932ec202c414b Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 24 Oct 2025 23:10:16 +0300
Subject: [PATCH 076/133] cleanup

---
 src/audio/AL/ALAudio.cpp                  | 31 -----------------------
 src/audio/AL/ALAudio.hpp                  |  2 --
 src/audio/NoAudio.hpp                     |  3 ---
 src/audio/audio.cpp                       |  4 ---
 src/audio/audio.hpp                       |  2 --
 src/logic/scripting/lua/libs/libaudio.cpp |  7 -----
 6 files changed, 49 deletions(-)

diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 28877485..267b20dd 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -625,37 +625,6 @@ void ALAudio::freeBuffer(uint buffer) {
     freebuffers.push_back(buffer);
 }
 
-void ALAudio::setOutputDevice(const std::string& deviceName) {
-    ALCdevice* newDevice = alcOpenDevice(deviceName.c_str());
-    if (newDevice == nullptr) {
-        logger.error() << "failed to open output device: " << deviceName;
-        return;
-    }
-
-    ALCcontext* newContext = alcCreateContext(newDevice, nullptr);
-    if (!alcMakeContextCurrent(newContext)) {
-        logger.error() << "failed to make context current for device: "
-                       << deviceName;
-        alcCloseDevice(newDevice);
-        return;
-    }
-
-    // Clean up old device and context
-    alcMakeContextCurrent(nullptr);
-    check_alc_errors(device, "alcMakeContextCurrent");
-    alcDestroyContext(context);
-    check_alc_errors(device, "alcDestroyContext");
-    if (!alcCloseDevice(device)) {
-        logger.error() << "old device not closed";
-    }
-
-    // Update to new device and context
-    device = newDevice;
-    context = newContext;
-
-    logger.info() << "switched output device to: " << deviceName;
-}
-
 void ALAudio::setListener(
     glm::vec3 position, glm::vec3 velocity, glm::vec3 at, glm::vec3 up
 ) {
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index 3c108b6f..6fef62f0 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -197,8 +197,6 @@ namespace audio {
         std::vector<std::string> getOutputDeviceNames() override;
         std::vector<std::string> getInputDeviceNames() override;
 
-        void setOutputDevice(const std::string& deviceName) override;
-
         void setListener(
             glm::vec3 position,
             glm::vec3 velocity,
diff --git a/src/audio/NoAudio.hpp b/src/audio/NoAudio.hpp
index cc0c240d..5012704b 100644
--- a/src/audio/NoAudio.hpp
+++ b/src/audio/NoAudio.hpp
@@ -89,9 +89,6 @@ namespace audio {
             return {};
         }
 
-        void setOutputDevice(const std::string& deviceName) override {
-        }
-
         void setListener(
             glm::vec3 position, glm::vec3 velocity, glm::vec3 at, glm::vec3 up
         ) override {
diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index 313deed8..60f44b04 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -285,10 +285,6 @@ void audio::set_input_device(const std::string& deviceName) {
     }
 }
 
-void audio::set_output_device(const std::string& deviceName) {
-    backend->setOutputDevice(deviceName);
-}
-
 void audio::set_listener(
     glm::vec3 position, glm::vec3 velocity, glm::vec3 lookAt, glm::vec3 up
 ) {
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index dd648027..c394398f 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -381,7 +381,6 @@ namespace audio {
         ) = 0;
         virtual std::vector<std::string> getInputDeviceNames() = 0;
         virtual std::vector<std::string> getOutputDeviceNames() = 0;
-        virtual void setOutputDevice(const std::string& deviceName) = 0;
         virtual void update(double delta) = 0;
 
         /// @brief Check if backend is an abstraction that does not internally
@@ -458,7 +457,6 @@ namespace audio {
     std::vector<std::string> get_output_devices_names();
 
     void set_input_device(const std::string& deviceName);
-    void set_output_device(const std::string& deviceName);
 
     /// @brief Configure 3D listener
     /// @param position listener position
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index 4551af0b..ed2e3db6 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -436,12 +436,6 @@ static int l_audio_set_input_device(lua::State* L) {
     return 0;
 }
 
-static int l_audio_set_output_device(lua::State* L) {
-    auto device_name = lua::tostring(L, 1);
-    audio::set_output_device(device_name);
-    return 0;
-}
-
 static int l_audio_get_input_info(lua::State* L) {
     auto device = audio::get_input_device();
     if (device == nullptr) {
@@ -486,7 +480,6 @@ const luaL_Reg audiolib[] = {
     {"get_input_devices_names", lua::wrap<l_audio_get_input_devices_names>},
     {"get_output_devices_names", lua::wrap<l_audio_get_output_devices_names>},
     {"set_input_device", lua::wrap<l_audio_set_input_device>},
-    {"set_output_device", lua::wrap<l_audio_set_output_device>},
     {"get_input_info", lua::wrap<l_audio_get_input_info>},
     {nullptr, nullptr}
 };

From cf561e78a81810fcb70975c7b785938af37b4b64 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 30 Oct 2025 19:56:07 +0300
Subject: [PATCH 077/133] fix: stream stops and dies on underflow

---
 res/scripts/hud.lua      |  9 +-------
 src/audio/AL/ALAudio.cpp | 46 ++++++++++++++++++++++++++--------------
 src/audio/AL/ALAudio.hpp |  9 +++++++-
 src/audio/NoAudio.hpp    |  7 ++++++
 src/audio/audio.cpp      | 11 ++++++++--
 src/audio/audio.hpp      |  5 +++++
 6 files changed, 60 insertions(+), 27 deletions(-)

diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index ba828491..7730ba5f 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -121,14 +121,7 @@ function on_hud_open()
 
     stream = PCMStream(44100, 1, 16)
     stream:share("test-stream")
-    local bytes = Bytearray(44100 / 8)
-    for i=1,#bytes do
-        local x = math.sin(i * 0.08) * 1 + 0
-        bytes[i] = x
-    end
-    stream:feed(bytes)
-
-    audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
+    streamid = audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
 end
 
 function on_hud_render()
diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 267b20dd..83d5c4f4 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -164,9 +164,10 @@ std::unique_ptr<Speaker> ALStream::createSpeaker(bool loop, int channel) {
     for (uint i = 0; i < ALStream::STREAM_BUFFERS; i++) {
         uint free_buffer = al->getFreeBuffer();
         if (!preloadBuffer(free_buffer, loop)) {
-            break;
+            unusedBuffers.push(free_buffer);
+        } else {
+            AL_CHECK(alSourceQueueBuffers(free_source, 1, &free_buffer));
         }
-        AL_CHECK(alSourceQueueBuffers(free_source, 1, &free_buffer));
     }
     return std::make_unique<ALSpeaker>(al, free_source, PRIORITY_HIGH, channel);
 }
@@ -213,11 +214,11 @@ void ALStream::unqueueBuffers(uint alsource) {
 uint ALStream::enqueueBuffers(uint alsource) {
     uint preloaded = 0;
     if (!unusedBuffers.empty()) {
-        uint first_buffer = unusedBuffers.front();
-        if (preloadBuffer(first_buffer, loop)) {
+        uint firstBuffer = unusedBuffers.front();
+        if (preloadBuffer(firstBuffer, loop)) {
             preloaded++;
             unusedBuffers.pop();
-            AL_CHECK(alSourceQueueBuffers(alsource, 1, &first_buffer));
+            AL_CHECK(alSourceQueueBuffers(alsource, 1, &firstBuffer));
         }
     }
     return preloaded;
@@ -227,14 +228,14 @@ void ALStream::update(double delta) {
     if (this->speaker == 0) {
         return;
     }
-    auto p_speaker = audio::get_speaker(this->speaker);
-    if (p_speaker == nullptr) {
+    auto speaker = audio::get_speaker(this->speaker);
+    if (speaker == nullptr) {
         this->speaker = 0;
         return;
     }
-    ALSpeaker* alspeaker = dynamic_cast<ALSpeaker*>(p_speaker);
+    ALSpeaker* alspeaker = dynamic_cast<ALSpeaker*>(speaker);
     assert(alspeaker != nullptr);
-    if (alspeaker->stopped) {
+    if (alspeaker->manuallyStopped) {
         this->speaker = 0;
         return;
     }
@@ -245,11 +246,11 @@ void ALStream::update(double delta) {
     uint preloaded = enqueueBuffers(alsource);
 
     // alspeaker->stopped is assigned to false at ALSpeaker::play(...)
-    if (p_speaker->isStopped() && !alspeaker->stopped) { //TODO: -V560 false-positive?
-        if (preloaded || dynamic_cast<MemoryPCMStream*>(source.get())) {
-            p_speaker->play();
-        } else {
-            p_speaker->stop();
+    if (speaker->isStopped() && !alspeaker->manuallyStopped) { //TODO: -V560 false-positive?
+        if (preloaded) {
+            speaker->play();
+        } else if (isStopOnEnd()){
+            speaker->stop();
         }
     }
 }
@@ -290,6 +291,14 @@ void ALStream::setTime(duration_t time) {
     }
 }
 
+bool ALStream::isStopOnEnd() const {
+    return stopOnEnd;
+}
+
+void ALStream::setStopOnEnd(bool flag) {
+    stopOnEnd = flag;
+}
+
 ALSpeaker::ALSpeaker(ALAudio* al, uint source, int priority, int channel)
     : al(al), priority(priority), channel(channel), source(source) {
 }
@@ -356,7 +365,7 @@ void ALSpeaker::setLoop(bool loop) {
 
 void ALSpeaker::play() {
     paused = false;
-    stopped = false;
+    manuallyStopped = false;
     auto p_channel = get_channel(this->channel);
     AL_CHECK(alSourcef(
         source,
@@ -372,7 +381,7 @@ void ALSpeaker::pause() {
 }
 
 void ALSpeaker::stop() {
-    stopped = true;
+    manuallyStopped = true;
     if (source) {
         AL_CHECK(alSourceStop(source));
 
@@ -436,6 +445,11 @@ int ALSpeaker::getPriority() const {
     return priority;
 }
 
+
+bool ALSpeaker::isManuallyStopped() const {
+    return manuallyStopped;
+}
+
 static bool alc_enumeration_ext = false;
 
 ALAudio::ALAudio(ALCdevice* device, ALCcontext* context)
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index 6fef62f0..39e6f337 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -58,6 +58,7 @@ namespace audio {
         bool keepSource;
         char buffer[BUFFER_SIZE];
         bool loop = false;
+        bool stopOnEnd = false;
 
         bool preloadBuffer(uint buffer, bool loop);
         void unqueueBuffers(uint alsource);
@@ -80,6 +81,10 @@ namespace audio {
         void setTime(duration_t time) override;
 
         static inline constexpr uint STREAM_BUFFERS = 3;
+
+        bool isStopOnEnd() const override;
+        
+        void setStopOnEnd(bool stopOnEnd) override;
     };
 
     class ALInputDevice : public InputDevice {
@@ -117,7 +122,7 @@ namespace audio {
         float volume = 0.0f;
     public:
         ALStream* stream = nullptr;
-        bool stopped = true;
+        bool manuallyStopped = true;
         bool paused = false;
         uint source;
         duration_t duration = 0.0f;
@@ -157,6 +162,8 @@ namespace audio {
         bool isRelative() const override;
 
         int getPriority() const override;
+
+        bool isManuallyStopped() const override;
     };
 
     class ALAudio : public Backend {
diff --git a/src/audio/NoAudio.hpp b/src/audio/NoAudio.hpp
index 5012704b..0da1b4d6 100644
--- a/src/audio/NoAudio.hpp
+++ b/src/audio/NoAudio.hpp
@@ -61,6 +61,13 @@ namespace audio {
 
         void setTime(duration_t time) override {
         }
+
+        bool isStopOnEnd() const override {
+            return false;
+        }
+
+        void setStopOnEnd(bool stopOnEnd) override {
+        }
     };
 
     class NoAudio : public Backend {
diff --git a/src/audio/audio.cpp b/src/audio/audio.cpp
index 60f44b04..0069ff12 100644
--- a/src/audio/audio.cpp
+++ b/src/audio/audio.cpp
@@ -464,8 +464,15 @@ void audio::update(double delta) {
             speaker->update(channel);
         }
         if (speaker->isStopped()) {
-            streams.erase(it->first);
-            it = speakers.erase(it);
+            auto foundStream = streams.find(it->first);
+            if (foundStream == streams.end() ||
+                (!speaker->isManuallyStopped() &&
+                 foundStream->second->isStopOnEnd())) {
+                streams.erase(it->first);
+                it = speakers.erase(it);
+            } else {
+                it++;
+            }
         } else {
             it++;
         }
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index c394398f..551fd7ec 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -221,6 +221,9 @@ namespace audio {
         /// @brief Set playhead to the selected time
         /// @param time selected time
         virtual void setTime(duration_t time) = 0;
+
+        virtual bool isStopOnEnd() const = 0;
+        virtual void setStopOnEnd(bool stopOnEnd) = 0;
     };
 
     /// @brief Sound is an audio asset that supposed to support many
@@ -355,6 +358,8 @@ namespace audio {
         inline bool isStopped() const {
             return getState() == State::stopped;
         }
+
+        virtual bool isManuallyStopped() const = 0;
     };
 
     class Backend {

From be2dc1abe54f896864fa2354ee3d17ae57a39f2e Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 30 Oct 2025 22:48:53 +0300
Subject: [PATCH 078/133] add PCMStream:create_sound method

---
 res/scripts/hud.lua                           | 10 +++++++
 src/audio/MemoryPCMStream.cpp                 |  4 +++
 src/audio/MemoryPCMStream.hpp                 |  2 ++
 .../lua/usertypes/lua_type_pcmstream.cpp      | 26 +++++++++++++++++++
 4 files changed, 42 insertions(+)

diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index 7730ba5f..a5aad766 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -122,6 +122,16 @@ function on_hud_open()
     stream = PCMStream(44100, 1, 16)
     stream:share("test-stream")
     streamid = audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
+
+
+    s = PCMStream(44100, 1, 8)
+    local buffer = Bytearray(44100)
+    for i=1, #buffer do
+        buffer[i] = math.random(1, 8)
+    end
+    s:feed(buffer)
+    s:create_sound("test-sound")
+    audio.play_sound_2d("test-sound", 2.0, 1.0, "ui")
 end
 
 function on_hud_render()
diff --git a/src/audio/MemoryPCMStream.cpp b/src/audio/MemoryPCMStream.cpp
index 7fcf4b0c..e0f40d5e 100644
--- a/src/audio/MemoryPCMStream.cpp
+++ b/src/audio/MemoryPCMStream.cpp
@@ -61,3 +61,7 @@ bool MemoryPCMStream::isSeekable() const {
 }
 
 void MemoryPCMStream::seek(size_t position) {}
+
+size_t MemoryPCMStream::available() const {
+    return buffer.size();
+}
diff --git a/src/audio/MemoryPCMStream.hpp b/src/audio/MemoryPCMStream.hpp
index 1f94d27e..bef2a05b 100644
--- a/src/audio/MemoryPCMStream.hpp
+++ b/src/audio/MemoryPCMStream.hpp
@@ -31,6 +31,8 @@ namespace audio {
         bool isSeekable() const override;
 
         void seek(size_t position) override;
+
+        size_t available() const;
     private:
         uint sampleRate;
         uint channels;
diff --git a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
index 3367813e..a4a13ea4 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.cpp
@@ -44,9 +44,35 @@ static int l_share(lua::State* L) {
     return 0;
 }
 
+static int l_create_sound(lua::State* L) {
+    auto stream = touserdata<LuaPCMStream>(L, 1);
+    if (stream == nullptr) {
+        return 0;
+    }
+    auto alias = require_lstring(L, 2);
+    auto memoryStream = stream->getStream();
+
+    std::vector<char> buffer(memoryStream->available());
+    memoryStream->readFully(buffer.data(), buffer.size(), true);
+    
+    auto pcm = std::make_shared<PCM>(
+        std::move(buffer),
+        0,
+        memoryStream->getChannels(),
+        static_cast<uint8_t>(memoryStream->getBitsPerSample()),
+        memoryStream->getSampleRate(),
+        memoryStream->isSeekable()
+    );
+    auto sound = audio::create_sound(std::move(pcm), true);
+    auto assets = engine->getAssets();
+    assets->store<audio::Sound>(std::move(sound), std::string(alias));
+    return 0;
+}
+
 static std::unordered_map<std::string, lua_CFunction> methods {
     {"feed", lua::wrap<l_feed>},
     {"share", lua::wrap<l_share>},
+    {"create_sound", lua::wrap<l_create_sound>},
 };
 
 static int l_meta_meta_call(lua::State* L) {

From 0e2b203fb2ad4ec508598abdd76ea2cf874340e7 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 31 Oct 2025 22:53:04 +0300
Subject: [PATCH 079/133] add debug.get_pack_by_frame

---
 res/scripts/stdmin.lua | 80 +++++++++++++++++++++++-------------------
 1 file changed, 43 insertions(+), 37 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index df5c7ce2..4e01e22a 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -1,3 +1,40 @@
+function crc32(bytes, chksum)
+    local chksum = chksum or 0
+
+    local length = #bytes
+    if type(bytes) == "table" then
+        local buffer_len = _ffi.new('int[1]', length)
+        local buffer = _ffi.new(
+            string.format("char[%s]", length)
+        )
+        for i=1, length do
+            buffer[i - 1] = bytes[i]
+        end
+        bytes = _ffi.string(buffer, buffer_len[0])
+    end
+    return _crc32(bytes, chksum)
+end
+
+-- Check if given table is an array
+function is_array(x)
+    if #x > 0 then
+        return true
+    end
+    for k, v in pairs(x) do
+        return false
+    end
+    return true
+end
+
+-- Get entry-point and filename from `entry-point:filename` path 
+function parse_path(path)
+    local index = string.find(path, ':')
+    if index == nil then
+        error("invalid path syntax (':' missing)")
+    end
+    return string.sub(path, 1, index-1), string.sub(path, index+1, -1)
+end
+
 local breakpoints = {}
 local dbg_steps_mode = false
 local dbg_step_into_func = false
@@ -5,6 +42,7 @@ local hook_lock = false
 local current_func
 local current_func_stack_size
 
+local __parse_path = parse_path
 local _debug_getinfo = debug.getinfo
 local _debug_getlocal = debug.getlocal
 local __pause = debug.pause
@@ -74,6 +112,11 @@ local __sendvalue = debug.__sendvalue
 debug.__pull_events = nil
 debug.__sendvalue = nil
 
+function debug.get_pack_by_frame(func)
+    local prefix, _ = __parse_path(_debug_getinfo(func, "S").source)
+    return prefix
+end
+
 function debug.pull_events()
     if not is_debugging then
         return
@@ -194,43 +237,6 @@ function __vc_Canvas_set_data(self, data)
     self:_set_data(tostring(_ffi.cast("uintptr_t", canvas_ffi_buffer)))
 end
 
-function crc32(bytes, chksum)
-    local chksum = chksum or 0
-
-    local length = #bytes
-    if type(bytes) == "table" then
-        local buffer_len = _ffi.new('int[1]', length)
-        local buffer = _ffi.new(
-            string.format("char[%s]", length)
-        )
-        for i=1, length do
-            buffer[i - 1] = bytes[i]
-        end
-        bytes = _ffi.string(buffer, buffer_len[0])
-    end
-    return _crc32(bytes, chksum)
-end
-
--- Check if given table is an array
-function is_array(x)
-    if #x > 0 then
-        return true
-    end
-    for k, v in pairs(x) do
-        return false
-    end
-    return true
-end
-
--- Get entry-point and filename from `entry-point:filename` path 
-function parse_path(path)
-    local index = string.find(path, ':')
-    if index == nil then
-        error("invalid path syntax (':' missing)")
-    end
-    return string.sub(path, 1, index-1), string.sub(path, index+1, -1)
-end
-
 function pack.is_installed(packid)
     return file.isfile(packid..":package.json")
 end

From 284f24433c15fe3e6fca24468b418f7885f8be0a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 31 Oct 2025 23:18:26 +0300
Subject: [PATCH 080/133] extract debugging code to internal/debugging module

---
 res/modules/internal/debugging.lua   | 146 +++++++++++++++++++++++++
 res/scripts/stdlib.lua               |   6 +-
 res/scripts/stdmin.lua               | 152 +--------------------------
 src/logic/scripting/lua/lua_util.cpp |  10 +-
 4 files changed, 157 insertions(+), 157 deletions(-)
 create mode 100644 res/modules/internal/debugging.lua

diff --git a/res/modules/internal/debugging.lua b/res/modules/internal/debugging.lua
new file mode 100644
index 00000000..cef40202
--- /dev/null
+++ b/res/modules/internal/debugging.lua
@@ -0,0 +1,146 @@
+local breakpoints = {}
+local dbg_steps_mode = false
+local dbg_step_into_func = false
+local hook_lock = false
+local current_func
+local current_func_stack_size
+
+local __parse_path = parse_path
+local _debug_getinfo = debug.getinfo
+local _debug_getlocal = debug.getlocal
+local __pause = debug.pause
+local __error = error
+local __sethook = debug.sethook
+
+-- 'return' hook not called for some functions
+-- todo: speedup
+local function calc_stack_size()
+    local s = debug.traceback("", 2)
+    local count = 0
+    for i in s:gmatch("\n") do
+        count = count + 1
+    end
+    return count
+end
+
+local is_debugging = debug.is_debugging()
+if is_debugging then
+    __sethook(function (e, line)
+        if e == "return" then
+            local info = _debug_getinfo(2)
+            if info.func == current_func then
+                current_func = nil
+            end
+        end
+        if dbg_steps_mode and not hook_lock then
+            hook_lock = true
+
+            if not dbg_step_into_func then
+                local func = _debug_getinfo(2).func
+                if func ~= current_func then
+                    return
+                end
+                if current_func_stack_size ~= calc_stack_size() then
+                    return
+                end
+            end
+            current_func = func
+            __pause("step")
+            debug.pull_events()
+        end
+        hook_lock = false
+        local bps = breakpoints[line]
+        if not bps then
+            return
+        end
+        local source = _debug_getinfo(2).source
+        if not bps[source] then
+            return
+        end
+        current_func = _debug_getinfo(2).func
+        current_func_stack_size = calc_stack_size()
+        __pause("breakpoint")
+        debug.pull_events()
+    end, "lr")
+end
+
+local DBG_EVENT_SET_BREAKPOINT = 1
+local DBG_EVENT_RM_BREAKPOINT = 2
+local DBG_EVENT_STEP = 3
+local DBG_EVENT_STEP_INTO_FUNCTION = 4
+local DBG_EVENT_RESUME = 5
+local DBG_EVENT_GET_VALUE = 6
+local __pull_events = debug.__pull_events
+local __sendvalue = debug.__sendvalue
+debug.__pull_events = nil
+debug.__sendvalue = nil
+
+function debug.get_pack_by_frame(func)
+    local prefix, _ = __parse_path(_debug_getinfo(func, "S").source)
+    return prefix
+end
+
+function debug.pull_events()
+    if not is_debugging then
+        return
+    end
+    if not debug.is_debugging() then
+        is_debugging = false
+        __sethook()
+    end
+    local events = __pull_events()
+    if not events then
+        return
+    end
+    for i, event in ipairs(events) do
+        if event[1] == DBG_EVENT_SET_BREAKPOINT then
+            debug.set_breakpoint(event[2], event[3])
+        elseif event[1] == DBG_EVENT_RM_BREAKPOINT then
+            debug.remove_breakpoint(event[2], event[3])
+        elseif event[1] == DBG_EVENT_STEP then
+            dbg_steps_mode = true
+            dbg_step_into_func = false
+        elseif event[1] == DBG_EVENT_STEP_INTO_FUNCTION then
+            dbg_steps_mode = true
+            dbg_step_into_func = true
+        elseif event[1] == DBG_EVENT_RESUME then
+            dbg_steps_mode = false
+            dbg_step_into_func = false
+        elseif event[1] == DBG_EVENT_GET_VALUE then
+            local _, value = _debug_getlocal(event[2] + 3, event[3])
+            for _, key in ipairs(event[4]) do
+                if value == nil then
+                    value = "error: index nil value"
+                    break
+                end
+                value = value[key]
+            end
+            __sendvalue(value, event[2], event[3], event[4])
+            __pause()
+        end
+    end
+end
+
+function debug.set_breakpoint(source, line)
+    local bps = breakpoints[line]
+    if not bps then
+        bps = {}
+        breakpoints[line] = bps
+    end
+    bps[source] = true
+end
+
+function debug.remove_breakpoint(source, line)
+    local bps = breakpoints[line]
+    if not bps then
+        return
+    end
+    bps[source] = nil
+end
+
+function error(message, level)
+    if is_debugging then
+        __pause("exception", message)
+    end
+    __error(message, level)
+end
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 3f732e07..cb25150b 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -177,10 +177,8 @@ function inventory.set_description(invid, slot, description)
     inventory.set_data(invid, slot, "description", description)
 end
 
-if enable_experimental then
-    require "core:internal/maths_inline"
-end
-
+require "core:internal/maths_inline"
+require "core:internal/debugging"
 asserts = require "core:internal/asserts"
 events = require "core:internal/events"
 
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 4e01e22a..783e054e 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -1,3 +1,6 @@
+local _ffi = ffi
+local _debug_getinfo = debug.getinfo
+
 function crc32(bytes, chksum)
     local chksum = chksum or 0
 
@@ -35,153 +38,6 @@ function parse_path(path)
     return string.sub(path, 1, index-1), string.sub(path, index+1, -1)
 end
 
-local breakpoints = {}
-local dbg_steps_mode = false
-local dbg_step_into_func = false
-local hook_lock = false
-local current_func
-local current_func_stack_size
-
-local __parse_path = parse_path
-local _debug_getinfo = debug.getinfo
-local _debug_getlocal = debug.getlocal
-local __pause = debug.pause
-local __error = error
-local __sethook = debug.sethook
-
--- 'return' hook not called for some functions
--- todo: speedup
-local function calc_stack_size()
-    local s = debug.traceback("", 2)
-    local count = 0
-    for i in s:gmatch("\n") do
-        count = count + 1
-    end
-    return count
-end
-
-local is_debugging = debug.is_debugging()
-if is_debugging then
-    __sethook(function (e, line)
-        if e == "return" then
-            local info = _debug_getinfo(2)
-            if info.func == current_func then
-                current_func = nil
-            end
-        end
-        if dbg_steps_mode and not hook_lock then
-            hook_lock = true
-
-            if not dbg_step_into_func then
-                local func = _debug_getinfo(2).func
-                if func ~= current_func then
-                    return
-                end
-                if current_func_stack_size ~= calc_stack_size() then
-                    return
-                end
-            end
-            current_func = func
-            __pause("step")
-            debug.pull_events()
-        end
-        hook_lock = false
-        local bps = breakpoints[line]
-        if not bps then
-            return
-        end
-        local source = _debug_getinfo(2).source
-        if not bps[source] then
-            return
-        end
-        current_func = _debug_getinfo(2).func
-        current_func_stack_size = calc_stack_size()
-        __pause("breakpoint")
-        debug.pull_events()
-    end, "lr")
-end
-
-local DBG_EVENT_SET_BREAKPOINT = 1
-local DBG_EVENT_RM_BREAKPOINT = 2
-local DBG_EVENT_STEP = 3
-local DBG_EVENT_STEP_INTO_FUNCTION = 4
-local DBG_EVENT_RESUME = 5
-local DBG_EVENT_GET_VALUE = 6
-local __pull_events = debug.__pull_events
-local __sendvalue = debug.__sendvalue
-debug.__pull_events = nil
-debug.__sendvalue = nil
-
-function debug.get_pack_by_frame(func)
-    local prefix, _ = __parse_path(_debug_getinfo(func, "S").source)
-    return prefix
-end
-
-function debug.pull_events()
-    if not is_debugging then
-        return
-    end
-    if not debug.is_debugging() then
-        is_debugging = false
-        __sethook()
-    end
-    local events = __pull_events()
-    if not events then
-        return
-    end
-    for i, event in ipairs(events) do
-        if event[1] == DBG_EVENT_SET_BREAKPOINT then
-            debug.set_breakpoint(event[2], event[3])
-        elseif event[1] == DBG_EVENT_RM_BREAKPOINT then
-            debug.remove_breakpoint(event[2], event[3])
-        elseif event[1] == DBG_EVENT_STEP then
-            dbg_steps_mode = true
-            dbg_step_into_func = false
-        elseif event[1] == DBG_EVENT_STEP_INTO_FUNCTION then
-            dbg_steps_mode = true
-            dbg_step_into_func = true
-        elseif event[1] == DBG_EVENT_RESUME then
-            dbg_steps_mode = false
-            dbg_step_into_func = false
-        elseif event[1] == DBG_EVENT_GET_VALUE then
-            local _, value = _debug_getlocal(event[2] + 3, event[3])
-            for _, key in ipairs(event[4]) do
-                if value == nil then
-                    value = "error: index nil value"
-                    break
-                end
-                value = value[key]
-            end
-            __sendvalue(value, event[2], event[3], event[4])
-            __pause()
-        end
-    end
-end
-
-function debug.set_breakpoint(source, line)
-    local bps = breakpoints[line]
-    if not bps then
-        bps = {}
-        breakpoints[line] = bps
-    end
-    bps[source] = true
-end
-
-function debug.remove_breakpoint(source, line)
-    local bps = breakpoints[line]
-    if not bps then
-        return
-    end
-    bps[source] = nil
-end
-
-function error(message, level)
-    if is_debugging then
-        __pause("exception", message)
-    end
-    __error(message, level)
-end
-
 -- Lua has no parallelizm, also _set_data does not call any lua functions so
 -- may be reused one global ffi buffer per lua_State
 local canvas_ffi_buffer
@@ -764,7 +620,7 @@ function __vc__error(msg, frame, n, lastn)
     if events then
         local frames = debug.get_traceback(1)
         events.emit(
-            "core:error", msg, 
+            "core:error", msg,
             table.sub(frames, 1 + (n or 0), lastn and #frames-lastn)
         )
     end
diff --git a/src/logic/scripting/lua/lua_util.cpp b/src/logic/scripting/lua/lua_util.cpp
index 401255c7..a09f5086 100644
--- a/src/logic/scripting/lua/lua_util.cpp
+++ b/src/logic/scripting/lua/lua_util.cpp
@@ -155,18 +155,18 @@ static int l_error_handler(lua_State* L) {
 }
 
 int lua::call(State* L, int argc, int nresults) {
-    int handler_pos = gettop(L) - argc;
+    int handlerPos = gettop(L) - argc;
     pushcfunction(L, l_error_handler);
-    insert(L, handler_pos);
+    insert(L, handlerPos);
     int top = gettop(L);
-    if (lua_pcall(L, argc, nresults, handler_pos)) {
+    if (lua_pcall(L, argc, nresults, handlerPos)) {
         std::string log = tostring(L, -1);
         pop(L);
-        remove(L, handler_pos);
+        remove(L, handlerPos);
         throw luaerror(log);
     }
     int added = gettop(L) - (top - argc - 1);
-    remove(L, handler_pos);
+    remove(L, handlerPos);
     return added;
 }
 

From fe8e4ba7b41c8c974c653248054d59cb2e2f255e Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 31 Oct 2025 23:30:29 +0300
Subject: [PATCH 081/133] add internal/audio_input module

---
 res/modules/internal/audio_input.lua | 27 +++++++++++++++++++++++++++
 res/scripts/hud.lua                  | 10 ++++++++--
 res/scripts/stdlib.lua               |  1 +
 res/scripts/stdmin.lua               |  2 +-
 res/texts/ru_RU.txt                  |  3 ++-
 5 files changed, 39 insertions(+), 4 deletions(-)
 create mode 100644 res/modules/internal/audio_input.lua

diff --git a/res/modules/internal/audio_input.lua b/res/modules/internal/audio_input.lua
new file mode 100644
index 00000000..3540e88b
--- /dev/null
+++ b/res/modules/internal/audio_input.lua
@@ -0,0 +1,27 @@
+local audio_input_tokens_store = {}
+audio.input = {}
+
+local _gui_confirm = gui.confirm
+local _base64_encode_urlsafe = base64.encode_urlsafe
+local _random_bytes = random.bytes
+local _debug_pack_by_frame = debug.get_pack_by_frame
+local _audio_fetch_input = audio.fetch_input
+
+function audio.fetch_input(token, size)
+    if audio_input_tokens_store[token] then
+        return _audio_fetch_input(size)
+    end
+    error("access denied")
+end
+
+local GRAND_PERMISSION_MSG = "Grant '%{0}' pack audio recording permission?"
+
+function audio.input.request_open(callback)
+    local token = _base64_encode_urlsafe(_random_bytes(18))
+    local caller = _debug_pack_by_frame(1)
+    _gui_confirm(gui.str(GRAND_PERMISSION_MSG):gsub("%%{0}", caller), function()
+        audio_input_tokens_store[token] = caller
+        callback(token)
+        menu:reset()
+    end)
+end
diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index a5aad766..73355ddf 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -134,6 +134,10 @@ function on_hud_open()
     audio.play_sound_2d("test-sound", 2.0, 1.0, "ui")
 end
 
+audio.input.request_open(function(token)
+    input_access_token = token
+end)
+
 function on_hud_render()
     if hud.hand_controller then
         hud.hand_controller()
@@ -141,6 +145,8 @@ function on_hud_render()
         update_hand()
     end
 
-    local bytes = audio.fetch_input()
-    stream:feed(bytes)
+    if input_access_token then
+        local bytes = audio.fetch_input(input_access_token)
+        stream:feed(bytes)
+    end
 end
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index cb25150b..d0077b6f 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -179,6 +179,7 @@ end
 
 require "core:internal/maths_inline"
 require "core:internal/debugging"
+require "core:internal/audio_input"
 asserts = require "core:internal/asserts"
 events = require "core:internal/events"
 
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 783e054e..30343d7d 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -2,7 +2,7 @@ local _ffi = ffi
 local _debug_getinfo = debug.getinfo
 
 function crc32(bytes, chksum)
-    local chksum = chksum or 0
+    chksum = chksum or 0
 
     local length = #bytes
     if type(bytes) == "table" then
diff --git a/res/texts/ru_RU.txt b/res/texts/ru_RU.txt
index 03ee8322..cc6de475 100644
--- a/res/texts/ru_RU.txt
+++ b/res/texts/ru_RU.txt
@@ -25,7 +25,8 @@ Grant %{0} pack modification permission?=Выдать разрешение на
 Error at line %{0}=Ошибка на строке %{0}
 Run=Запустить
 Filter=Фильтр
-Are you sure you want to open the link: =Вы уверены, что хотите открыть ссылку: 
+Are you sure you want to open the link: =Вы уверены, что хотите открыть ссылку:
+Grant '%{0}' pack audio recording permission?=Выдать паку '%{0}' разрешение на запись звука?
 
 editor.info.tooltip=CTRL+S - Сохранить\nCTRL+R - Запустить\nCTRL+Z - Отменить\nCTRL+Y - Повторить
 devtools.traceback=Стек вызовов (от последнего)

From fcbbdd649bbad1214bf4bc44b6f87a6328711acf Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 31 Oct 2025 23:54:56 +0300
Subject: [PATCH 082/133] split internal modules

---
 res/modules/internal/deprecated.lua           |  48 ++
 res/modules/internal/extensions/file.lua      |  45 ++
 res/modules/internal/extensions/inventory.lua |  71 +++
 res/modules/internal/extensions/math.lua      |  37 ++
 res/modules/internal/extensions/pack.lua      |  13 +
 res/modules/internal/extensions/string.lua    | 126 +++++
 res/modules/internal/extensions/table.lua     | 179 +++++++
 res/modules/internal/rules.lua                |  70 +++
 res/scripts/stdlib.lua                        | 206 +-------
 res/scripts/stdmin.lua                        | 456 +-----------------
 10 files changed, 627 insertions(+), 624 deletions(-)
 create mode 100644 res/modules/internal/deprecated.lua
 create mode 100644 res/modules/internal/extensions/file.lua
 create mode 100644 res/modules/internal/extensions/inventory.lua
 create mode 100644 res/modules/internal/extensions/math.lua
 create mode 100644 res/modules/internal/extensions/pack.lua
 create mode 100644 res/modules/internal/extensions/string.lua
 create mode 100644 res/modules/internal/extensions/table.lua
 create mode 100644 res/modules/internal/rules.lua

diff --git a/res/modules/internal/deprecated.lua b/res/modules/internal/deprecated.lua
new file mode 100644
index 00000000..0be82795
--- /dev/null
+++ b/res/modules/internal/deprecated.lua
@@ -0,0 +1,48 @@
+-- --------- Deprecated functions ------ --
+local function wrap_deprecated(func, name, alternatives)
+    return function (...)
+        on_deprecated_call(name, alternatives)
+        return func(...)
+    end
+end
+
+block_index = wrap_deprecated(block.index, "block_index", "block.index")
+block_name = wrap_deprecated(block.name, "block_name", "block.name")
+blocks_count = wrap_deprecated(block.defs_count, "blocks_count", "block.defs_count")
+is_solid_at = wrap_deprecated(block.is_solid_at, "is_solid_at", "block.is_solid_at")
+is_replaceable_at = wrap_deprecated(block.is_replaceable_at, "is_replaceable_at", "block.is_replaceable_at")
+set_block = wrap_deprecated(block.set, "set_block", "block.set")
+get_block = wrap_deprecated(block.get, "get_block", "block.get")
+get_block_X = wrap_deprecated(block.get_X, "get_block_X", "block.get_X")
+get_block_Y = wrap_deprecated(block.get_Y, "get_block_Y", "block.get_Y")
+get_block_Z = wrap_deprecated(block.get_Z, "get_block_Z", "block.get_Z")
+get_block_states = wrap_deprecated(block.get_states, "get_block_states", "block.get_states")
+set_block_states = wrap_deprecated(block.set_states, "set_block_states", "block.set_states")
+get_block_rotation = wrap_deprecated(block.get_rotation, "get_block_rotation", "block.get_rotation")
+set_block_rotation = wrap_deprecated(block.set_rotation, "set_block_rotation", "block.set_rotation")
+get_block_user_bits = wrap_deprecated(block.get_user_bits, "get_block_user_bits", "block.get_user_bits")
+set_block_user_bits = wrap_deprecated(block.set_user_bits, "set_block_user_bits", "block.set_user_bits")
+
+function load_script(path, nocache)
+    on_deprecated_call("load_script", "require or loadstring")
+    return __load_script(path, nocache)
+end
+
+_dofile = dofile
+-- Replaces dofile('*/content/packid/*') with load_script('packid:*') 
+function dofile(path)
+    on_deprecated_call("dofile", "require or loadstring")
+    local index = string.find(path, "/content/")
+    if index then
+        local newpath = string.sub(path, index+9)
+        index = string.find(newpath, "/")
+        if index then
+            local label = string.sub(newpath, 1, index-1)
+            newpath = label..':'..string.sub(newpath, index+1)
+            if file.isfile(newpath) then
+                return __load_script(newpath, true)
+            end
+        end
+    end
+    return _dofile(path)
+end
diff --git a/res/modules/internal/extensions/file.lua b/res/modules/internal/extensions/file.lua
new file mode 100644
index 00000000..0f104012
--- /dev/null
+++ b/res/modules/internal/extensions/file.lua
@@ -0,0 +1,45 @@
+function file.name(path)
+    return path:match("([^:/\\]+)$")
+end
+
+function file.stem(path)
+    local name = file.name(path)
+    return name:match("(.+)%.[^%.]+$") or name
+end
+
+function file.ext(path)
+    return path:match("%.([^:/\\]+)$")
+end
+
+function file.prefix(path)
+    return path:match("^([^:]+)")
+end
+
+function file.parent(path)
+    local dir = path:match("(.*)/")
+    if not dir then
+        return file.prefix(path)..":"
+    end
+    return dir
+end
+
+function file.path(path)
+    local pos = path:find(':')
+    return path:sub(pos + 1)
+end
+
+function file.join(a, b)
+    if a[#a] == ':' then
+        return a .. b
+    end
+    return a .. "/" .. b
+end
+
+function file.readlines(path)
+    local str = file.read(path)
+    local lines = {}
+    for s in str:gmatch("[^\r\n]+") do
+        table.insert(lines, s)
+    end
+    return lines
+end
diff --git a/res/modules/internal/extensions/inventory.lua b/res/modules/internal/extensions/inventory.lua
new file mode 100644
index 00000000..799eecb0
--- /dev/null
+++ b/res/modules/internal/extensions/inventory.lua
@@ -0,0 +1,71 @@
+function inventory.get_uses(invid, slot)
+    local uses = inventory.get_data(invid, slot, "uses")
+    if uses == nil then
+        return item.uses(inventory.get(invid, slot))
+    end
+    return uses
+end
+
+function inventory.use(invid, slot)
+    local itemid, count = inventory.get(invid, slot)
+    if itemid == nil then
+        return
+    end
+    local item_uses = inventory.get_uses(invid, slot)
+    if item_uses == nil then
+        return
+    end
+    if item_uses == 1 then
+        inventory.set(invid, slot, itemid, count - 1)
+    elseif item_uses > 1 then
+        inventory.set_data(invid, slot, "uses", item_uses - 1)
+    end
+end
+
+function inventory.decrement(invid, slot, count)
+    count = count or 1
+    local itemid, itemcount = inventory.get(invid, slot)
+    if itemcount <= count then
+        inventory.set(invid, slot, 0)
+    else
+        inventory.set_count(invid, slot, itemcount - count)
+    end
+end
+
+function inventory.get_caption(invid, slot)
+    local item_id, count = inventory.get(invid, slot)
+    local caption = inventory.get_data(invid, slot, "caption")
+    if not caption then return item.caption(item_id) end
+
+    return caption
+end
+
+function inventory.set_caption(invid, slot, caption)
+    local itemid, itemcount = inventory.get(invid, slot)
+    if itemid == 0 then
+        return
+    end
+    if caption == nil or type(caption) ~= "string" then
+        caption = ""
+    end
+    inventory.set_data(invid, slot, "caption", caption)
+end
+
+function inventory.get_description(invid, slot)
+    local item_id, count = inventory.get(invid, slot)
+    local description = inventory.get_data(invid, slot, "description")
+    if not description then return item.description(item_id) end
+
+    return description
+end
+
+function inventory.set_description(invid, slot, description)
+    local itemid, itemcount = inventory.get(invid, slot)
+    if itemid == 0 then
+        return
+    end
+    if description == nil or type(description) ~= "string" then
+        description = ""
+    end
+    inventory.set_data(invid, slot, "description", description)
+end
diff --git a/res/modules/internal/extensions/math.lua b/res/modules/internal/extensions/math.lua
new file mode 100644
index 00000000..d906e94a
--- /dev/null
+++ b/res/modules/internal/extensions/math.lua
@@ -0,0 +1,37 @@
+function math.clamp(_in, low, high)
+    return math.min(math.max(_in, low), high)
+end
+
+function math.rand(low, high)
+    return low + (high - low) * math.random()
+end
+
+function math.normalize(num, conf)
+    conf = conf or 1
+
+    return (num / conf) % 1
+end
+
+function math.round(num, places)
+    places = places or 0
+
+    local mult = 10 ^ places
+    return math.floor(num * mult + 0.5) / mult
+end
+
+function math.sum(...)
+    local numbers = nil
+    local sum = 0
+
+    if type(...) == "table" then
+        numbers = ...
+    else
+        numbers = {...}
+    end
+
+    for _, v in ipairs(numbers) do
+        sum = sum + v
+    end
+
+    return sum
+end
diff --git a/res/modules/internal/extensions/pack.lua b/res/modules/internal/extensions/pack.lua
new file mode 100644
index 00000000..c43c1203
--- /dev/null
+++ b/res/modules/internal/extensions/pack.lua
@@ -0,0 +1,13 @@
+function pack.is_installed(packid)
+    return file.isfile(packid..":package.json")
+end
+
+function pack.data_file(packid, name)
+    file.mkdirs("world:data/"..packid)
+    return "world:data/"..packid.."/"..name
+end
+
+function pack.shared_file(packid, name)
+    file.mkdirs("config:"..packid)
+    return "config:"..packid.."/"..name
+end
diff --git a/res/modules/internal/extensions/string.lua b/res/modules/internal/extensions/string.lua
new file mode 100644
index 00000000..f76470df
--- /dev/null
+++ b/res/modules/internal/extensions/string.lua
@@ -0,0 +1,126 @@
+local pattern_escape_replacements = {
+    ["("] = "%(",
+    [")"] = "%)",
+    ["."] = "%.",
+    ["%"] = "%%",
+    ["+"] = "%+",
+    ["-"] = "%-",
+    ["*"] = "%*",
+    ["?"] = "%?",
+    ["["] = "%[",
+    ["]"] = "%]",
+    ["^"] = "%^",
+    ["$"] = "%$",
+    ["\0"] = "%z"
+}
+
+function string.pattern_safe(str)
+    return string.gsub(str, ".", pattern_escape_replacements)
+end
+
+local string_sub = string.sub
+local string_find = string.find
+local string_len = string.len
+function string.explode(separator, str, withpattern)
+    if (withpattern == nil) then withpattern = false end
+
+    local ret = {}
+    local current_pos = 1
+
+    for i = 1, string_len(str) do
+        local start_pos, end_pos = string_find(
+            str, separator, current_pos, not withpattern)
+        if (not start_pos) then break end
+        ret[i] = string_sub(str, current_pos, start_pos - 1)
+        current_pos = end_pos + 1
+    end
+
+    ret[#ret + 1] = string_sub(str, current_pos)
+
+    return ret
+end
+
+function string.split(str, delimiter)
+    return string.explode(delimiter, str)
+end
+
+function string.formatted_time(seconds, format)
+    if (not seconds) then seconds = 0 end
+    local hours = math.floor(seconds / 3600)
+    local minutes = math.floor((seconds / 60) % 60)
+    local millisecs = (seconds - math.floor(seconds)) * 1000
+    seconds = math.floor(seconds % 60)
+
+    if (format) then
+        return string.format(format, minutes, seconds, millisecs)
+    else
+        return { h = hours, m = minutes, s = seconds, ms = millisecs }
+    end
+end
+
+function string.replace(str, tofind, toreplace)
+    local tbl = string.explode(tofind, str)
+    if (tbl[1]) then return table.concat(tbl, toreplace) end
+    return str
+end
+
+function string.trim(s, char)
+    if char then char = string.pattern_safe(char) else char = "%s" end
+    return string.match(s, "^" .. char .. "*(.-)" .. char .. "*$") or s
+end
+
+function string.trim_right(s, char)
+    if char then char = string.pattern_safe(char) else char = "%s" end
+    return string.match(s, "^(.-)" .. char .. "*$") or s
+end
+
+function string.trim_left(s, char)
+    if char then char = string.pattern_safe(char) else char = "%s" end
+    return string.match(s, "^" .. char .. "*(.+)$") or s
+end
+
+function string.pad(str, size, char)
+    char = char == nil and " " or char
+
+    local padding = math.floor((size - #str) / 2)
+    local extra_padding = (size - #str) % 2
+
+    return string.rep(char, padding) .. str .. string.rep(char, padding + extra_padding)
+end
+
+function string.left_pad(str, size, char)
+    char = char == nil and " " or char
+
+    local left_padding = size - #str
+    return string.rep(char, left_padding) .. str
+end
+
+function string.right_pad(str, size, char)
+    char = char == nil and " " or char
+
+    local right_padding = size - #str
+    return str .. string.rep(char, right_padding)
+end
+
+string.lower = utf8.lower
+string.upper = utf8.upper
+string.escape = utf8.escape
+
+local meta = getmetatable("")
+
+function meta:__index(key)
+    local val = string[key]
+    if (val ~= nil) then
+        return val
+    elseif (tonumber(key)) then
+        return string.sub(self, key, key)
+    end
+end
+
+function string.starts_with(str, start)
+    return string.sub(str, 1, string.len(start)) == start
+end
+
+function string.ends_with(str, endStr)
+    return endStr == "" or string.sub(str, -string.len(endStr)) == endStr
+end
diff --git a/res/modules/internal/extensions/table.lua b/res/modules/internal/extensions/table.lua
new file mode 100644
index 00000000..33047df3
--- /dev/null
+++ b/res/modules/internal/extensions/table.lua
@@ -0,0 +1,179 @@
+function table.copy(t)
+    local copied = {}
+
+    for k, v in pairs(t) do
+        copied[k] = v
+    end
+
+    return copied
+end
+
+function table.deep_copy(t)
+    local copied = {}
+
+    for k, v in pairs(t) do
+        if type(v) == "table" then
+            copied[k] = table.deep_copy(v)
+        else
+            copied[k] = v
+        end
+    end
+
+    return setmetatable(copied, getmetatable(t))
+end
+
+function table.count_pairs(t)
+    local count = 0
+
+    for k, v in pairs(t) do
+        count = count + 1
+    end
+
+    return count
+end
+
+function table.random(t)
+    return t[math.random(1, #t)]
+end
+
+function table.shuffle(t)
+    for i = #t, 2, -1 do
+        local j = math.random(i)
+        t[i], t[j] = t[j], t[i]
+    end
+
+    return t
+end
+
+function table.merge(t1, t2)
+    for i, v in pairs(t2) do
+        if type(i) == "number" then
+            t1[#t1 + 1] = v
+        elseif t1[i] == nil then
+            t1[i] = v
+        end
+    end
+
+    return t1
+end
+
+function table.map(t, func)
+    for i, v in pairs(t) do
+        t[i] = func(i, v)
+    end
+
+    return t
+end
+
+function table.filter(t, func)
+
+    for i = #t, 1, -1 do
+        if not func(i, t[i]) then
+            table.remove(t, i)
+        end
+    end
+
+    local size = #t
+
+    for i, v in pairs(t) do
+        local i_type = type(i)
+        if i_type == "number" then
+            if i < 1 or i > size then
+                if not func(i, v) then
+                    t[i] = nil
+                end
+            end
+        else
+            if not func(i, v) then
+                t[i] = nil
+            end
+        end
+    end
+
+    return t
+end
+
+function table.set_default(t, key, default)
+    if t[key] == nil then
+        t[key] = default
+        return default
+    end
+
+    return t[key]
+end
+
+function table.flat(t)
+    local flat = {}
+
+    for _, v in pairs(t) do
+        if type(v) == "table" then
+            table.merge(flat, v)
+        else
+            table.insert(flat, v)
+        end
+    end
+
+    return flat
+end
+
+function table.deep_flat(t)
+    local flat = {}
+
+    for _, v in pairs(t) do
+        if type(v) == "table" then
+            table.merge(flat, table.deep_flat(v))
+        else
+            table.insert(flat, v)
+        end
+    end
+
+    return flat
+end
+
+function table.sub(arr, start, stop)
+    local res = {}
+    start = start or 1
+    stop = stop or #arr
+
+    for i = start, stop do
+        table.insert(res, arr[i])
+    end
+
+    return res
+end
+
+function table.has(t, x)
+    for i,v in ipairs(t) do
+        if v == x then
+            return true
+        end
+    end
+    return false
+end
+
+function table.index(t, x)
+    for i,v in ipairs(t) do
+        if v == x then
+            return i
+        end
+    end
+    return -1
+end
+
+function table.remove_value(t, x)
+    local index = table.index(t, x)
+    if index ~= -1 then
+        table.remove(t, index)
+    end
+end
+
+function table.tostring(t)
+    local s = '['
+    for i,v in ipairs(t) do
+        s = s..tostring(v)
+        if i < #t then
+            s = s..', '
+        end
+    end
+    return s..']'
+end
diff --git a/res/modules/internal/rules.lua b/res/modules/internal/rules.lua
new file mode 100644
index 00000000..a1a5a8c3
--- /dev/null
+++ b/res/modules/internal/rules.lua
@@ -0,0 +1,70 @@
+local rules = {nexid = 1, rules = {}}
+
+function rules.get_rule(name)
+    local rule = rules.rules[name]
+    if rule == nil then
+        rule = {listeners={}}
+        rules.rules[name] = rule
+    end
+    return rule
+end
+
+function rules.get(name)
+    local rule = rules.rules[name]
+    if rule == nil then
+        return nil
+    end
+    return rule.value
+end
+
+function rules.set(name, value)
+    local rule = rules.get_rule(name)
+    rule.value = value
+    for _, handler in pairs(rule.listeners) do
+        handler(value)
+    end
+end
+
+function rules.reset(name)
+    local rule = rules.get_rule(name)
+    rules.set(rule.default)
+end
+
+function rules.listen(name, handler)
+    local rule = rules.get_rule(name)
+    local id = rules.nexid
+    rules.nextid = rules.nexid + 1
+    rule.listeners[utf8.encode(id)] = handler
+    return id
+end
+
+function rules.create(name, value, handler)
+    local rule = rules.get_rule(name)
+    rule.default = value
+
+    local handlerid
+    if handler ~= nil then
+        handlerid = rules.listen(name, handler)
+    end
+    if rules.get(name) == nil then
+        rules.set(name, value)
+    elseif handler then
+        handler(rules.get(name))
+    end
+    return handlerid
+end
+
+function rules.unlisten(name, id)
+    local rule = rules.rules[name]
+    if rule == nil then
+        return
+    end
+    rule.listeners[utf8.encode(id)] = nil
+end
+
+function rules.clear()
+    rules.rules = {}
+    rules.nextid = 1
+end
+
+return rules
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index d0077b6f..71a8256e 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -105,81 +105,10 @@ elseif __vc_app then
     complete_app_lib(__vc_app)
 end
 
-function inventory.get_uses(invid, slot)
-    local uses = inventory.get_data(invid, slot, "uses")
-    if uses == nil then
-        return item.uses(inventory.get(invid, slot))
-    end
-    return uses
-end
-
-function inventory.use(invid, slot)
-    local itemid, count = inventory.get(invid, slot)
-    if itemid == nil then
-        return
-    end
-    local item_uses = inventory.get_uses(invid, slot)
-    if item_uses == nil then
-        return
-    end
-    if item_uses == 1 then
-        inventory.set(invid, slot, itemid, count - 1)
-    elseif item_uses > 1 then
-        inventory.set_data(invid, slot, "uses", item_uses - 1)
-    end
-end
-
-function inventory.decrement(invid, slot, count)
-    count = count or 1
-    local itemid, itemcount = inventory.get(invid, slot)
-    if itemcount <= count then
-        inventory.set(invid, slot, 0)
-    else
-        inventory.set_count(invid, slot, itemcount - count)
-    end
-end
-
-function inventory.get_caption(invid, slot)
-    local item_id, count = inventory.get(invid, slot)
-    local caption = inventory.get_data(invid, slot, "caption")
-    if not caption then return item.caption(item_id) end
-
-    return caption
-end
-
-function inventory.set_caption(invid, slot, caption)
-    local itemid, itemcount = inventory.get(invid, slot)
-    if itemid == 0 then
-        return
-    end
-    if caption == nil or type(caption) ~= "string" then
-        caption = ""
-    end
-    inventory.set_data(invid, slot, "caption", caption)
-end
-
-function inventory.get_description(invid, slot)
-    local item_id, count = inventory.get(invid, slot)
-    local description = inventory.get_data(invid, slot, "description")
-    if not description then return item.description(item_id) end
-
-    return description
-end
-
-function inventory.set_description(invid, slot, description)
-    local itemid, itemcount = inventory.get(invid, slot)
-    if itemid == 0 then
-        return
-    end
-    if description == nil or type(description) ~= "string" then
-        description = ""
-    end
-    inventory.set_data(invid, slot, "description", description)
-end
-
 require "core:internal/maths_inline"
 require "core:internal/debugging"
 require "core:internal/audio_input"
+require "core:internal/extensions/inventory"
 asserts = require "core:internal/asserts"
 events = require "core:internal/events"
 
@@ -306,86 +235,20 @@ else
     os.pid = ffi.C.getpid()
 end
 
-ffi = nil
-__vc_lock_internal_modules()
-
 math.randomseed(time.uptime() * 1536227939)
 
-rules = {nexid = 1, rules = {}}
+rules = require "core:internal/rules"
 local _rules = rules
 
-function _rules.get_rule(name)
-    local rule = _rules.rules[name]
-    if rule == nil then
-        rule = {listeners={}}
-        _rules.rules[name] = rule
-    end
-    return rule
-end
-
-function _rules.get(name)
-    local rule = _rules.rules[name]
-    if rule == nil then
-        return nil
-    end
-    return rule.value
-end
-
-function _rules.set(name, value)
-    local rule = _rules.get_rule(name)
-    rule.value = value
-    for _, handler in pairs(rule.listeners) do
-        handler(value)
-    end
-end
-
-function _rules.reset(name)
-    local rule = _rules.get_rule(name)
-    _rules.set(rule.default)
-end
-
-function _rules.listen(name, handler)
-    local rule = _rules.get_rule(name)
-    local id = _rules.nexid
-    _rules.nextid = _rules.nexid + 1
-    rule.listeners[utf8.encode(id)] = handler
-    return id
-end
-
-function _rules.create(name, value, handler)
-    local rule = _rules.get_rule(name)
-    rule.default = value
-
-    local handlerid
-    if handler ~= nil then
-        handlerid = _rules.listen(name, handler)
-    end
-    if _rules.get(name) == nil then
-        _rules.set(name, value)
-    elseif handler then
-        handler(_rules.get(name))
-    end
-    return handlerid
-end
-
-function _rules.unlisten(name, id)
-    local rule = _rules.rules[name]
-    if rule == nil then
-        return
-    end
-    rule.listeners[utf8.encode(id)] = nil
-end
-
-function _rules.clear()
-    _rules.rules = {}
-    _rules.nextid = 1
-end
-
 function __vc_on_hud_open()
+    local _hud_is_content_access = hud._is_content_access
+    local _hud_set_content_access = hud._set_content_access
+    local _hud_set_debug_cheats = hud._set_debug_cheats
+
     _rules.create("allow-cheats", true)
 
-    _rules.create("allow-content-access", hud._is_content_access(), function(value)
-        hud._set_content_access(value)
+    _rules.create("allow-content-access", _hud_is_content_access(), function(value)
+        _hud_set_content_access(value)
     end)
     _rules.create("allow-flight", true, function(value)
         input.set_enabled("player.flight", value)
@@ -406,7 +269,7 @@ function __vc_on_hud_open()
         input.set_enabled("player.fast_interaction", value)
     end)
     _rules.create("allow-debug-cheats", true, function(value)
-        hud._set_debug_cheats(value)
+        _hud_set_debug_cheats(value)
     end)
     input.add_callback("devtools.console", function()
         if menu.page ~= "" then
@@ -605,6 +468,7 @@ local _getinfo = debug.getinfo
 for i, name in ipairs(removed_names) do
     debug[name] = nil
 end
+
 debug.getinfo = function(lvl, fields)
     if type(lvl) == "number" then
         lvl = lvl + 1
@@ -614,51 +478,7 @@ debug.getinfo = function(lvl, fields)
     return debuginfo
 end
 
--- --------- Deprecated functions ------ --
-local function wrap_deprecated(func, name, alternatives)
-    return function (...)
-        on_deprecated_call(name, alternatives)
-        return func(...)
-    end
-end
+require "core:internal/deprecated"
 
-block_index = wrap_deprecated(block.index, "block_index", "block.index")
-block_name = wrap_deprecated(block.name, "block_name", "block.name")
-blocks_count = wrap_deprecated(block.defs_count, "blocks_count", "block.defs_count")
-is_solid_at = wrap_deprecated(block.is_solid_at, "is_solid_at", "block.is_solid_at")
-is_replaceable_at = wrap_deprecated(block.is_replaceable_at, "is_replaceable_at", "block.is_replaceable_at")
-set_block = wrap_deprecated(block.set, "set_block", "block.set")
-get_block = wrap_deprecated(block.get, "get_block", "block.get")
-get_block_X = wrap_deprecated(block.get_X, "get_block_X", "block.get_X")
-get_block_Y = wrap_deprecated(block.get_Y, "get_block_Y", "block.get_Y")
-get_block_Z = wrap_deprecated(block.get_Z, "get_block_Z", "block.get_Z")
-get_block_states = wrap_deprecated(block.get_states, "get_block_states", "block.get_states")
-set_block_states = wrap_deprecated(block.set_states, "set_block_states", "block.set_states")
-get_block_rotation = wrap_deprecated(block.get_rotation, "get_block_rotation", "block.get_rotation")
-set_block_rotation = wrap_deprecated(block.set_rotation, "set_block_rotation", "block.set_rotation")
-get_block_user_bits = wrap_deprecated(block.get_user_bits, "get_block_user_bits", "block.get_user_bits")
-set_block_user_bits = wrap_deprecated(block.set_user_bits, "set_block_user_bits", "block.set_user_bits")
-
-function load_script(path, nocache)
-    on_deprecated_call("load_script", "require or loadstring")
-    return __load_script(path, nocache)
-end
-
-_dofile = dofile
--- Replaces dofile('*/content/packid/*') with load_script('packid:*') 
-function dofile(path)
-    on_deprecated_call("dofile", "require or loadstring")
-    local index = string.find(path, "/content/")
-    if index then
-        local newpath = string.sub(path, index+9)
-        index = string.find(newpath, "/")
-        if index then
-            local label = string.sub(newpath, 1, index-1)
-            newpath = label..':'..string.sub(newpath, index+1)
-            if file.isfile(newpath) then
-                return __load_script(newpath, true)
-            end
-        end
-    end
-    return _dofile(path)
-end
+ffi = nil
+__vc_lock_internal_modules()
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 30343d7d..7e8678e5 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -42,6 +42,26 @@ end
 -- may be reused one global ffi buffer per lua_State
 local canvas_ffi_buffer
 local canvas_ffi_buffer_size = 0
+local _ffi = ffi
+function __vc_Canvas_set_data(self, data)
+    if type(data) == "cdata" then
+        self:_set_data(tostring(_ffi.cast("uintptr_t", data)))
+    end
+    local width = self.width
+    local height = self.height
+
+    local size = width * height * 4
+    if size > canvas_ffi_buffer_size then
+        canvas_ffi_buffer = _ffi.new(
+            string.format("unsigned char[%s]", size)
+        )
+        canvas_ffi_buffer_size = size
+    end
+    for i=0, size - 1 do
+        canvas_ffi_buffer[i] = data[i + 1]
+    end
+    self:_set_data(tostring(_ffi.cast("uintptr_t", canvas_ffi_buffer)))
+end
 
 local ipairs_mt_supported = false
 for i, _ in ipairs(setmetatable({l={1}}, {
@@ -72,42 +92,6 @@ function await(co)
     return res, err
 end
 
-local _ffi = ffi
-function __vc_Canvas_set_data(self, data)
-    if type(data) == "cdata" then
-        self:_set_data(tostring(_ffi.cast("uintptr_t", data)))
-    end
-    local width = self.width
-    local height = self.height
-
-    local size = width * height * 4
-    if size > canvas_ffi_buffer_size then
-        canvas_ffi_buffer = _ffi.new(
-            string.format("unsigned char[%s]", size)
-        )
-        canvas_ffi_buffer_size = size
-    end
-    for i=0, size - 1 do
-        canvas_ffi_buffer[i] = data[i + 1]
-    end
-    self:_set_data(tostring(_ffi.cast("uintptr_t", canvas_ffi_buffer)))
-end
-
-function pack.is_installed(packid)
-    return file.isfile(packid..":package.json")
-end
-
-function pack.data_file(packid, name)
-    file.mkdirs("world:data/"..packid)
-    return "world:data/"..packid.."/"..name
-end
-
-function pack.shared_file(packid, name)
-    file.mkdirs("config:"..packid)
-    return "config:"..packid.."/"..name
-end
-
-
 function timeit(iters, func, ...)
     local tm = os.clock()
     for i=1,iters do
@@ -118,364 +102,6 @@ end
 
 ----------------------------------------------
 
-function math.clamp(_in, low, high)
-    return math.min(math.max(_in, low), high)
-end
-
-function math.rand(low, high)
-    return low + (high - low) * math.random()
-end
-
-function math.normalize(num, conf)
-    conf = conf or 1
-
-    return (num / conf) % 1
-end
-
-function math.round(num, places)
-    places = places or 0
-
-    local mult = 10 ^ places
-    return math.floor(num * mult + 0.5) / mult
-end
-
-function math.sum(...)
-    local numbers = nil
-    local sum = 0
-
-    if type(...) == "table" then
-        numbers = ...
-    else
-        numbers = {...}
-    end
-
-    for _, v in ipairs(numbers) do
-        sum = sum + v
-    end
-
-    return sum
-end
-
-----------------------------------------------
-
-function table.copy(t)
-    local copied = {}
-
-    for k, v in pairs(t) do
-        copied[k] = v
-    end
-
-    return copied
-end
-
-function table.deep_copy(t)
-    local copied = {}
-
-    for k, v in pairs(t) do
-        if type(v) == "table" then
-            copied[k] = table.deep_copy(v)
-        else
-            copied[k] = v
-        end
-    end
-
-    return setmetatable(copied, getmetatable(t))
-end
-
-function table.count_pairs(t)
-    local count = 0
-
-    for k, v in pairs(t) do
-        count = count + 1
-    end
-
-    return count
-end
-
-function table.random(t)
-    return t[math.random(1, #t)]
-end
-
-function table.shuffle(t)
-    for i = #t, 2, -1 do
-        local j = math.random(i)
-        t[i], t[j] = t[j], t[i]
-    end
-
-    return t
-end
-
-function table.merge(t1, t2)
-    for i, v in pairs(t2) do
-        if type(i) == "number" then
-            t1[#t1 + 1] = v
-        elseif t1[i] == nil then
-            t1[i] = v
-        end
-    end
-
-    return t1
-end
-
-function table.map(t, func)
-    for i, v in pairs(t) do
-        t[i] = func(i, v)
-    end
-
-    return t
-end
-
-function table.filter(t, func)
-
-    for i = #t, 1, -1 do
-        if not func(i, t[i]) then
-            table.remove(t, i)
-        end
-    end
-
-    local size = #t
-
-    for i, v in pairs(t) do
-        local i_type = type(i)
-        if i_type == "number" then
-            if i < 1 or i > size then
-                if not func(i, v) then
-                    t[i] = nil
-                end
-            end
-        else
-            if not func(i, v) then
-                t[i] = nil
-            end
-        end
-    end
-
-    return t
-end
-
-function table.set_default(t, key, default)
-    if t[key] == nil then
-        t[key] = default
-        return default
-    end
-
-    return t[key]
-end
-
-function table.flat(t)
-    local flat = {}
-
-    for _, v in pairs(t) do
-        if type(v) == "table" then
-            table.merge(flat, v)
-        else
-            table.insert(flat, v)
-        end
-    end
-
-    return flat
-end
-
-function table.deep_flat(t)
-    local flat = {}
-
-    for _, v in pairs(t) do
-        if type(v) == "table" then
-            table.merge(flat, table.deep_flat(v))
-        else
-            table.insert(flat, v)
-        end
-    end
-
-    return flat
-end
-
-function table.sub(arr, start, stop)
-    local res = {}
-    start = start or 1
-    stop = stop or #arr
-
-    for i = start, stop do
-        table.insert(res, arr[i])
-    end
-
-    return res
-end
-
-----------------------------------------------
-
-local pattern_escape_replacements = {
-    ["("] = "%(",
-    [")"] = "%)",
-    ["."] = "%.",
-    ["%"] = "%%",
-    ["+"] = "%+",
-    ["-"] = "%-",
-    ["*"] = "%*",
-    ["?"] = "%?",
-    ["["] = "%[",
-    ["]"] = "%]",
-    ["^"] = "%^",
-    ["$"] = "%$",
-    ["\0"] = "%z"
-}
-
-function string.pattern_safe(str)
-    return string.gsub(str, ".", pattern_escape_replacements)
-end
-
-local string_sub = string.sub
-local string_find = string.find
-local string_len = string.len
-function string.explode(separator, str, withpattern)
-    if (withpattern == nil) then withpattern = false end
-
-    local ret = {}
-    local current_pos = 1
-
-    for i = 1, string_len(str) do
-        local start_pos, end_pos = string_find(
-            str, separator, current_pos, not withpattern)
-        if (not start_pos) then break end
-        ret[i] = string_sub(str, current_pos, start_pos - 1)
-        current_pos = end_pos + 1
-    end
-
-    ret[#ret + 1] = string_sub(str, current_pos)
-
-    return ret
-end
-
-function string.split(str, delimiter)
-    return string.explode(delimiter, str)
-end
-
-function string.formatted_time(seconds, format)
-    if (not seconds) then seconds = 0 end
-    local hours = math.floor(seconds / 3600)
-    local minutes = math.floor((seconds / 60) % 60)
-    local millisecs = (seconds - math.floor(seconds)) * 1000
-    seconds = math.floor(seconds % 60)
-
-    if (format) then
-        return string.format(format, minutes, seconds, millisecs)
-    else
-        return { h = hours, m = minutes, s = seconds, ms = millisecs }
-    end
-end
-
-function string.replace(str, tofind, toreplace)
-    local tbl = string.explode(tofind, str)
-    if (tbl[1]) then return table.concat(tbl, toreplace) end
-    return str
-end
-
-function string.trim(s, char)
-    if char then char = string.pattern_safe(char) else char = "%s" end
-    return string.match(s, "^" .. char .. "*(.-)" .. char .. "*$") or s
-end
-
-function string.trim_right(s, char)
-    if char then char = string.pattern_safe(char) else char = "%s" end
-    return string.match(s, "^(.-)" .. char .. "*$") or s
-end
-
-function string.trim_left(s, char)
-    if char then char = string.pattern_safe(char) else char = "%s" end
-    return string.match(s, "^" .. char .. "*(.+)$") or s
-end
-
-function string.pad(str, size, char)
-    char = char == nil and " " or char
-
-    local padding = math.floor((size - #str) / 2)
-    local extra_padding = (size - #str) % 2
-
-    return string.rep(char, padding) .. str .. string.rep(char, padding + extra_padding)
-end
-
-function string.left_pad(str, size, char)
-    char = char == nil and " " or char
-
-    local left_padding = size - #str
-    return string.rep(char, left_padding) .. str
-end
-
-function string.right_pad(str, size, char)
-    char = char == nil and " " or char
-
-    local right_padding = size - #str
-    return str .. string.rep(char, right_padding)
-end
-
-string.lower = utf8.lower
-string.upper = utf8.upper
-string.escape = utf8.escape
-
-local meta = getmetatable("")
-
-function meta:__index(key)
-    local val = string[key]
-    if (val ~= nil) then
-        return val
-    elseif (tonumber(key)) then
-        return string.sub(self, key, key)
-    end
-end
-
-function string.starts_with(str, start)
-    return string.sub(str, 1, string.len(start)) == start
-end
-
-function string.ends_with(str, endStr)
-    return endStr == "" or string.sub(str, -string.len(endStr)) == endStr
-end
-
-function table.has(t, x)
-    for i,v in ipairs(t) do
-        if v == x then
-            return true
-        end
-    end
-    return false
-end
-
-function table.index(t, x)
-    for i,v in ipairs(t) do
-        if v == x then
-            return i
-        end
-    end
-    return -1
-end
-
-function table.remove_value(t, x)
-    local index = table.index(t, x)
-    if index ~= -1 then
-        table.remove(t, index)
-    end
-end
-
-function table.tostring(t)
-    local s = '['
-    for i,v in ipairs(t) do
-        s = s..tostring(v)
-        if i < #t then
-            s = s..', '
-        end
-    end
-    return s..']'
-end
-
-function file.readlines(path)
-    local str = file.read(path)
-    local lines = {}
-    for s in str:gmatch("[^\r\n]+") do
-        table.insert(lines, s)
-    end
-    return lines
-end
-
 function debug.count_frames()
     local frames = 1
     while true do
@@ -634,43 +260,11 @@ function __vc_warning(msg, detail, n)
     end
 end
 
-function file.name(path)
-    return path:match("([^:/\\]+)$")
-end
-
-function file.stem(path)
-    local name = file.name(path)
-    return name:match("(.+)%.[^%.]+$") or name
-end
-
-function file.ext(path)
-    return path:match("%.([^:/\\]+)$")
-end
-
-function file.prefix(path)
-    return path:match("^([^:]+)")
-end
-
-function file.parent(path)
-    local dir = path:match("(.*)/")
-    if not dir then
-        return file.prefix(path)..":"
-    end
-    return dir
-end
-
-function file.path(path)
-    local pos = path:find(':')
-    return path:sub(pos + 1)
-end
-
-function file.join(a, b)
-    if a[#a] == ':' then
-        return a .. b
-    end
-    return a .. "/" .. b
-end
-
+require "core:internal/extensions/pack"
+require "core:internal/extensions/math"
+require "core:internal/extensions/file"
+require "core:internal/extensions/table"
+require "core:internal/extensions/string"
 bit.compile = require "core:bitwise/compiler"
 bit.execute = require "core:bitwise/executor"
 

From 5a65cbe07128a149dba7d44bbd69154da871d6c8 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 1 Nov 2025 22:04:39 +0300
Subject: [PATCH 083/133] move PCMStream to audio

---
 res/scripts/hud.lua                                      | 4 ++--
 src/logic/scripting/lua/lua_engine.cpp                   | 8 +++++++-
 src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp | 2 +-
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index 73355ddf..db6f9b79 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -119,12 +119,12 @@ function on_hud_open()
 
     hud.default_hand_controller = update_hand
 
-    stream = PCMStream(44100, 1, 16)
+    stream = audio.PCMStream(44100, 1, 16)
     stream:share("test-stream")
     streamid = audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
 
 
-    s = PCMStream(44100, 1, 8)
+    s = audio.PCMStream(44100, 1, 8)
     local buffer = Bytearray(44100)
     for i=1, #buffer do
         buffer[i] = math.random(1, 8)
diff --git a/src/logic/scripting/lua/lua_engine.cpp b/src/logic/scripting/lua/lua_engine.cpp
index c4507bb1..80e2cff7 100644
--- a/src/logic/scripting/lua/lua_engine.cpp
+++ b/src/logic/scripting/lua/lua_engine.cpp
@@ -131,7 +131,6 @@ void lua::init_state(State* L, StateType stateType) {
     newusertype<LuaHeightmap>(L);
     newusertype<LuaVoxelFragment>(L);
     newusertype<LuaCanvas>(L);
-    newusertype<LuaPCMStream>(L);
 }
 
 void lua::initialize(const EnginePaths& paths, const CoreParameters& params) {
@@ -186,5 +185,12 @@ State* lua::create_state(const EnginePaths& paths, StateType stateType) {
         }
         pop(L);
     }
+    newusertype<LuaPCMStream>(L);
+    if (getglobal(L, "audio")) {
+        if (getglobal(L, "__vc_PCMStream")) {
+            setfield(L, "PCMStream");
+        }
+        pop(L);
+    }
     return L;
 }
diff --git a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp
index 47979693..524c7169 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_pcmstream.hpp
@@ -18,7 +18,7 @@ namespace lua {
             return TYPENAME;
         }
         static int createMetatable(lua::State*);
-        inline static std::string TYPENAME = "PCMStream";
+        inline static std::string TYPENAME = "__vc_PCMStream";
     private:
         std::shared_ptr<audio::MemoryPCMStream> stream;
     };

From 86a4060a689e133d645429f08fcc217f847c13a9 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 1 Nov 2025 23:06:26 +0300
Subject: [PATCH 084/133] feat: multiple audio fetchers support

---
 res/modules/internal/audio_input.lua      | 21 +++++++++++++++++----
 res/modules/internal/bytearray.lua        | 21 +++++++++++++++++++--
 res/scripts/stdlib.lua                    |  9 ++++-----
 res/scripts/stdmin.lua                    |  6 ++++++
 src/logic/scripting/lua/libs/libaudio.cpp |  2 +-
 5 files changed, 47 insertions(+), 12 deletions(-)

diff --git a/res/modules/internal/audio_input.lua b/res/modules/internal/audio_input.lua
index 3540e88b..c0aa638e 100644
--- a/res/modules/internal/audio_input.lua
+++ b/res/modules/internal/audio_input.lua
@@ -5,21 +5,34 @@ local _gui_confirm = gui.confirm
 local _base64_encode_urlsafe = base64.encode_urlsafe
 local _random_bytes = random.bytes
 local _debug_pack_by_frame = debug.get_pack_by_frame
-local _audio_fetch_input = audio.fetch_input
+local _audio_fetch_input = audio.__fetch_input
+audio.__fetch_input = nil
+local MAX_FETCH = 44100 * 4
+
+local total_fetch = Bytearray()
+
+function audio.__reset_fetch_buffer()
+    total_fetch:clear()
+end
 
 function audio.fetch_input(token, size)
+    size = size or MAX_FETCH
     if audio_input_tokens_store[token] then
-        return _audio_fetch_input(size)
+        if #total_fetch >= size then
+            return total_fetch:sub(1, size)
+        end
+        total_fetch:append(_audio_fetch_input(size - #total_fetch))
+        return total_fetch:sub()
     end
     error("access denied")
 end
 
-local GRAND_PERMISSION_MSG = "Grant '%{0}' pack audio recording permission?"
+local GRANT_PERMISSION_MSG = "Grant '%{0}' pack audio recording permission?"
 
 function audio.input.request_open(callback)
     local token = _base64_encode_urlsafe(_random_bytes(18))
     local caller = _debug_pack_by_frame(1)
-    _gui_confirm(gui.str(GRAND_PERMISSION_MSG):gsub("%%{0}", caller), function()
+    _gui_confirm(gui.str(GRANT_PERMISSION_MSG):gsub("%%{0}", caller), function()
         audio_input_tokens_store[token] = caller
         callback(token)
         menu:reset()
diff --git a/res/modules/internal/bytearray.lua b/res/modules/internal/bytearray.lua
index 56795499..7d5d250e 100644
--- a/res/modules/internal/bytearray.lua
+++ b/res/modules/internal/bytearray.lua
@@ -14,6 +14,8 @@ FFI.cdef[[
 
 local malloc = FFI.C.malloc
 local free = FFI.C.free
+local FFIBytearray
+local bytearray_type
 
 local function grow_buffer(self, elems)
     local new_capacity = math.ceil(self.capacity / 0.75 + elems)
@@ -119,6 +121,20 @@ local function get_capacity(self)
     return self.capacity
 end
 
+local function sub(self, offset, length)
+    offset = offset or 1
+    length = length or (self.size - offset + 1)
+    if offset < 1 or offset > self.size then
+        return FFIBytearray(0)
+    end
+    if offset + length - 1 > self.size then
+        length = self.size - offset + 1
+    end
+    local buffer = malloc(length)
+    FFI.copy(buffer, self.bytes + (offset - 1), length)
+    return bytearray_type(buffer, length, length)
+end
+
 local bytearray_methods = {
     append=append,
     insert=insert,
@@ -127,6 +143,7 @@ local bytearray_methods = {
     clear=clear,
     reserve=reserve,
     get_capacity=get_capacity,
+    sub=sub,
 }
 
 local bytearray_mt = {
@@ -168,9 +185,9 @@ local bytearray_mt = {
 }
 bytearray_mt.__pairs = bytearray_mt.__ipairs
 
-local bytearray_type = FFI.metatype("bytearray_t", bytearray_mt)
+bytearray_type = FFI.metatype("bytearray_t", bytearray_mt)
 
-local FFIBytearray = {
+FFIBytearray = {
     __call = function (self, n)
         local t = type(n)
         if t == "string" then
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 71a8256e..19c17384 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -211,11 +211,6 @@ entities.get_all = function(uids)
     end
 end
 
-local bytearray = require "core:internal/bytearray"
-Bytearray = bytearray.FFIBytearray
-Bytearray_as_string = bytearray.FFIBytearray_as_string
-Bytearray_construct = function(...) return Bytearray(...) end
-
 __vc_scripts_registry = require "core:internal/scripts_registry"
 
 file.open = require "core:internal/stream_providers/file"
@@ -424,6 +419,9 @@ end
 
 local __post_runnables = {}
 
+local fn_audio_reset_fetch_buffer = audio.__reset_fetch_buffer
+audio.__reset_fetch_buffer = nil
+
 function __process_post_runnables()
     if #__post_runnables then
         for _, func in ipairs(__post_runnables) do
@@ -449,6 +447,7 @@ function __process_post_runnables()
         __vc_named_coroutines[name] = nil
     end
 
+    fn_audio_reset_fetch_buffer()
     debug.pull_events()
     network.__process_events()
     block.__process_register_events()
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 7e8678e5..49714b99 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -265,6 +265,12 @@ require "core:internal/extensions/math"
 require "core:internal/extensions/file"
 require "core:internal/extensions/table"
 require "core:internal/extensions/string"
+
+local bytearray = require "core:internal/bytearray"
+Bytearray = bytearray.FFIBytearray
+Bytearray_as_string = bytearray.FFIBytearray_as_string
+Bytearray_construct = function(...) return Bytearray(...) end
+
 bit.compile = require "core:bitwise/compiler"
 bit.execute = require "core:bitwise/executor"
 
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index ed2e3db6..37c26549 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -476,7 +476,7 @@ const luaL_Reg audiolib[] = {
     {"get_velocity", lua::wrap<l_audio_get_velocity>},
     {"count_speakers", lua::wrap<l_audio_count_speakers>},
     {"count_streams", lua::wrap<l_audio_count_streams>},
-    {"fetch_input", lua::wrap<l_audio_fetch_input>},
+    {"__fetch_input", lua::wrap<l_audio_fetch_input>},
     {"get_input_devices_names", lua::wrap<l_audio_get_input_devices_names>},
     {"get_output_devices_names", lua::wrap<l_audio_get_output_devices_names>},
     {"set_input_device", lua::wrap<l_audio_set_input_device>},

From aa54e900d9b10f9e2e32dacc340bd65551d4a672 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 2 Nov 2025 01:17:56 +0300
Subject: [PATCH 085/133] add U16view, I16view, U32view, I32view classes

---
 res/modules/internal/audio_input.lua |  4 +-
 res/modules/internal/bytearray.lua   | 61 ++++++++++++++++++++++++++--
 res/scripts/hud.lua                  |  9 ++--
 res/scripts/stdmin.lua               |  4 ++
 4 files changed, 69 insertions(+), 9 deletions(-)

diff --git a/res/modules/internal/audio_input.lua b/res/modules/internal/audio_input.lua
index c0aa638e..b87c7071 100644
--- a/res/modules/internal/audio_input.lua
+++ b/res/modules/internal/audio_input.lua
@@ -19,10 +19,10 @@ function audio.fetch_input(token, size)
     size = size or MAX_FETCH
     if audio_input_tokens_store[token] then
         if #total_fetch >= size then
-            return total_fetch:sub(1, size)
+            return total_fetch:slice(1, size)
         end
         total_fetch:append(_audio_fetch_input(size - #total_fetch))
-        return total_fetch:sub()
+        return total_fetch:slice()
     end
     error("access denied")
 end
diff --git a/res/modules/internal/bytearray.lua b/res/modules/internal/bytearray.lua
index 7d5d250e..c292d6a8 100644
--- a/res/modules/internal/bytearray.lua
+++ b/res/modules/internal/bytearray.lua
@@ -121,7 +121,7 @@ local function get_capacity(self)
     return self.capacity
 end
 
-local function sub(self, offset, length)
+local function slice(self, offset, length)
     offset = offset or 1
     length = length or (self.size - offset + 1)
     if offset < 1 or offset > self.size then
@@ -131,6 +131,9 @@ local function sub(self, offset, length)
         length = self.size - offset + 1
     end
     local buffer = malloc(length)
+    if not buffer then
+        error("malloc(" .. length .. ") returned NULL")
+    end
     FFI.copy(buffer, self.bytes + (offset - 1), length)
     return bytearray_type(buffer, length, length)
 end
@@ -143,7 +146,7 @@ local bytearray_methods = {
     clear=clear,
     reserve=reserve,
     get_capacity=get_capacity,
-    sub=sub,
+    slice=slice,
 }
 
 local bytearray_mt = {
@@ -227,7 +230,59 @@ local function FFIBytearray_as_string(bytes)
     end
 end
 
+local function create_FFIview_class(name, typename, typesize)
+    local FFIU16view_mt = {
+        __index = function(self, key)
+            if key <= 0 or key > self.size then
+                return
+            end
+            return self.ptr[key - 1]
+        end,
+        __newindex = function(self, key, value)
+            if key == self.size + 1 then
+                return append(self, value)
+            elseif key <= 0 or key > self.size then
+                return
+            end
+            self.ptr[key - 1] = value
+        end,
+        __len = function(self)
+            return self.size
+        end,
+        __tostring = function(self)
+            return string.format(name .. "[%s]{...}", tonumber(self.size))
+        end,
+        __ipairs = function(self)
+            local i = 0
+            return function()
+                i = i + 1
+                if i <= self.size then
+                    return i, self.ptr[i - 1]
+                end
+            end
+        end
+    }
+    return function (bytes)
+        local ptr = FFI.cast(typename .. "*", bytes.bytes)
+        local x = setmetatable({
+            bytes=bytes,
+            ptr=ptr,
+            size=math.floor(bytes.size / typesize),
+        }, FFIU16view_mt)
+        return x
+    end
+end
+
+local FFII16view = create_FFIview_class("FFII16view", "int16_t", 2)
+local FFIU16view = create_FFIview_class("FFIU16view", "uint16_t", 2)
+local FFII32view = create_FFIview_class("FFII32view", "int32_t", 4)
+local FFIU32view = create_FFIview_class("FFIU32view", "uint32_t", 4)
+
 return {
     FFIBytearray = setmetatable(FFIBytearray, FFIBytearray),
-    FFIBytearray_as_string = FFIBytearray_as_string
+    FFIBytearray_as_string = FFIBytearray_as_string,
+    FFIU16view = FFIU16view,
+    FFII16view = FFII16view,
+    FFIU32view = FFIU32view,
+    FFII32view = FFII32view,
 }
diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index db6f9b79..3e2fecb1 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -124,10 +124,11 @@ function on_hud_open()
     streamid = audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
 
 
-    s = audio.PCMStream(44100, 1, 8)
-    local buffer = Bytearray(44100)
-    for i=1, #buffer do
-        buffer[i] = math.random(1, 8)
+    s = audio.PCMStream(44100, 1, 16)
+    local buffer = Bytearray(44100 * 4)
+    local view = U16view(buffer)
+    for i=1, view.size do
+        view[i] = 16000 + math.sin(i / 200.0 * (1 + i * 0.0001)) * 2000
     end
     s:feed(buffer)
     s:create_sound("test-sound")
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 49714b99..63409c36 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -269,6 +269,10 @@ require "core:internal/extensions/string"
 local bytearray = require "core:internal/bytearray"
 Bytearray = bytearray.FFIBytearray
 Bytearray_as_string = bytearray.FFIBytearray_as_string
+U16view = bytearray.FFIU16view
+I16view = bytearray.FFII16view
+U32view = bytearray.FFIU32view
+I32view = bytearray.FFII32view
 Bytearray_construct = function(...) return Bytearray(...) end
 
 bit.compile = require "core:bitwise/compiler"

From 90f7fce2b1051cd8dce5496b368c35f6fe745bbc Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 09:30:38 +0300
Subject: [PATCH 086/133] feat: pass pack environment to menu page script

---
 src/logic/scripting/lua/libs/libgui.cpp | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index 6395dc5b..0f8ac2da 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -19,6 +19,8 @@
 #include "graphics/ui/gui_util.hpp"
 #include "graphics/ui/markdown.hpp"
 #include "graphics/core/Font.hpp"
+#include "content/Content.hpp"
+#include "content/ContentPack.hpp"
 #include "items/Inventories.hpp"
 #include "util/stringutil.hpp"
 #include "world/Level.hpp"
@@ -1026,13 +1028,17 @@ static int l_gui_load_document(lua::State* L) {
     io::path filename = lua::require_string(L, 1);
     auto alias = lua::require_string(L, 2);
     auto args = lua::tovalue(L, 3);
-    
+    auto prefix = filename.entryPoint();
+
+    auto env = scripting::get_root_environment();
+    if (content) {
+        if (auto runtime = content->getPackRuntime(prefix)) {
+            env = runtime->getEnvironment();
+        }
+    }
+
     auto documentPtr = UiDocument::read(
-        engine->getGUI(),
-        scripting::get_root_environment(),
-        alias,
-        filename,
-        filename.string()
+        engine->getGUI(), std::move(env), alias, filename, filename.string()
     );
     auto document = documentPtr.get();
     engine->getAssets()->store(std::move(documentPtr), alias);

From ca6096c397639f6f627e806eafa8ca0aa2f295d7 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 11:53:48 +0300
Subject: [PATCH 087/133] minor refactor

---
 res/layouts/pages/scripts.xml.lua | 12 ++----------
 res/scripts/stdlib.lua            | 14 ++++++++++++++
 src/engine/ServerMainloop.cpp     |  3 +--
 src/logic/scripting/scripting.cpp | 13 +++++++++++--
 src/logic/scripting/scripting.hpp |  1 +
 5 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/res/layouts/pages/scripts.xml.lua b/res/layouts/pages/scripts.xml.lua
index dad0d1ff..72c3246f 100644
--- a/res/layouts/pages/scripts.xml.lua
+++ b/res/layouts/pages/scripts.xml.lua
@@ -1,18 +1,10 @@
 function run_script(path)
-    debug.log("starting application script "..path)
-
-    local code = file.read(path)
-    local chunk, err = loadstring(code, path)
-    if chunk == nil then
-        error(err)
-    end
-    setfenv(chunk, setmetatable({app=__vc_app}, {__index=_G}))
-    start_coroutine(chunk, path)
+    __vc_start_app_script(path)
 end
 
 function refresh()
     document.list:clear()
-    
+
     local allpacks = table.merge(pack.get_available(), pack.get_installed())
     local infos = pack.get_info(allpacks)
     for _, name in ipairs(allpacks) do
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 3f732e07..447f7dd4 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -186,6 +186,20 @@ events = require "core:internal/events"
 
 function pack.unload(prefix)
     events.remove_by_prefix(prefix)
+    __vc__pack_envs[prefix] = nil
+end
+
+function __vc_start_app_script(path)
+    debug.log("starting application script "..path)
+
+    local code = file.read(path)
+    local chunk, err = loadstring(code, path)
+    if chunk == nil then
+        error(err)
+    end
+    local script_env = setmetatable({app = app or __vc_app}, {__index=_G})
+    setfenv(chunk, script_env)
+    return start_coroutine(chunk, path)
 end
 
 gui_util = require "core:internal/gui_util"
diff --git a/src/engine/ServerMainloop.cpp b/src/engine/ServerMainloop.cpp
index 2f446533..ab35ffbd 100644
--- a/src/engine/ServerMainloop.cpp
+++ b/src/engine/ServerMainloop.cpp
@@ -32,8 +32,7 @@ void ServerMainloop::run() {
         setLevel(std::move(level));
     });
 
-    logger.info() << "starting test " << coreParams.scriptFile.string();
-    auto process = scripting::start_coroutine(
+    auto process = scripting::start_app_script(
         "script:" + coreParams.scriptFile.filename().u8string()
     );
 
diff --git a/src/logic/scripting/scripting.cpp b/src/logic/scripting/scripting.cpp
index 4d3672f1..c15f30aa 100644
--- a/src/logic/scripting/scripting.cpp
+++ b/src/logic/scripting/scripting.cpp
@@ -151,9 +151,10 @@ std::unique_ptr<IClientProjectScript> scripting::load_client_project_script(
     return std::make_unique<LuaProjectScript>(L, std::move(env));
 }
 
-std::unique_ptr<Process> scripting::start_coroutine(const io::path& script) {
+static std::unique_ptr<Process> start_lua_coroutine(
+    const io::path& script, const std::string& method
+) {
     auto L = lua::get_main_state();
-    auto method = "__vc_start_coroutine";
     if (lua::getglobal(L, method)) {
         auto source = io::read_string(script);
         lua::loadbuffer(L, 0, source, script.name());
@@ -167,6 +168,14 @@ std::unique_ptr<Process> scripting::start_coroutine(const io::path& script) {
     return nullptr;
 }
 
+std::unique_ptr<Process> scripting::start_coroutine(const io::path& script) {
+    return start_lua_coroutine(script, "__vc_start_coroutine");
+}
+
+std::unique_ptr<Process> scripting::start_app_script(const io::path& script) {
+    return start_lua_coroutine(script, "__vc_start_app_script");
+}
+
 [[nodiscard]] scriptenv scripting::get_root_environment() {
     return std::make_shared<int>(0);
 }
diff --git a/src/logic/scripting/scripting.hpp b/src/logic/scripting/scripting.hpp
index 5a86b81d..2f45ae60 100644
--- a/src/logic/scripting/scripting.hpp
+++ b/src/logic/scripting/scripting.hpp
@@ -77,6 +77,7 @@ namespace scripting {
     );
 
     std::unique_ptr<Process> start_coroutine(const io::path& script);
+    std::unique_ptr<Process> start_app_script(const io::path& script);
 
     void on_world_load(LevelController* controller);
     void on_world_tick(int tps);

From 9afe265094abf7fcc8535d6a58ec725d02df3847 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 11:59:58 +0300
Subject: [PATCH 088/133] update doc/*/scripting/builtins/libapp.md

---
 doc/en/scripting/builtins/libapp.md | 2 ++
 doc/ru/scripting/builtins/libapp.md | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/doc/en/scripting/builtins/libapp.md b/doc/en/scripting/builtins/libapp.md
index 69a472ee..45414ba1 100644
--- a/doc/en/scripting/builtins/libapp.md
+++ b/doc/en/scripting/builtins/libapp.md
@@ -7,6 +7,8 @@ The script/test name without the path and extension is available as `app.script`
 local filename = "script:"..app.script..".lua"
 ```
 
+Since the control script may not belong to any of the packs, it does not belongs to its own package and has its own global namespace in which all global functions and tables are available, as well as the `app` library.
+
 ## Functions
 
 ```lua
diff --git a/doc/ru/scripting/builtins/libapp.md b/doc/ru/scripting/builtins/libapp.md
index 4e9493c4..d2ddec72 100644
--- a/doc/ru/scripting/builtins/libapp.md
+++ b/doc/ru/scripting/builtins/libapp.md
@@ -7,6 +7,8 @@
 local filename = "script:"..app.script..".lua"
 ```
 
+Так как управляющий сценарий может не принадлежать ни одному из паков, он не относиться к своему паку и имеет собственное пространство имён, в котором доступны все глобальные функции и таблицы, а также библиотека `app`.
+
 ## Функции
 
 ```lua

From d163f12e6796379fcf4536e8ee2abe5413561260 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 12:13:55 +0300
Subject: [PATCH 089/133] fix

---
 res/scripts/stdlib.lua            |  4 ++--
 src/logic/scripting/scripting.cpp | 17 +++--------------
 src/logic/scripting/scripting.hpp |  1 -
 3 files changed, 5 insertions(+), 17 deletions(-)

diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 447f7dd4..4443eed3 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -198,8 +198,8 @@ function __vc_start_app_script(path)
         error(err)
     end
     local script_env = setmetatable({app = app or __vc_app}, {__index=_G})
-    setfenv(chunk, script_env)
-    return start_coroutine(chunk, path)
+    chunk = setfenv(chunk, script_env)
+    return __vc_start_coroutine(chunk, path)
 end
 
 gui_util = require "core:internal/gui_util"
diff --git a/src/logic/scripting/scripting.cpp b/src/logic/scripting/scripting.cpp
index c15f30aa..586feeb8 100644
--- a/src/logic/scripting/scripting.cpp
+++ b/src/logic/scripting/scripting.cpp
@@ -151,13 +151,10 @@ std::unique_ptr<IClientProjectScript> scripting::load_client_project_script(
     return std::make_unique<LuaProjectScript>(L, std::move(env));
 }
 
-static std::unique_ptr<Process> start_lua_coroutine(
-    const io::path& script, const std::string& method
-) {
+std::unique_ptr<Process> scripting::start_app_script(const io::path& script) {
     auto L = lua::get_main_state();
-    if (lua::getglobal(L, method)) {
-        auto source = io::read_string(script);
-        lua::loadbuffer(L, 0, source, script.name());
+    if (lua::getglobal(L, "__vc_start_app_script")) {
+        lua::pushstring(L, script.string());
         if (lua::call(L, 1)) {
             int id = lua::tointeger(L, -1);
             lua::pop(L, 1);
@@ -168,14 +165,6 @@ static std::unique_ptr<Process> start_lua_coroutine(
     return nullptr;
 }
 
-std::unique_ptr<Process> scripting::start_coroutine(const io::path& script) {
-    return start_lua_coroutine(script, "__vc_start_coroutine");
-}
-
-std::unique_ptr<Process> scripting::start_app_script(const io::path& script) {
-    return start_lua_coroutine(script, "__vc_start_app_script");
-}
-
 [[nodiscard]] scriptenv scripting::get_root_environment() {
     return std::make_shared<int>(0);
 }
diff --git a/src/logic/scripting/scripting.hpp b/src/logic/scripting/scripting.hpp
index 2f45ae60..d9c7e614 100644
--- a/src/logic/scripting/scripting.hpp
+++ b/src/logic/scripting/scripting.hpp
@@ -76,7 +76,6 @@ namespace scripting {
         const io::path& script
     );
 
-    std::unique_ptr<Process> start_coroutine(const io::path& script);
     std::unique_ptr<Process> start_app_script(const io::path& script);
 
     void on_world_load(LevelController* controller);

From 751489b00363d354b64695acb5a90486e6bf9674 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 16:17:57 +0300
Subject: [PATCH 090/133] add input.get_mouse_delta()

---
 doc/en/scripting/builtins/libinput.md     | 6 ++++++
 doc/ru/scripting/builtins/libinput.md     | 6 ++++++
 src/logic/scripting/lua/libs/libinput.cpp | 7 +++++++
 3 files changed, 19 insertions(+)

diff --git a/doc/en/scripting/builtins/libinput.md b/doc/en/scripting/builtins/libinput.md
index 02f2a8d0..2c577389 100644
--- a/doc/en/scripting/builtins/libinput.md
+++ b/doc/en/scripting/builtins/libinput.md
@@ -48,6 +48,12 @@ input.get_mouse_pos() --> {int, int}
 
 Returns cursor screen position.
 
+```lua
+input.get_mouse_delta() --> {int, int}
+```
+
+Returns cursor movement delta.
+
 ```lua
 input.get_bindings() --> strings array
 ```
diff --git a/doc/ru/scripting/builtins/libinput.md b/doc/ru/scripting/builtins/libinput.md
index afe22ee6..96bc3105 100644
--- a/doc/ru/scripting/builtins/libinput.md
+++ b/doc/ru/scripting/builtins/libinput.md
@@ -48,6 +48,12 @@ input.get_mouse_pos() --> {int, int}
 
 Возвращает позицию курсора на экране.
 
+```lua
+input.get_mouse_delta() --> {int, int}
+```
+
+Возращает дельту позиции курсора.
+
 ```lua
 input.get_bindings() --> массив строк
 ```
diff --git a/src/logic/scripting/lua/libs/libinput.cpp b/src/logic/scripting/lua/libs/libinput.cpp
index 6d75fd4b..eb605671 100644
--- a/src/logic/scripting/lua/libs/libinput.cpp
+++ b/src/logic/scripting/lua/libs/libinput.cpp
@@ -82,6 +82,12 @@ static int l_get_mouse_pos(lua::State* L) {
     return lua::pushvec2(L, engine->getInput().getCursor().pos);
 }
 
+static int l_get_mouse_delta(lua::State* L) {
+    if (engine->isHeadless())
+        return 0;
+    return lua::pushvec2(L, engine->getInput().getCursor().delta);
+}
+
 static int l_get_bindings(lua::State* L) {
     if (engine->isHeadless())
         return 0;
@@ -171,6 +177,7 @@ const luaL_Reg inputlib[] = {
     {"mousecode", lua::wrap<l_mousecode>},
     {"add_callback", lua::wrap<l_add_callback>},
     {"get_mouse_pos", lua::wrap<l_get_mouse_pos>},
+    {"get_mouse_delta", lua::wrap<l_get_mouse_delta>},
     {"get_bindings", lua::wrap<l_get_bindings>},
     {"get_binding_text", lua::wrap<l_get_binding_text>},
     {"is_active", lua::wrap<l_is_active>},

From 9e817c39ce6fc5ee11f2005dabfa0dab1fb952fe Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 17:55:01 +0300
Subject: [PATCH 091/133] disable mouse camera control if non-standard camera
 used

---
 src/frontend/LevelFrontend.cpp | 3 +--
 src/logic/PlayerController.cpp | 5 ++---
 src/objects/Player.cpp         | 6 ++++++
 src/objects/Player.hpp         | 6 ++++++
 4 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/src/frontend/LevelFrontend.cpp b/src/frontend/LevelFrontend.cpp
index 5dfdf822..9a8553da 100644
--- a/src/frontend/LevelFrontend.cpp
+++ b/src/frontend/LevelFrontend.cpp
@@ -49,8 +49,7 @@ LevelFrontend::LevelFrontend(
                 auto sound = rassets.get<audio::Sound>(material->stepsSound);
                 glm::vec3 pos {};
                 auto soundsCamera = currentPlayer->currentCamera.get();
-                if (soundsCamera == currentPlayer->spCamera.get() ||
-                    soundsCamera == currentPlayer->tpCamera.get()) {
+                if (currentPlayer->isCurrentCameraBuiltin()) {
                     soundsCamera = currentPlayer->fpCamera.get();
                 }
                 bool relative = player == currentPlayer && 
diff --git a/src/logic/PlayerController.cpp b/src/logic/PlayerController.cpp
index 0ced9425..9de01404 100644
--- a/src/logic/PlayerController.cpp
+++ b/src/logic/PlayerController.cpp
@@ -207,8 +207,7 @@ void CameraControl::update(
         tpCamera->front = camera->front;
         tpCamera->right = camera->right;
     }
-    if (player.currentCamera == spCamera || player.currentCamera == tpCamera ||
-        player.currentCamera == camera) {
+    if (player.isCurrentCameraBuiltin()) {
         player.currentCamera->setFov(glm::radians(settings.fov.get()));
     }
 }
@@ -280,7 +279,7 @@ void PlayerController::postUpdate(
         updateFootsteps(delta);
     }
 
-    if (!pause && input) {
+    if (!pause && input && player.isCurrentCameraBuiltin()) {
         camControl.updateMouse(this->input, windowHeight);
     }
     camControl.refreshRotation();
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index f14f9d2d..f27dc743 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -84,6 +84,12 @@ Hitbox* Player::getHitbox() {
     return nullptr;
 }
 
+bool Player::isCurrentCameraBuiltin() const {
+    return currentCamera.get() == fpCamera.get() ||
+           currentCamera.get() == spCamera.get() ||
+           currentCamera.get() == tpCamera.get();
+}
+
 void Player::updateSelectedEntity() {
     selectedEid = selection.entity;
 }
diff --git a/src/objects/Player.hpp b/src/objects/Player.hpp
index 7d6523f2..18c5a599 100644
--- a/src/objects/Player.hpp
+++ b/src/objects/Player.hpp
@@ -131,6 +131,8 @@ public:
         return position;
     }
 
+    bool isCurrentCameraBuiltin() const;
+
     Hitbox* getHitbox();
 
     void setSpawnPoint(glm::vec3 point);
@@ -147,4 +149,8 @@ public:
     inline u64id_t getId() const {
         return id;
     }
+
+    Level& getLevel() const {
+        return level;
+    }
 };

From 88e61125d198d0c66482b3b8afa8295910d6f9f5 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 19:47:35 +0300
Subject: [PATCH 092/133] add device select to audio settings

---
 res/layouts/pages/settings_audio.xml.lua  | 34 +++++++++++++++++++++++
 res/layouts/templates/problem.xml         |  2 +-
 res/layouts/templates/script_file.xml     |  2 +-
 res/modules/internal/audio_input.lua      | 33 ++++++++++++++++++----
 res/scripts/hud.lua                       |  8 ++++--
 src/audio/AL/ALAudio.cpp                  | 11 ++++++++
 src/audio/AL/ALAudio.hpp                  |  2 ++
 src/audio/audio.hpp                       |  5 ++++
 src/logic/scripting/lua/libs/libaudio.cpp |  4 ++-
 9 files changed, 91 insertions(+), 10 deletions(-)

diff --git a/res/layouts/pages/settings_audio.xml.lua b/res/layouts/pages/settings_audio.xml.lua
index 9b29bd52..1b14cf04 100644
--- a/res/layouts/pages/settings_audio.xml.lua
+++ b/res/layouts/pages/settings_audio.xml.lua
@@ -24,10 +24,44 @@ function update_setting(x, id, name, postfix)
     )
 end
 
+local initialized = false
+
 function on_open()
+    if not initialized then
+        initialized = true
+        local token = audio.input.__get_core_token()
+        document.root:add("<container id='tm' />")
+        local prev_amplitude = 0.0
+        document.tm:setInterval(16, function()
+            audio.input.fetch_input(token)
+            local amplitude = audio.input.get_max_amplitude()
+            if amplitude > 0.0 then
+                amplitude = math.sqrt(amplitude)
+            end
+            document.input_volume_inner.size = {
+                prev_amplitude *
+                document.input_volume_outer.size[1],
+                document.input_volume_outer.size[2]
+            }
+            prev_amplitude = amplitude * 0.25 + prev_amplitude * 0.75
+        end)
+    end
     create_setting("audio.volume-master", "Master Volume", 0.01)
     create_setting("audio.volume-regular", "Regular Sounds", 0.01)
     create_setting("audio.volume-ui", "UI Sounds", 0.01)
     create_setting("audio.volume-ambient", "Ambient", 0.01)
     create_setting("audio.volume-music", "Music", 0.01)
+    document.root:add("<select id='input_device_select' "..
+        "onselect='function(opt) audio.set_input_device(opt) end'/>")
+    document.root:add("<container id='input_volume_outer' color='#000000' size='4'>"
+                        .."<container id='input_volume_inner' color='#00FF00FF' size='4'/>"
+                    .."</container>")
+    local selectbox = document.input_device_select
+    local devices = {}
+    local names = audio.get_input_devices_names()
+    for i, name in ipairs(names) do
+        table.insert(devices, {value=name, text=name})
+    end
+    selectbox.options = devices
+    selectbox.value = audio.get_input_info().device_specifier
 end
diff --git a/res/layouts/templates/problem.xml b/res/layouts/templates/problem.xml
index f4382dbb..b2bfdfe9 100644
--- a/res/layouts/templates/problem.xml
+++ b/res/layouts/templates/problem.xml
@@ -1,7 +1,7 @@
 <container id="%{id}" size="32" tooltip="%{text}" 
            onclick="events.emit('core:open_traceback', '%{traceback}')">
     <image src="gui/%{type}" size="32"/>
-    <label pos="36,2" sizefunc="-1,-1">%{text}</label>
+    <label pos="36,2" size-func="-1,-1">%{text}</label>
     <image src="gui/cross" interactive="true" size="16" gravity="top-right" 
            onclick="document['%{id}']:destruct()"></image>
 </container>
diff --git a/res/layouts/templates/script_file.xml b/res/layouts/templates/script_file.xml
index f5d55729..69a63342 100644
--- a/res/layouts/templates/script_file.xml
+++ b/res/layouts/templates/script_file.xml
@@ -6,7 +6,7 @@
         onclick='%{open_func}("%{filename}")'
         markup='md'
         tooltip='%{unit}'
-        sizefunc="-1,-1">
+        size-func="-1,-1">
         [#FFFFFF80]%{path}[#FFFFFFFF]%{name}
     </label>
 </container>
diff --git a/res/modules/internal/audio_input.lua b/res/modules/internal/audio_input.lua
index b87c7071..f61d5300 100644
--- a/res/modules/internal/audio_input.lua
+++ b/res/modules/internal/audio_input.lua
@@ -1,27 +1,43 @@
-local audio_input_tokens_store = {}
+local _base64_encode_urlsafe = base64.encode_urlsafe
+local _random_bytes = random.bytes
+local core_token = _base64_encode_urlsafe(_random_bytes(18))
+
+local audio_input_tokens_store = {[core_token] = "core"}
 audio.input = {}
 
 local _gui_confirm = gui.confirm
-local _base64_encode_urlsafe = base64.encode_urlsafe
-local _random_bytes = random.bytes
 local _debug_pack_by_frame = debug.get_pack_by_frame
 local _audio_fetch_input = audio.__fetch_input
 audio.__fetch_input = nil
 local MAX_FETCH = 44100 * 4
+local MAX_AMPLITUDE = 32768
 
 local total_fetch = Bytearray()
+local max_amplitude = 0.0
 
 function audio.__reset_fetch_buffer()
     total_fetch:clear()
+    max_amplitude = 0.0
 end
 
-function audio.fetch_input(token, size)
+function audio.input.get_max_amplitude()
+    return max_amplitude / MAX_AMPLITUDE
+end
+
+function audio.input.fetch_input(token, size)
     size = size or MAX_FETCH
     if audio_input_tokens_store[token] then
         if #total_fetch >= size then
             return total_fetch:slice(1, size)
         end
-        total_fetch:append(_audio_fetch_input(size - #total_fetch))
+        local fetched = _audio_fetch_input(size - #total_fetch)
+        if not fetched then
+            return
+        end
+        for i, sample in ipairs(I16view(fetched)) do
+            max_amplitude = math.max(math.abs(sample))
+        end
+        total_fetch:append(fetched)
         return total_fetch:slice()
     end
     error("access denied")
@@ -38,3 +54,10 @@ function audio.input.request_open(callback)
         menu:reset()
     end)
 end
+
+function audio.input.__get_core_token()
+    local caller = _debug_pack_by_frame(1)
+    if caller == "core" then
+        return core_token
+    end
+end
diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index 3e2fecb1..0124c93d 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -119,6 +119,8 @@ function on_hud_open()
 
     hud.default_hand_controller = update_hand
 
+    debug.print(audio.get_input_devices_names())
+
     stream = audio.PCMStream(44100, 1, 16)
     stream:share("test-stream")
     streamid = audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
@@ -147,7 +149,9 @@ function on_hud_render()
     end
 
     if input_access_token then
-        local bytes = audio.fetch_input(input_access_token)
-        stream:feed(bytes)
+        local bytes = audio.input.fetch_input(input_access_token)
+        if bytes then
+            stream:feed(bytes)
+        end
     end
 end
diff --git a/src/audio/AL/ALAudio.cpp b/src/audio/AL/ALAudio.cpp
index 83d5c4f4..e38c0f16 100644
--- a/src/audio/AL/ALAudio.cpp
+++ b/src/audio/AL/ALAudio.cpp
@@ -79,6 +79,13 @@ ALInputDevice::ALInputDevice(
       channels(channels),
       bitsPerSample(bitsPerSample),
       sampleRate(sampleRate) {
+    const ALCchar* deviceName = alcGetString(device, ALC_CAPTURE_DEVICE_SPECIFIER);
+
+    if (deviceName) {
+        deviceSpecifier = std::string(deviceName);
+    } else {
+        logger.warning() << "could not retrieve input device specifier";
+    }
 }
 
 ALInputDevice::~ALInputDevice() {
@@ -108,6 +115,10 @@ uint ALInputDevice::getBitsPerSample() const {
     return bitsPerSample;
 }
 
+const std::string& ALInputDevice::getDeviceSpecifier() const {
+    return deviceSpecifier;
+}
+
 size_t ALInputDevice::read(char* buffer, size_t bufferSize) {
     ALCint samplesCount = 0;
     alcGetIntegerv(device, ALC_CAPTURE_SAMPLES, sizeof(samplesCount), &samplesCount);
diff --git a/src/audio/AL/ALAudio.hpp b/src/audio/AL/ALAudio.hpp
index 39e6f337..f154741f 100644
--- a/src/audio/AL/ALAudio.hpp
+++ b/src/audio/AL/ALAudio.hpp
@@ -104,6 +104,7 @@ namespace audio {
         uint getChannels() const override;
         uint getSampleRate() const override;
         uint getBitsPerSample() const override;
+        const std::string& getDeviceSpecifier() const override;
 
         size_t read(char* buffer, size_t bufferSize) override;
     private:
@@ -112,6 +113,7 @@ namespace audio {
         uint channels;
         uint bitsPerSample;
         uint sampleRate;
+        std::string deviceSpecifier;
     };
 
     /// @brief AL source adapter
diff --git a/src/audio/audio.hpp b/src/audio/audio.hpp
index 551fd7ec..2cd8c127 100644
--- a/src/audio/audio.hpp
+++ b/src/audio/audio.hpp
@@ -127,7 +127,12 @@ namespace audio {
         /// @return 8 or 16
         virtual uint getBitsPerSample() const = 0;
 
+        /// @brief Read available data to buffer.
+        /// @return size of data received or PCMStream::ERROR in case of error
         virtual size_t read(char* buffer, size_t bufferSize) = 0;
+
+        /// @brief Get device specifier string
+        virtual const std::string& getDeviceSpecifier() const = 0;
     };
 
     /// @brief audio::PCMStream is a data source for audio::Stream
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index 37c26549..a848f7d0 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -441,7 +441,9 @@ static int l_audio_get_input_info(lua::State* L) {
     if (device == nullptr) {
         return 0;
     }
-    lua::createtable(L, 0, 3);
+    lua::createtable(L, 0, 4);
+    lua::pushlstring(L, device->getDeviceSpecifier());
+    lua::setfield(L, "device_specifier");
     lua::pushinteger(L, device->getChannels());
     lua::setfield(L, "channels");
     lua::pushinteger(L, device->getSampleRate());

From 41e2b015d7c506923e41038ae4d6c309645b6c5d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 4 Nov 2025 22:06:06 +0300
Subject: [PATCH 093/133] update audio settings page

---
 res/layouts/pages/settings_audio.xml.lua | 6 ++++--
 res/texts/ru_RU.txt                      | 1 +
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/res/layouts/pages/settings_audio.xml.lua b/res/layouts/pages/settings_audio.xml.lua
index 1b14cf04..82fc7f0b 100644
--- a/res/layouts/pages/settings_audio.xml.lua
+++ b/res/layouts/pages/settings_audio.xml.lua
@@ -38,12 +38,13 @@ function on_open()
             if amplitude > 0.0 then
                 amplitude = math.sqrt(amplitude)
             end
+            amplitude = math.max(amplitude, prev_amplitude - time.delta())
             document.input_volume_inner.size = {
                 prev_amplitude *
                 document.input_volume_outer.size[1],
                 document.input_volume_outer.size[2]
             }
-            prev_amplitude = amplitude * 0.25 + prev_amplitude * 0.75
+            prev_amplitude = amplitude
         end)
     end
     create_setting("audio.volume-master", "Master Volume", 0.01)
@@ -51,10 +52,11 @@ function on_open()
     create_setting("audio.volume-ui", "UI Sounds", 0.01)
     create_setting("audio.volume-ambient", "Ambient", 0.01)
     create_setting("audio.volume-music", "Music", 0.01)
+    document.root:add("<label context='settings'>@Microphone</label>")
     document.root:add("<select id='input_device_select' "..
         "onselect='function(opt) audio.set_input_device(opt) end'/>")
     document.root:add("<container id='input_volume_outer' color='#000000' size='4'>"
-                        .."<container id='input_volume_inner' color='#00FF00FF' size='4'/>"
+                        .."<container id='input_volume_inner' color='#00FF00FF' pos='1' size='2'/>"
                     .."</container>")
     local selectbox = document.input_device_select
     local devices = {}
diff --git a/res/texts/ru_RU.txt b/res/texts/ru_RU.txt
index cc6de475..9dec5dfd 100644
--- a/res/texts/ru_RU.txt
+++ b/res/texts/ru_RU.txt
@@ -106,6 +106,7 @@ settings.Shadows quality=Качество теней
 settings.Conflict=Найдены возможные конфликты
 settings.Windowed=Оконный
 settings.Borderless=Безрамочный
+settings.Microphone=Микрофон
 
 # Управление
 chunks.reload=Перезагрузить Чанки

From d9f2d54bf0b891ee01678191b2a7a3aa2428c8a8 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 00:20:58 +0300
Subject: [PATCH 094/133] feat: canvas from texture atlas element

---
 src/graphics/core/Atlas.cpp                   |  8 +++
 src/graphics/core/Atlas.hpp                   |  7 ++-
 src/graphics/core/ImageData.cpp               | 11 ++++
 src/graphics/core/ImageData.hpp               |  2 +
 src/graphics/core/Texture.cpp                 |  6 +++
 src/graphics/core/Texture.hpp                 |  1 +
 src/logic/scripting/lua/libs/libassets.cpp    | 31 +++++++++++
 src/logic/scripting/lua/lua_custom_types.hpp  | 25 +++++----
 .../lua/usertypes/lua_type_canvas.cpp         | 54 ++++++++++++++-----
 src/maths/UVRegion.hpp                        |  9 +++-
 10 files changed, 126 insertions(+), 28 deletions(-)

diff --git a/src/graphics/core/Atlas.cpp b/src/graphics/core/Atlas.cpp
index be205d1e..d06a20b9 100644
--- a/src/graphics/core/Atlas.cpp
+++ b/src/graphics/core/Atlas.cpp
@@ -49,6 +49,14 @@ ImageData* Atlas::getImage() const {
     return image.get();
 }
 
+std::shared_ptr<Texture> Atlas::shareTexture() const {
+    return texture;
+}
+
+std::shared_ptr<ImageData> Atlas::shareImageData() const {
+    return image;
+}
+
 void AtlasBuilder::add(const std::string& name, std::unique_ptr<ImageData> image) {
     entries.push_back(atlasentry{name, std::shared_ptr<ImageData>(image.release())});
     names.insert(name);
diff --git a/src/graphics/core/Atlas.hpp b/src/graphics/core/Atlas.hpp
index af3e4721..adea16a4 100644
--- a/src/graphics/core/Atlas.hpp
+++ b/src/graphics/core/Atlas.hpp
@@ -14,8 +14,8 @@ class ImageData;
 class Texture;
 
 class Atlas {
-    std::unique_ptr<Texture> texture;
-    std::unique_ptr<ImageData> image;
+    std::shared_ptr<Texture> texture;
+    std::shared_ptr<ImageData> image;
     std::unordered_map<std::string, UVRegion> regions;
 public:
     /// @param image atlas raster
@@ -36,6 +36,9 @@ public:
 
     Texture* getTexture() const;
     ImageData* getImage() const;
+
+    std::shared_ptr<Texture> shareTexture() const;
+    std::shared_ptr<ImageData> shareImageData() const;
 };
 
 struct atlasentry {
diff --git a/src/graphics/core/ImageData.cpp b/src/graphics/core/ImageData.cpp
index 44a1936e..3a5e3cb6 100644
--- a/src/graphics/core/ImageData.cpp
+++ b/src/graphics/core/ImageData.cpp
@@ -95,6 +95,17 @@ void ImageData::blit(const ImageData& image, int x, int y) {
     throw std::runtime_error("mismatching format");
 }
 
+std::unique_ptr<ImageData> ImageData::cropped(int x, int y, int width, int height) const {
+    width = std::min<int>(width, this->width - x);
+    height = std::min<int>(height, this->height - y);
+    if (width <= 0 || height <= 0) {
+        throw std::runtime_error("invalid crop dimensions");
+    }
+    auto subImage = std::make_unique<ImageData>(format, width, height);
+    subImage->blitMatchingFormat(*this, -x, -y);
+    return subImage;
+}
+
 static bool clip_line(int& x1, int& y1, int& x2, int& y2, int width, int height) {
     const int left = 0;
     const int right = width;
diff --git a/src/graphics/core/ImageData.hpp b/src/graphics/core/ImageData.hpp
index d09a0411..86396568 100644
--- a/src/graphics/core/ImageData.hpp
+++ b/src/graphics/core/ImageData.hpp
@@ -33,6 +33,8 @@ public:
     void extrude(int x, int y, int w, int h);
     void fixAlphaColor();
 
+    std::unique_ptr<ImageData> cropped(int x, int y, int width, int height) const;
+
     ubyte* getData() const {
         return data.get();
     }
diff --git a/src/graphics/core/Texture.cpp b/src/graphics/core/Texture.cpp
index 1dc18a65..46f153e8 100644
--- a/src/graphics/core/Texture.cpp
+++ b/src/graphics/core/Texture.cpp
@@ -54,6 +54,12 @@ void Texture::reload(const ubyte* data) {
     glBindTexture(GL_TEXTURE_2D, 0);
 }
 
+void Texture::reloadPartial(const ImageData& image, uint x, uint y, uint w, uint h) {
+    glBindTexture(GL_TEXTURE_2D, id);
+    glTexSubImage2D(GL_TEXTURE_2D, 0, x, y, w, h, GL_RGBA, GL_UNSIGNED_BYTE, image.getData());
+    glBindTexture(GL_TEXTURE_2D, 0);
+}
+
 std::unique_ptr<ImageData> Texture::readData() {
     auto data = std::make_unique<ubyte[]>(width * height * 4);
     glBindTexture(GL_TEXTURE_2D, id);
diff --git a/src/graphics/core/Texture.hpp b/src/graphics/core/Texture.hpp
index 59568619..5e67890c 100644
--- a/src/graphics/core/Texture.hpp
+++ b/src/graphics/core/Texture.hpp
@@ -19,6 +19,7 @@ public:
     virtual void bind() const;
     virtual void unbind() const;
     void reload(const ubyte* data);
+    void reloadPartial(const ImageData& image, uint x, uint y, uint w, uint h);
 
     void setNearestFilter();
 
diff --git a/src/logic/scripting/lua/libs/libassets.cpp b/src/logic/scripting/lua/libs/libassets.cpp
index 9924069a..6018a12c 100644
--- a/src/logic/scripting/lua/libs/libassets.cpp
+++ b/src/logic/scripting/lua/libs/libassets.cpp
@@ -7,7 +7,9 @@
 #include "engine/Engine.hpp"
 #include "graphics/commons/Model.hpp"
 #include "graphics/core/Texture.hpp"
+#include "graphics/core/Atlas.hpp"
 #include "util/Buffer.hpp"
+#include "../lua_custom_types.hpp"
 
 using namespace scripting;
 
@@ -64,8 +66,37 @@ static int l_parse_model(lua::State* L) {
     return 0;
 }
 
+static int l_to_canvas(lua::State* L) {
+    auto alias = lua::require_lstring(L, 1);
+    size_t sep = alias.rfind(':');
+    if (sep == std::string::npos) {
+        return 0;
+    }
+    auto atlasName = alias.substr(0, sep);
+    auto& assets = *engine->getAssets();
+    if (auto atlas = assets.get<Atlas>(std::string(atlasName))) {
+        auto textureName = std::string(alias.substr(sep + 1));
+        auto image = atlas->shareImageData();
+        auto texture = atlas->shareTexture();
+        if (auto region = atlas->getIf(textureName)) {
+            UVRegion uvRegion = *region;
+            int atlasWidth = static_cast<int>(image->getWidth());
+            int atlasHeight = static_cast<int>(image->getHeight());
+            int x = static_cast<int>(uvRegion.u1 * atlasWidth);
+            int y = static_cast<int>(uvRegion.v1 * atlasHeight);
+            int w = static_cast<int>(uvRegion.getWidth() * atlasWidth);
+            int h = static_cast<int>(uvRegion.getHeight() * atlasHeight);
+            return lua::newuserdata<lua::LuaCanvas>(
+                L, std::move(texture), image->cropped(x, y, w, h), uvRegion
+            );
+        }
+    }
+    return 0;
+}
+
 const luaL_Reg assetslib[] = {
     {"load_texture", lua::wrap<l_load_texture>},
     {"parse_model", lua::wrap<l_parse_model>},
+    {"to_canvas", lua::wrap<l_to_canvas>},
     {nullptr, nullptr}
 };
diff --git a/src/logic/scripting/lua/lua_custom_types.hpp b/src/logic/scripting/lua/lua_custom_types.hpp
index c17a78bc..bf2c4f87 100644
--- a/src/logic/scripting/lua/lua_custom_types.hpp
+++ b/src/logic/scripting/lua/lua_custom_types.hpp
@@ -6,6 +6,7 @@
 #include <random>
 
 #include "lua_commons.hpp"
+#include "maths/UVRegion.hpp"
 
 struct fnl_state;
 class Heightmap;
@@ -81,8 +82,9 @@ namespace lua {
     class LuaCanvas : public Userdata {
     public:
         explicit LuaCanvas(
-            std::shared_ptr<Texture> inTexture,
-            std::shared_ptr<ImageData> inData
+            std::shared_ptr<Texture> texture,
+            std::shared_ptr<ImageData> data,
+            UVRegion region = UVRegion(0, 0, 1, 1)
         );
         ~LuaCanvas() override = default;
 
@@ -90,29 +92,32 @@ namespace lua {
             return TYPENAME;
         }
 
-        [[nodiscard]] auto& texture() const {
-            return *mTexture;
+        [[nodiscard]] auto& getTexture() const {
+            return *texture;
         }
 
-        [[nodiscard]] auto& data() const {
-            return *mData;
+        [[nodiscard]] auto& getData() const {
+            return *data;
         }
 
         [[nodiscard]] bool hasTexture() const {
-            return mTexture != nullptr;
+            return texture != nullptr;
         }
 
         auto shareTexture() const {
-            return mTexture;
+            return texture;
         }
 
+        void update();
+
         void createTexture();
 
         static int createMetatable(lua::State*);
         inline static std::string TYPENAME = "Canvas";
     private:
-        std::shared_ptr<Texture> mTexture; // nullable
-        std::shared_ptr<ImageData> mData;
+        std::shared_ptr<Texture> texture; // nullable
+        std::shared_ptr<ImageData> data;
+        UVRegion region;
     };
     static_assert(!std::is_abstract<LuaCanvas>());
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index ec086904..fcb27779 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -10,14 +10,42 @@
 using namespace lua;
 
 LuaCanvas::LuaCanvas(
-    std::shared_ptr<Texture> inTexture, std::shared_ptr<ImageData> inData
+    std::shared_ptr<Texture> texture,
+    std::shared_ptr<ImageData> data,
+    UVRegion region
 )
-    : mTexture(std::move(inTexture)), mData(std::move(inData)) {
+    : texture(std::move(texture)),
+      data(std::move(data)),
+      region(std::move(region)) {
+}
+
+void LuaCanvas::update() {
+    if (!hasTexture()) {
+        return;
+    }
+    if (region.isFull()) {
+        texture->reload(*data);
+    } else {
+        uint texWidth = texture->getWidth();
+        uint texHeight = texture->getHeight();
+        uint imgWidth = data->getWidth();
+        uint imgHeight = data->getHeight();
+
+        uint x = static_cast<uint>(region.u1 * texWidth);
+        uint y = static_cast<uint>(region.v1 * texHeight);
+        uint w = static_cast<uint>((region.u2 - region.u1) * texWidth);
+        uint h = static_cast<uint>((region.v2 - region.v1) * texHeight);
+
+        w = std::min<uint>(w, imgWidth);
+        h = std::min<uint>(h, imgHeight);
+
+        texture->reloadPartial(*data, x, y, w, h);
+    }
 }
 
 void LuaCanvas::createTexture() {
-    mTexture = Texture::from(mData.get());
-    mTexture->setMipMapping(false, true);
+    texture = Texture::from(data.get());
+    texture->setMipMapping(false, true);
 }
 
 union RGBA {
@@ -41,7 +69,7 @@ static RGBA* get_at(const ImageData& data, uint x, uint y) {
 
 static RGBA* get_at(State* L, uint x, uint y) {
     if (auto canvas = touserdata<LuaCanvas>(L, 1)) {
-        return get_at(canvas->data(), x, y);
+        return get_at(canvas->getData(), x, y);
     }
     return nullptr;
 }
@@ -97,7 +125,7 @@ static LuaCanvas& require_canvas(State* L, int idx) {
 
 static int l_clear(State* L) {
     auto& canvas = require_canvas(L, 1);
-    auto& image = canvas.data();
+    auto& image = canvas.getData();
     ubyte* data = image.getData();
     RGBA rgba {};
     if (gettop(L) == 1) {
@@ -122,7 +150,7 @@ static int l_line(State* L) {
 
     RGBA rgba = get_rgba(L, 6);
     if (auto canvas = touserdata<LuaCanvas>(L, 1)) {
-        auto& image = canvas->data();
+        auto& image = canvas->getData();
         image.drawLine(
             x1, y1, x2, y2, glm::ivec4 {rgba.r, rgba.g, rgba.b, rgba.a}
         );
@@ -135,13 +163,13 @@ static int l_blit(State* L) {
     auto& src = require_canvas(L, 2);
     int dst_x = tointeger(L, 3);
     int dst_y = tointeger(L, 4);
-    dst.data().blit(src.data(), dst_x, dst_y);
+    dst.getData().blit(src.getData(), dst_x, dst_y);
     return 0;
 }
 
 static int l_set_data(State* L) {
     auto& canvas = require_canvas(L, 1);
-    auto& image = canvas.data();
+    auto& image = canvas.getData();
     auto data = image.getData();
 
     if (lua::isstring(L, 2)) {
@@ -166,9 +194,7 @@ static int l_set_data(State* L) {
 
 static int l_update(State* L) {
     if (auto canvas = touserdata<LuaCanvas>(L, 1)) {
-        if (canvas->hasTexture()) {
-            canvas->texture().reload(canvas->data());
-        }
+        canvas->update();
     }
     return 0;
 }
@@ -202,7 +228,7 @@ static int l_meta_index(State* L) {
     if (texture == nullptr) {
         return 0;
     }
-    auto& data = texture->data();
+    auto& data = texture->getData();
     if (isnumber(L, 2)) {
         if (auto pixel = get_at(data, static_cast<uint>(tointeger(L, 2)))) {
             return pushinteger(L, pixel->rgba);
@@ -231,7 +257,7 @@ static int l_meta_newindex(State* L) {
     if (texture == nullptr) {
         return 0;
     }
-    auto& data = texture->data();
+    auto& data = texture->getData();
     if (isnumber(L, 2) && isnumber(L, 3)) {
         if (auto pixel = get_at(data, static_cast<uint>(tointeger(L, 2)))) {
             pixel->rgba = static_cast<uint>(tointeger(L, 3));
diff --git a/src/maths/UVRegion.hpp b/src/maths/UVRegion.hpp
index 354c939b..f7e398d8 100644
--- a/src/maths/UVRegion.hpp
+++ b/src/maths/UVRegion.hpp
@@ -1,8 +1,7 @@
 #pragma once
 
 #include <cmath>
-#include <glm/vec2.hpp>
-#include <glm/vec4.hpp>
+#include <glm/glm.hpp>
 
 struct UVRegion {
     float u1;
@@ -69,4 +68,10 @@ struct UVRegion {
         copy.scale(scale);
         return copy;
     }
+
+    bool isFull() const {
+        const auto e = 1e-7;
+        return glm::abs(u1 - 0.0) < e && glm::abs(v1 - 0.0) < e &&
+               glm::abs(u2 - 1.0) < e && glm::abs(v2 - 1.0) < e;
+    }
 };

From 643ae11d5c31e759609365df9da34457f960fbc1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 01:30:47 +0300
Subject: [PATCH 095/133] feat: rebuild mip-maps on texture reload

---
 src/graphics/core/Texture.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/graphics/core/Texture.cpp b/src/graphics/core/Texture.cpp
index 46f153e8..04285aa8 100644
--- a/src/graphics/core/Texture.cpp
+++ b/src/graphics/core/Texture.cpp
@@ -51,12 +51,14 @@ void Texture::reload(const ubyte* data) {
     glBindTexture(GL_TEXTURE_2D, id);
     glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0,
         GL_RGBA, GL_UNSIGNED_BYTE, static_cast<const GLvoid*>(data));
+    glGenerateMipmap(GL_TEXTURE_2D);
     glBindTexture(GL_TEXTURE_2D, 0);
 }
 
 void Texture::reloadPartial(const ImageData& image, uint x, uint y, uint w, uint h) {
     glBindTexture(GL_TEXTURE_2D, id);
     glTexSubImage2D(GL_TEXTURE_2D, 0, x, y, w, h, GL_RGBA, GL_UNSIGNED_BYTE, image.getData());
+    glGenerateMipmap(GL_TEXTURE_2D);
     glBindTexture(GL_TEXTURE_2D, 0);
 }
 

From 7b45b4083baa035694e1ed3912bed0326f2dd608 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 01:47:42 +0300
Subject: [PATCH 096/133] feat: keep previous values in debug panel if cursor
 is not locked

---
 src/frontend/debug_panel.cpp | 39 +++++++++++++++++++++++++++++++++---
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/src/frontend/debug_panel.cpp b/src/frontend/debug_panel.cpp
index 10c6b85c..c42b2930 100644
--- a/src/frontend/debug_panel.cpp
+++ b/src/frontend/debug_panel.cpp
@@ -9,6 +9,7 @@
 #include "graphics/ui/elements/TextBox.hpp"
 #include "graphics/ui/elements/TrackBar.hpp"
 #include "graphics/ui/elements/InputBindBox.hpp"
+#include "graphics/ui/GUI.hpp"
 #include "graphics/render/WorldRenderer.hpp"
 #include "graphics/render/ParticlesRenderer.hpp"
 #include "graphics/render/ChunksRenderer.hpp"
@@ -43,10 +44,15 @@ static std::shared_ptr<Label> create_label(GUI& gui, wstringsupplier supplier) {
     return label;
 }
 
+static bool should_keep_previous(GUI& gui) {
+    return !gui.getInput().isCursorLocked();
+}
+
 // TODO: move to xml
 // TODO: move to xml finally
 // TODO: move to xml finally
 // TODO: move to xml finally
+// TODO: move to xml finally
 std::shared_ptr<UINode> create_debug_panel(
     Engine& engine, 
     Level& level, 
@@ -81,7 +87,7 @@ std::shared_ptr<UINode> create_debug_panel(
         fpsMax = fps;
     });
 
-    panel->listenInterval(1.0f, [&engine]() {
+    panel->listenInterval(1.0f, [&engine, &gui]() {
         const auto& network = engine.getNetwork();
         size_t totalDownload = network.getTotalDownload();
         size_t totalUpload = network.getTotalUpload();
@@ -135,7 +141,16 @@ std::shared_ptr<UINode> create_debug_panel(
                std::to_wstring(player.getId());
     }));
     panel->add(create_label(gui, [&]() -> std::wstring {
-        const auto& vox = player.selection.vox;
+        // TODO: move to xml finally
+        static voxel prevVox = {BLOCK_VOID, {}};
+
+        auto vox = player.selection.vox;
+        if (vox.id == BLOCK_VOID && should_keep_previous(gui)) {
+            vox = prevVox;
+        } else {
+            prevVox = vox;
+        }
+
         std::wstringstream stream;
         stream << "r:" << vox.state.rotation << " s:"
                 << std::bitset<3>(vox.state.segment) << " u:"
@@ -148,8 +163,17 @@ std::shared_ptr<UINode> create_debug_panel(
         }
     }));
     panel->add(create_label(gui, [&]() -> std::wstring {
-        const auto& selection = player.selection;
+        // TODO: move to xml finally
+        static CursorSelection prevSelection {};
+
+        auto selection = player.selection;
         const auto& vox = selection.vox;
+        if (vox.id == BLOCK_VOID && should_keep_previous(gui)) {
+            selection = prevSelection;
+        } else {
+            prevSelection = selection;
+        }
+
         if (vox.id == BLOCK_VOID) {
             return L"x: - y: - z: -";
         }
@@ -158,7 +182,16 @@ std::shared_ptr<UINode> create_debug_panel(
                L" z: " + std::to_wstring(selection.actualPosition.z);
     }));
     panel->add(create_label(gui, [&]() {
+        // TODO: move to xml finally
+        static entityid_t prevEid = ENTITY_NONE;
+
         auto eid = player.getSelectedEntity();
+        if (eid == ENTITY_NONE && should_keep_previous(gui)) {
+            eid = prevEid;
+        } else {
+            prevEid = eid;
+        }
+
         if (eid == ENTITY_NONE) {
             return std::wstring {L"entity: -"};
         } else if (auto entity = level.entities->get(eid)) {

From c565e9897f98733a4aed581489b8ec1d14d81635 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 02:13:32 +0300
Subject: [PATCH 097/133] feat: go back in menu on Escape pressed

---
 res/scripts/stdlib.lua                  | 4 +++-
 src/engine/Engine.cpp                   | 9 +++++++++
 src/logic/scripting/lua/libs/libgui.cpp | 2 +-
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 4443eed3..7d551a4a 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -441,7 +441,9 @@ function __vc_on_hud_open()
     end)
     input.add_callback("key:escape", function()
         if menu.page ~= "" then
-            menu:reset()
+            if not menu:back() then
+                menu:reset()
+            end
         elseif hud.is_inventory_open() then
             hud.close_inventory()
         else
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index a977f354..3053b613 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -26,6 +26,7 @@
 #include "graphics/core/ImageData.hpp"
 #include "graphics/core/Shader.hpp"
 #include "graphics/ui/GUI.hpp"
+#include "graphics/ui/elements/Menu.hpp"
 #include "objects/rigging.hpp"
 #include "logic/EngineController.hpp"
 #include "logic/CommandsInterpreter.hpp"
@@ -154,6 +155,14 @@ void Engine::initializeClient() {
         },
         true
     ));
+
+    keepAlive(this->input->addKeyCallback(Keycode::ESCAPE, [this]() {
+        auto& menu = *gui->getMenu();
+        if (menu.hasOpenPage() && menu.back()) {
+            return true;
+        }
+        return false;
+    }));
 }
 
 void Engine::initialize(CoreParameters coreParameters) {
diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index 0f8ac2da..032cc168 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -57,7 +57,7 @@ DocumentNode get_document_node(lua::State* L, int idx) {
 static int l_menu_back(lua::State* L) {
     auto node = get_document_node(L);
     if (auto menu = dynamic_cast<Menu*>(node.node.get())) {
-        menu->back();
+        return lua::pushboolean(L, menu->back());
     }
     return 0;
 }

From 28dd2f38d20abb0e70e6a2c7dce66376ae55a24a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 12:25:50 +0300
Subject: [PATCH 098/133] feat: update atlas texture extrusion on its reload

---
 src/assets/assetload_funcs.cpp                |  4 ++--
 src/constants.hpp                             |  2 ++
 src/graphics/render/BlocksPreview.cpp         |  2 +-
 src/logic/scripting/lua/lua_custom_types.hpp  |  3 ++-
 .../lua/usertypes/lua_type_canvas.cpp         | 21 +++++++++++++++++--
 5 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/src/assets/assetload_funcs.cpp b/src/assets/assetload_funcs.cpp
index d865cc1a..4fda3b0d 100644
--- a/src/assets/assetload_funcs.cpp
+++ b/src/assets/assetload_funcs.cpp
@@ -184,7 +184,7 @@ assetload::postfunc assetload::atlas(
         if (!append_atlas(builder, file)) continue;
     }
     std::set<std::string> names = builder.getNames();
-    Atlas* atlas = builder.build(2, false).release();
+    Atlas* atlas = builder.build(ATLAS_EXTRUSION, false).release();
     return [=](auto assets) {
         atlas->prepare();
         assets->store(std::unique_ptr<Atlas>(atlas), name);
@@ -501,7 +501,7 @@ static bool load_animation(
             }
             if (!append_atlas(builder, file)) continue;
         }
-        auto srcAtlas = builder.build(2, true);
+        auto srcAtlas = builder.build(ATLAS_EXTRUSION, true);
         if (frameList.empty()) {
             for (const auto& frameName : builder.getNames()) {
                 frameList.emplace_back(frameName, 0);
diff --git a/src/constants.hpp b/src/constants.hpp
index 6544316e..91e2c180 100644
--- a/src/constants.hpp
+++ b/src/constants.hpp
@@ -61,6 +61,8 @@ inline constexpr int ITEM_ICON_SIZE = 48;
 
 inline constexpr int TRANSLUCENT_BLOCKS_SORT_INTERVAL = 8;
 
+inline constexpr int ATLAS_EXTRUSION = 2;
+
 inline const std::string SHADERS_FOLDER = "shaders";
 inline const std::string TEXTURES_FOLDER = "textures";
 inline const std::string FONTS_FOLDER = "fonts";
diff --git a/src/graphics/render/BlocksPreview.cpp b/src/graphics/render/BlocksPreview.cpp
index 4b8bfee9..ad025d3c 100644
--- a/src/graphics/render/BlocksPreview.cpp
+++ b/src/graphics/render/BlocksPreview.cpp
@@ -137,5 +137,5 @@ std::unique_ptr<Atlas> BlocksPreview::build(
         builder.add(def.name, draw(cache, shader, fbo, batch, def, iconSize));
     }
     fbo.unbind();
-    return builder.build(2);
+    return builder.build(ATLAS_EXTRUSION);
 }
diff --git a/src/logic/scripting/lua/lua_custom_types.hpp b/src/logic/scripting/lua/lua_custom_types.hpp
index bf2c4f87..e1e9c3b6 100644
--- a/src/logic/scripting/lua/lua_custom_types.hpp
+++ b/src/logic/scripting/lua/lua_custom_types.hpp
@@ -6,6 +6,7 @@
 #include <random>
 
 #include "lua_commons.hpp"
+#include "constants.hpp"
 #include "maths/UVRegion.hpp"
 
 struct fnl_state;
@@ -108,7 +109,7 @@ namespace lua {
             return texture;
         }
 
-        void update();
+        void update(int extrusion = ATLAS_EXTRUSION);
 
         void createTexture();
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index fcb27779..8f5d3e00 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -19,7 +19,7 @@ LuaCanvas::LuaCanvas(
       region(std::move(region)) {
 }
 
-void LuaCanvas::update() {
+void LuaCanvas::update(int extrusion) {
     if (!hasTexture()) {
         return;
     }
@@ -39,7 +39,24 @@ void LuaCanvas::update() {
         w = std::min<uint>(w, imgWidth);
         h = std::min<uint>(h, imgHeight);
 
-        texture->reloadPartial(*data, x, y, w, h);
+        if (extrusion > 0) {
+            auto extruded = std::make_unique<ImageData>(
+                data->getFormat(),
+                w + extrusion * 2,
+                h + extrusion * 2
+            );
+            extruded->blit(*data, extrusion, extrusion);
+            extruded->extrude(0, 0, w + extrusion * 2, h + extrusion * 2);
+            texture->reloadPartial(
+                *extruded,
+                x - extrusion,
+                y - extrusion,
+                w + extrusion * 2,
+                h + extrusion * 2
+            );
+        } else {
+            texture->reloadPartial(*data, x, y, w, h);
+        }
     }
 }
 

From 878d8245487e6a8f2f548923634601dc8a2c7b3d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 20:50:27 +0300
Subject: [PATCH 099/133] feat: create canvas from texture

---
 src/logic/scripting/lua/libs/libassets.cpp | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/logic/scripting/lua/libs/libassets.cpp b/src/logic/scripting/lua/libs/libassets.cpp
index 6018a12c..76e824e2 100644
--- a/src/logic/scripting/lua/libs/libassets.cpp
+++ b/src/logic/scripting/lua/libs/libassets.cpp
@@ -67,17 +67,27 @@ static int l_parse_model(lua::State* L) {
 }
 
 static int l_to_canvas(lua::State* L) {
+    auto& assets = *engine->getAssets();
+
     auto alias = lua::require_lstring(L, 1);
     size_t sep = alias.rfind(':');
     if (sep == std::string::npos) {
+        auto texture = assets.getShared<Texture>(std::string(alias));
+        if (texture != nullptr) {
+            auto image = texture->readData();
+            return lua::newuserdata<lua::LuaCanvas>(
+                L, texture, std::move(image)
+            );
+        }
         return 0;
     }
     auto atlasName = alias.substr(0, sep);
-    auto& assets = *engine->getAssets();
+    
     if (auto atlas = assets.get<Atlas>(std::string(atlasName))) {
         auto textureName = std::string(alias.substr(sep + 1));
         auto image = atlas->shareImageData();
         auto texture = atlas->shareTexture();
+
         if (auto region = atlas->getIf(textureName)) {
             UVRegion uvRegion = *region;
             int atlasWidth = static_cast<int>(image->getWidth());

From 340b469b403476efa7bf6d929e2f43e6199ff97b Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 5 Nov 2025 20:59:35 +0300
Subject: [PATCH 100/133] update doc/*/scripting/builtins/libassets.md

---
 doc/en/scripting/builtins/libassets.md | 8 ++++++++
 doc/ru/scripting/builtins/libassets.md | 8 ++++++++
 2 files changed, 16 insertions(+)

diff --git a/doc/en/scripting/builtins/libassets.md b/doc/en/scripting/builtins/libassets.md
index bd095435..b39239a5 100644
--- a/doc/en/scripting/builtins/libassets.md
+++ b/doc/en/scripting/builtins/libassets.md
@@ -25,4 +25,12 @@ assets.parse_model(
     -- Model name after loading
     name: str
 )
+
+-- Creates a Canvas from a loaded texture.
+assets.to_canvas(
+    -- The name of the loaded texture.
+    -- Both standalone textures ("texture_name") and
+    -- those in an atlas ("atlas:texture_name") are supported
+    name: str
+) --> Canvas
 ```
diff --git a/doc/ru/scripting/builtins/libassets.md b/doc/ru/scripting/builtins/libassets.md
index 2c510948..ec069e1a 100644
--- a/doc/ru/scripting/builtins/libassets.md
+++ b/doc/ru/scripting/builtins/libassets.md
@@ -25,4 +25,12 @@ assets.parse_model(
     -- Имя модели после загрузки
     name: str
 )
+
+-- Создаёт холст (Canvas) из загруженной текстуры
+assets.to_canvas(
+    -- Имя загруженной текстуры. 
+    -- Поддерживается как отдельные ("имя_текстуры"), 
+    -- так и находящиеся в атласе ("атлас:имя_текстуры").
+    name: str
+) --> Canvas
 ```

From ebe82205482159d732a78ef7ee1080c57f2d9044 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 6 Nov 2025 12:25:21 +0300
Subject: [PATCH 101/133] cleanup

---
 res/scripts/hud.lua | 30 ------------------------------
 1 file changed, 30 deletions(-)

diff --git a/res/scripts/hud.lua b/res/scripts/hud.lua
index 0124c93d..90883d94 100644
--- a/res/scripts/hud.lua
+++ b/res/scripts/hud.lua
@@ -55,8 +55,6 @@ local function update_hand()
     skeleton.set_model("hand", bone, item.model_name(itemid))
 end
 
-local stream
-
 function on_hud_open()
     input.add_callback("player.pick", function ()
         if hud.is_paused() or hud.is_inventory_open() then
@@ -118,40 +116,12 @@ function on_hud_open()
     configure_SSAO()
 
     hud.default_hand_controller = update_hand
-
-    debug.print(audio.get_input_devices_names())
-
-    stream = audio.PCMStream(44100, 1, 16)
-    stream:share("test-stream")
-    streamid = audio.play_stream_2d("test-stream", 2.0, 1.0, "ui")
-
-
-    s = audio.PCMStream(44100, 1, 16)
-    local buffer = Bytearray(44100 * 4)
-    local view = U16view(buffer)
-    for i=1, view.size do
-        view[i] = 16000 + math.sin(i / 200.0 * (1 + i * 0.0001)) * 2000
-    end
-    s:feed(buffer)
-    s:create_sound("test-sound")
-    audio.play_sound_2d("test-sound", 2.0, 1.0, "ui")
 end
 
-audio.input.request_open(function(token)
-    input_access_token = token
-end)
-
 function on_hud_render()
     if hud.hand_controller then
         hud.hand_controller()
     else
         update_hand()
     end
-
-    if input_access_token then
-        local bytes = audio.input.fetch_input(input_access_token)
-        if bytes then
-            stream:feed(bytes)
-        end
-    end
 end

From be1f336d90a7ed90c3099a5326021e5081b275f8 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 7 Nov 2025 22:32:16 +0300
Subject: [PATCH 102/133] rename audio.input.fetch_input to audio.input.fetch

---
 res/layouts/pages/settings_audio.xml.lua  | 2 +-
 res/modules/internal/audio_input.lua      | 2 +-
 src/logic/scripting/lua/libs/libaudio.cpp | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/res/layouts/pages/settings_audio.xml.lua b/res/layouts/pages/settings_audio.xml.lua
index 82fc7f0b..29859819 100644
--- a/res/layouts/pages/settings_audio.xml.lua
+++ b/res/layouts/pages/settings_audio.xml.lua
@@ -33,7 +33,7 @@ function on_open()
         document.root:add("<container id='tm' />")
         local prev_amplitude = 0.0
         document.tm:setInterval(16, function()
-            audio.input.fetch_input(token)
+            audio.input.fetch(token)
             local amplitude = audio.input.get_max_amplitude()
             if amplitude > 0.0 then
                 amplitude = math.sqrt(amplitude)
diff --git a/res/modules/internal/audio_input.lua b/res/modules/internal/audio_input.lua
index f61d5300..adf44b97 100644
--- a/res/modules/internal/audio_input.lua
+++ b/res/modules/internal/audio_input.lua
@@ -24,7 +24,7 @@ function audio.input.get_max_amplitude()
     return max_amplitude / MAX_AMPLITUDE
 end
 
-function audio.input.fetch_input(token, size)
+function audio.input.fetch(token, size)
     size = size or MAX_FETCH
     if audio_input_tokens_store[token] then
         if #total_fetch >= size then
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index a848f7d0..7ec6f1a6 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -389,7 +389,7 @@ static int l_audio_count_streams(lua::State* L) {
     return lua::pushinteger(L, audio::count_streams());
 }
 
-/// @brief audio.fetch_input(size) -> Bytearray
+/// @brief audio.input.fetch(size) -> Bytearray
 static int l_audio_fetch_input(lua::State* L) {
     auto device = audio::get_input_device();
     if (device == nullptr) {

From 8de7f79ed52db8e2b4fbe2f980a959148c98ee41 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 7 Nov 2025 23:05:50 +0300
Subject: [PATCH 103/133] update doc/*/audio.md

---
 doc/en/audio.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++
 doc/ru/audio.md | 77 +++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 153 insertions(+)

diff --git a/doc/en/audio.md b/doc/en/audio.md
index cacd7107..09510402 100644
--- a/doc/en/audio.md
+++ b/doc/en/audio.md
@@ -203,3 +203,79 @@ audio.count_speakers() -> integer
 -- get current number of playing streams
 audio.count_streams() -> integer
 ```
+
+### audio.PCMStream
+
+```lua
+-- Creating a PCM data source
+local stream = audio.PCMStream(
+    -- Sample rate
+    sample_rate: integer,
+    -- Number of channels (1 - mono, 2 - stereo)
+    channels: integer,
+    -- Number of bits per sample (8 or 16)
+    bits_per_sample: integer,
+)
+
+-- Feeding PCM data into the stream
+stream:feed(
+    -- PCM data to be fed into the stream
+    data: Bytearray
+)
+
+-- Publishing the PCM data source for use by the engine systems
+stream:share(
+    -- Alias of the audio stream, which can be referenced in audio.play_stream
+    alias: string
+)
+
+-- Creating a sound from the PCM data in the stream
+stream:create_sound(
+    -- Name of the created sound
+    name: string
+)
+```
+
+### Audio Recording
+
+```lua
+-- Requests access to audio recording
+-- On confirmation, the callback receives a token for use in audio.input.fetch
+audio.input.request_open(callback: function(string))
+
+-- Reads new PCM audio input data
+audio.input.fetch(
+    -- Token obtained through audio.input.request_open
+    access_token: string,
+    -- Maximum buffer size in bytes (optional)
+    [optional] max_read_size: integer
+)
+```
+
+### Example of Audio Generation:
+
+```lua
+-- For working with 16-bit samples, use a U16view over Bytearray
+-- Example:
+local max_amplitude = 32767
+local sample_rate = 44100
+local total_samples = sample_rate * 5 -- 5 seconds of mono
+local bytes = Bytearray(total_samples * 2) -- 5 seconds of 16-bit mono
+local samples = I16view(bytes)
+
+local frequency_hz = 400
+for i=1, total_samples do
+    local value = math.sin(i * math.pi * 2 / sample_rate * frequency_hz)
+    samples[i] = value * max_amplitude
+end
+
+local stream_name = "test-stream"
+local stream = audio.PCMStream(sample_rate, 1, 16)
+stream:feed(bytes)
+stream:share(stream_name)
+
+local volume = 1.0
+local pitch = 1.0
+local channel = "ui"
+audio.play_stream_2d(stream_name, volume, pitch, channel)
+```
diff --git a/doc/ru/audio.md b/doc/ru/audio.md
index 1fce6c35..8291e7ba 100644
--- a/doc/ru/audio.md
+++ b/doc/ru/audio.md
@@ -29,6 +29,7 @@
 Доступ к спикерам производится по целочисленным id, которые не повторяются за время работы движка, следует избегать хранения прямых указателей на объекты класса.
 
 Нумерация ID спикеров начинается с 1. ID 0 означает невозможность воспроизведения, по какой-либо причине.
+
 ### Звук (Sound)
 
 Звуковые данные загруженные в память для возможности одновременного воспроизведения из нескольких источников. Может предоставлять доступ к PCM данным.
@@ -203,3 +204,79 @@ audio.count_speakers() -> integer
 -- получить текущее число проигрываемых аудио-потоков
 audio.count_streams() -> integer
 ```
+
+### audio.PCMStream
+
+```lua
+-- создание источника PCM данных
+local stream = audio.PCMStream(
+    -- частота дискретизации
+    sample_rate: integer,
+    -- число каналов (1 - моно, 2 - стерео)
+    channels: integer,
+    -- число бит на сэмпл (8 или 16)
+    bits_per_sample: integer,
+)
+
+-- подача PCM данных в поток
+stream:feed(
+    -- PCM данные для подачи в поток
+    data: Bytearray
+)
+
+-- публикация источника PCM данных для использования системами движка
+stream:share(
+    -- имя потокового аудио, которое можно будет указать в audio.play_stream
+    alias: string
+)
+
+-- создание звука из имеющихся в потоке PCM данных
+stream:create_sound(
+    -- имя создаваемого звука
+    name: string
+)
+```
+
+### Запись звука
+
+```lua
+-- запрашивает доступ к записи звука
+-- при подтверждении, в callback передаётся токен для использовании в audio.input.fetch
+audio.input.request_open(callback: function(string))
+
+-- читает новые PCM данные аудио ввода
+audio.input.fetch(
+    -- токен, полученный через audio.input.request_open
+    access_token: string,
+    -- максимальное размер буфера в байтах
+    [опционально] max_read_size: integer
+)
+```
+
+### Пример генерации аудио:
+
+```lua
+-- для работы с 16-битными семплами используйте U16view поверх Bytearray
+-- пример:
+local max_amplitude = 32767
+local sample_rate = 44100
+local total_samples = sample_rate * 5 -- 5 секунд моно
+local bytes = Bytearray(total_samples * 2) -- 5 секунд 16 бит моно
+local samples = I16view(bytes)
+
+local frequency_hz = 400
+for i=1, total_samples do
+    local value = math.sin(i * math.pi * 2 / sample_rate * frequency_hz)
+    samples[i] = value * max_amplitude
+end
+
+local stream_name = "test-stream"
+local stream = audio.PCMStream(sample_rate, 1, 16)
+stream:feed(bytes)
+stream:share(stream_name)
+
+local volume = 1.0
+local pitch = 1.0
+local channel = "ui"
+audio.play_stream_2d(stream_name, volume, pitch, channel)
+```

From 60ed10c0a114c35aad70cb84ffc6d0c3b14f8769 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 8 Nov 2025 11:42:10 +0300
Subject: [PATCH 104/133] add prefix check to events.on

---
 res/modules/internal/events.lua | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/res/modules/internal/events.lua b/res/modules/internal/events.lua
index 7635af25..a0cd8276 100644
--- a/res/modules/internal/events.lua
+++ b/res/modules/internal/events.lua
@@ -2,7 +2,14 @@ local events = {
     handlers = {}
 }
 
+local __parse_path = parse_path
+local __pack_is_installed = pack.is_installed
+
 function events.on(event, func)
+    local prefix = __parse_path(event)
+    if prefix ~= "core" and not __pack_is_installed(prefix) then
+        error("pack prefix required")
+    end
     if events.handlers[event] == nil then
         events.handlers[event] = {}
     end

From 05de043154d3c4a59af9d14b67b094782852e31c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 18:23:10 +0300
Subject: [PATCH 105/133] add 'project:content' content source

---
 src/content/ContentControl.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/content/ContentControl.cpp b/src/content/ContentControl.cpp
index 9c99135b..543931d3 100644
--- a/src/content/ContentControl.cpp
+++ b/src/content/ContentControl.cpp
@@ -30,6 +30,7 @@ ContentControl::ContentControl(
     manager->setSources({
         "world:content",
         "user:content",
+        "project:content",
         "res:content",
     });
 }

From 87ff77a73fd0640d478827f8a3e73f06eda48e7c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 18:26:36 +0300
Subject: [PATCH 106/133] add project start application script

---
 src/devtools/Project.hpp            |  2 ++
 src/engine/Engine.cpp               | 28 ++++++++++++++++++++++++----
 src/engine/Engine.hpp               |  1 +
 src/engine/Mainloop.cpp             |  1 +
 src/engine/ServerMainloop.cpp       |  1 +
 src/frontend/screens/MenuScreen.cpp |  8 +++++---
 6 files changed, 34 insertions(+), 7 deletions(-)

diff --git a/src/devtools/Project.hpp b/src/devtools/Project.hpp
index be9d88a3..68093ada 100644
--- a/src/devtools/Project.hpp
+++ b/src/devtools/Project.hpp
@@ -4,6 +4,7 @@
 #include <vector>
 #include <memory>
 
+#include "interfaces/Process.hpp"
 #include "interfaces/Serializable.hpp"
 
 namespace scripting {
@@ -15,6 +16,7 @@ struct Project : Serializable {
     std::string title;
     std::vector<std::string> basePacks;
     std::unique_ptr<scripting::IClientProjectScript> clientScript;
+    std::unique_ptr<Process> setupCoroutine;
 
     ~Project();
 
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 3053b613..1b8cd440 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -62,13 +62,24 @@ static std::unique_ptr<ImageData> load_icon() {
     return nullptr;
 }
 
-static std::unique_ptr<scripting::IClientProjectScript> load_client_project_script() {
+static std::unique_ptr<scripting::IClientProjectScript> load_project_client_script() {
     io::path scriptFile = "project:project_client.lua";
     if (io::exists(scriptFile)) {
-        logger.info() << "starting project script";
+        logger.info() << "starting project client script";
         return scripting::load_client_project_script(scriptFile);
     } else {
-        logger.warning() << "project script does not exists";
+        logger.warning() << "project client script does not exists";
+    }
+    return nullptr;
+}
+
+static std::unique_ptr<Process> load_project_start_script() {
+    io::path scriptFile = "project:start.lua";
+    if (io::exists(scriptFile)) {
+        logger.info() << "starting project start script";
+        return scripting::start_app_script(scriptFile);
+    } else {
+        logger.warning() << "project start script does not exists";
     }
     return nullptr;
 }
@@ -226,7 +237,10 @@ void Engine::initialize(CoreParameters coreParameters) {
         langs::setup(lang, paths.resPaths.collectRoots());
     }, true));
 
-    project->clientScript = load_client_project_script();
+    project->setupCoroutine = load_project_start_script();
+    if (!params.headless) {
+        project->clientScript = load_project_client_script();
+    }
 }
 
 void Engine::loadSettings() {
@@ -301,6 +315,12 @@ void Engine::detachDebugger() {
     debuggingServer.reset();
 }
 
+void Engine::applicationTick() {
+    if (project->setupCoroutine && project->setupCoroutine->isActive()) {
+        project->setupCoroutine->update();
+    }
+}
+
 void Engine::updateFrontend() {
     double delta = time.getDelta();
     updateHotkeys();
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 98a2c3ef..468563d0 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -105,6 +105,7 @@ public:
 
     void postUpdate();
 
+    void applicationTick();
     void updateFrontend();
     void renderFrame();
     void nextFrame();
diff --git a/src/engine/Mainloop.cpp b/src/engine/Mainloop.cpp
index a14c5464..5435e983 100644
--- a/src/engine/Mainloop.cpp
+++ b/src/engine/Mainloop.cpp
@@ -38,6 +38,7 @@ void Mainloop::run() {
     logger.info() << "main loop started";
     while (!window.isShouldClose()){
         time.update(window.time());
+        engine.applicationTick();
         engine.updateFrontend();
 
         if (!window.isIconified()) {
diff --git a/src/engine/ServerMainloop.cpp b/src/engine/ServerMainloop.cpp
index ab35ffbd..7fb8ffed 100644
--- a/src/engine/ServerMainloop.cpp
+++ b/src/engine/ServerMainloop.cpp
@@ -60,6 +60,7 @@ void ServerMainloop::run() {
             controller->getLevel()->getWorld()->updateTimers(delta);
             controller->update(glm::min(delta, 0.2), false);
         }
+        engine.applicationTick();
         engine.postUpdate();
 
         if (!coreParams.testMode) {
diff --git a/src/frontend/screens/MenuScreen.cpp b/src/frontend/screens/MenuScreen.cpp
index c1339494..e1015e8c 100644
--- a/src/frontend/screens/MenuScreen.cpp
+++ b/src/frontend/screens/MenuScreen.cpp
@@ -12,9 +12,11 @@
 #include "window/Camera.hpp"
 #include "engine/Engine.hpp"
 
-MenuScreen::MenuScreen(Engine& engine) : Screen(engine) {
-    uicamera =
-        std::make_unique<Camera>(glm::vec3(), engine.getWindow().getSize().y);
+MenuScreen::MenuScreen(Engine& engine)
+    : Screen(engine),
+      uicamera(
+          std::make_unique<Camera>(glm::vec3(), engine.getWindow().getSize().y)
+      ) {
     uicamera->perspective = false;
     uicamera->near = -1.0f;
     uicamera->far = 1.0f;

From 4bafad708e60bf111d124843c22b338cc896b466 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 19:09:35 +0300
Subject: [PATCH 107/133] move window-related code from Engine.cpp to
 WindowControl

---
 src/engine/Engine.cpp        | 63 ++++------------------------
 src/engine/Engine.hpp        |  4 +-
 src/engine/WindowControl.cpp | 81 ++++++++++++++++++++++++++++++++++++
 src/engine/WindowControl.hpp | 24 +++++++++++
 src/io/engine_paths.cpp      |  2 +-
 src/io/engine_paths.hpp      |  2 +-
 6 files changed, 116 insertions(+), 60 deletions(-)
 create mode 100644 src/engine/WindowControl.cpp
 create mode 100644 src/engine/WindowControl.hpp

diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 1b8cd440..7f920833 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -8,8 +8,6 @@
 #include "assets/AssetsLoader.hpp"
 #include "audio/audio.hpp"
 #include "coders/GLSLExtension.hpp"
-#include "coders/imageio.hpp"
-#include "coders/json.hpp"
 #include "coders/toml.hpp"
 #include "coders/commons.hpp"
 #include "devtools/Editor.hpp"
@@ -23,23 +21,21 @@
 #include "frontend/screens/Screen.hpp"
 #include "graphics/render/ModelsGenerator.hpp"
 #include "graphics/core/DrawContext.hpp"
-#include "graphics/core/ImageData.hpp"
 #include "graphics/core/Shader.hpp"
 #include "graphics/ui/GUI.hpp"
 #include "graphics/ui/elements/Menu.hpp"
-#include "objects/rigging.hpp"
 #include "logic/EngineController.hpp"
 #include "logic/CommandsInterpreter.hpp"
 #include "logic/scripting/scripting.hpp"
 #include "logic/scripting/scripting_hud.hpp"
 #include "network/Network.hpp"
 #include "util/platform.hpp"
-#include "window/Camera.hpp"
 #include "window/input.hpp"
 #include "window/Window.hpp"
 #include "world/Level.hpp"
 #include "Mainloop.hpp"
 #include "ServerMainloop.hpp"
+#include "WindowControl.hpp"
 
 #include <iostream>
 #include <assert.h>
@@ -50,18 +46,6 @@
 
 static debug::Logger logger("engine");
 
-static std::unique_ptr<ImageData> load_icon() {
-    try {
-        auto file = "res:textures/misc/icon.png";
-        if (io::exists(file)) {
-            return imageio::read(file);
-        }
-    } catch (const std::exception& err) {
-        logger.error() << "could not load window icon: " << err.what();
-    }
-    return nullptr;
-}
-
 static std::unique_ptr<scripting::IClientProjectScript> load_project_client_script() {
     io::path scriptFile = "project:project_client.lua";
     if (io::exists(scriptFile)) {
@@ -119,29 +103,9 @@ void Engine::onContentLoad() {
 }
 
 void Engine::initializeClient() {
-    std::string title = project->title;
-    if (title.empty()) {
-        title = "VoxelCore v" +
-                        std::to_string(ENGINE_VERSION_MAJOR) + "." +
-                        std::to_string(ENGINE_VERSION_MINOR);
-    }
-    if (ENGINE_DEBUG_BUILD) {
-        title += " [debug]";
-    }
-    if (debuggingServer) {
-        title = "[debugging] " + title;
-    }
-    auto [window, input] = Window::initialize(&settings.display, title);
-    if (!window || !input){
-        throw initialize_error("could not initialize window");
-    }
-    window->setFramerate(settings.display.framerate.get());
+    windowControl = std::make_unique<WindowControl>(*this);
+    auto [window, input] = windowControl->initialize();
 
-    time.set(window->time());
-    if (auto icon = load_icon()) {
-        icon->flipY();
-        window->setIcon(icon.get());
-    }
     this->window = std::move(window);
     this->input = std::move(input);
 
@@ -270,7 +234,7 @@ void Engine::loadControls() {
 
 void Engine::updateHotkeys() {
     if (input->jpressed(Keycode::F2)) {
-        saveScreenshot();
+        windowControl->saveScreenshot();
     }
     if (input->pressed(Keycode::LEFT_CONTROL) && input->pressed(Keycode::F3) &&
         input->jpressed(Keycode::U)) {
@@ -285,14 +249,6 @@ void Engine::updateHotkeys() {
     }
 }
 
-void Engine::saveScreenshot() {
-    auto image = window->takeScreenshot();
-    image->flipY();
-    io::path filename = paths.getNewScreenshotFile("png");
-    imageio::write(filename.string(), image.get());
-    logger.info() << "saved screenshot as " << filename.string();
-}
-
 void Engine::run() {
     if (params.headless) {
         ServerMainloop(*this).run();
@@ -331,13 +287,7 @@ void Engine::updateFrontend() {
 }
 
 void Engine::nextFrame() {
-    window->setFramerate(
-        window->isIconified() && settings.display.limitFpsIconified.get()
-            ? 20
-            : settings.display.framerate.get()
-    );
-    window->swapBuffers();
-    input->pollEvents();
+    windowControl->nextFrame();
 }
 
 void Engine::startPauseLoop() {
@@ -437,7 +387,8 @@ void Engine::loadAssets() {
 
     // no need
     // correct log messages order is more useful
-    bool threading = false; // look at two upper lines
+    // todo: before setting to true, check if GLSLExtension thread safe
+    bool threading = false; // look at three upper lines
     if (threading) {
         auto task = loader.startTask([=](){});
         task->waitForEnd();
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 468563d0..2049258f 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -14,6 +14,7 @@
 #include <string>
 
 class Window;
+class WindowControl;
 class Assets;
 class Level;
 class Screen;
@@ -75,6 +76,7 @@ class Engine : public util::ObjectsKeeper {
     std::unique_ptr<gui::GUI> gui;
     std::unique_ptr<devtools::Editor> editor;
     std::unique_ptr<devtools::DebuggingServer> debuggingServer;
+    std::unique_ptr<WindowControl> windowControl;
     PostRunnables postRunnables;
     Time time;
     OnWorldOpen levelConsumer;
@@ -144,8 +146,6 @@ public:
         postRunnables.postRunnable(callback);
     }
 
-    void saveScreenshot();
-
     EngineController* getController();
 
     void setLevelConsumer(OnWorldOpen levelConsumer);
diff --git a/src/engine/WindowControl.cpp b/src/engine/WindowControl.cpp
new file mode 100644
index 00000000..edf0a6e7
--- /dev/null
+++ b/src/engine/WindowControl.cpp
@@ -0,0 +1,81 @@
+#include "WindowControl.hpp"
+
+#include "Engine.hpp"
+#include "devtools/Project.hpp"
+#include "coders/imageio.hpp"
+#include "window/Window.hpp"
+#include "window/input.hpp"
+#include "debug/Logger.hpp"
+#include "graphics/core/ImageData.hpp"
+
+static debug::Logger logger("window-control");
+
+namespace {
+    static std::unique_ptr<ImageData> load_icon() {
+        try {
+            auto file = "res:textures/misc/icon.png";
+            if (io::exists(file)) {
+                return imageio::read(file);
+            }
+        } catch (const std::exception& err) {
+            logger.error() << "could not load window icon: " << err.what();
+        }
+        return nullptr;
+    }
+}
+
+WindowControl::WindowControl(Engine& engine) : engine(engine) {}
+
+WindowControl::Result WindowControl::initialize() {
+    const auto& project = engine.getProject();
+    auto& settings = engine.getSettings();
+
+    std::string title = project.title;
+    if (title.empty()) {
+        title = "VoxelCore v" +
+                        std::to_string(ENGINE_VERSION_MAJOR) + "." +
+                        std::to_string(ENGINE_VERSION_MINOR);
+    }
+    if (ENGINE_DEBUG_BUILD) {
+        title += " [debug]";
+    }
+    if (engine.getDebuggingServer()) {
+        title = "[debugging] " + title;
+    }
+
+    auto [window, input] = Window::initialize(&settings.display, title);
+    if (!window || !input){
+        throw initialize_error("could not initialize window");
+    }
+    window->setFramerate(settings.display.framerate.get());
+    if (auto icon = load_icon()) {
+        icon->flipY();
+        window->setIcon(icon.get());
+    }
+
+    return Result {std::move(window), std::move(input)};
+}
+
+void WindowControl::saveScreenshot() {
+    auto& window = engine.getWindow();
+    const auto& paths = engine.getPaths();
+
+    auto image = window.takeScreenshot();
+    image->flipY();
+    io::path filename = paths.getNewScreenshotFile("png");
+    imageio::write(filename.string(), image.get());
+    logger.info() << "saved screenshot as " << filename.string();
+}
+
+void WindowControl::nextFrame() {
+    const auto& settings = engine.getSettings();
+    auto& window = engine.getWindow();
+    auto& input = engine.getInput();
+    window.setFramerate(
+        window.isIconified() && settings.display.limitFpsIconified.get()
+            ? 20
+            : settings.display.framerate.get()
+    );
+    window.swapBuffers();
+    input.pollEvents();
+}
diff --git a/src/engine/WindowControl.hpp b/src/engine/WindowControl.hpp
new file mode 100644
index 00000000..807d9758
--- /dev/null
+++ b/src/engine/WindowControl.hpp
@@ -0,0 +1,24 @@
+#pragma once
+
+#include <memory>
+
+class Window;
+class Input;
+class Engine;
+
+class WindowControl {
+public:
+    struct Result {
+        std::unique_ptr<Window> window;
+        std::unique_ptr<Input> input;
+    };
+    WindowControl(Engine& engine);
+
+    Result initialize();
+
+    void nextFrame();
+
+    void saveScreenshot();
+private:
+    Engine& engine;
+};
diff --git a/src/io/engine_paths.cpp b/src/io/engine_paths.cpp
index 98363d9b..ef102621 100644
--- a/src/io/engine_paths.cpp
+++ b/src/io/engine_paths.cpp
@@ -67,7 +67,7 @@ const std::filesystem::path& EnginePaths::getResourcesFolder() const {
     return resourcesFolder;
 }
 
-io::path EnginePaths::getNewScreenshotFile(const std::string& ext) {
+io::path EnginePaths::getNewScreenshotFile(const std::string& ext) const {
     auto folder = SCREENSHOTS_FOLDER;
     if (!io::is_directory(folder)) {
         io::create_directories(folder);
diff --git a/src/io/engine_paths.hpp b/src/io/engine_paths.hpp
index 8b9b7f8e..0fa58874 100644
--- a/src/io/engine_paths.hpp
+++ b/src/io/engine_paths.hpp
@@ -63,7 +63,7 @@ public:
 
     void setCurrentWorldFolder(io::path folder);
     io::path getCurrentWorldFolder();
-    io::path getNewScreenshotFile(const std::string& ext);
+    io::path getNewScreenshotFile(const std::string& ext) const;
 
     std::string mount(const io::path& file);
     void unmount(const std::string& name);

From 01bf474a2b36201164bcae7e7052526441172e53 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 19:37:40 +0300
Subject: [PATCH 108/133] cleanup Engine.cpp a bit

---
 src/devtools/Project.cpp     | 25 ++++++++++++++++++++++
 src/devtools/Project.hpp     |  3 +++
 src/engine/Engine.cpp        | 41 ++++++------------------------------
 src/engine/WindowControl.cpp | 10 +++++++++
 src/engine/WindowControl.hpp |  2 ++
 5 files changed, 47 insertions(+), 34 deletions(-)

diff --git a/src/devtools/Project.cpp b/src/devtools/Project.cpp
index 881f6cc7..61e99c6a 100644
--- a/src/devtools/Project.cpp
+++ b/src/devtools/Project.cpp
@@ -1,8 +1,13 @@
 #include "Project.hpp"
 
 #include "data/dv_util.hpp"
+#include "debug/Logger.hpp"
+#include "io/io.hpp"
+#include "io/path.hpp"
 #include "logic/scripting/scripting.hpp"
 
+static debug::Logger logger("project");
+
 Project::~Project() = default;
 
 dv::value Project::serialize() const {
@@ -18,3 +23,23 @@ void Project::deserialize(const dv::value& src) {
     src.at("title").get(title);
     dv::get(src, "base_packs", basePacks);
 }
+
+void Project::loadProjectClientScript() {
+    io::path scriptFile = "project:project_client.lua";
+    if (io::exists(scriptFile)) {
+        logger.info() << "starting project client script";
+        clientScript = scripting::load_client_project_script(scriptFile);
+    } else {
+        logger.warning() << "project client script does not exists";
+    }
+}
+
+void Project::loadProjectStartScript() {
+    io::path scriptFile = "project:start.lua";
+    if (io::exists(scriptFile)) {
+        logger.info() << "starting project start script";
+        setupCoroutine = scripting::start_app_script(scriptFile);
+    } else {
+        logger.warning() << "project start script does not exists";
+    }
+}
diff --git a/src/devtools/Project.hpp b/src/devtools/Project.hpp
index 68093ada..f0851b30 100644
--- a/src/devtools/Project.hpp
+++ b/src/devtools/Project.hpp
@@ -22,4 +22,7 @@ struct Project : Serializable {
 
     dv::value serialize() const override;
     void deserialize(const dv::value& src) override;
+
+    void loadProjectClientScript();
+    void loadProjectStartScript();
 };
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 7f920833..150b8b02 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -46,28 +46,6 @@
 
 static debug::Logger logger("engine");
 
-static std::unique_ptr<scripting::IClientProjectScript> load_project_client_script() {
-    io::path scriptFile = "project:project_client.lua";
-    if (io::exists(scriptFile)) {
-        logger.info() << "starting project client script";
-        return scripting::load_client_project_script(scriptFile);
-    } else {
-        logger.warning() << "project client script does not exists";
-    }
-    return nullptr;
-}
-
-static std::unique_ptr<Process> load_project_start_script() {
-    io::path scriptFile = "project:start.lua";
-    if (io::exists(scriptFile)) {
-        logger.info() << "starting project start script";
-        return scripting::start_app_script(scriptFile);
-    } else {
-        logger.warning() << "project start script does not exists";
-    }
-    return nullptr;
-}
-
 Engine::Engine() = default;
 Engine::~Engine() = default;
 
@@ -146,7 +124,7 @@ void Engine::initialize(CoreParameters coreParameters) {
 
     logger.info() << "engine version: " << ENGINE_VERSION_STRING;
     if (params.headless) {
-        logger.info() << "headless mode is enabled";
+        logger.info() << "engine runs in headless mode";
     }
     if (params.projectFolder.empty()) {
         params.projectFolder = params.resFolder;
@@ -154,6 +132,9 @@ void Engine::initialize(CoreParameters coreParameters) {
     paths.setResourcesFolder(params.resFolder);
     paths.setUserFilesFolder(params.userFolder);
     paths.setProjectFolder(params.projectFolder);
+    if (!params.scriptFile.empty()) {
+        paths.setScriptFolder(params.scriptFile.parent_path());
+    }
     paths.prepare();
     loadProject();
 
@@ -172,10 +153,6 @@ void Engine::initialize(CoreParameters coreParameters) {
             );
         }
     }
-
-    if (!params.scriptFile.empty()) {
-        paths.setScriptFolder(params.scriptFile.parent_path());
-    }
     loadSettings();
 
     controller = std::make_unique<EngineController>(*this);
@@ -201,9 +178,9 @@ void Engine::initialize(CoreParameters coreParameters) {
         langs::setup(lang, paths.resPaths.collectRoots());
     }, true));
 
-    project->setupCoroutine = load_project_start_script();
+    project->loadProjectStartScript();
     if (!params.headless) {
-        project->clientScript = load_project_client_script();
+        project->loadProjectClientScript();
     }
 }
 
@@ -241,11 +218,7 @@ void Engine::updateHotkeys() {
         gui->toggleDebug();
     }
     if (input->jpressed(Keycode::F11)) {
-        if (settings.display.windowMode.get() != static_cast<int>(WindowMode::FULLSCREEN)) {
-            settings.display.windowMode.set(static_cast<int>(WindowMode::FULLSCREEN));
-        } else {
-            settings.display.windowMode.set(static_cast<int>(WindowMode::WINDOWED));
-        }
+        windowControl->toggleFullscreen();
     }
 }
 
diff --git a/src/engine/WindowControl.cpp b/src/engine/WindowControl.cpp
index edf0a6e7..8557c5be 100644
--- a/src/engine/WindowControl.cpp
+++ b/src/engine/WindowControl.cpp
@@ -67,6 +67,16 @@ void WindowControl::saveScreenshot() {
     logger.info() << "saved screenshot as " << filename.string();
 }
 
+void WindowControl::toggleFullscreen() {
+    auto& settings = engine.getSettings();
+    auto& windowMode = settings.display.windowMode;
+    if (windowMode.get() != static_cast<int>(WindowMode::FULLSCREEN)) {
+        windowMode.set(static_cast<int>(WindowMode::FULLSCREEN));
+    } else {
+        windowMode.set(static_cast<int>(WindowMode::WINDOWED));
+    }
+}
+
 void WindowControl::nextFrame() {
     const auto& settings = engine.getSettings();
     auto& window = engine.getWindow();
diff --git a/src/engine/WindowControl.hpp b/src/engine/WindowControl.hpp
index 807d9758..f3b7c8bc 100644
--- a/src/engine/WindowControl.hpp
+++ b/src/engine/WindowControl.hpp
@@ -19,6 +19,8 @@ public:
     void nextFrame();
 
     void saveScreenshot();
+
+    void toggleFullscreen();
 private:
     Engine& engine;
 };

From 3b583d4dd6995279c47409193e8c2c7c2f63f755 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 19:56:46 +0300
Subject: [PATCH 109/133] refactor: Engine, EnginePaths, move CoreParameters to
 new header

---
 src/engine/CoreParameters.hpp | 15 +++++++
 src/engine/Engine.cpp         |  9 +---
 src/engine/Engine.hpp         | 33 +++++---------
 src/io/engine_paths.cpp       | 82 ++++++++++++++++-------------------
 src/io/engine_paths.hpp       | 17 +++-----
 5 files changed, 71 insertions(+), 85 deletions(-)
 create mode 100644 src/engine/CoreParameters.hpp

diff --git a/src/engine/CoreParameters.hpp b/src/engine/CoreParameters.hpp
new file mode 100644
index 00000000..c937bf3a
--- /dev/null
+++ b/src/engine/CoreParameters.hpp
@@ -0,0 +1,15 @@
+#pragma once
+
+#include <string>
+#include <filesystem>
+
+struct CoreParameters {
+    bool headless = false;
+    bool testMode = false;
+    std::filesystem::path resFolder = "res";
+    std::filesystem::path userFolder = ".";
+    std::filesystem::path scriptFile;
+    std::filesystem::path projectFolder;
+    std::string debugServerString;
+    int tps = 20;
+};
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 150b8b02..ca8edc89 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -16,6 +16,7 @@
 #include "content/ContentControl.hpp"
 #include "core_defs.hpp"
 #include "io/io.hpp"
+#include "io/settings_io.hpp"
 #include "frontend/locale.hpp"
 #include "frontend/menu.hpp"
 #include "frontend/screens/Screen.hpp"
@@ -129,13 +130,7 @@ void Engine::initialize(CoreParameters coreParameters) {
     if (params.projectFolder.empty()) {
         params.projectFolder = params.resFolder;
     }
-    paths.setResourcesFolder(params.resFolder);
-    paths.setUserFilesFolder(params.userFolder);
-    paths.setProjectFolder(params.projectFolder);
-    if (!params.scriptFile.empty()) {
-        paths.setScriptFolder(params.scriptFile.parent_path());
-    }
-    paths.prepare();
+    paths.prepare(params);
     loadProject();
 
     editor = std::make_unique<devtools::Editor>(*this);
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 2049258f..5087ab50 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -1,26 +1,26 @@
 #pragma once
 
-#include "delegates.hpp"
-#include "typedefs.hpp"
-#include "settings.hpp"
-
-#include "io/engine_paths.hpp"
-#include "io/settings_io.hpp"
-#include "util/ObjectsKeeper.hpp"
+#include "CoreParameters.hpp"
 #include "PostRunnables.hpp"
 #include "Time.hpp"
+#include "delegates.hpp"
+#include "io/engine_paths.hpp"
+#include "settings.hpp"
+#include "typedefs.hpp"
+#include "util/ObjectsKeeper.hpp"
 
 #include <memory>
 #include <string>
 
-class Window;
-class WindowControl;
 class Assets;
-class Level;
-class Screen;
 class ContentControl;
 class EngineController;
 class Input;
+class Level;
+class Screen;
+class SettingsHandler;
+class Window;
+class WindowControl;
 struct Project;
 
 namespace gui {
@@ -45,17 +45,6 @@ public:
     initialize_error(const std::string& message) : std::runtime_error(message) {}
 };
 
-struct CoreParameters {
-    bool headless = false;
-    bool testMode = false;
-    std::filesystem::path resFolder = "res";
-    std::filesystem::path userFolder = ".";
-    std::filesystem::path scriptFile;
-    std::filesystem::path projectFolder;
-    std::string debugServerString;
-    int tps = 20;
-};
-
 using OnWorldOpen = std::function<void(std::unique_ptr<Level>, int64_t)>;
 
 class Engine : public util::ObjectsKeeper {
diff --git a/src/io/engine_paths.cpp b/src/io/engine_paths.cpp
index ef102621..506230ad 100644
--- a/src/io/engine_paths.cpp
+++ b/src/io/engine_paths.cpp
@@ -1,44 +1,56 @@
 #include "engine_paths.hpp"
 
+#include "debug/Logger.hpp"
+#include "io/devices/StdfsDevice.hpp"
+#include "io/devices/ZipFileDevice.hpp"
+#include "maths/util.hpp"
+#include "typedefs.hpp"
+#include "util/platform.hpp"
+#include "util/random.hpp"
+#include "util/stringutil.hpp"
+#include "world/files/WorldFiles.hpp"
+
 #include <algorithm>
 #include <array>
+#include <chrono>
 #include <sstream>
 #include <stack>
-#include "typedefs.hpp"
-#include "util/stringutil.hpp"
-#include "util/platform.hpp"
+#include <stdexcept>
 #include <utility>
 
-#include "io/devices/StdfsDevice.hpp"
-#include "io/devices/ZipFileDevice.hpp"
-#include "world/files/WorldFiles.hpp"
-#include "debug/Logger.hpp"
-
-#include <chrono>
-#include "maths/util.hpp"
-
-template<int n>
-static std::string generate_random_base64() {
-    auto now = std::chrono::high_resolution_clock::now();
-    auto seed = now.time_since_epoch().count();
-
-    util::PseudoRandom random(seed); // fixme: replace with safe random
-    ubyte bytes[n];
-    random.rand(bytes, n);
-    return util::base64_urlsafe_encode(bytes, n);
-}
-
 namespace fs = std::filesystem;
 
-static debug::Logger logger("engine-paths");
+static std::random_device random_device;
 
 static inline io::path SCREENSHOTS_FOLDER = "user:screenshots";
 static inline io::path CONTENT_FOLDER = "user:content";
 static inline io::path WORLDS_FOLDER = "user:worlds";
 
-void EnginePaths::prepare() {
+static debug::Logger logger("engine-paths");
+
+template<int n>
+static std::string generate_random_base64() {
+    auto randomEngine = util::seeded_random_engine(random_device);
+    static std::uniform_int_distribution<integer_t> dist(0, 0xFF);
+    ubyte bytes[n];
+    for (size_t i = 0; i < n; i++) {
+        bytes[i] = dist(randomEngine);
+    }
+    return util::base64_urlsafe_encode(bytes, n);
+}
+
+void EnginePaths::prepare(CoreParameters& params) {
+    resourcesFolder = params.resFolder;
+    userFilesFolder = params.userFolder;
+    projectFolder = params.projectFolder;
+    if (!params.scriptFile.empty()) {
+        scriptFolder = params.scriptFile.parent_path();
+        io::set_device("script", std::make_shared<io::StdfsDevice>(*scriptFolder));
+    }
+
     io::set_device("res", std::make_shared<io::StdfsDevice>(resourcesFolder, false));
     io::set_device("user", std::make_shared<io::StdfsDevice>(userFilesFolder));
+    io::set_device("project", std::make_shared<io::StdfsDevice>(projectFolder));
 
     if (!io::is_directory("res:")) {
         throw std::runtime_error(
@@ -59,11 +71,11 @@ void EnginePaths::prepare() {
     io::create_subdevice("config", "user", "config");
 }
 
-const std::filesystem::path& EnginePaths::getUserFilesFolder() const {
+const fs::path& EnginePaths::getUserFilesFolder() const {
     return userFilesFolder;
 }
 
-const std::filesystem::path& EnginePaths::getResourcesFolder() const {
+const fs::path& EnginePaths::getResourcesFolder() const {
     return resourcesFolder;
 }
 
@@ -132,24 +144,6 @@ std::vector<io::path> EnginePaths::scanForWorlds() const {
     return folders;
 }
 
-void EnginePaths::setUserFilesFolder(std::filesystem::path folder) {
-    this->userFilesFolder = std::move(folder);
-}
-
-void EnginePaths::setResourcesFolder(std::filesystem::path folder) {
-    this->resourcesFolder = std::move(folder);
-}
-
-void EnginePaths::setScriptFolder(std::filesystem::path folder) {
-    io::set_device("script", std::make_shared<io::StdfsDevice>(folder));
-    this->scriptFolder = std::move(folder);
-}
-
-void EnginePaths::setProjectFolder(std::filesystem::path folder) {
-    io::set_device("project", std::make_shared<io::StdfsDevice>(folder));
-    this->projectFolder = std::move(folder);
-}
-
 void EnginePaths::setCurrentWorldFolder(io::path folder) {
     if (folder.empty()) {
         io::remove_device("world");
diff --git a/src/io/engine_paths.hpp b/src/io/engine_paths.hpp
index 0fa58874..fd411db7 100644
--- a/src/io/engine_paths.hpp
+++ b/src/io/engine_paths.hpp
@@ -1,15 +1,15 @@
 #pragma once
 
+#include "io.hpp"
+#include "data/dv.hpp"
+#include "engine/CoreParameters.hpp"
+
 #include <unordered_map>
-#include <stdexcept>
 #include <optional>
 #include <string>
 #include <vector>
 #include <tuple>
 
-#include "io.hpp"
-#include "data/dv.hpp"
-
 struct PathsRoot {
     std::string name;
     io::path path;
@@ -46,18 +46,11 @@ class EnginePaths {
 public:
     ResPaths resPaths;
 
-    void prepare();
+    void prepare(CoreParameters& params);
 
-    void setUserFilesFolder(std::filesystem::path folder);
     const std::filesystem::path& getUserFilesFolder() const;
-
-    void setResourcesFolder(std::filesystem::path folder);
     const std::filesystem::path& getResourcesFolder() const;
 
-    void setScriptFolder(std::filesystem::path folder);
-
-    void setProjectFolder(std::filesystem::path folder);
-
     io::path getWorldFolderByName(const std::string& name);
     io::path getWorldsFolder() const;
 

From 17ffa73ce75671d69ffe1e6b479a28249907006b Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 20:13:59 +0300
Subject: [PATCH 110/133] refactor: move and rename EnginePaths

---
 src/assets/AssetsLoader.cpp                   |  2 +-
 src/assets/assetload_funcs.cpp                |  2 +-
 src/coders/GLSLExtension.cpp                  |  2 +-
 src/content/ContentControl.cpp                |  2 +-
 src/content/ContentLoader.cpp                 |  2 +-
 src/content/ContentPack.cpp                   |  2 +-
 src/content/loading/GeneratorLoader.cpp       |  2 +-
 src/core_defs.cpp                             |  2 +-
 src/devtools/Editor.cpp                       |  2 +-
 src/engine/Engine.cpp                         | 17 +++++++-------
 src/engine/Engine.hpp                         |  6 ++---
 .../EnginePaths.cpp}                          | 22 +++++--------------
 .../EnginePaths.hpp}                          | 16 +++++---------
 src/engine/ServerMainloop.cpp                 |  1 +
 src/engine/WindowControl.cpp                  |  1 +
 src/frontend/menu.cpp                         |  2 +-
 src/frontend/screens/LevelScreen.cpp          |  1 +
 src/graphics/render/Decorator.cpp             |  1 +
 src/logic/EngineController.cpp                | 17 +++++++-------
 src/logic/scripting/lua/libs/libaudio.cpp     |  1 +
 src/logic/scripting/lua/libs/libcore.cpp      |  2 +-
 src/logic/scripting/lua/libs/libentity.cpp    |  1 +
 src/logic/scripting/lua/libs/libfile.cpp      |  2 +-
 .../scripting/lua/libs/libgeneration.cpp      |  1 +
 src/logic/scripting/lua/libs/libpack.cpp      |  2 +-
 src/logic/scripting/lua/libs/libworld.cpp     |  2 +-
 src/logic/scripting/lua/lua_engine.cpp        |  2 +-
 .../lua/usertypes/lua_type_heightmap.cpp      |  1 +
 src/logic/scripting/scripting.cpp             |  2 +-
 src/util/command_line.cpp                     |  2 +-
 30 files changed, 57 insertions(+), 63 deletions(-)
 rename src/{io/engine_paths.cpp => engine/EnginePaths.cpp} (92%)
 rename src/{io/engine_paths.hpp => engine/EnginePaths.hpp} (81%)

diff --git a/src/assets/AssetsLoader.cpp b/src/assets/AssetsLoader.cpp
index 8dc7c31c..0fde22fc 100644
--- a/src/assets/AssetsLoader.cpp
+++ b/src/assets/AssetsLoader.cpp
@@ -9,7 +9,7 @@
 #include "content/Content.hpp"
 #include "content/ContentPack.hpp"
 #include "debug/Logger.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "graphics/core/Texture.hpp"
 #include "logic/scripting/scripting.hpp"
diff --git a/src/assets/assetload_funcs.cpp b/src/assets/assetload_funcs.cpp
index 4fda3b0d..a1c04dfc 100644
--- a/src/assets/assetload_funcs.cpp
+++ b/src/assets/assetload_funcs.cpp
@@ -15,7 +15,7 @@
 #include "coders/vec3.hpp"
 #include "constants.hpp"
 #include "debug/Logger.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "frontend/UiDocument.hpp"
 #include "graphics/core/Atlas.hpp"
diff --git a/src/coders/GLSLExtension.cpp b/src/coders/GLSLExtension.cpp
index 5d53cb35..fa1335f3 100644
--- a/src/coders/GLSLExtension.cpp
+++ b/src/coders/GLSLExtension.cpp
@@ -6,7 +6,7 @@
 #include <utility>
 
 #include "debug/Logger.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "typedefs.hpp"
 #include "util/stringutil.hpp"
 #include "coders/json.hpp"
diff --git a/src/content/ContentControl.cpp b/src/content/ContentControl.cpp
index 543931d3..6140c3d2 100644
--- a/src/content/ContentControl.cpp
+++ b/src/content/ContentControl.cpp
@@ -1,7 +1,7 @@
 #include "ContentControl.hpp"
 
 #include "io/io.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "Content.hpp"
 #include "ContentPack.hpp"
 #include "ContentBuilder.hpp"
diff --git a/src/content/ContentLoader.cpp b/src/content/ContentLoader.cpp
index ea29e27c..a88146be 100644
--- a/src/content/ContentLoader.cpp
+++ b/src/content/ContentLoader.cpp
@@ -13,7 +13,7 @@
 #include "objects/rigging.hpp"
 #include "util/listutil.hpp"
 #include "util/stringutil.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 
 static debug::Logger logger("content-loader");
 
diff --git a/src/content/ContentPack.cpp b/src/content/ContentPack.cpp
index 021f083e..d2ffdc9e 100644
--- a/src/content/ContentPack.cpp
+++ b/src/content/ContentPack.cpp
@@ -8,7 +8,7 @@
 #include "coders/json.hpp"
 #include "constants.hpp"
 #include "data/dv.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "coders/commons.hpp"
 #include "debug/Logger.hpp"
diff --git a/src/content/loading/GeneratorLoader.cpp b/src/content/loading/GeneratorLoader.cpp
index 2f8f40d5..668425e0 100644
--- a/src/content/loading/GeneratorLoader.cpp
+++ b/src/content/loading/GeneratorLoader.cpp
@@ -6,7 +6,7 @@
 #include "../ContentPack.hpp"
 
 #include "io/io.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "logic/scripting/scripting.hpp"
 #include "util/stringutil.hpp"
 #include "world/generator/GeneratorDef.hpp"
diff --git a/src/core_defs.cpp b/src/core_defs.cpp
index 79551cd4..a72d6eef 100644
--- a/src/core_defs.cpp
+++ b/src/core_defs.cpp
@@ -4,7 +4,7 @@
 #include "content/Content.hpp"
 #include "content/ContentBuilder.hpp"
 #include "io/io.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "window/input.hpp"
 #include "voxels/Block.hpp"
 #include "coders/toml.hpp"
diff --git a/src/devtools/Editor.cpp b/src/devtools/Editor.cpp
index 82475ee4..0bd0af7d 100644
--- a/src/devtools/Editor.cpp
+++ b/src/devtools/Editor.cpp
@@ -1,7 +1,7 @@
 #include "Editor.hpp"
 
 #include "engine/Engine.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "coders/syntax_parser.hpp"
 #include "SyntaxProcessor.hpp"
 
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index ca8edc89..b892908c 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -37,6 +37,7 @@
 #include "Mainloop.hpp"
 #include "ServerMainloop.hpp"
 #include "WindowControl.hpp"
+#include "EnginePaths.hpp"
 
 #include <iostream>
 #include <assert.h>
@@ -61,7 +62,7 @@ Engine& Engine::getInstance() {
 
 void Engine::onContentLoad() {
     editor->loadTools();
-    langs::setup(langs::get_current(), paths.resPaths.collectRoots());
+    langs::setup(langs::get_current(), paths->resPaths.collectRoots());
     
     if (isHeadless()) {
         return;
@@ -130,7 +131,7 @@ void Engine::initialize(CoreParameters coreParameters) {
     if (params.projectFolder.empty()) {
         params.projectFolder = params.resFolder;
     }
-    paths.prepare(params);
+    paths = std::make_unique<EnginePaths>(params);
     loadProject();
 
     editor = std::make_unique<devtools::Editor>(*this);
@@ -161,7 +162,7 @@ void Engine::initialize(CoreParameters coreParameters) {
             langs::locale_by_envlocale(platform::detect_locale())
         );
     }
-    content = std::make_unique<ContentControl>(*project, paths, *input, [this]() {
+    content = std::make_unique<ContentControl>(*project, *paths, *input, [this]() {
         onContentLoad();
     });
     scripting::initialize(this);
@@ -170,7 +171,7 @@ void Engine::initialize(CoreParameters coreParameters) {
         gui->setPageLoader(scripting::create_page_loader());
     }
     keepAlive(settings.ui.language.observe([this](auto lang) {
-        langs::setup(lang, paths.resPaths.collectRoots());
+        langs::setup(lang, paths->resPaths.collectRoots());
     }, true));
 
     project->loadProjectStartScript();
@@ -345,12 +346,12 @@ void Engine::setLevelConsumer(OnWorldOpen levelConsumer) {
 
 void Engine::loadAssets() {
     logger.info() << "loading assets";
-    Shader::preprocessor->setPaths(&paths.resPaths);
+    Shader::preprocessor->setPaths(&paths->resPaths);
 
     auto content = this->content->get();
 
     auto new_assets = std::make_unique<Assets>();
-    AssetsLoader loader(*this, *new_assets, paths.resPaths);
+    AssetsLoader loader(*this, *new_assets, paths->resPaths);
     AssetsLoader::addDefaults(loader, content);
 
     // no need
@@ -426,11 +427,11 @@ Assets* Engine::getAssets() {
 }
 
 EnginePaths& Engine::getPaths() {
-    return paths;
+    return *paths;
 }
 
 ResPaths& Engine::getResPaths() {
-    return paths.resPaths;
+    return paths->resPaths;
 }
 
 std::shared_ptr<Screen> Engine::getScreen() {
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 5087ab50..58a79f95 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -4,7 +4,6 @@
 #include "PostRunnables.hpp"
 #include "Time.hpp"
 #include "delegates.hpp"
-#include "io/engine_paths.hpp"
 #include "settings.hpp"
 #include "typedefs.hpp"
 #include "util/ObjectsKeeper.hpp"
@@ -15,8 +14,10 @@
 class Assets;
 class ContentControl;
 class EngineController;
+class EnginePaths;
 class Input;
 class Level;
+class ResPaths;
 class Screen;
 class SettingsHandler;
 class Window;
@@ -50,8 +51,7 @@ using OnWorldOpen = std::function<void(std::unique_ptr<Level>, int64_t)>;
 class Engine : public util::ObjectsKeeper {
     CoreParameters params;
     EngineSettings settings;
-    EnginePaths paths;
-
+    std::unique_ptr<EnginePaths> paths;
     std::unique_ptr<Project> project;
     std::unique_ptr<SettingsHandler> settingsHandler;
     std::unique_ptr<Assets> assets;
diff --git a/src/io/engine_paths.cpp b/src/engine/EnginePaths.cpp
similarity index 92%
rename from src/io/engine_paths.cpp
rename to src/engine/EnginePaths.cpp
index 506230ad..8a786140 100644
--- a/src/io/engine_paths.cpp
+++ b/src/engine/EnginePaths.cpp
@@ -1,4 +1,4 @@
-#include "engine_paths.hpp"
+#include "EnginePaths.hpp"
 
 #include "debug/Logger.hpp"
 #include "io/devices/StdfsDevice.hpp"
@@ -39,10 +39,10 @@ static std::string generate_random_base64() {
     return util::base64_urlsafe_encode(bytes, n);
 }
 
-void EnginePaths::prepare(CoreParameters& params) {
-    resourcesFolder = params.resFolder;
-    userFilesFolder = params.userFolder;
-    projectFolder = params.projectFolder;
+EnginePaths::EnginePaths(CoreParameters& params)
+    : resourcesFolder(params.resFolder),
+      userFilesFolder(params.userFolder),
+      projectFolder(params.projectFolder) {
     if (!params.scriptFile.empty()) {
         scriptFolder = params.scriptFile.parent_path();
         io::set_device("script", std::make_shared<io::StdfsDevice>(*scriptFolder));
@@ -71,14 +71,6 @@ void EnginePaths::prepare(CoreParameters& params) {
     io::create_subdevice("config", "user", "config");
 }
 
-const fs::path& EnginePaths::getUserFilesFolder() const {
-    return userFilesFolder;
-}
-
-const fs::path& EnginePaths::getResourcesFolder() const {
-    return resourcesFolder;
-}
-
 io::path EnginePaths::getNewScreenshotFile(const std::string& ext) const {
     auto folder = SCREENSHOTS_FOLDER;
     if (!io::is_directory(folder)) {
@@ -107,10 +99,6 @@ io::path EnginePaths::getWorldsFolder() const {
     return WORLDS_FOLDER;
 }
 
-io::path EnginePaths::getCurrentWorldFolder() {
-    return currentWorldFolder;
-}
-
 io::path EnginePaths::getWorldFolderByName(const std::string& name) {
     return getWorldsFolder() / name;
 }
diff --git a/src/io/engine_paths.hpp b/src/engine/EnginePaths.hpp
similarity index 81%
rename from src/io/engine_paths.hpp
rename to src/engine/EnginePaths.hpp
index fd411db7..41d02236 100644
--- a/src/io/engine_paths.hpp
+++ b/src/engine/EnginePaths.hpp
@@ -1,8 +1,8 @@
 #pragma once
 
-#include "io.hpp"
+#include "io/io.hpp"
 #include "data/dv.hpp"
-#include "engine/CoreParameters.hpp"
+#include "CoreParameters.hpp"
 
 #include <unordered_map>
 #include <optional>
@@ -46,16 +46,12 @@ class EnginePaths {
 public:
     ResPaths resPaths;
 
-    void prepare(CoreParameters& params);
-
-    const std::filesystem::path& getUserFilesFolder() const;
-    const std::filesystem::path& getResourcesFolder() const;
+    EnginePaths(CoreParameters& params);
 
     io::path getWorldFolderByName(const std::string& name);
     io::path getWorldsFolder() const;
 
     void setCurrentWorldFolder(io::path folder);
-    io::path getCurrentWorldFolder();
     io::path getNewScreenshotFile(const std::string& ext) const;
 
     std::string mount(const io::path& file);
@@ -73,9 +69,9 @@ public:
     static inline io::path CONTROLS_FILE = "user:controls.toml";
     static inline io::path SETTINGS_FILE = "user:settings.toml";
 private:
-    std::filesystem::path userFilesFolder {"."};
-    std::filesystem::path resourcesFolder {"res"};
-    std::filesystem::path projectFolder = resourcesFolder;
+    std::filesystem::path resourcesFolder;
+    std::filesystem::path userFilesFolder;
+    std::filesystem::path projectFolder;
     io::path currentWorldFolder;
     std::optional<std::filesystem::path> scriptFolder;
     std::vector<PathsRoot> entryPoints;
diff --git a/src/engine/ServerMainloop.cpp b/src/engine/ServerMainloop.cpp
index 7fb8ffed..41887aee 100644
--- a/src/engine/ServerMainloop.cpp
+++ b/src/engine/ServerMainloop.cpp
@@ -1,6 +1,7 @@
 #include "ServerMainloop.hpp"
 
 #include "Engine.hpp"
+#include "EnginePaths.hpp"
 #include "logic/scripting/scripting.hpp"
 #include "logic/LevelController.hpp"
 #include "interfaces/Process.hpp"
diff --git a/src/engine/WindowControl.cpp b/src/engine/WindowControl.cpp
index 8557c5be..0dabd009 100644
--- a/src/engine/WindowControl.cpp
+++ b/src/engine/WindowControl.cpp
@@ -1,6 +1,7 @@
 #include "WindowControl.hpp"
 
 #include "Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "devtools/Project.hpp"
 #include "coders/imageio.hpp"
 #include "window/Window.hpp"
diff --git a/src/frontend/menu.cpp b/src/frontend/menu.cpp
index e46888df..372264a5 100644
--- a/src/frontend/menu.cpp
+++ b/src/frontend/menu.cpp
@@ -11,7 +11,7 @@
 #include "graphics/ui/elements/Menu.hpp"
 #include "graphics/ui/gui_util.hpp"
 #include "interfaces/Task.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "locale.hpp"
 #include "logic/scripting/scripting.hpp"
 #include "screens/MenuScreen.hpp"
diff --git a/src/frontend/screens/LevelScreen.cpp b/src/frontend/screens/LevelScreen.cpp
index d398b3cc..f3694d85 100644
--- a/src/frontend/screens/LevelScreen.cpp
+++ b/src/frontend/screens/LevelScreen.cpp
@@ -6,6 +6,7 @@
 #include "core_defs.hpp"
 #include "debug/Logger.hpp"
 #include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "assets/Assets.hpp"
 #include "frontend/ContentGfxCache.hpp"
 #include "frontend/LevelFrontend.hpp"
diff --git a/src/graphics/render/Decorator.cpp b/src/graphics/render/Decorator.cpp
index 94b8ee13..8bbb2c9d 100644
--- a/src/graphics/render/Decorator.cpp
+++ b/src/graphics/render/Decorator.cpp
@@ -19,6 +19,7 @@
 #include "logic/LevelController.hpp"
 #include "util/stringutil.hpp"
 #include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "audio/audio.hpp"
 #include "maths/util.hpp"
diff --git a/src/logic/EngineController.cpp b/src/logic/EngineController.cpp
index 0d0a5a60..d6820fa1 100644
--- a/src/logic/EngineController.cpp
+++ b/src/logic/EngineController.cpp
@@ -4,28 +4,29 @@
 #include <algorithm>
 #include <memory>
 
-#include "engine/Engine.hpp"
 #include "coders/commons.hpp"
-#include "debug/Logger.hpp"
 #include "coders/json.hpp"
-#include "content/ContentReport.hpp"
 #include "content/ContentControl.hpp"
+#include "content/ContentReport.hpp"
 #include "content/PacksManager.hpp"
-#include "world/files/WorldConverter.hpp"
-#include "world/files/WorldFiles.hpp"
+#include "debug/Logger.hpp"
+#include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "frontend/locale.hpp"
 #include "frontend/menu.hpp"
 #include "frontend/screens/LevelScreen.hpp"
 #include "frontend/screens/MenuScreen.hpp"
-#include "graphics/ui/GUI.hpp"
 #include "graphics/ui/elements/Menu.hpp"
 #include "graphics/ui/gui_util.hpp"
-#include "objects/Players.hpp"
+#include "graphics/ui/GUI.hpp"
 #include "interfaces/Task.hpp"
+#include "LevelController.hpp"
+#include "objects/Players.hpp"
 #include "util/stringutil.hpp"
+#include "world/files/WorldConverter.hpp"
+#include "world/files/WorldFiles.hpp"
 #include "world/Level.hpp"
 #include "world/World.hpp"
-#include "LevelController.hpp"
 
 static debug::Logger logger("engine-control");
 
diff --git a/src/logic/scripting/lua/libs/libaudio.cpp b/src/logic/scripting/lua/libs/libaudio.cpp
index db868c57..606c4351 100644
--- a/src/logic/scripting/lua/libs/libaudio.cpp
+++ b/src/logic/scripting/lua/libs/libaudio.cpp
@@ -1,6 +1,7 @@
 #include "audio/audio.hpp"
 #include "assets/Assets.hpp"
 #include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "api_lua.hpp"
 
 inline const char* DEFAULT_CHANNEL = "regular";
diff --git a/src/logic/scripting/lua/libs/libcore.cpp b/src/logic/scripting/lua/libs/libcore.cpp
index 9f14e2a0..34c33d6d 100644
--- a/src/logic/scripting/lua/libs/libcore.cpp
+++ b/src/logic/scripting/lua/libs/libcore.cpp
@@ -8,7 +8,7 @@
 #include "content/Content.hpp"
 #include "content/ContentControl.hpp"
 #include "engine/Engine.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "io/settings_io.hpp"
 #include "frontend/menu.hpp"
diff --git a/src/logic/scripting/lua/libs/libentity.cpp b/src/logic/scripting/lua/libs/libentity.cpp
index 26d3ea61..3b9730c2 100644
--- a/src/logic/scripting/lua/libs/libentity.cpp
+++ b/src/logic/scripting/lua/libs/libentity.cpp
@@ -2,6 +2,7 @@
 
 #include "content/Content.hpp"
 #include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "objects/Entities.hpp"
 #include "objects/EntityDef.hpp"
 #include "objects/Entity.hpp"
diff --git a/src/logic/scripting/lua/libs/libfile.cpp b/src/logic/scripting/lua/libs/libfile.cpp
index 28ed5a6e..c3ee4bdb 100644
--- a/src/logic/scripting/lua/libs/libfile.cpp
+++ b/src/logic/scripting/lua/libs/libfile.cpp
@@ -3,7 +3,7 @@
 
 #include "coders/gzip.hpp"
 #include "engine/Engine.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "io/devices/ZipFileDevice.hpp"
 #include "util/stringutil.hpp"
diff --git a/src/logic/scripting/lua/libs/libgeneration.cpp b/src/logic/scripting/lua/libs/libgeneration.cpp
index 5c060382..49407022 100644
--- a/src/logic/scripting/lua/libs/libgeneration.cpp
+++ b/src/logic/scripting/lua/libs/libgeneration.cpp
@@ -9,6 +9,7 @@
 #include "content/Content.hpp"
 #include "content/ContentControl.hpp"
 #include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "../lua_custom_types.hpp"
 
 using namespace scripting;
diff --git a/src/logic/scripting/lua/libs/libpack.cpp b/src/logic/scripting/lua/libs/libpack.cpp
index f23e96b3..b7162b4d 100644
--- a/src/logic/scripting/lua/libs/libpack.cpp
+++ b/src/logic/scripting/lua/libs/libpack.cpp
@@ -10,7 +10,7 @@
 #include "graphics/ui/elements/Menu.hpp"
 #include "frontend/locale.hpp"
 #include "world/files/WorldFiles.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "world/Level.hpp"
 #include "world/World.hpp"
 #include "api_lua.hpp"
diff --git a/src/logic/scripting/lua/libs/libworld.cpp b/src/logic/scripting/lua/libs/libworld.cpp
index 41778204..eb966f50 100644
--- a/src/logic/scripting/lua/libs/libworld.cpp
+++ b/src/logic/scripting/lua/libs/libworld.cpp
@@ -10,7 +10,7 @@
 #include "content/ContentControl.hpp"
 #include "engine/Engine.hpp"
 #include "world/files/WorldFiles.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "lighting/Lighting.hpp"
 #include "voxels/Chunk.hpp"
diff --git a/src/logic/scripting/lua/lua_engine.cpp b/src/logic/scripting/lua/lua_engine.cpp
index 08d2eb85..324b3d3b 100644
--- a/src/logic/scripting/lua/lua_engine.cpp
+++ b/src/logic/scripting/lua/lua_engine.cpp
@@ -4,7 +4,7 @@
 #include <iostream>
 
 #include "io/io.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "debug/Logger.hpp"
 #include "util/stringutil.hpp"
 #include "libs/api_lua.hpp"
diff --git a/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp b/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp
index 3e015b72..2800035a 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_heightmap.cpp
@@ -13,6 +13,7 @@
 #include "graphics/core/ImageData.hpp"
 #include "maths/Heightmap.hpp"
 #include "engine/Engine.hpp"
+#include "engine/EnginePaths.hpp"
 #include "../lua_util.hpp"
 
 using namespace lua;
diff --git a/src/logic/scripting/scripting.cpp b/src/logic/scripting/scripting.cpp
index 586feeb8..b9efda4b 100644
--- a/src/logic/scripting/scripting.cpp
+++ b/src/logic/scripting/scripting.cpp
@@ -9,7 +9,7 @@
 #include "content/ContentControl.hpp"
 #include "debug/Logger.hpp"
 #include "engine/Engine.hpp"
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "io/io.hpp"
 #include "frontend/UiDocument.hpp"
 #include "items/Inventory.hpp"
diff --git a/src/util/command_line.cpp b/src/util/command_line.cpp
index 3691b77b..7cb3614e 100644
--- a/src/util/command_line.cpp
+++ b/src/util/command_line.cpp
@@ -6,7 +6,7 @@
 #include <string>
 #include <iomanip>
 
-#include "io/engine_paths.hpp"
+#include "engine/EnginePaths.hpp"
 #include "util/ArgsReader.hpp"
 #include "engine/Engine.hpp"
 

From 65bba0088b6f8cf446f927584b298a4725dff615 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 21:24:21 +0300
Subject: [PATCH 111/133] update doc/*/content-packs.md

---
 doc/en/content-packs.md | 75 +++++++++++++++++++++++++++++++++++++-
 doc/ru/content-packs.md | 79 +++++++++++++++++++++++++++++++++++++++--
 2 files changed, 151 insertions(+), 3 deletions(-)

diff --git a/doc/en/content-packs.md b/doc/en/content-packs.md
index a41f95f9..c193fb18 100644
--- a/doc/en/content-packs.md
+++ b/doc/en/content-packs.md
@@ -48,6 +48,79 @@ Example:
 
 Content pack picture should be added as *icon.png* file. Recommended size: 128x128
 
-See *res/content/base* as an example of content pack structure.
+# File System
 
+Every loaded pack is mounted to the internal file system as a new mount point, whose name matches the pack's id.
 
+This means that accessing pack files does not require the use of additional functions:
+
+```lua
+print(file.read("your_pack_id:package.json")) -- will output the contents of the pack's package.json
+```
+
+This is also one of the reasons why some ids are reserved and cannot be used.
+
+Mount points are mounted as read-only. To gain write access, use the `pack.request_writeable` function.
+
+Read more about the [file](scripting/builtins/libfile.md) library.
+
+# Content Pack Structure
+
+Don't be intimidated by the following text, as a minimal pack only requires `package.json`.
+
+- Content:
+    - `block_materials/` - Block material definitions
+    - `blocks/` - Block definitions
+    - `items/` - Item definitions
+    - `generators/` - World generators
+    - `entities/` - Entity definitions
+    - `skeletons/` - Entity skeleton definitions
+    - `presets/` - Presets (can also be used by packs for their own purposes)
+        - `text3d/` - 3D Text
+        - `weather/` - Weather
+- Code:
+    - `modules/` - Script modules
+    - `scripts/` - Content scripts, world scripts
+        - `components/` - Entity components
+- Assets (Client-side resources):
+    - `fonts/` - Fonts
+    - `models/` - 3D Models
+    - `textures/` - Textures
+    - `shaders/` - Shaders
+        - `effects/` - Post-processing effects
+    - `sounds/` - Sounds and Music
+    - `texts/` - Localization files
+- GUI:
+    - `layouts/` - UI Layouts
+        - `pages/` - Menu page layouts (for the pagebox element)
+- Configuration:
+    - `config/` - Configuration files
+        - `defaults.toml` - Overrides for standard content bindings, such as the player entity, default generator, etc.
+        - `bindings.toml` - Keyboard/Mouse bindings
+        - `user-props.toml` - User properties for content definitions
+    - `devtools/` - Auxiliary files for internal debugging tools
+    - `content.json` - Automatically generated content lists, used for validating world indices and for conversion when mismatched
+    - `icon.png` - Pack icon
+    - `package.json` - Pack definition file
+    - `preload.json` - Asset preload lists for assets that are not loaded automatically; avoid listing assets unnecessarily
+    - `resources.json` - Definition lists for [resources](resources.md) (not to be confused with assets)
+    - `resource-aliases.json` - Files declaring aliases for [resources](resources.md)
+
+> [!WARNING]
+> Manually editing `content.json` is strongly discouraged and will most likely lead to irreversible world corruption.
+
+# Content Sources
+
+Content packs are searched for within **content sources**, which are paths in the engine's file system.
+
+Source priority determines the scan order: if the same pack is found in multiple sources, the one belonging to the source with the highest priority will be selected.
+
+Content sources in descending order of priority:
+- `world:content` - Content in the world folder (`world/content/`)
+- `user:content` - Content in the user folder (`$HOME/.voxeng/content/`)
+- `project:content` - Content in the project folder (`project/content/`)
+- `res:content` - Built-in content shipped with the engine core (`res/content/`)
+
+I.e., if the same pack exists in both `world:content` and `user:content`, the version from `world:content` will be selected.
+
+The pack version, however, is currently not taken into account.
diff --git a/doc/ru/content-packs.md b/doc/ru/content-packs.md
index 4245555f..32f9be59 100644
--- a/doc/ru/content-packs.md
+++ b/doc/ru/content-packs.md
@@ -50,5 +50,80 @@
 
 Изображение контент-пака добавляется в виде файла *icon.png* в папку пака (не в textures). Рекомендованный размер изображения: 128x128
 
-Новые блоки добавляются в под-папку **blocks**, предметы в **items**, текстуры в **textures**
-С примером файловой структуры лучше ознакомиться через базовый пакет (*res/content/base*)
+# Файловая система
+
+Каждый загруженный пак монтируется к внутренней файловой системе как новая точка входа, имя которой совпадает с id пака.
+
+Это значит, что для доступа к файлам пака не требуется использование дополнительных функций:
+
+```lua
+print(file.read("пак:package.json")) -- выведет содержимое package.json пака
+```
+
+Также это является одной из причин того, что некоторые id зарезервированы от использования.
+
+Точки входа монтируются как read-only. Для получения доступа к записи существует функция pack.request_writeable.
+
+Подробнее про библиотеку [file](scripting/builtins/libfile.md).
+
+# Структура контент-пака
+
+Пусть вас не пугает следующий текст, ведь минимальный пак содержит только package.json.
+
+- Контент:
+    - `block_materials/` - определения материалов блоков
+    - `blocks/` - определения блоков
+    - `items/` - определения предметов
+    - `generators/` - генераторы мира
+    - `entities/` - определения сущностей
+    - `skeletons/` - определения скелетов сущностей
+    - `presets/` - пресеты (может использоваться и паками в своих целях)
+        - `text3d/` - 3D текст
+        - `weather/` - погода
+- Код:
+    - `modules/` - скриптовые модули
+    - `scripts/` - скрипты контента, мира
+        - `components/` - компоненты сущностей
+- Ассеты (ресурсы клиентской стороны):
+    - `fonts/` - шрифты
+    - `models/` - 3D модели
+    - `textures/` - текстуры
+    - `shaders/` - шейдеры
+        - `effects/` - эффекты пост-обработки
+    - `sounds/` - звуки и музыка
+    - `texts/` - файлы локализации
+- GUI:
+    - `layouts/` - макеты UI
+        - `pages/` - макеты страниц меню (элемент pagebox)
+- Конфигурация:
+    - `config/` - файлы конфигурации
+        - `defaults.toml` - переопределения стандартных привязок к контенту, такие как сущность игрока, генератор по-умолчанию и т.д.
+        - `bindings.toml` - привязки к клавишам / мыши
+        - `user-props.toml` - пользовательские свойства определений контента
+    - `devtools/` - вспомогательные файлы внутренних инструментов отладки
+    - `content.json` - генерируемые автоматически списки контента, используемое для проверки корректности индексов в мире и конвертации при несовпадении
+    - `icon.png` - иконка пака
+    - `package.json` - файл опеределения пака
+    - `preload.json` - списки предзагрузки ассетов, которые не загружаются автоматически, не следует указывать ассеты без надобности
+    - `resources.json` - списки определений [ресурсов](resources.md) (не путать с ассетами)
+    - `resource-aliases.json` - файлы объявления псевдонимов для [ресурсов](resources.md)
+
+> [!WARNING]
+> Ручное редактирование `content.json` противопоказано и скорее всего приведёт к необратимой поломке миров.
+
+# Источники контента
+
+Поиск контент-паков производится среди **источников контента**, являющихся путями в файловой системе движка.
+
+Приоритет источника определяет порядок сканирования: если один и тот же пак найден в нескольких источниках, 
+будет выбран тот, что принадлежит источнику с наивысшим приоритетом.
+
+Источники контента в порядке убывания приоритета:
+- `world:content` - контент папке с миром (`мир/content/`)
+- `user:content` - контент в папке пользователя (`$HOME/.voxeng/content/`)
+- `project:content` - контент в папке с проектом (`проект/content/`)
+- `res:content` - встроенный контент, поставляемый вместе с ядром движка (`res/content/`)
+
+Т.е. если в `world:content` и в `user:content` есть один и тот же пак, будет выбрана версия из `world:content`.
+
+Версия пака, при этом, на данный момент, не учитывается.

From 7fc3703ad2f72e31e27dce95404a2f58a59f098f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 22:22:24 +0300
Subject: [PATCH 112/133] feat: refresh on demand in menu (adaptive framerate)

---
 src/engine/Engine.cpp            |  6 +++---
 src/engine/Engine.hpp            |  2 +-
 src/engine/Mainloop.cpp          |  4 +++-
 src/engine/WindowControl.cpp     | 19 ++++++++++++-------
 src/engine/WindowControl.hpp     |  2 +-
 src/window/Window.hpp            |  5 +++++
 src/window/detail/GLFWWindow.cpp | 32 ++++++++++++++++++++++++++++++--
 src/window/input.hpp             |  2 +-
 8 files changed, 56 insertions(+), 16 deletions(-)

diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index b892908c..4cd7a316 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -255,8 +255,8 @@ void Engine::updateFrontend() {
     gui->postAct();
 }
 
-void Engine::nextFrame() {
-    windowControl->nextFrame();
+void Engine::nextFrame(bool waitForRefresh) {
+    windowControl->nextFrame(waitForRefresh);
 }
 
 void Engine::startPauseLoop() {
@@ -275,7 +275,7 @@ void Engine::startPauseLoop() {
         if (isHeadless()) {
             platform::sleep(1.0 / params.tps * 1000);
         } else {
-            nextFrame();
+            nextFrame(false);
         }
     }
     if (initialCursorLocked) {
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index 58a79f95..6b09b2ca 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -99,7 +99,7 @@ public:
     void applicationTick();
     void updateFrontend();
     void renderFrame();
-    void nextFrame();
+    void nextFrame(bool waitForRefresh);
     void startPauseLoop();
     
     /// @brief Set screen (scene).
diff --git a/src/engine/Mainloop.cpp b/src/engine/Mainloop.cpp
index 5435e983..e87bc7d9 100644
--- a/src/engine/Mainloop.cpp
+++ b/src/engine/Mainloop.cpp
@@ -45,7 +45,9 @@ void Mainloop::run() {
             engine.renderFrame();
         }
         engine.postUpdate();
-        engine.nextFrame();
+        engine.nextFrame(
+            dynamic_cast<const MenuScreen*>(engine.getScreen().get()) != nullptr
+        );
     }
     logger.info() << "main loop stopped";
 }
diff --git a/src/engine/WindowControl.cpp b/src/engine/WindowControl.cpp
index 0dabd009..637f4899 100644
--- a/src/engine/WindowControl.cpp
+++ b/src/engine/WindowControl.cpp
@@ -8,6 +8,7 @@
 #include "window/input.hpp"
 #include "debug/Logger.hpp"
 #include "graphics/core/ImageData.hpp"
+#include "util/platform.hpp"
 
 static debug::Logger logger("window-control");
 
@@ -78,15 +79,19 @@ void WindowControl::toggleFullscreen() {
     }
 }
 
-void WindowControl::nextFrame() {
+void WindowControl::nextFrame(bool waitForRefresh) {
     const auto& settings = engine.getSettings();
     auto& window = engine.getWindow();
     auto& input = engine.getInput();
-    window.setFramerate(
-        window.isIconified() && settings.display.limitFpsIconified.get()
-            ? 20
-            : settings.display.framerate.get()
-    );
+    if (waitForRefresh) {
+        window.setFramerate(Window::FPS_UNLIMITED);
+    } else {
+        window.setFramerate(
+            window.isIconified() && settings.display.limitFpsIconified.get()
+                ? 20
+                : settings.display.framerate.get()
+        );
+    }
     window.swapBuffers();
-    input.pollEvents();
+    input.pollEvents(waitForRefresh);
 }
diff --git a/src/engine/WindowControl.hpp b/src/engine/WindowControl.hpp
index f3b7c8bc..2bea138e 100644
--- a/src/engine/WindowControl.hpp
+++ b/src/engine/WindowControl.hpp
@@ -16,7 +16,7 @@ public:
 
     Result initialize();
 
-    void nextFrame();
+    void nextFrame(bool waitForRefresh);
 
     void saveScreenshot();
 
diff --git a/src/window/Window.hpp b/src/window/Window.hpp
index 135e4f7d..71004470 100644
--- a/src/window/Window.hpp
+++ b/src/window/Window.hpp
@@ -18,6 +18,8 @@ enum class WindowMode {
 
 class Window {
 public:
+    static inline constexpr int FPS_UNLIMITED = 0;
+
     Window(glm::ivec2 size) : size(std::move(size)) {}
 
     virtual ~Window() = default;
@@ -40,6 +42,9 @@ public:
     virtual void popScissor() = 0;
     virtual void resetScissor() = 0;
 
+    virtual void setShouldRefresh() = 0;
+    virtual bool checkShouldRefresh() = 0;
+
     virtual double time() = 0;
 
     virtual void setFramerate(int framerate) = 0;
diff --git a/src/window/detail/GLFWWindow.cpp b/src/window/detail/GLFWWindow.cpp
index 27f56d3c..a80c10e0 100644
--- a/src/window/detail/GLFWWindow.cpp
+++ b/src/window/detail/GLFWWindow.cpp
@@ -180,14 +180,18 @@ public:
         : window(window) {
     }
 
-    void pollEvents() override {
+    void pollEvents(bool waitForRefresh) override {
         delta.x = 0.0f;
         delta.y = 0.0f;
         scroll = 0;
         currentFrame++;
         codepoints.clear();
         pressedKeys.clear();
-        glfwPollEvents();
+        if (waitForRefresh) {
+            glfwWaitEvents();
+        } else {
+            glfwPollEvents();
+        }
 
         for (auto& [_, binding] : bindings.getAll()) {
             if (!binding.enabled) {
@@ -377,6 +381,18 @@ public:
         prevSwap = time();
     }
 
+    void setShouldRefresh() override {
+        shouldRefresh = true;
+    }
+
+    bool checkShouldRefresh() override {
+        if (shouldRefresh) {
+            shouldRefresh = false;
+            return true;
+        }
+        return false;
+    }
+
     bool isMaximized() const override {
         return glfwGetWindowAttrib(window, GLFW_MAXIMIZED);
     }
@@ -557,12 +573,14 @@ private:
     double prevSwap = 0.0;
     int posX = 0;
     int posY = 0;
+    bool shouldRefresh = true;
 };
 static_assert(!std::is_abstract<GLFWWindow>());
 
 static void mouse_button_callback(GLFWwindow* window, int button, int action, int) {
     auto handler = static_cast<GLFWWindow*>(glfwGetWindowUserPointer(window));
     handler->input.onMouseCallback(button, action == GLFW_PRESS);
+    handler->setShouldRefresh();
 }
 
 static void character_callback(GLFWwindow* window, unsigned int codepoint) {
@@ -574,6 +592,8 @@ static void key_callback(
     GLFWwindow* window, int key, int /*scancode*/, int action, int /*mode*/
 ) {
     auto handler = static_cast<GLFWWindow*>(glfwGetWindowUserPointer(window));
+    handler->setShouldRefresh();
+
     auto& input = handler->input;
     if (key == GLFW_KEY_UNKNOWN) {
         return;
@@ -599,11 +619,13 @@ static void window_size_callback(GLFWwindow* window, int width, int height) {
 static void scroll_callback(GLFWwindow* window, double, double yoffset) {
     auto handler = static_cast<GLFWWindow*>(glfwGetWindowUserPointer(window));
     handler->input.scroll += yoffset;
+    handler->setShouldRefresh();
 }
 
 static void cursor_pos_callback(GLFWwindow* window, double xpos, double ypos) {
     auto handler = static_cast<GLFWWindow*>(glfwGetWindowUserPointer(window));
     handler->input.setCursorPosition(xpos, ypos);
+    handler->setShouldRefresh();
 }
 
 static void iconify_callback(GLFWwindow* window, int iconified) {
@@ -629,6 +651,11 @@ static void create_standard_cursors() {
     }
 }
 
+static void refresh_callback(GLFWwindow* window) {
+    auto handler = static_cast<GLFWWindow*>(glfwGetWindowUserPointer(window));
+    handler->setShouldRefresh();
+}
+
 static void setup_callbacks(GLFWwindow* window) {
     glfwSetKeyCallback(window, key_callback);
     glfwSetMouseButtonCallback(window, mouse_button_callback);
@@ -637,6 +664,7 @@ static void setup_callbacks(GLFWwindow* window) {
     glfwSetCharCallback(window, character_callback);
     glfwSetScrollCallback(window, scroll_callback);
     glfwSetWindowIconifyCallback(window, iconify_callback);
+    glfwSetWindowRefreshCallback(window, refresh_callback);
 }
 
 std::tuple<
diff --git a/src/window/input.hpp b/src/window/input.hpp
index 2edfe4c7..84c12040 100644
--- a/src/window/input.hpp
+++ b/src/window/input.hpp
@@ -261,7 +261,7 @@ class Input {
 public:
     virtual ~Input() = default;
 
-    virtual void pollEvents() = 0;
+    virtual void pollEvents(bool waitForRefresh) = 0;
 
     virtual const char* getClipboardText() const = 0;
     virtual void setClipboardText(const char* str) = 0;

From 50d520e747e346d940bcd47674baab23d9cf139c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 22:27:37 +0300
Subject: [PATCH 113/133] fix: container:setInterval in menu screen

---
 src/graphics/ui/elements/Container.cpp | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/graphics/ui/elements/Container.cpp b/src/graphics/ui/elements/Container.cpp
index b930d76a..77ed5dd3 100644
--- a/src/graphics/ui/elements/Container.cpp
+++ b/src/graphics/ui/elements/Container.cpp
@@ -2,6 +2,8 @@
 
 #include "graphics/core/DrawContext.hpp"
 #include "graphics/core/Batch2D.hpp"
+#include "window/Window.hpp"
+#include "../GUI.hpp"
 
 #include <algorithm>
 #include <utility>
@@ -87,9 +89,12 @@ void Container::act(float delta) {
             }
         }
     }
+    GUI& gui = this->gui;
     intervalEvents.erase(std::remove_if(
         intervalEvents.begin(), intervalEvents.end(),
-        [](const IntervalEvent& event) {
+        [&gui](const IntervalEvent& event) {
+            // TODO: make it interval-based
+            gui.getWindow().setShouldRefresh();
             return event.repeat == 0;
         }
     ), intervalEvents.end());

From 0e6fb878bf0b20149c56d165eeb6c4ec1d6bf3a4 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 23:04:50 +0300
Subject: [PATCH 114/133] add app.reset_content 'non_reset_packs' optional
 argument

---
 res/scripts/stdmin.lua                   | 23 ++++++++++++++++++++++-
 src/content/ContentControl.cpp           |  6 ++----
 src/content/ContentControl.hpp           |  2 +-
 src/engine/Engine.cpp                    |  1 +
 src/frontend/screens/MenuScreen.cpp      |  2 +-
 src/logic/scripting/lua/libs/libcore.cpp | 11 ++++++++++-
 src/logic/scripting/scripting.cpp        | 12 ++++++++++--
 src/logic/scripting/scripting.hpp        |  2 +-
 src/window/detail/GLFWWindow.cpp         |  6 +++---
 9 files changed, 51 insertions(+), 14 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index df5c7ce2..362e9a41 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -742,15 +742,36 @@ function require(path)
     return __load_script(prefix .. ":modules/" .. file .. ".lua", nil, env)
 end
 
-function __scripts_cleanup()
+-- TODO: move to string
+local function join(t, sep)
+    local s = ""
+    for i, v in ipairs(t) do
+        s = s..tostring(v)
+        if i < #t then
+            s = s..sep
+        end
+    end
+    return s
+end
+
+function __scripts_cleanup(non_reset_packs)
     debug.log("cleaning scripts cache")
+    if #non_reset_packs == 0 then
+        debug.log("no non-reset packs")
+    else
+        debug.log("non-reset packs: "..join(non_reset_packs, ", "))
+    end
     for k, v in pairs(__cached_scripts) do
         local packname, _ = parse_path(k)
+        if table.has(non_reset_packs, packname) then
+            goto continue
+        end
         if packname ~= "core" then
             debug.log("unloaded "..k)
             __cached_scripts[k] = nil
             package.loaded[k] = nil
         end
+        ::continue::
     end
 end
 
diff --git a/src/content/ContentControl.cpp b/src/content/ContentControl.cpp
index 6140c3d2..c887baa6 100644
--- a/src/content/ContentControl.cpp
+++ b/src/content/ContentControl.cpp
@@ -49,10 +49,10 @@ std::vector<std::string>& ContentControl::getBasePacks() {
     return basePacks;
 }
 
-void ContentControl::resetContent() {
+void ContentControl::resetContent(const std::vector<std::string>& nonReset) {
     paths.setCurrentWorldFolder("");
 
-    scripting::cleanup();
+    scripting::cleanup(nonReset);
     std::vector<PathsRoot> resRoots;
     {
         auto pack = ContentPack::createCore();
@@ -79,8 +79,6 @@ void ContentControl::loadContent(const std::vector<std::string>& names) {
 }
 
 void ContentControl::loadContent() {
-    scripting::cleanup();
-
     std::vector<std::string> names;
     for (auto& pack : contentPacks) {
         names.push_back(pack.id);
diff --git a/src/content/ContentControl.hpp b/src/content/ContentControl.hpp
index ef45a04a..f066601e 100644
--- a/src/content/ContentControl.hpp
+++ b/src/content/ContentControl.hpp
@@ -34,7 +34,7 @@ public:
     std::vector<std::string>& getBasePacks();
 
     /// @brief Reset content to base packs list
-    void resetContent();
+    void resetContent(const std::vector<std::string>& nonReset);
 
     void loadContent(const std::vector<std::string>& names);
 
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 4cd7a316..6598562f 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -394,6 +394,7 @@ void Engine::setScreen(std::shared_ptr<Screen> screen) {
     }
     if (project->clientScript && this->screen) {
         project->clientScript->onScreenChange(this->screen->getName(), true);
+        window->setShouldRefresh();
     }
 }
 
diff --git a/src/frontend/screens/MenuScreen.cpp b/src/frontend/screens/MenuScreen.cpp
index e1015e8c..6472578d 100644
--- a/src/frontend/screens/MenuScreen.cpp
+++ b/src/frontend/screens/MenuScreen.cpp
@@ -26,7 +26,7 @@ MenuScreen::MenuScreen(Engine& engine)
 MenuScreen::~MenuScreen() = default;
 
 void MenuScreen::onOpen() {
-    engine.getContentControl().resetContent();
+    engine.getContentControl().resetContent({});
     
     auto menu = engine.getGUI().getMenu();
     menu->reset();
diff --git a/src/logic/scripting/lua/libs/libcore.cpp b/src/logic/scripting/lua/libs/libcore.cpp
index 34c33d6d..8f8a7bc8 100644
--- a/src/logic/scripting/lua/libs/libcore.cpp
+++ b/src/logic/scripting/lua/libs/libcore.cpp
@@ -43,7 +43,16 @@ static int l_reset_content(lua::State* L) {
     if (level != nullptr) {
         throw std::runtime_error("world must be closed before");
     }
-    content_control->resetContent();
+    std::vector<std::string> nonResetPacks;
+    if (lua::istable(L, 1)) {
+        int len = lua::objlen(L, 1);
+        for (int i = 0; i < len; i++) {
+            lua::rawgeti(L, i + 1, 1);
+            nonResetPacks.emplace_back(lua::require_lstring(L, -1));
+            lua::pop(L);
+        }
+    }
+    content_control->resetContent(std::move(nonResetPacks));
     return 0;
 }
 
diff --git a/src/logic/scripting/scripting.cpp b/src/logic/scripting/scripting.cpp
index b9efda4b..f3135c1c 100644
--- a/src/logic/scripting/scripting.cpp
+++ b/src/logic/scripting/scripting.cpp
@@ -348,10 +348,13 @@ void scripting::on_world_quit() {
     scripting::controller = nullptr;
 }
 
-void scripting::cleanup() {
+void scripting::cleanup(const std::vector<std::string>& nonReset) {
     auto L = lua::get_main_state();
     lua::requireglobal(L, "pack");
     for (auto& pack : content_control->getAllContentPacks()) {
+        if (std::find(nonReset.begin(), nonReset.end(), pack.id) != nonReset.end()) {
+            continue;
+        }
         lua::requirefield(L, "unload");
         lua::pushstring(L, pack.id);
         lua::call_nothrow(L, 1);
@@ -359,7 +362,12 @@ void scripting::cleanup() {
     lua::pop(L);
 
     if (lua::getglobal(L, "__scripts_cleanup")) {
-        lua::call_nothrow(L, 0);
+        lua::createtable(L, nonReset.size(), 0);
+        for (size_t i = 0; i < nonReset.size(); i++) {
+            lua::pushstring(L, nonReset[i]);
+            lua::rawseti(L, i + 1);
+        }
+        lua::call_nothrow(L, 1);
     }
 }
 
diff --git a/src/logic/scripting/scripting.hpp b/src/logic/scripting/scripting.hpp
index d9c7e614..a096e9cc 100644
--- a/src/logic/scripting/scripting.hpp
+++ b/src/logic/scripting/scripting.hpp
@@ -82,7 +82,7 @@ namespace scripting {
     void on_world_tick(int tps);
     void on_world_save();
     void on_world_quit();
-    void cleanup();
+    void cleanup(const std::vector<std::string>& nonReset);
     void on_blocks_tick(const Block& block, int tps);
     void update_block(const Block& block, const glm::ivec3& pos);
     void random_update_block(const Block& block, const glm::ivec3& pos);
diff --git a/src/window/detail/GLFWWindow.cpp b/src/window/detail/GLFWWindow.cpp
index a80c10e0..5fa8865f 100644
--- a/src/window/detail/GLFWWindow.cpp
+++ b/src/window/detail/GLFWWindow.cpp
@@ -382,11 +382,11 @@ public:
     }
 
     void setShouldRefresh() override {
-        shouldRefresh = true;
+        shouldRefresh = 2;
     }
 
     bool checkShouldRefresh() override {
-        if (shouldRefresh) {
+        if ((--shouldRefresh) == 0) {
             shouldRefresh = false;
             return true;
         }
@@ -573,7 +573,7 @@ private:
     double prevSwap = 0.0;
     int posX = 0;
     int posY = 0;
-    bool shouldRefresh = true;
+    int shouldRefresh = 1;
 };
 static_assert(!std::is_abstract<GLFWWindow>());
 

From db05527fcf40571bb9c78f56d94d3a9ef023b3aa Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 23:11:12 +0300
Subject: [PATCH 115/133] add hud.is_open(layoutid) --> bool

---
 src/frontend/hud.cpp                    | 10 ++++++++++
 src/frontend/hud.hpp                    |  2 ++
 src/logic/scripting/lua/libs/libhud.cpp |  6 ++++++
 3 files changed, 18 insertions(+)

diff --git a/src/frontend/hud.cpp b/src/frontend/hud.cpp
index c8301d26..89789e29 100644
--- a/src/frontend/hud.cpp
+++ b/src/frontend/hud.cpp
@@ -756,3 +756,13 @@ void Hud::setAllowPause(bool flag) {
     }
     allowPause = flag;
 }
+
+bool Hud::isOpen(const std::string& layoutid) const {
+    for (const auto& element : elements) {
+        auto doc = element.getDocument();
+        if (doc && doc->getId() == layoutid) {
+            return true;
+        }
+    }
+    return false;
+}
diff --git a/src/frontend/hud.hpp b/src/frontend/hud.hpp
index c0c7d1ef..560382d3 100644
--- a/src/frontend/hud.hpp
+++ b/src/frontend/hud.hpp
@@ -213,6 +213,8 @@ public:
 
     void setAllowPause(bool flag);
 
+    bool isOpen(const std::string& layoutid) const;
+
     static bool showGeneratorMinimap;
 
     /// @brief Runtime updating debug visualization texture
diff --git a/src/logic/scripting/lua/libs/libhud.cpp b/src/logic/scripting/lua/libs/libhud.cpp
index e3d29783..7ab5d33c 100644
--- a/src/logic/scripting/lua/libs/libhud.cpp
+++ b/src/logic/scripting/lua/libs/libhud.cpp
@@ -189,6 +189,11 @@ static int l_reload_script(lua::State* L) {
     return 0;
 }
 
+static int l_is_open(lua::State* L) {
+    auto layoutid = lua::require_string(L, 1);
+    return lua::pushboolean(L, hud->isOpen(layoutid));
+}
+
 const luaL_Reg hudlib[] = {
     {"open_inventory", wrap_hud<l_open_inventory>},
     {"close_inventory", wrap_hud<l_close_inventory>},
@@ -208,5 +213,6 @@ const luaL_Reg hudlib[] = {
     {"_set_debug_cheats", wrap_hud<l_set_debug_cheats>},
     {"set_allow_pause", wrap_hud<l_set_allow_pause>},
     {"reload_script", wrap_hud<l_reload_script>},
+    {"is_open", wrap_hud<l_is_open>},
     {nullptr, nullptr}
 };

From 50cd4f98d9acc864b7cd1dc3c2ea43bcfd7c9c06 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 9 Nov 2025 23:13:59 +0300
Subject: [PATCH 116/133] update doc/*/scripting/builtins/libhud.md

---
 doc/en/scripting/builtins/libhud.md | 6 ++++++
 doc/ru/scripting/builtins/libhud.md | 4 ++++
 2 files changed, 10 insertions(+)

diff --git a/doc/en/scripting/builtins/libhud.md b/doc/en/scripting/builtins/libhud.md
index 58d78302..a7e3fa85 100644
--- a/doc/en/scripting/builtins/libhud.md
+++ b/doc/en/scripting/builtins/libhud.md
@@ -20,6 +20,12 @@ hud.open(
     [optional] invid: int
 ) -> int
 
+-- Returns true if specified layout is open.
+hud.is_open(
+    layoutid: str
+) -> bool
+
+
 -- Open block UI and inventory.
 -- Throws an exception if block has no UI layout.
 -- Returns block inventory ID (if *"inventory-size"=0* a virtual 
diff --git a/doc/ru/scripting/builtins/libhud.md b/doc/ru/scripting/builtins/libhud.md
index 5f0856b3..6ed81e05 100644
--- a/doc/ru/scripting/builtins/libhud.md
+++ b/doc/ru/scripting/builtins/libhud.md
@@ -20,6 +20,10 @@ hud.open(
     [опционально] invid: int
 ) -> int
 
+-- Возвращает true если указаный макет UI открыт.
+hud.is_open(
+    layoutid: str
+) -> bool
 
 -- Открывает инвентарь и UI блока.
 -- Если блок не имеет макета UI - бросается исключение.

From be5a9077ca1e7ea9029096bfb956fda4b22de1f9 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 00:16:06 +0300
Subject: [PATCH 117/133] fix

---
 src/engine/WindowControl.cpp     | 2 +-
 src/window/detail/GLFWWindow.cpp | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/engine/WindowControl.cpp b/src/engine/WindowControl.cpp
index 637f4899..a44a410d 100644
--- a/src/engine/WindowControl.cpp
+++ b/src/engine/WindowControl.cpp
@@ -93,5 +93,5 @@ void WindowControl::nextFrame(bool waitForRefresh) {
         );
     }
     window.swapBuffers();
-    input.pollEvents(waitForRefresh);
+    input.pollEvents(waitForRefresh && !window.checkShouldRefresh());
 }
diff --git a/src/window/detail/GLFWWindow.cpp b/src/window/detail/GLFWWindow.cpp
index 5fa8865f..a80c10e0 100644
--- a/src/window/detail/GLFWWindow.cpp
+++ b/src/window/detail/GLFWWindow.cpp
@@ -382,11 +382,11 @@ public:
     }
 
     void setShouldRefresh() override {
-        shouldRefresh = 2;
+        shouldRefresh = true;
     }
 
     bool checkShouldRefresh() override {
-        if ((--shouldRefresh) == 0) {
+        if (shouldRefresh) {
             shouldRefresh = false;
             return true;
         }
@@ -573,7 +573,7 @@ private:
     double prevSwap = 0.0;
     int posX = 0;
     int posY = 0;
-    int shouldRefresh = 1;
+    bool shouldRefresh = true;
 };
 static_assert(!std::is_abstract<GLFWWindow>());
 

From 7a4eb87195accc4c24d1680854388e24fe9e2734 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 00:20:32 +0300
Subject: [PATCH 118/133] fix

---
 src/graphics/ui/elements/Container.cpp | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/graphics/ui/elements/Container.cpp b/src/graphics/ui/elements/Container.cpp
index 77ed5dd3..8d45c2a1 100644
--- a/src/graphics/ui/elements/Container.cpp
+++ b/src/graphics/ui/elements/Container.cpp
@@ -79,6 +79,10 @@ void Container::act(float delta) {
             node->act(delta);
         }
     }
+    if (!intervalEvents.empty()) {
+        // TODO: make it interval-based
+        gui.getWindow().setShouldRefresh();
+    }
     for (IntervalEvent& event : intervalEvents) {
         event.timer += delta;
         if (event.timer > event.interval) {
@@ -93,8 +97,6 @@ void Container::act(float delta) {
     intervalEvents.erase(std::remove_if(
         intervalEvents.begin(), intervalEvents.end(),
         [&gui](const IntervalEvent& event) {
-            // TODO: make it interval-based
-            gui.getWindow().setShouldRefresh();
             return event.repeat == 0;
         }
     ), intervalEvents.end());

From 630e75c7d9090f454ef69fbe79a75fc852648218 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 00:25:38 +0300
Subject: [PATCH 119/133] make adaptive menu fps optional
 ('display.adaptive-menu-fps' flag)

---
 src/engine/Mainloop.cpp | 2 ++
 src/io/settings_io.cpp  | 1 +
 src/settings.hpp        | 2 ++
 3 files changed, 5 insertions(+)

diff --git a/src/engine/Mainloop.cpp b/src/engine/Mainloop.cpp
index e87bc7d9..d6ca17cb 100644
--- a/src/engine/Mainloop.cpp
+++ b/src/engine/Mainloop.cpp
@@ -18,6 +18,7 @@ Mainloop::Mainloop(Engine& engine) : engine(engine) {
 void Mainloop::run() {
     auto& time = engine.getTime();
     auto& window = engine.getWindow();
+    auto& settings = engine.getSettings();
 
     engine.setLevelConsumer([this](auto level, int64_t localPlayer) {
         if (level == nullptr) {
@@ -46,6 +47,7 @@ void Mainloop::run() {
         }
         engine.postUpdate();
         engine.nextFrame(
+            settings.display.adaptiveFpsInMenu.get() &&
             dynamic_cast<const MenuScreen*>(engine.getScreen().get()) != nullptr
         );
     }
diff --git a/src/io/settings_io.cpp b/src/io/settings_io.cpp
index 5e1c8327..f4e89338 100644
--- a/src/io/settings_io.cpp
+++ b/src/io/settings_io.cpp
@@ -51,6 +51,7 @@ SettingsHandler::SettingsHandler(EngineSettings& settings) {
     builder.add("framerate", &settings.display.framerate);
     builder.add("limit-fps-iconified", &settings.display.limitFpsIconified);
     builder.add("window-mode", &settings.display.windowMode);
+    builder.add("adaptive-menu-fps", &settings.display.adaptiveFpsInMenu);
 
     builder.section("camera");
     builder.add("sensitivity", &settings.camera.sensitivity);
diff --git a/src/settings.hpp b/src/settings.hpp
index f97fb513..ee35d5a4 100644
--- a/src/settings.hpp
+++ b/src/settings.hpp
@@ -31,6 +31,8 @@ struct DisplaySettings {
     IntegerSetting framerate {-1, -1, 120};
     /// @brief Limit framerate when window is iconified
     FlagSetting limitFpsIconified {false};
+    /// @brief Adaptive framerate in menu (experimental)
+    FlagSetting adaptiveFpsInMenu {false};
 };
 
 struct ChunksSettings {

From b0d662f84555c6984bb590b97e32ea293c859040 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 00:34:01 +0300
Subject: [PATCH 120/133] limit adaptive fps to display.framerate setting

---
 src/engine/WindowControl.cpp | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/src/engine/WindowControl.cpp b/src/engine/WindowControl.cpp
index a44a410d..5ae96965 100644
--- a/src/engine/WindowControl.cpp
+++ b/src/engine/WindowControl.cpp
@@ -83,15 +83,11 @@ void WindowControl::nextFrame(bool waitForRefresh) {
     const auto& settings = engine.getSettings();
     auto& window = engine.getWindow();
     auto& input = engine.getInput();
-    if (waitForRefresh) {
-        window.setFramerate(Window::FPS_UNLIMITED);
-    } else {
-        window.setFramerate(
-            window.isIconified() && settings.display.limitFpsIconified.get()
-                ? 20
-                : settings.display.framerate.get()
-        );
-    }
+    window.setFramerate(
+        window.isIconified() && settings.display.limitFpsIconified.get()
+            ? 20
+            : settings.display.framerate.get()
+    );
     window.swapBuffers();
     input.pollEvents(waitForRefresh && !window.checkShouldRefresh());
 }

From a4461a7dc3a678fe8954772bcd57dee0f4b41822 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 12:23:35 +0300
Subject: [PATCH 121/133] update non-reset-packs semantics

---
 res/scripts/stdlib.lua               |  1 -
 res/scripts/stdmin.lua               |  1 +
 src/logic/scripting/lua/lua_util.cpp | 16 ++++++++++++++++
 src/logic/scripting/lua/lua_util.hpp |  1 +
 src/logic/scripting/scripting.cpp    | 13 +++++++++----
 5 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 7d551a4a..eedc9d43 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -186,7 +186,6 @@ events = require "core:internal/events"
 
 function pack.unload(prefix)
     events.remove_by_prefix(prefix)
-    __vc__pack_envs[prefix] = nil
 end
 
 function __vc_start_app_script(path)
diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index 362e9a41..ea425748 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -771,6 +771,7 @@ function __scripts_cleanup(non_reset_packs)
             __cached_scripts[k] = nil
             package.loaded[k] = nil
         end
+        __vc__pack_envs[packname] = nil
         ::continue::
     end
 end
diff --git a/src/logic/scripting/lua/lua_util.cpp b/src/logic/scripting/lua/lua_util.cpp
index 401255c7..1f0bfd99 100644
--- a/src/logic/scripting/lua/lua_util.cpp
+++ b/src/logic/scripting/lua/lua_util.cpp
@@ -336,6 +336,22 @@ int lua::create_environment(State* L, int parent) {
     return id;
 }
 
+int lua::restore_pack_environment(lua::State* L, const std::string& packid) {
+    if(!lua::getglobal(L, "__vc__pack_envs")) {
+        return -1;
+    }
+    int id = nextEnvironment++;
+
+    if (lua::getfield(L, packid)) {
+        // envname = env
+        setglobal(L, env_name(id));
+        lua::pop(L);
+        return id;
+    }
+    lua::pop(L);
+    return -1;
+}
+
 void lua::remove_environment(State* L, int id) {
     if (id == 0) {
         return;
diff --git a/src/logic/scripting/lua/lua_util.hpp b/src/logic/scripting/lua/lua_util.hpp
index a8fb246e..9e543a0a 100644
--- a/src/logic/scripting/lua/lua_util.hpp
+++ b/src/logic/scripting/lua/lua_util.hpp
@@ -614,6 +614,7 @@ namespace lua {
         return 0;
     }
     int create_environment(lua::State*, int parent);
+    int restore_pack_environment(lua::State*, const std::string& packid);
     void remove_environment(lua::State*, int id);
 
     inline void close(lua::State* L) {
diff --git a/src/logic/scripting/scripting.cpp b/src/logic/scripting/scripting.cpp
index f3135c1c..8fe88d39 100644
--- a/src/logic/scripting/scripting.cpp
+++ b/src/logic/scripting/scripting.cpp
@@ -173,7 +173,15 @@ std::unique_ptr<Process> scripting::start_app_script(const io::path& script) {
     const ContentPack& pack
 ) {
     auto L = lua::get_main_state();
-    int id = lua::create_environment(L, 0);
+    int id = lua::restore_pack_environment(L, pack.id);
+    if (id != -1) {
+        return std::shared_ptr<int>(new int(id), [=](int* id) { //-V508
+            lua::remove_environment(L, *id);
+            delete id;
+        });
+    }
+    id = lua::create_environment(L, 0);
+
     lua::pushenv(L, id);
     lua::pushvalue(L, -1);
     lua::setfield(L, "PACK_ENV");
@@ -352,9 +360,6 @@ void scripting::cleanup(const std::vector<std::string>& nonReset) {
     auto L = lua::get_main_state();
     lua::requireglobal(L, "pack");
     for (auto& pack : content_control->getAllContentPacks()) {
-        if (std::find(nonReset.begin(), nonReset.end(), pack.id) != nonReset.end()) {
-            continue;
-        }
         lua::requirefield(L, "unload");
         lua::pushstring(L, pack.id);
         lua::call_nothrow(L, 1);

From 232a86aae4e5b0466352b121284dc83f692be5c7 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 17:29:46 +0300
Subject: [PATCH 122/133] fix the stupid

---
 res/scripts/stdmin.lua | 14 +-------------
 1 file changed, 1 insertion(+), 13 deletions(-)

diff --git a/res/scripts/stdmin.lua b/res/scripts/stdmin.lua
index ea425748..0f90cea6 100644
--- a/res/scripts/stdmin.lua
+++ b/res/scripts/stdmin.lua
@@ -742,24 +742,12 @@ function require(path)
     return __load_script(prefix .. ":modules/" .. file .. ".lua", nil, env)
 end
 
--- TODO: move to string
-local function join(t, sep)
-    local s = ""
-    for i, v in ipairs(t) do
-        s = s..tostring(v)
-        if i < #t then
-            s = s..sep
-        end
-    end
-    return s
-end
-
 function __scripts_cleanup(non_reset_packs)
     debug.log("cleaning scripts cache")
     if #non_reset_packs == 0 then
         debug.log("no non-reset packs")
     else
-        debug.log("non-reset packs: "..join(non_reset_packs, ", "))
+        debug.log("non-reset packs: "..table.concat(non_reset_packs, ", "))
     end
     for k, v in pairs(__cached_scripts) do
         local packname, _ = parse_path(k)

From 0a45277f962191194b330f36f2e23b508f1c636e Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 18:28:24 +0300
Subject: [PATCH 123/133] add 'graphics.soft-lighting' setting

---
 src/frontend/screens/LevelScreen.cpp   | 11 +++++----
 src/graphics/render/BlocksRenderer.cpp | 34 +++++++++++++++++---------
 src/io/settings_io.cpp                 |  1 +
 src/settings.hpp                       |  2 ++
 4 files changed, 32 insertions(+), 16 deletions(-)

diff --git a/src/frontend/screens/LevelScreen.cpp b/src/frontend/screens/LevelScreen.cpp
index f3694d85..eab517da 100644
--- a/src/frontend/screens/LevelScreen.cpp
+++ b/src/frontend/screens/LevelScreen.cpp
@@ -76,13 +76,14 @@ LevelScreen::LevelScreen(
         engine, *controller, *renderer, assets, *player
     );
 
-    keepAlive(settings.graphics.backlight.observe([=](bool) {
-        player->chunks->saveAndClear();
-        renderer->clear();
-    }));
-    keepAlive(settings.graphics.denseRender.observe([=](bool) {
+    auto resetChunks = [=](bool) {
         player->chunks->saveAndClear();
         renderer->clear();
+    };
+    keepAlive(settings.graphics.backlight.observe(resetChunks));
+    keepAlive(settings.graphics.softLighting.observe(resetChunks));
+    keepAlive(settings.graphics.denseRender.observe([=](bool flag) {
+        resetChunks(flag);
         frontend->getContentGfxCache().refresh();
     }));
     keepAlive(settings.camera.fov.observe([=](double value) {
diff --git a/src/graphics/render/BlocksRenderer.cpp b/src/graphics/render/BlocksRenderer.cpp
index 6df7967e..f2788df3 100644
--- a/src/graphics/render/BlocksRenderer.cpp
+++ b/src/graphics/render/BlocksRenderer.cpp
@@ -9,7 +9,7 @@
 #include "lighting/Lightmap.hpp"
 #include "frontend/ContentGfxCache.hpp"
 
-const glm::vec3 BlocksRenderer::SUN_VECTOR(0.528265f, 0.833149f, -0.163704f);
+const glm::vec3 BlocksRenderer::SUN_VECTOR(0.528265, 0.833149, -0.163704);
 const float DIRECTIONAL_LIGHT_FACTOR = 0.3f;
 
 BlocksRenderer::BlocksRenderer(
@@ -35,8 +35,7 @@ BlocksRenderer::BlocksRenderer(
     blockDefsCache = content.getIndices()->blocks.getDefs();
 }
 
-BlocksRenderer::~BlocksRenderer() {
-}
+BlocksRenderer::~BlocksRenderer() = default;
 
 /// Basic vertex add method
 void BlocksRenderer::vertex(
@@ -480,6 +479,7 @@ void BlocksRenderer::render(
 ) {
     bool denseRender = this->denseRender;
     bool densePass = this->densePass;
+    bool enableAO = settings.graphics.softLighting.get();
     for (const auto drawGroup : *content.drawGroups) {
         int begin = beginEnds[drawGroup][0];
         if (begin == 0) {
@@ -516,7 +516,7 @@ void BlocksRenderer::render(
             switch (def.getModel(state.userbits).type) {
                 case BlockModelType::BLOCK:
                     blockCube({x, y, z}, texfaces, def, vox.state, !def.shadeless,
-                              def.ambientOcclusion);
+                              def.ambientOcclusion && enableAO);
                     break;
                 case BlockModelType::XSPRITE: {
                     if (!denseRender)
@@ -527,7 +527,7 @@ void BlocksRenderer::render(
                 case BlockModelType::AABB: {
                     if (!denseRender)
                     blockAABB({x, y, z}, texfaces, &def, vox.state.rotation,
-                              !def.shadeless, def.ambientOcclusion);
+                              !def.shadeless, def.ambientOcclusion && enableAO);
                     break;
                 }
                 case BlockModelType::CUSTOM: {
@@ -537,7 +537,7 @@ void BlocksRenderer::render(
                         def,
                         vox.state,
                         !def.shadeless,
-                        def.ambientOcclusion
+                        def.ambientOcclusion && enableAO
                     );
                     break;
                 }
@@ -561,6 +561,7 @@ SortingMeshData BlocksRenderer::renderTranslucent(
     size_t totalSize = 0;
 
     bool densePass = this->densePass;
+    bool enableAO = settings.graphics.softLighting.get();
     for (const auto drawGroup : *content.drawGroups) {
         int begin = beginEnds[drawGroup][0];
         if (begin == 0) {
@@ -594,7 +595,7 @@ SortingMeshData BlocksRenderer::renderTranslucent(
             switch (def.getModel(state.userbits).type) {
                 case BlockModelType::BLOCK:
                     blockCube({x, y, z}, texfaces, def, vox.state, !def.shadeless,
-                              def.ambientOcclusion);
+                              def.ambientOcclusion && enableAO);
                     break;
                 case BlockModelType::XSPRITE: {
                     blockXSprite(x, y, z, glm::vec3(1.0f),
@@ -602,13 +603,24 @@ SortingMeshData BlocksRenderer::renderTranslucent(
                     break;
                 }
                 case BlockModelType::AABB: {
-                    blockAABB({x, y, z}, texfaces, &def, vox.state.rotation,
-                              !def.shadeless, def.ambientOcclusion);
+                    blockAABB(
+                        {x, y, z},
+                        texfaces,
+                        &def,
+                        vox.state.rotation,
+                        !def.shadeless,
+                        def.ambientOcclusion && enableAO
+                    );
                     break;
                 }
                 case BlockModelType::CUSTOM: {
-                    blockCustomModel({x, y, z}, def, vox.state,
-                                     !def.shadeless, def.ambientOcclusion);
+                    blockCustomModel(
+                        {x, y, z},
+                        def,
+                        vox.state,
+                        !def.shadeless,
+                        def.ambientOcclusion && enableAO
+                    );
                     break;
                 }
                 default:
diff --git a/src/io/settings_io.cpp b/src/io/settings_io.cpp
index f4e89338..6e94db9f 100644
--- a/src/io/settings_io.cpp
+++ b/src/io/settings_io.cpp
@@ -79,6 +79,7 @@ SettingsHandler::SettingsHandler(EngineSettings& settings) {
     builder.add("ssao", &settings.graphics.ssao);
     builder.add("shadows-quality", &settings.graphics.shadowsQuality);
     builder.add("dense-render-distance", &settings.graphics.denseRenderDistance);
+    builder.add("soft-lighting", &settings.graphics.softLighting);
 
     builder.section("ui");
     builder.add("language", &settings.ui.language);
diff --git a/src/settings.hpp b/src/settings.hpp
index ee35d5a4..9b3fa363 100644
--- a/src/settings.hpp
+++ b/src/settings.hpp
@@ -85,6 +85,8 @@ struct GraphicsSettings {
     IntegerSetting shadowsQuality {0, 0, 3};
     /// @brief Dense render distance
     IntegerSetting denseRenderDistance {56, 0, 10'000};
+    /// @brief Soft lighting for blocks
+    FlagSetting softLighting {true};
 };
 
 struct PathfindingSettings {

From 1a0535c8afc4b1f873ae98dc5d1805a37719d12f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 18:40:50 +0300
Subject: [PATCH 124/133] add 'graphics.soft-lighting' to settings menu

---
 res/layouts/pages/settings_display.xml.lua  | 1 +
 res/layouts/pages/settings_graphics.xml.lua | 3 ++-
 res/texts/en_US.txt                         | 1 +
 res/texts/ru_RU.txt                         | 4 +++-
 4 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/res/layouts/pages/settings_display.xml.lua b/res/layouts/pages/settings_display.xml.lua
index 6934cef6..9c62c334 100644
--- a/res/layouts/pages/settings_display.xml.lua
+++ b/res/layouts/pages/settings_display.xml.lua
@@ -70,4 +70,5 @@ function on_open()
     create_checkbox("camera.inertia", "Camera Inertia")
     create_checkbox("camera.fov-effects", "Camera FOV Effects")
     create_checkbox("display.limit-fps-iconified", "Limit Background FPS")
+    create_setting("graphics.gamma", "Gamma", 0.05, "", "graphics.gamma.tooltip")
 end
diff --git a/res/layouts/pages/settings_graphics.xml.lua b/res/layouts/pages/settings_graphics.xml.lua
index 99ba6609..de1795f3 100644
--- a/res/layouts/pages/settings_graphics.xml.lua
+++ b/res/layouts/pages/settings_graphics.xml.lua
@@ -39,8 +39,9 @@ function on_open()
     create_setting("chunks.load-distance", "Load Distance", 1)
     create_setting("chunks.load-speed", "Load Speed", 1)
     create_setting("graphics.fog-curve", "Fog Curve", 0.1)
-    create_setting("graphics.gamma", "Gamma", 0.05, "", "graphics.gamma.tooltip")
+    
     create_checkbox("graphics.backlight", "Backlight", "graphics.backlight.tooltip")
+    create_checkbox("graphics.soft-lighting", "Soft lighting", "graphics.soft-lighting.tooltip")
     create_checkbox("graphics.dense-render", "Dense blocks render", "graphics.dense-render.tooltip")
     create_checkbox("graphics.advanced-render", "Advanced render", "graphics.advanced-render.tooltip")
     create_checkbox("graphics.ssao", "SSAO", "graphics.ssao.tooltip")
diff --git a/res/texts/en_US.txt b/res/texts/en_US.txt
index e35ff99c..ae19130e 100644
--- a/res/texts/en_US.txt
+++ b/res/texts/en_US.txt
@@ -20,6 +20,7 @@ devtools.output=Output
 graphics.gamma.tooltip=Lighting brightness curve
 graphics.backlight.tooltip=Backlight to prevent total darkness
 graphics.dense-render.tooltip=Enables transparency in blocks like leaves
+graphics.soft-lighting.tooltip=Enables blocks soft lighting
 
 # settings
 settings.Controls Search Mode=Search by attached button name
diff --git a/res/texts/ru_RU.txt b/res/texts/ru_RU.txt
index 03ee8322..5f772a33 100644
--- a/res/texts/ru_RU.txt
+++ b/res/texts/ru_RU.txt
@@ -39,7 +39,8 @@ pack.remove-confirm=Удалить весь поставляемый паком/
 # Подсказки
 graphics.gamma.tooltip=Кривая яркости освещения
 graphics.backlight.tooltip=Подсветка, предотвращающая полную темноту
-graphics.dense-render.tooltip=Включает прозрачность блоков, таких как листья.
+graphics.dense-render.tooltip=Включает прозрачность блоков, таких как листья
+graphics.soft-lighting.tooltip=Включает мягкое освещение у блоков
 
 # Меню
 menu.Apply=Применить
@@ -80,6 +81,7 @@ world.delete-confirm=Удалить мир безвозвратно?
 settings.Ambient=Фон
 settings.Backlight=Подсветка
 settings.Dense blocks render=Плотный рендер блоков
+settings.Soft lighting=Мягкое освещение
 settings.Camera Shaking=Тряска Камеры
 settings.Camera Inertia=Инерция Камеры
 settings.Camera FOV Effects=Эффекты поля зрения

From 7715301d656561301fb49b46b7e23f48c84180b1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 10 Nov 2025 19:15:57 +0300
Subject: [PATCH 125/133] update workflows

---
 .github/workflows/appimage.yml      | 2 +-
 .github/workflows/macos.yml         | 2 +-
 .github/workflows/windows-clang.yml | 2 +-
 .github/workflows/windows.yml       | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/appimage.yml b/.github/workflows/appimage.yml
index 5a01a618..121c5a60 100644
--- a/.github/workflows/appimage.yml
+++ b/.github/workflows/appimage.yml
@@ -2,7 +2,7 @@ name: x86-64 AppImage
 
 on:
   push:
-    branches: [ "main", "dev", "release-**"]
+    branches: [ "main", "release-**"]
   pull_request:
     branches: [ "main", "dev" ]
 
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
index f8fe3dfa..bb40a7ad 100644
--- a/.github/workflows/macos.yml
+++ b/.github/workflows/macos.yml
@@ -2,7 +2,7 @@ name: Macos Build
 
 on:
   push:
-    branches: [ "main", "dev", "release-**"]
+    branches: [ "main", "release-**"]
   pull_request:
     branches: [ "main", "dev" ]
 
diff --git a/.github/workflows/windows-clang.yml b/.github/workflows/windows-clang.yml
index cdf354dd..cb486409 100644
--- a/.github/workflows/windows-clang.yml
+++ b/.github/workflows/windows-clang.yml
@@ -2,7 +2,7 @@ name: Windows Build (CLang)
 
 on:
   push:
-    branches: [ "main", "dev", "release-**"]
+    branches: [ "main", "release-**"]
   pull_request:
     branches: [ "main", "dev" ]
 
diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
index e5ee5a69..afeed757 100644
--- a/.github/workflows/windows.yml
+++ b/.github/workflows/windows.yml
@@ -2,7 +2,7 @@ name: MSVC Build
 
 on:
   push:
-    branches: [ "main", "dev", "release-**"]
+    branches: [ "main", "release-**"]
   pull_request:
     branches: [ "main", "dev" ]
 

From b9777cc682f8aa698223bb4890315b4f373124e1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 11 Nov 2025 17:46:38 +0300
Subject: [PATCH 126/133] add canvas:unbind_texture method

---
 doc/en/scripting/ui.md                                |  1 +
 doc/ru/scripting/ui.md                                |  1 +
 src/logic/scripting/lua/usertypes/lua_type_canvas.cpp | 11 +++++++++++
 src/logic/scripting/lua/usertypes/lua_type_canvas.hpp |  1 +
 4 files changed, 14 insertions(+)

diff --git a/doc/en/scripting/ui.md b/doc/en/scripting/ui.md
index 2da6843c..091d7ff8 100644
--- a/doc/en/scripting/ui.md
+++ b/doc/en/scripting/ui.md
@@ -196,6 +196,7 @@ Here, *color* can be specified in the following ways:
 | data:update()                                            | applies changes to the canvas and uploads it to the GPU |
 | data:set_data(data: table<int>)                          | replaces pixel data (width * height * 4 numbers)        |
 | data:create_texture(name: str)                           | creates and shares texture to renderer                  |
+| data:unbind_texture()                                    | unbinds the texture from the canvas                     |
 
 ## Inline frame (iframe)
 
diff --git a/doc/ru/scripting/ui.md b/doc/ru/scripting/ui.md
index 19f1f8ab..10514edb 100644
--- a/doc/ru/scripting/ui.md
+++ b/doc/ru/scripting/ui.md
@@ -196,6 +196,7 @@ document["worlds-panel"]:clear()
 | data:update()                                            | применяет изменения и загружает холст в видеопамять  |
 | data:set_data(data: table<int>)                          | заменяет данные пикселей (ширина * высота * 4 чисел) |
 | data:create_texture(name: str)                           | создаёт и делится текстурой с рендерером             |
+| data:unbind_texture()                                    | отвязывает текстуру от холста                        |
 
 ## Рамка встраивания (iframe)
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index 325f916f..40af6e81 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -66,6 +66,10 @@ void LuaCanvas::createTexture() {
     texture->setMipMapping(false, true);
 }
 
+void LuaCanvas::unbindTexture() {
+    texture.reset();
+}
+
 union RGBA {
     struct {
         uint8_t r, g, b, a;
@@ -99,7 +103,13 @@ static int l_at(State* L) {
     if (auto pixel = get_at(L, x, y)) {
         return pushinteger(L, pixel->rgba);
     }
+    return 0;
+}
 
+static int l_unbind_texture(State* L) {
+    if (auto canvas = touserdata<LuaCanvas>(L, 1)) {
+        canvas->unbindTexture();
+    }
     return 0;
 }
 
@@ -238,6 +248,7 @@ static std::unordered_map<std::string, lua_CFunction> methods {
     {"clear", lua::wrap<l_clear>},
     {"update", lua::wrap<l_update>},
     {"create_texture", lua::wrap<l_create_texture>},
+    {"unbind_texture", lua::wrap<l_unbind_texture>},
     {"_set_data", lua::wrap<l_set_data>},
 };
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp
index 198313cb..854443d1 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.hpp
@@ -40,6 +40,7 @@ namespace lua {
         void update(int extrusion = ATLAS_EXTRUSION);
 
         void createTexture();
+        void unbindTexture();
 
         static int createMetatable(lua::State*);
         inline static std::string TYPENAME = "Canvas";

From 83f7bf80c434cb4b877b1ca0b81e71e7a56091e4 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 11 Nov 2025 19:30:27 +0300
Subject: [PATCH 127/133] add canvas:mul and canvas:add methods

---
 doc/en/scripting/ui.md                        |  2 +
 doc/ru/scripting/ui.md                        |  2 +
 src/graphics/core/ImageData.cpp               | 93 +++++++++++++++++++
 src/graphics/core/ImageData.hpp               |  4 +
 .../lua/usertypes/lua_type_canvas.cpp         | 30 ++++++
 5 files changed, 131 insertions(+)

diff --git a/doc/en/scripting/ui.md b/doc/en/scripting/ui.md
index 091d7ff8..37c316fd 100644
--- a/doc/en/scripting/ui.md
+++ b/doc/en/scripting/ui.md
@@ -197,6 +197,8 @@ Here, *color* can be specified in the following ways:
 | data:set_data(data: table<int>)                          | replaces pixel data (width * height * 4 numbers)        |
 | data:create_texture(name: str)                           | creates and shares texture to renderer                  |
 | data:unbind_texture()                                    | unbinds the texture from the canvas                     |
+| data:mul(*color* or Canvas)                              | multiplies a color by the specified color or canvas     |
+| data:add(*color* or Canvas)                              | adds a color or another canvas to a color               |
 
 ## Inline frame (iframe)
 
diff --git a/doc/ru/scripting/ui.md b/doc/ru/scripting/ui.md
index 10514edb..741c8cf3 100644
--- a/doc/ru/scripting/ui.md
+++ b/doc/ru/scripting/ui.md
@@ -197,6 +197,8 @@ document["worlds-panel"]:clear()
 | data:set_data(data: table<int>)                          | заменяет данные пикселей (ширина * высота * 4 чисел) |
 | data:create_texture(name: str)                           | создаёт и делится текстурой с рендерером             |
 | data:unbind_texture()                                    | отвязывает текстуру от холста                        |
+| data:mul(*цвет* или Canvas)                              | умножает увет на указанный цвет или холст            |
+| data:add(*цвет* или Canvas)                              | прибавляет цвет или другой холст к цвету             |
 
 ## Рамка встраивания (iframe)
 
diff --git a/src/graphics/core/ImageData.cpp b/src/graphics/core/ImageData.cpp
index 3a5e3cb6..b69b5f4a 100644
--- a/src/graphics/core/ImageData.cpp
+++ b/src/graphics/core/ImageData.cpp
@@ -420,6 +420,99 @@ void ImageData::fixAlphaColor() {
     }
 }
 
+static void check_matching(const ImageData& a, const ImageData& b) {
+    if (b.getWidth() != a.getWidth() ||
+        b.getHeight() != a.getHeight() ||
+        b.getFormat() != a.getFormat()) {
+        throw std::runtime_error("image sizes or formats do not match");
+    }
+}
+
+void ImageData::mulColor(const glm::ivec4& color) {    
+    uint comps;
+    switch (format) {
+        case ImageFormat::rgb888: comps = 3; break;
+        case ImageFormat::rgba8888: comps = 4; break;
+        default:
+            throw std::runtime_error("only unsigned byte formats supported");    
+    }
+    for (uint y = 0; y < height; y++) {
+        for (uint x = 0; x < width; x++) {
+            uint idx = (y * width + x) * comps;
+            for (uint c = 0; c < comps; c++) {
+                float val = static_cast<float>(data[idx + c]) * color[c] / 255.0f;
+                data[idx + c] =
+                    static_cast<ubyte>(std::min(std::max(val, 0.0f), 255.0f));
+            }
+        }
+    }
+}
+
+void ImageData::addColor(const ImageData& other) {
+    check_matching(*this, other);
+
+    uint comps;
+    switch (format) {
+        case ImageFormat::rgb888: comps = 3; break;
+        case ImageFormat::rgba8888: comps = 4; break;
+        default:
+            throw std::runtime_error("only unsigned byte formats supported");    
+    }
+    for (uint y = 0; y < height; y++) {
+        for (uint x = 0; x < width; x++) {
+            uint idx = (y * width + x) * comps;
+            for (uint c = 0; c < comps; c++) {
+                int val = data[idx + c] + other.data[idx + c];
+                data[idx + c] =
+                    static_cast<ubyte>(std::min(std::max(val, 0), 255));
+            }
+        }
+    }
+}
+
+void ImageData::addColor(const glm::ivec4& color) {
+    uint comps;
+    switch (format) {
+        case ImageFormat::rgb888: comps = 3; break;
+        case ImageFormat::rgba8888: comps = 4; break;
+        default:
+            throw std::runtime_error("only unsigned byte formats supported");    
+    }
+    for (uint y = 0; y < height; y++) {
+        for (uint x = 0; x < width; x++) {
+            uint idx = (y * width + x) * comps;
+            for (uint c = 0; c < comps; c++) {
+                int val = data[idx + c] + color[c];
+                data[idx + c] =
+                    static_cast<ubyte>(std::min(std::max(val, 0), 255));
+            }
+        }
+    }
+}
+
+void ImageData::mulColor(const ImageData& other) {
+    check_matching(*this, other);
+
+    uint comps;
+    switch (format) {
+        case ImageFormat::rgb888: comps = 3; break;
+        case ImageFormat::rgba8888: comps = 4; break;
+        default:
+            throw std::runtime_error("only unsigned byte formats supported");    
+    }
+    for (uint y = 0; y < height; y++) {
+        for (uint x = 0; x < width; x++) {
+            uint idx = (y * width + x) * comps;
+            for (uint c = 0; c < comps; c++) {
+                float val = static_cast<float>(data[idx + c]) *
+                            static_cast<float>(other.data[idx + c]) / 255.0f;
+                data[idx + c] =
+                    static_cast<ubyte>(std::min(std::max(val, 0.0f), 255.0f));
+            }
+        }
+    }
+}
+
 std::unique_ptr<ImageData> add_atlas_margins(ImageData* image, int grid_size) {
     // RGBA is only supported
     assert(image->getFormat() == ImageFormat::rgba8888);
diff --git a/src/graphics/core/ImageData.hpp b/src/graphics/core/ImageData.hpp
index 86396568..a0e694e3 100644
--- a/src/graphics/core/ImageData.hpp
+++ b/src/graphics/core/ImageData.hpp
@@ -32,6 +32,10 @@ public:
     void blit(const ImageData& image, int x, int y);
     void extrude(int x, int y, int w, int h);
     void fixAlphaColor();
+    void mulColor(const glm::ivec4& color);
+    void mulColor(const ImageData& other);
+    void addColor(const glm::ivec4& color);
+    void addColor(const ImageData& other);
 
     std::unique_ptr<ImageData> cropped(int x, int y, int width, int height) const;
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index 40af6e81..8adb558c 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -240,6 +240,34 @@ static int l_create_texture(State* L) {
     return 0;
 }
 
+static int l_mul(State* L) {
+    auto canvas = touserdata<LuaCanvas>(L, 1);
+    if (canvas == nullptr) {
+        return 0;
+    }
+    if (lua::isnumber(L, 2)) {
+        RGBA rgba = get_rgba(L, 2);
+        canvas->getData().mulColor(glm::ivec4 {rgba.r, rgba.g, rgba.b, rgba.a});
+    } else if (auto other = touserdata<LuaCanvas>(L, 2)) {
+        canvas->getData().mulColor(other->getData());
+    }
+    return 0;
+}
+
+static int l_add(State* L) {
+    auto canvas = touserdata<LuaCanvas>(L, 1);
+    if (canvas == nullptr) {
+        return 0;
+    }
+    if (lua::istable(L, 2)) {
+        RGBA rgba = get_rgba(L, 2);
+        canvas->getData().addColor(glm::ivec4 {rgba.r, rgba.g, rgba.b, rgba.a});
+    } else if (auto other = touserdata<LuaCanvas>(L, 2)) {
+        canvas->getData().addColor(other->getData());
+    }
+    return 0;
+}
+
 static std::unordered_map<std::string, lua_CFunction> methods {
     {"at", lua::wrap<l_at>},
     {"set", lua::wrap<l_set>},
@@ -249,6 +277,8 @@ static std::unordered_map<std::string, lua_CFunction> methods {
     {"update", lua::wrap<l_update>},
     {"create_texture", lua::wrap<l_create_texture>},
     {"unbind_texture", lua::wrap<l_unbind_texture>},
+    {"mul", lua::wrap<l_mul>},
+    {"add", lua::wrap<l_add>},
     {"_set_data", lua::wrap<l_set_data>},
 };
 

From 34d13442b614b76a7794bd7a2fd909ddf7931a2a Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 11 Nov 2025 19:34:40 +0300
Subject: [PATCH 128/133] add canvas:sub method

---
 doc/en/scripting/ui.md                        |  1 +
 doc/ru/scripting/ui.md                        |  1 +
 src/graphics/core/ImageData.cpp               |  8 ++++----
 src/graphics/core/ImageData.hpp               |  4 ++--
 .../lua/usertypes/lua_type_canvas.cpp         | 19 +++++++++++++++++--
 5 files changed, 25 insertions(+), 8 deletions(-)

diff --git a/doc/en/scripting/ui.md b/doc/en/scripting/ui.md
index 37c316fd..80750501 100644
--- a/doc/en/scripting/ui.md
+++ b/doc/en/scripting/ui.md
@@ -199,6 +199,7 @@ Here, *color* can be specified in the following ways:
 | data:unbind_texture()                                    | unbinds the texture from the canvas                     |
 | data:mul(*color* or Canvas)                              | multiplies a color by the specified color or canvas     |
 | data:add(*color* or Canvas)                              | adds a color or another canvas to a color               |
+| data:sub(*color* or Canvas)                              | subtracts a color or another canvas to a color          |
 
 ## Inline frame (iframe)
 
diff --git a/doc/ru/scripting/ui.md b/doc/ru/scripting/ui.md
index 741c8cf3..c6c769ac 100644
--- a/doc/ru/scripting/ui.md
+++ b/doc/ru/scripting/ui.md
@@ -199,6 +199,7 @@ document["worlds-panel"]:clear()
 | data:unbind_texture()                                    | отвязывает текстуру от холста                        |
 | data:mul(*цвет* или Canvas)                              | умножает увет на указанный цвет или холст            |
 | data:add(*цвет* или Canvas)                              | прибавляет цвет или другой холст к цвету             |
+| data:sub(*цвет* или Canvas)                              | вычитает цвет или другой холст к цвету               |
 
 ## Рамка встраивания (iframe)
 
diff --git a/src/graphics/core/ImageData.cpp b/src/graphics/core/ImageData.cpp
index b69b5f4a..bd243832 100644
--- a/src/graphics/core/ImageData.cpp
+++ b/src/graphics/core/ImageData.cpp
@@ -448,7 +448,7 @@ void ImageData::mulColor(const glm::ivec4& color) {
     }
 }
 
-void ImageData::addColor(const ImageData& other) {
+void ImageData::addColor(const ImageData& other, int multiplier) {
     check_matching(*this, other);
 
     uint comps;
@@ -462,7 +462,7 @@ void ImageData::addColor(const ImageData& other) {
         for (uint x = 0; x < width; x++) {
             uint idx = (y * width + x) * comps;
             for (uint c = 0; c < comps; c++) {
-                int val = data[idx + c] + other.data[idx + c];
+                int val = data[idx + c] + other.data[idx + c] * multiplier;
                 data[idx + c] =
                     static_cast<ubyte>(std::min(std::max(val, 0), 255));
             }
@@ -470,7 +470,7 @@ void ImageData::addColor(const ImageData& other) {
     }
 }
 
-void ImageData::addColor(const glm::ivec4& color) {
+void ImageData::addColor(const glm::ivec4& color, int multiplier) {
     uint comps;
     switch (format) {
         case ImageFormat::rgb888: comps = 3; break;
@@ -482,7 +482,7 @@ void ImageData::addColor(const glm::ivec4& color) {
         for (uint x = 0; x < width; x++) {
             uint idx = (y * width + x) * comps;
             for (uint c = 0; c < comps; c++) {
-                int val = data[idx + c] + color[c];
+                int val = data[idx + c] + color[c] * multiplier;
                 data[idx + c] =
                     static_cast<ubyte>(std::min(std::max(val, 0), 255));
             }
diff --git a/src/graphics/core/ImageData.hpp b/src/graphics/core/ImageData.hpp
index a0e694e3..a1597a98 100644
--- a/src/graphics/core/ImageData.hpp
+++ b/src/graphics/core/ImageData.hpp
@@ -34,8 +34,8 @@ public:
     void fixAlphaColor();
     void mulColor(const glm::ivec4& color);
     void mulColor(const ImageData& other);
-    void addColor(const glm::ivec4& color);
-    void addColor(const ImageData& other);
+    void addColor(const glm::ivec4& color, int multiplier);
+    void addColor(const ImageData& other, int multiplier);
 
     std::unique_ptr<ImageData> cropped(int x, int y, int width, int height) const;
 
diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index 8adb558c..b93b52c6 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -261,9 +261,23 @@ static int l_add(State* L) {
     }
     if (lua::istable(L, 2)) {
         RGBA rgba = get_rgba(L, 2);
-        canvas->getData().addColor(glm::ivec4 {rgba.r, rgba.g, rgba.b, rgba.a});
+        canvas->getData().addColor(glm::ivec4 {rgba.r, rgba.g, rgba.b, rgba.a}, 1);
     } else if (auto other = touserdata<LuaCanvas>(L, 2)) {
-        canvas->getData().addColor(other->getData());
+        canvas->getData().addColor(other->getData(), 1);
+    }
+    return 0;
+}
+
+static int l_sub(State* L) {
+    auto canvas = touserdata<LuaCanvas>(L, 1);
+    if (canvas == nullptr) {
+        return 0;
+    }
+    if (lua::istable(L, 2)) {
+        RGBA rgba = get_rgba(L, 2);
+        canvas->getData().addColor(glm::ivec4 {rgba.r, rgba.g, rgba.b, rgba.a}, -1);
+    } else if (auto other = touserdata<LuaCanvas>(L, 2)) {
+        canvas->getData().addColor(other->getData(), -1);
     }
     return 0;
 }
@@ -279,6 +293,7 @@ static std::unordered_map<std::string, lua_CFunction> methods {
     {"unbind_texture", lua::wrap<l_unbind_texture>},
     {"mul", lua::wrap<l_mul>},
     {"add", lua::wrap<l_add>},
+    {"sub", lua::wrap<l_sub>},
     {"_set_data", lua::wrap<l_set_data>},
 };
 

From 1c777746a077a1bd979a6bdcd89ea8106c2cd258 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 11 Nov 2025 21:22:28 +0300
Subject: [PATCH 129/133] fix atlas canvas update extrusion

---
 src/logic/scripting/lua/usertypes/lua_type_canvas.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
index b93b52c6..de8021de 100644
--- a/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
+++ b/src/logic/scripting/lua/usertypes/lua_type_canvas.cpp
@@ -47,7 +47,9 @@ void LuaCanvas::update(int extrusion) {
                 h + extrusion * 2
             );
             extruded->blit(*data, extrusion, extrusion);
-            extruded->extrude(0, 0, w + extrusion * 2, h + extrusion * 2);
+            for (uint j = 0; j < extrusion; j++) {
+                extruded->extrude(extrusion - j, extrusion - j, w + j*2, h + j*2);
+            }
             texture->reloadPartial(
                 *extruded,
                 x - extrusion,

From 371aaaa9f5d8bb01c734c2e62499eecd82781ad4 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 12 Nov 2025 12:29:07 +0300
Subject: [PATCH 130/133] make exchange slot available as 'hud.exchange-slot'

---
 src/frontend/hud.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/frontend/hud.cpp b/src/frontend/hud.cpp
index 89789e29..5cc16119 100644
--- a/src/frontend/hud.cpp
+++ b/src/frontend/hud.cpp
@@ -469,6 +469,7 @@ void Hud::showExchangeSlot() {
         gui,
         SlotLayout(-1, glm::vec2(), false, false, nullptr, nullptr, nullptr)
     );
+    exchangeSlot->setId("hud.exchange-slot");
     exchangeSlot->bind(exchangeSlotInv->getId(), exchangeSlotInv->getSlot(0), &content);
     exchangeSlot->setColor(glm::vec4());
     exchangeSlot->setInteractive(false);

From b5e69f1eae6f7493ec192de506ea5ecd7a4d7ce6 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 12 Nov 2025 18:43:34 +0300
Subject: [PATCH 131/133] make ui_element.id access non-throwing

---
 src/logic/scripting/lua/libs/libgui.cpp | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index 3697d39c..a051aa56 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -30,14 +30,17 @@ using namespace gui;
 using namespace scripting;
 
 static DocumentNode get_document_node_impl(
-    lua::State*, const std::string& name, const std::string& nodeName
+    lua::State*, const std::string& name, const std::string& nodeName, bool throwable=true
 ) {
     auto doc = engine->getAssets()->get<UiDocument>(name);
     if (doc == nullptr) {
-        throw std::runtime_error("document '" + name + "' not found");
+        if (throwable) {
+            throw std::runtime_error("document '" + name + "' not found");
+        }
+        return {nullptr, nullptr};
     }
     auto node = doc->get(nodeName);
-    if (node == nullptr) {
+    if (node == nullptr && throwable) {
         throw std::runtime_error(
             "document '" + name + "' has no element with id '" + nodeName + "'"
         );
@@ -459,6 +462,9 @@ static int p_get_content_offset(UINode* node, lua::State* L) {
     return lua::pushvec(L, node->getContentOffset());
 }
 static int p_get_id(UINode* node, lua::State* L) {
+    if (node == nullptr) {
+        return 0;
+    }
     return lua::pushstring(L, node->getId());
 }
 static int p_get_color(UINode* node, lua::State* L) {
@@ -540,6 +546,10 @@ static int p_get_options(UINode* node, lua::State* L) {
     return 0;
 }
 
+static bool is_node_required(std::string_view attr) {
+    return attr != "id";
+}
+
 static int l_gui_getattr(lua::State* L) {
     if (!lua::isstring(L, 1)) {
         throw std::runtime_error("document name is not a string");
@@ -568,6 +578,7 @@ static int l_gui_getattr(lua::State* L) {
         throw std::runtime_error("attribute name is not a string");
     }
     auto attr = lua::require_string(L, 3);
+    bool required = is_node_required(attr);
 
     static const std::unordered_map<
         std::string_view,
@@ -630,7 +641,7 @@ static int l_gui_getattr(lua::State* L) {
         };
     auto func = getters.find(attr);
     if (func != getters.end()) {
-        auto docnode = get_document_node_impl(L, docname, element);
+        auto docnode = get_document_node_impl(L, docname, element, required);
         auto node = docnode.node;
         return func->second(node.get(), L);
     }

From ef656e9ff1a0a5074aabf0470005aa5a2227bf39 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 12 Nov 2025 18:49:04 +0300
Subject: [PATCH 132/133] revert non-throwing 'id' and add 'exists' property &
 update doc/*/scripting/ui.md

---
 doc/en/scripting/ui.md                  | 1 +
 doc/ru/scripting/ui.md                  | 1 +
 src/logic/scripting/lua/libs/libgui.cpp | 7 ++++++-
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/en/scripting/ui.md b/doc/en/scripting/ui.md
index 80750501..c35bf908 100644
--- a/doc/en/scripting/ui.md
+++ b/doc/en/scripting/ui.md
@@ -37,6 +37,7 @@ Properties that apply to all elements:
 | Name          | Type    | Read | Write | Description                                 |
 | ------------- | ------- | ---- | ----- | ------------------------------------------- |
 | id            | string  | yes  | *no*  | element id                                  |
+| exists        | bool    | yes  | *no*  | checks if element exists                    |
 | pos           | vec2    | yes  | yes   | element position inside a container         |
 | wpos          | vec2    | yes  | yes   | element position inside the window          |
 | size          | vec2    | yes  | yes   | element size                                |
diff --git a/doc/ru/scripting/ui.md b/doc/ru/scripting/ui.md
index c6c769ac..a6d6006d 100644
--- a/doc/ru/scripting/ui.md
+++ b/doc/ru/scripting/ui.md
@@ -37,6 +37,7 @@ document["worlds-panel"]:clear()
 | Название      | Тип     | Чтение | Запись | Описание                                  |
 | ------------- | ------- | ------ | ------ | ----------------------------------------- |
 | id            | string  | да     | *нет*  | идентификатор элемента                    |
+| exists        | bool    | да     | *нет*  | проверяет, существует ли элемент          |
 | pos           | vec2    | да     | да     | позиция элемента внутри контейнера        |
 | wpos          | vec2    | да     | да     | позиция элемента в окне                   |
 | size          | vec2    | да     | да     | размер элемента                           |
diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index a051aa56..cdf65898 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -546,8 +546,12 @@ static int p_get_options(UINode* node, lua::State* L) {
     return 0;
 }
 
+static int p_is_exists(UINode* node, lua::State* L) {
+    return lua::pushboolean(L, node != nullptr);
+}
+
 static bool is_node_required(std::string_view attr) {
-    return attr != "id";
+    return attr != "exists";
 }
 
 static int l_gui_getattr(lua::State* L) {
@@ -585,6 +589,7 @@ static int l_gui_getattr(lua::State* L) {
         std::function<int(UINode*, lua::State*)>>
         getters {
             {"id", p_get_id},
+            {"exists", p_is_exists},
             {"color", p_get_color},
             {"hoverColor", p_get_hover_color},
             {"pressedColor", p_get_pressed_color},

From 72a71758463d2347e62583b841f1a451a3f68f6c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 12 Nov 2025 20:09:31 +0300
Subject: [PATCH 133/133] update doc/*/main-page.md

---
 doc/en/main-page.md | 5 +++--
 doc/ru/main-page.md | 5 +++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/doc/en/main-page.md b/doc/en/main-page.md
index 5eb767f9..30cb106c 100644
--- a/doc/en/main-page.md
+++ b/doc/en/main-page.md
@@ -1,8 +1,9 @@
 # Documentation
 
-Documentation for 0.30 (in development).
+Documentation for 0.30.
 
-[Documentation for 0.29.](https://github.com/MihailRis/voxelcore/blob/release-0.29/doc/ru/main-page.md)
+> [!WARNING]
+> Version is in development. Proceed to [Documentation for 0.29.](https://github.com/MihailRis/voxelcore/blob/release-0.29/doc/ru/main-page.md)
 
 ## Sections
 
diff --git a/doc/ru/main-page.md b/doc/ru/main-page.md
index 60d0794d..e74c2915 100644
--- a/doc/ru/main-page.md
+++ b/doc/ru/main-page.md
@@ -1,8 +1,9 @@
 # Документация
 
-Документация версии 0.30 (в разработке).
+Документация версии 0.30.
 
-[Документация 0.29.](https://github.com/MihailRis/voxelcore/blob/release-0.29/doc/ru/main-page.md)
+> [!WARNING]
+> Версия находится в разработке. Перейдите к [документации для 0.28](https://github.com/MihailRis/voxelcore/blob/release-0.29/doc/ru/main-page.md)
 
 ## Разделы