From 6d9771bc329e987d5511134f63c738741b1f8f1e Mon Sep 17 00:00:00 2001
From: GHOST11111100 <mirdodoevsasha@gmail.com>
Date: Wed, 15 Jan 2025 18:42:16 +0300
Subject: [PATCH 01/36] added base hex color parser, and md statement

---
 src/graphics/ui/markdown.cpp | 77 ++++++++++++++++++++++++++----------
 1 file changed, 56 insertions(+), 21 deletions(-)

diff --git a/src/graphics/ui/markdown.cpp b/src/graphics/ui/markdown.cpp
index ab328e66..dd8613b5 100644
--- a/src/graphics/ui/markdown.cpp
+++ b/src/graphics/ui/markdown.cpp
@@ -1,15 +1,21 @@
 #include "markdown.hpp"
-
 #include "graphics/core/Font.hpp"
 
 using namespace markdown;
 
+static inline int hexchar2int(char c) {
+    if (c >= '0' && c <= '9') return c - '0';
+    if (c >= 'a' && c <= 'f') return c - 'a' + 10;
+    if (c >= 'A' && c <= 'F') return c - 'A' + 10;
+    return -1;
+}
+
 template <typename CharT>
 static inline void emit(
     CharT c, FontStylesScheme& styles, std::basic_stringstream<CharT>& ss
 ) {
     ss << c;
-    styles.map.emplace_back(styles.palette.size()-1);
+    styles.map.emplace_back(styles.palette.size() - 1);
 }
 
 template <typename CharT>
@@ -21,21 +27,36 @@ static inline void emit_md(
 }
 
 template <typename CharT>
-static inline void restyle(
-    CharT c,
-    FontStyle& style,
-    FontStylesScheme& styles,
-    std::basic_stringstream<CharT>& ss,
-    int& pos,
-    bool eraseMarkdown
-) {
-    styles.palette.push_back(style);
-    if (!eraseMarkdown) {
-        emit_md(c, styles, ss);
+static glm::vec4 parse_color(const std::basic_string_view<CharT>& color_code) {
+    if (color_code.size() != 9 || color_code[0] != '#') {
+        return glm::vec4(1, 1, 1, 1); // default to white
     }
-    pos++;
+
+    auto hex_to_float = [](char high, char low) {
+        int high_val = hexchar2int(high);
+        int low_val = hexchar2int(low);
+        if (high_val == -1 || low_val == -1) {
+            return 1.0f; // default to max value on error
+        }
+        return (high_val * 16 + low_val) / 255.0f;
+    };
+
+    return glm::vec4(
+        hex_to_float(color_code[1], color_code[2]),
+        hex_to_float(color_code[3], color_code[4]),
+        hex_to_float(color_code[5], color_code[6]),
+        hex_to_float(color_code[7], color_code[8])
+    );
 }
 
+template <typename CharT>
+static inline void apply_color(const std::basic_string_view<CharT>& color_code, FontStylesScheme& styles) {
+    FontStyle style = styles.palette.back();
+    style.color = parse_color(color_code);
+    styles.palette.push_back(style);
+}
+
+// TODO: Refactor md code processing
 template <typename CharT>
 Result<CharT> process_markdown(
     std::basic_string_view<CharT> source, bool eraseMarkdown
@@ -50,6 +71,19 @@ Result<CharT> process_markdown(
     int pos = 0;
     while (pos < source.size()) {
         CharT first = source[pos];
+
+        if (first == '[' && pos + 10 < source.size() && source[pos + 1] == '#' && source[pos + 9] == ']') {
+            std::basic_string_view<CharT> color_code = source.substr(pos + 1, 9);
+            apply_color(color_code, styles);
+            if (!eraseMarkdown) {
+                for (int i = 0; i < 10; ++i) {
+                    emit_md(source[pos + i], styles, ss);
+                }
+            }
+            pos += 10; // Skip past the color code
+            continue;
+        }
+
         if (first == '\\') {
             if (pos + 1 < source.size()) {
                 CharT second = source[++pos];
@@ -67,32 +101,33 @@ Result<CharT> process_markdown(
                 pos--;
             }
         } else if (first == '*') {
-            if (pos + 1 < source.size() && source[pos+1] == '*') {
+            if (pos + 1 < source.size() && source[pos + 1] == '*') {
                 pos++;
                 if (!eraseMarkdown)
                     emit_md(first, styles, ss);
                 style.bold = !style.bold;
-                restyle(first, style, styles, ss, pos, eraseMarkdown);
+                styles.palette.push_back(style);
                 continue;
             }
             style.italic = !style.italic;
-            restyle(first, style, styles, ss, pos, eraseMarkdown);
+            styles.palette.push_back(style);
             continue;
-        } else if (first == '_' && pos + 1 < source.size() && source[pos+1] == '_') {
+        } else if (first == '_' && pos + 1 < source.size() && source[pos + 1] == '_') {
             pos++;
             if (!eraseMarkdown)
                 emit_md(first, styles, ss);
             style.underline = !style.underline;
-            restyle(first, style, styles, ss, pos, eraseMarkdown);
+            styles.palette.push_back(style);
             continue;
-        } else if (first == '~' && pos + 1 < source.size() && source[pos+1] == '~') {
+        } else if (first == '~' && pos + 1 < source.size() && source[pos + 1] == '~') {
             pos++;
             if (!eraseMarkdown)
                 emit_md(first, styles, ss);
             style.strikethrough = !style.strikethrough;
-            restyle(first, style, styles, ss, pos, eraseMarkdown);
+            styles.palette.push_back(style);
             continue;
         }
+
         if (first == '\n') {
             styles.palette.push_back(styles.palette.at(1));
         }

From 9ce34080f775b3c05afe83c1d814aa83be4a274c Mon Sep 17 00:00:00 2001
From: GHOST11111100 <mirdodoevsasha@gmail.com>
Date: Wed, 15 Jan 2025 19:07:48 +0300
Subject: [PATCH 02/36] fixed engine hang when using other special characters

---
 src/graphics/ui/markdown.cpp | 32 +++++++++++++++++++++++---------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/src/graphics/ui/markdown.cpp b/src/graphics/ui/markdown.cpp
index dd8613b5..8a1b13bf 100644
--- a/src/graphics/ui/markdown.cpp
+++ b/src/graphics/ui/markdown.cpp
@@ -56,7 +56,22 @@ static inline void apply_color(const std::basic_string_view<CharT>& color_code,
     styles.palette.push_back(style);
 }
 
-// TODO: Refactor md code processing
+template <typename CharT>
+static inline void restyle(
+    CharT c,
+    FontStyle& style,
+    FontStylesScheme& styles,
+    std::basic_stringstream<CharT>& ss,
+    int& pos,
+    bool eraseMarkdown
+) {
+    styles.palette.push_back(style);
+    if (!eraseMarkdown) {
+        emit_md(c, styles, ss);
+    }
+    pos++;
+}
+
 template <typename CharT>
 Result<CharT> process_markdown(
     std::basic_string_view<CharT> source, bool eraseMarkdown
@@ -101,33 +116,32 @@ Result<CharT> process_markdown(
                 pos--;
             }
         } else if (first == '*') {
-            if (pos + 1 < source.size() && source[pos + 1] == '*') {
+            if (pos + 1 < source.size() && source[pos+1] == '*') {
                 pos++;
                 if (!eraseMarkdown)
                     emit_md(first, styles, ss);
                 style.bold = !style.bold;
-                styles.palette.push_back(style);
+                restyle(first, style, styles, ss, pos, eraseMarkdown);
                 continue;
             }
             style.italic = !style.italic;
-            styles.palette.push_back(style);
+            restyle(first, style, styles, ss, pos, eraseMarkdown);
             continue;
-        } else if (first == '_' && pos + 1 < source.size() && source[pos + 1] == '_') {
+        } else if (first == '_' && pos + 1 < source.size() && source[pos+1] == '_') {
             pos++;
             if (!eraseMarkdown)
                 emit_md(first, styles, ss);
             style.underline = !style.underline;
-            styles.palette.push_back(style);
+            restyle(first, style, styles, ss, pos, eraseMarkdown);
             continue;
-        } else if (first == '~' && pos + 1 < source.size() && source[pos + 1] == '~') {
+        } else if (first == '~' && pos + 1 < source.size() && source[pos+1] == '~') {
             pos++;
             if (!eraseMarkdown)
                 emit_md(first, styles, ss);
             style.strikethrough = !style.strikethrough;
-            styles.palette.push_back(style);
+            restyle(first, style, styles, ss, pos, eraseMarkdown);
             continue;
         }
-
         if (first == '\n') {
             styles.palette.push_back(styles.palette.at(1));
         }

From 6ca8dc18cf9a2b062fdc7a4e0a19f4e4f16b5ec8 Mon Sep 17 00:00:00 2001
From: GHOST11111100 <mirdodoevsasha@gmail.com>
Date: Wed, 15 Jan 2025 20:09:30 +0300
Subject: [PATCH 03/36] fix hex code length and use a exists hex to int method;
 added docs for color codes

---
 doc/en/text-styles.md        | 31 +++++++++++++++++++++++++++++++
 doc/ru/text-styles.md        | 30 ++++++++++++++++++++++++++++++
 src/graphics/ui/markdown.cpp | 20 +++++++-------------
 3 files changed, 68 insertions(+), 13 deletions(-)

diff --git a/doc/en/text-styles.md b/doc/en/text-styles.md
index e85437e1..4afce42a 100644
--- a/doc/en/text-styles.md
+++ b/doc/en/text-styles.md
@@ -19,3 +19,34 @@ Styles can be combined. Example:
 Output:
 
 ***<ins>Message</ins>*** using *~~combed~~ combined* styles<ins>~~.~~</ins>
+
+# Colors
+
+Text color can be set using a color code: [#RRGGBB]
+
+
+| Component | Purpose                           |
+| --------- | --------------------------------- |
+| R         | Represents the intensity of red   |
+| G         | Represents the intensity of green |
+| B         | Represents the intensity of blue  |
+
+### Example:
+
+<span style="color: #ff0000">
+    <span style="color:rgb(105, 105, 105)">
+    [#ff0000]
+    </span>Red Text
+</span>
+
+<span style="color: #00ff00">
+    <span style="color:rgb(105, 105, 105)">
+    [#00ff00]
+    </span>Green Text
+</span>
+
+<span style="color: #0000ff">
+    <span style="color:rgb(105, 105, 105)">
+    [#0000ff]
+    </span>Blue Text
+</span>
diff --git a/doc/ru/text-styles.md b/doc/ru/text-styles.md
index 0a09abe3..4fbe3ed5 100644
--- a/doc/ru/text-styles.md
+++ b/doc/ru/text-styles.md
@@ -19,3 +19,33 @@
 Вывод:
 
 ***<ins>Сообщение</ins>***, демонстрирующее *~~обедненные~~ объединенные* стили<ins>~~.~~</ins>
+
+## Цвета
+
+Цвет текста задается при помощи цветового кода: [#RRGGBB]
+
+| Компонент        | Назначение                    |
+| ------------ | ------------------------- |
+| R       | Используется для интенсивности красного        |
+| G       | Используется для интенсивности зеленого        |
+| B       | Используется для интенсивности синего        |
+
+### Например:
+
+<span style="color: #ff0000">
+    <span style="color:rgb(105, 105, 105)">
+    [#ff0000]
+    </span>Красный Текст
+</span>
+
+<span style="color: #00ff00">
+    <span style="color:rgb(105, 105, 105)">
+    [#00ff00]
+    </span>Зеленый Текст
+</span>
+
+<span style="color: #0000ff">
+    <span style="color:rgb(105, 105, 105)">
+    [#0000ff]
+    </span>Синий Текст
+</span>
\ No newline at end of file
diff --git a/src/graphics/ui/markdown.cpp b/src/graphics/ui/markdown.cpp
index 8a1b13bf..bbbc298a 100644
--- a/src/graphics/ui/markdown.cpp
+++ b/src/graphics/ui/markdown.cpp
@@ -1,15 +1,9 @@
 #include "markdown.hpp"
+#include "coders/commons.hpp"
 #include "graphics/core/Font.hpp"
 
 using namespace markdown;
 
-static inline int hexchar2int(char c) {
-    if (c >= '0' && c <= '9') return c - '0';
-    if (c >= 'a' && c <= 'f') return c - 'a' + 10;
-    if (c >= 'A' && c <= 'F') return c - 'A' + 10;
-    return -1;
-}
-
 template <typename CharT>
 static inline void emit(
     CharT c, FontStylesScheme& styles, std::basic_stringstream<CharT>& ss
@@ -28,7 +22,7 @@ static inline void emit_md(
 
 template <typename CharT>
 static glm::vec4 parse_color(const std::basic_string_view<CharT>& color_code) {
-    if (color_code.size() != 9 || color_code[0] != '#') {
+    if (color_code.size() != 8 || color_code[0] != '#') {
         return glm::vec4(1, 1, 1, 1); // default to white
     }
 
@@ -45,7 +39,7 @@ static glm::vec4 parse_color(const std::basic_string_view<CharT>& color_code) {
         hex_to_float(color_code[1], color_code[2]),
         hex_to_float(color_code[3], color_code[4]),
         hex_to_float(color_code[5], color_code[6]),
-        hex_to_float(color_code[7], color_code[8])
+        1
     );
 }
 
@@ -87,15 +81,15 @@ Result<CharT> process_markdown(
     while (pos < source.size()) {
         CharT first = source[pos];
 
-        if (first == '[' && pos + 10 < source.size() && source[pos + 1] == '#' && source[pos + 9] == ']') {
-            std::basic_string_view<CharT> color_code = source.substr(pos + 1, 9);
+        if (first == '[' && pos + 9 < source.size() && source[pos + 1] == '#' && source[pos + 8] == ']') {
+            std::basic_string_view<CharT> color_code = source.substr(pos + 1, 8);
             apply_color(color_code, styles);
             if (!eraseMarkdown) {
-                for (int i = 0; i < 10; ++i) {
+                for (int i = 0; i < 9; ++i) {
                     emit_md(source[pos + i], styles, ss);
                 }
             }
-            pos += 10; // Skip past the color code
+            pos += 9; // Skip past the color code
             continue;
         }
 

From a93af583d19b9fd640ef287b90fabd0eaa7d0fe4 Mon Sep 17 00:00:00 2001
From: GHOST11111100 <mirdodoevsasha@gmail.com>
Date: Wed, 15 Jan 2025 21:22:13 +0300
Subject: [PATCH 04/36] added color code escaping

---
 src/graphics/ui/markdown.cpp | 70 ++++++++++++++++++++++--------------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/src/graphics/ui/markdown.cpp b/src/graphics/ui/markdown.cpp
index bbbc298a..8616facd 100644
--- a/src/graphics/ui/markdown.cpp
+++ b/src/graphics/ui/markdown.cpp
@@ -1,4 +1,5 @@
 #include "markdown.hpp"
+
 #include "coders/commons.hpp"
 #include "graphics/core/Font.hpp"
 
@@ -23,14 +24,14 @@ static inline void emit_md(
 template <typename CharT>
 static glm::vec4 parse_color(const std::basic_string_view<CharT>& color_code) {
     if (color_code.size() != 8 || color_code[0] != '#') {
-        return glm::vec4(1, 1, 1, 1); // default to white
+        return glm::vec4(1, 1, 1, 1);  // default to white
     }
 
     auto hex_to_float = [](char high, char low) {
         int high_val = hexchar2int(high);
         int low_val = hexchar2int(low);
         if (high_val == -1 || low_val == -1) {
-            return 1.0f; // default to max value on error
+            return 1.0f;  // default to max value on error
         }
         return (high_val * 16 + low_val) / 255.0f;
     };
@@ -44,7 +45,9 @@ static glm::vec4 parse_color(const std::basic_string_view<CharT>& color_code) {
 }
 
 template <typename CharT>
-static inline void apply_color(const std::basic_string_view<CharT>& color_code, FontStylesScheme& styles) {
+static inline void apply_color(
+    const std::basic_string_view<CharT>& color_code, FontStylesScheme& styles
+) {
     FontStyle style = styles.palette.back();
     style.color = parse_color(color_code);
     styles.palette.push_back(style);
@@ -73,7 +76,7 @@ Result<CharT> process_markdown(
     std::basic_stringstream<CharT> ss;
     FontStylesScheme styles {
         // markdown                                           default
-        {{false, false, false, false, glm::vec4(1,1,1,0.5f)}, {}},
+        {{false, false, false, false, glm::vec4(1, 1, 1, 0.5f)}, {}},
         {}
     };
     FontStyle style;
@@ -81,18 +84,6 @@ Result<CharT> process_markdown(
     while (pos < source.size()) {
         CharT first = source[pos];
 
-        if (first == '[' && pos + 9 < source.size() && source[pos + 1] == '#' && source[pos + 8] == ']') {
-            std::basic_string_view<CharT> color_code = source.substr(pos + 1, 8);
-            apply_color(color_code, styles);
-            if (!eraseMarkdown) {
-                for (int i = 0; i < 9; ++i) {
-                    emit_md(source[pos + i], styles, ss);
-                }
-            }
-            pos += 9; // Skip past the color code
-            continue;
-        }
-
         if (first == '\\') {
             if (pos + 1 < source.size()) {
                 CharT second = source[++pos];
@@ -106,14 +97,39 @@ Result<CharT> process_markdown(
                         emit(second, styles, ss);
                         pos++;
                         continue;
+                    case '[':
+                        if (pos + 9 < source.size() && source[pos + 1] == '#' &&
+                            source[pos + 8] == ']') {
+                            if (!eraseMarkdown) {
+                                emit_md(source[pos - 1], styles, ss);
+                            }
+                            for (int i = 0; i < 10; ++i) {
+                                
+                                emit(source[pos + i], styles, ss);
+                            }
+
+                            pos += 10;
+                            continue;
+                        }
                 }
                 pos--;
             }
+        } else if (first == '[' && pos + 9 < source.size() &&
+                   source[pos + 1] == '#' && source[pos + 8] == ']') {
+            std::basic_string_view<CharT> color_code =
+                source.substr(pos + 1, 8);
+            apply_color(color_code, styles);
+            if (!eraseMarkdown) {
+                for (int i = 0; i < 9; ++i) {
+                    emit_md(source[pos + i], styles, ss);
+                }
+            }
+            pos += 9;  // Skip past the color code
+            continue;
         } else if (first == '*') {
-            if (pos + 1 < source.size() && source[pos+1] == '*') {
+            if (pos + 1 < source.size() && source[pos + 1] == '*') {
                 pos++;
-                if (!eraseMarkdown)
-                    emit_md(first, styles, ss);
+                if (!eraseMarkdown) emit_md(first, styles, ss);
                 style.bold = !style.bold;
                 restyle(first, style, styles, ss, pos, eraseMarkdown);
                 continue;
@@ -121,17 +137,17 @@ Result<CharT> process_markdown(
             style.italic = !style.italic;
             restyle(first, style, styles, ss, pos, eraseMarkdown);
             continue;
-        } else if (first == '_' && pos + 1 < source.size() && source[pos+1] == '_') {
+        } else if (first == '_' && pos + 1 < source.size() &&
+                   source[pos + 1] == '_') {
             pos++;
-            if (!eraseMarkdown)
-                emit_md(first, styles, ss);
+            if (!eraseMarkdown) emit_md(first, styles, ss);
             style.underline = !style.underline;
             restyle(first, style, styles, ss, pos, eraseMarkdown);
             continue;
-        } else if (first == '~' && pos + 1 < source.size() && source[pos+1] == '~') {
+        } else if (first == '~' && pos + 1 < source.size() &&
+                   source[pos + 1] == '~') {
             pos++;
-            if (!eraseMarkdown)
-                emit_md(first, styles, ss);
+            if (!eraseMarkdown) emit_md(first, styles, ss);
             style.strikethrough = !style.strikethrough;
             restyle(first, style, styles, ss, pos, eraseMarkdown);
             continue;
@@ -149,6 +165,8 @@ Result<char> markdown::process(std::string_view source, bool eraseMarkdown) {
     return process_markdown(source, eraseMarkdown);
 }
 
-Result<wchar_t> markdown::process(std::wstring_view source, bool eraseMarkdown) {
+Result<wchar_t> markdown::process(
+    std::wstring_view source, bool eraseMarkdown
+) {
     return process_markdown(source, eraseMarkdown);
 }

From acb07c6664fb656ef6c0f9e0ce345f9560b6f656 Mon Sep 17 00:00:00 2001
From: GHOST11111100 <mirdodoevsasha@gmail.com>
Date: Wed, 15 Jan 2025 21:28:52 +0300
Subject: [PATCH 05/36] fixed color code highlight

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

diff --git a/src/graphics/ui/markdown.cpp b/src/graphics/ui/markdown.cpp
index 8616facd..44991804 100644
--- a/src/graphics/ui/markdown.cpp
+++ b/src/graphics/ui/markdown.cpp
@@ -114,10 +114,8 @@ Result<CharT> process_markdown(
                 }
                 pos--;
             }
-        } else if (first == '[' && pos + 9 < source.size() &&
-                   source[pos + 1] == '#' && source[pos + 8] == ']') {
-            std::basic_string_view<CharT> color_code =
-                source.substr(pos + 1, 8);
+        } else if (first == '[' && pos + 9 <= source.size() && source[pos + 1] == '#' && source[pos + 8] == ']') {
+            std::basic_string_view<CharT> color_code = source.substr(pos + 1, 8);
             apply_color(color_code, styles);
             if (!eraseMarkdown) {
                 for (int i = 0; i < 9; ++i) {

From 43f0cbe3fe5f8231af0415207fda129e5e58b81f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 15 Jan 2025 22:25:51 +0300
Subject: [PATCH 06/36] add player.is_suspended, player.set_suspended

---
 src/logic/LevelController.cpp              |  6 ++++++
 src/logic/scripting/lua/libs/libplayer.cpp | 16 ++++++++++++++++
 src/objects/Player.cpp                     |  8 ++++++++
 src/objects/Player.hpp                     |  4 ++++
 src/objects/Players.cpp                    | 21 +++++++++++++++++++++
 src/objects/Players.hpp                    |  4 ++++
 6 files changed, 59 insertions(+)

diff --git a/src/logic/LevelController.cpp b/src/logic/LevelController.cpp
index 47a6384d..422807c6 100644
--- a/src/logic/LevelController.cpp
+++ b/src/logic/LevelController.cpp
@@ -66,6 +66,9 @@ LevelController::LevelController(
 
 void LevelController::update(float delta, bool pause) {
     for (const auto& [_, player] : *level->players) {
+        if (player->isSuspended()) {
+            continue;
+        }
         glm::vec3 position = player->getPosition();
         player->chunks->configure(
             position.x,
@@ -85,6 +88,9 @@ void LevelController::update(float delta, bool pause) {
         level->entities->updatePhysics(delta);
         level->entities->update(delta);
         for (const auto& [_, player] : *level->players) {
+            if (player->isSuspended()) {
+                continue;
+            }
             if (playerTickClock.update(delta)) {
                 if (player->getId() % playerTickClock.getParts() ==
                     playerTickClock.getPart()) {
diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index af908aea..5979d0f6 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -284,6 +284,20 @@ static int l_delete(lua::State* L) {
     return 0;
 }
 
+static int l_is_suspended(lua::State* L) {
+    if (auto player = get_player(L, 1)) {
+        return lua::pushboolean(L, player->isSuspended());
+    }
+    return 0;
+}
+
+static int l_set_suspended(lua::State* L) {
+    if (auto player = get_player(L, 1)) {
+        player->setSuspended(lua::toboolean(L, 2));
+    }
+    return 0;
+}
+
 const luaL_Reg playerlib[] = {
     {"get_pos", lua::wrap<l_get_pos>},
     {"set_pos", lua::wrap<l_set_pos>},
@@ -293,6 +307,8 @@ const luaL_Reg playerlib[] = {
     {"set_rot", lua::wrap<l_set_rot>},
     {"get_dir", lua::wrap<l_get_dir>},
     {"get_inventory", lua::wrap<l_get_inv>},
+    {"is_suspended", lua::wrap<l_is_suspended>},
+    {"set_suspended", lua::wrap<l_set_suspended>},
     {"is_flight", lua::wrap<l_is_flight>},
     {"set_flight", lua::wrap<l_set_flight>},
     {"is_noclip", lua::wrap<l_is_noclip>},
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index f80fffa7..e0a4a49e 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -224,6 +224,14 @@ float Player::getSpeed() const {
     return speed;
 }
 
+bool Player::isSuspended() const {
+    return suspended;
+}
+
+void Player::setSuspended(bool flag) {
+    suspended = flag;
+}
+
 bool Player::isFlight() const {
     return flight;
 }
diff --git a/src/objects/Player.hpp b/src/objects/Player.hpp
index 1e87e2a7..8caf7a63 100644
--- a/src/objects/Player.hpp
+++ b/src/objects/Player.hpp
@@ -47,6 +47,7 @@ class Player : public Serializable {
     glm::vec3 position;
     glm::vec3 spawnpoint {};
     std::shared_ptr<Inventory> inventory;
+    bool suspended = false;
     bool flight = false;
     bool noclip = false;
     bool infiniteItems = true;
@@ -85,6 +86,9 @@ public:
     int getChosenSlot() const;
     float getSpeed() const;
 
+    bool isSuspended() const;
+    void setSuspended(bool flag);
+
     bool isFlight() const;
     void setFlight(bool flag);
 
diff --git a/src/objects/Players.cpp b/src/objects/Players.cpp
index 1a683a34..edd74274 100644
--- a/src/objects/Players.cpp
+++ b/src/objects/Players.cpp
@@ -4,6 +4,7 @@
 #include "items/Inventories.hpp"
 #include "world/Level.hpp"
 #include "world/World.hpp"
+#include "objects/Entities.hpp"
 
 Players::Players(Level& level) : level(level) {}
 
@@ -36,6 +37,26 @@ Player* Players::create() {
     return player;
 }
 
+void Players::suspend(int64_t id) {
+    if (auto player = get(id)) {
+        if (player->isSuspended()) {
+            return;
+        }
+        player->setSuspended(true);
+        level.entities->despawn(player->getEntity());
+        player->setEntity(0);
+    }
+}
+
+void Players::resume(int64_t id) {
+    if (auto player = get(id)) {
+        if (!player->isSuspended()) {
+            return;
+        }
+        player->setSuspended(false);
+    }
+}
+
 void Players::remove(int64_t id) {
     players.erase(id);
 }
diff --git a/src/objects/Players.hpp b/src/objects/Players.hpp
index 74f5c565..74146ade 100644
--- a/src/objects/Players.hpp
+++ b/src/objects/Players.hpp
@@ -25,6 +25,10 @@ public:
 
     Player* create();
 
+    void suspend(int64_t id);
+
+    void resume(int64_t id);
+
     void remove(int64_t id);
 
     dv::value serialize() const override;

From b59752bc845c0d224ac8c376961e109ffd941a14 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 01:23:45 +0300
Subject: [PATCH 07/36] fix player_animator

---
 res/content/base/scripts/components/player_animator.lua | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/res/content/base/scripts/components/player_animator.lua b/res/content/base/scripts/components/player_animator.lua
index 871284d5..f85deddc 100644
--- a/res/content/base/scripts/components/player_animator.lua
+++ b/res/content/base/scripts/components/player_animator.lua
@@ -12,7 +12,7 @@ local function refresh_model(id)
 end
 
 function on_render()
-    local invid, slotid = player.get_inventory()
+    local invid, slotid = player.get_inventory(hud.get_player())
     local id, _ = inventory.get(invid, slotid)
     if id ~= itemid then
         refresh_model(id)

From 44b9e21d460217787a9f7379fbd1b0b318994c53 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 03:46:56 +0300
Subject: [PATCH 08/36] fix input.add_callback

---
 src/logic/scripting/lua/libs/libinput.cpp | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libinput.cpp b/src/logic/scripting/lua/libs/libinput.cpp
index 3447728b..4121a384 100644
--- a/src/logic/scripting/lua/libs/libinput.cpp
+++ b/src/logic/scripting/lua/libs/libinput.cpp
@@ -45,11 +45,6 @@ static int l_add_callback(lua::State* L) {
             handler = Events::keyCallbacks[key].add(actual_callback);
         }
     }
-
-    const auto& bind = Events::bindings.find(bindname);
-    if (bind == Events::bindings.end()) {
-        throw std::runtime_error("unknown binding " + util::quote(bindname));
-    }
     auto callback = [=]() -> bool {
         if (!scripting::engine->getGUI()->isFocusCaught()) {
             return actual_callback();
@@ -57,6 +52,10 @@ static int l_add_callback(lua::State* L) {
         return false;
     };
     if (handler == nullptr) {
+        const auto& bind = Events::bindings.find(bindname);
+        if (bind == Events::bindings.end()) {
+            throw std::runtime_error("unknown binding " + util::quote(bindname));
+        }
         handler = bind->second.onactived.add(callback);
     }
 

From 2073d3782ad40ebc7cddf27e73388bb0ce39c077 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 04:16:32 +0300
Subject: [PATCH 09/36] fix HandlersList concurrency

---
 src/util/HandlersList.hpp | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/util/HandlersList.hpp b/src/util/HandlersList.hpp
index 737fdf36..45882512 100644
--- a/src/util/HandlersList.hpp
+++ b/src/util/HandlersList.hpp
@@ -14,7 +14,7 @@ namespace util {
         int nextid = 1;
         std::unordered_map<int, std::function<bool(Types...)>> handlers;
         std::vector<int> order;
-        std::recursive_mutex mutex;
+        std::mutex mutex;
     public:
         HandlersList() = default;
 
@@ -46,11 +46,15 @@ namespace util {
         }
 
         void notify(Types...args) {
-            std::lock_guard lock(mutex);
-            
-            auto orderCopy = order;
+            std::vector<int> orderCopy;
+            decltype(handlers) handlersCopy;
+            {
+                std::lock_guard lock(mutex);
+                orderCopy = order;
+                handlersCopy = handlers;
+            }
             for (auto it = orderCopy.rbegin(); it != orderCopy.rend(); ++it) {
-                if (handlers.at(*it)(args...)) {
+                if (handlersCopy.at(*it)(args...)) {
                     break;
                 }
             }

From 8aee8d81fb639fbdea005f5227f2c9284e84418e Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 05:55:49 +0300
Subject: [PATCH 10/36] fix: player name still visible after player removal

---
 src/graphics/render/Decorator.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/graphics/render/Decorator.cpp b/src/graphics/render/Decorator.cpp
index 4c9b9289..e9fda381 100644
--- a/src/graphics/render/Decorator.cpp
+++ b/src/graphics/render/Decorator.cpp
@@ -156,6 +156,7 @@ void Decorator::update(float delta, const Camera& camera) {
         auto note = renderer.texts->get(textsIter->second);
         auto player = level.players->get(textsIter->first);
         if (player == nullptr) {
+            renderer.texts->remove(textsIter->second);
             textsIter = playerTexts.erase(textsIter);
         } else {
             note->setPosition(player->getPosition() + glm::vec3(0, 1, 0));

From b5999fe36420d116674abc353ed3dad739ac5f70 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 05:57:01 +0300
Subject: [PATCH 11/36] fix some UB

---
 src/lighting/Lighting.cpp            | 12 +++++++++++-
 src/logic/scripting/lua/lua_util.hpp | 14 ++++++++++++--
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/src/lighting/Lighting.cpp b/src/lighting/Lighting.cpp
index bf55e001..eb721db2 100644
--- a/src/lighting/Lighting.cpp
+++ b/src/lighting/Lighting.cpp
@@ -8,9 +8,12 @@
 #include "voxels/Block.hpp"
 #include "constants.hpp"
 #include "util/timeutil.hpp"
+#include "debug/Logger.hpp"
 
 #include <memory>
 
+static debug::Logger logger("lighting");
+
 Lighting::Lighting(const Content& content, Chunks& chunks) 
   : content(content), chunks(chunks) {
     auto& indices = *content.getIndices();
@@ -63,6 +66,10 @@ void Lighting::buildSkyLight(int cx, int cz){
     const auto blockDefs = content.getIndices()->blocks.getDefs();
 
     Chunk* chunk = chunks.getChunk(cx, cz);
+    if (chunk == nullptr) {
+        logger.error() << "attempted to build sky lights to chunk missing in local matrix";
+        return;
+    }
     for (int z = 0; z < CHUNK_D; z++){
         for (int x = 0; x < CHUNK_W; x++){
             int gx = x + cx * CHUNK_W;
@@ -95,7 +102,10 @@ void Lighting::onChunkLoaded(int cx, int cz, bool expand) {
 
     auto blockDefs = content.getIndices()->blocks.getDefs();
     auto chunk = chunks.getChunk(cx, cz);
-
+    if (chunk == nullptr) {
+        logger.error() << "attempted to build lights to chunk missing in local matrix";
+        return;
+    }
     for (uint y = 0; y < CHUNK_H; y++){
         for (uint z = 0; z < CHUNK_D; z++){
             for (uint x = 0; x < CHUNK_W; x++){
diff --git a/src/logic/scripting/lua/lua_util.hpp b/src/logic/scripting/lua/lua_util.hpp
index 9f3ac414..1baf9c35 100644
--- a/src/logic/scripting/lua/lua_util.hpp
+++ b/src/logic/scripting/lua/lua_util.hpp
@@ -19,6 +19,7 @@ namespace lua {
     int userdata_destructor(lua::State* L);
 
     std::string env_name(int env);
+    void dump_stack(lua::State*);
 
     inline bool getglobal(lua::State* L, const std::string& name) {
         lua_getglobal(L, name.c_str());
@@ -208,7 +209,7 @@ namespace lua {
         return lua_isnumber(L, idx);
     }
     inline bool isstring(lua::State* L, int idx) {
-        return lua_isstring(L, idx);
+        return lua_type(L, idx) == LUA_TSTRING;
     }
     inline bool istable(lua::State* L, int idx) {
         return lua_istable(L, idx);
@@ -226,6 +227,11 @@ namespace lua {
         return lua_toboolean(L, idx);
     }
     inline lua::Integer tointeger(lua::State* L, int idx) {
+#ifndef NDEBUG
+        if (lua_type(L, idx) == LUA_TSTRING) {
+            throw std::runtime_error("integer expected, got string");
+        }
+#endif
         return lua_tointeger(L, idx);
     }
     inline uint64_t touinteger(lua::State* L, int idx) {
@@ -236,6 +242,11 @@ namespace lua {
         return static_cast<uint64_t>(val);
     }
     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");
+        }
+#endif
         return lua_tonumber(L, idx);
     }
     inline const char* tostring(lua::State* L, int idx) {
@@ -588,7 +599,6 @@ namespace lua {
     }
     int create_environment(lua::State*, int parent);
     void remove_environment(lua::State*, int id);
-    void dump_stack(lua::State*);
 
     inline void close(lua::State* L) {
         lua_close(L);

From 65fec4f4a9ba9a25d40ef3c9e0f22cde421c356d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 05:59:43 +0300
Subject: [PATCH 12/36] introduce local player

---
 src/engine/Engine.cpp                      |  8 ++++----
 src/engine/Engine.hpp                      |  8 +++++---
 src/engine/Mainloop.cpp                    |  6 ++++--
 src/engine/ServerMainloop.cpp              |  2 +-
 src/frontend/debug_panel.cpp               |  6 ++++++
 src/frontend/screens/LevelScreen.cpp       | 13 ++++++++-----
 src/frontend/screens/LevelScreen.hpp       |  4 +++-
 src/logic/ChunksController.cpp             |  6 ++++--
 src/logic/EngineController.cpp             | 16 +++++++++++-----
 src/logic/EngineController.hpp             |  3 +++
 src/logic/LevelController.cpp              |  5 +++++
 src/logic/PlayerController.cpp             |  1 -
 src/logic/scripting/lua/libs/libcore.cpp   |  6 ++++++
 src/logic/scripting/lua/libs/libplayer.cpp | 13 +++++++++----
 src/objects/Players.cpp                    | 13 +++++++++++--
 src/objects/Players.hpp                    |  5 ++++-
 16 files changed, 84 insertions(+), 31 deletions(-)

diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 9184fdd6..00382420 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -272,7 +272,7 @@ PacksManager Engine::createPacksManager(const fs::path& worldFolder) {
     return manager;
 }
 
-void Engine::setLevelConsumer(consumer<std::unique_ptr<Level>> levelConsumer) {
+void Engine::setLevelConsumer(OnWorldOpen levelConsumer) {
     this->levelConsumer = std::move(levelConsumer);
 }
 
@@ -446,14 +446,14 @@ void Engine::setLanguage(std::string locale) {
     langs::setup(paths.getResourcesFolder(), std::move(locale), contentPacks);
 }
 
-void Engine::onWorldOpen(std::unique_ptr<Level> level) {
+void Engine::onWorldOpen(std::unique_ptr<Level> level, int64_t localPlayer) {
     logger.info() << "world open";
-    levelConsumer(std::move(level));
+    levelConsumer(std::move(level), localPlayer);
 }
 
 void Engine::onWorldClosed() {
     logger.info() << "world closed";
-    levelConsumer(nullptr);
+    levelConsumer(nullptr, -1);
 }
 
 void Engine::quit() {
diff --git a/src/engine/Engine.hpp b/src/engine/Engine.hpp
index af9f7fb9..406d420a 100644
--- a/src/engine/Engine.hpp
+++ b/src/engine/Engine.hpp
@@ -53,6 +53,8 @@ struct CoreParameters {
     std::filesystem::path scriptFile;
 };
 
+using OnWorldOpen = std::function<void(std::unique_ptr<Level>, int64_t)>;
+
 class Engine : public util::ObjectsKeeper {
     CoreParameters params;
     EngineSettings settings;
@@ -71,7 +73,7 @@ class Engine : public util::ObjectsKeeper {
     std::unique_ptr<gui::GUI> gui;
     PostRunnables postRunnables;
     Time time;
-    consumer<std::unique_ptr<Level>> levelConsumer;
+    OnWorldOpen levelConsumer;
     bool quitSignal = false;
     
     void loadControls();
@@ -134,7 +136,7 @@ public:
     /// @brief Get engine resource paths controller
     ResPaths* getResPaths();
 
-    void onWorldOpen(std::unique_ptr<Level> level);
+    void onWorldOpen(std::unique_ptr<Level> level, int64_t localPlayer);
     void onWorldClosed();
 
     void quit();
@@ -166,7 +168,7 @@ public:
 
     PacksManager createPacksManager(const fs::path& worldFolder);
 
-    void setLevelConsumer(consumer<std::unique_ptr<Level>> levelConsumer);
+    void setLevelConsumer(OnWorldOpen levelConsumer);
 
     SettingsHandler& getSettingsHandler();
 
diff --git a/src/engine/Mainloop.cpp b/src/engine/Mainloop.cpp
index e0e64d10..2de6291d 100644
--- a/src/engine/Mainloop.cpp
+++ b/src/engine/Mainloop.cpp
@@ -15,14 +15,16 @@ Mainloop::Mainloop(Engine& engine) : engine(engine) {
 void Mainloop::run() {
     auto& time = engine.getTime();
 
-    engine.setLevelConsumer([this](auto level) {
+    engine.setLevelConsumer([this](auto level, int64_t localPlayer) {
         if (level == nullptr) {
             // destroy LevelScreen and run quit callbacks
             engine.setScreen(nullptr);
             // create and go to menu screen
             engine.setScreen(std::make_shared<MenuScreen>(engine));
         } else {
-            engine.setScreen(std::make_shared<LevelScreen>(engine, std::move(level)));
+            engine.setScreen(std::make_shared<LevelScreen>(
+                engine, std::move(level), localPlayer
+            ));
         }
     });
 
diff --git a/src/engine/ServerMainloop.cpp b/src/engine/ServerMainloop.cpp
index b97919be..954c2a11 100644
--- a/src/engine/ServerMainloop.cpp
+++ b/src/engine/ServerMainloop.cpp
@@ -30,7 +30,7 @@ void ServerMainloop::run() {
         logger.info() << "nothing to do";
         return;
     }
-    engine.setLevelConsumer([this](auto level) {
+    engine.setLevelConsumer([this](auto level, auto) {
         setLevel(std::move(level));
     });
 
diff --git a/src/frontend/debug_panel.cpp b/src/frontend/debug_panel.cpp
index a234c38a..936c3b2e 100644
--- a/src/frontend/debug_panel.cpp
+++ b/src/frontend/debug_panel.cpp
@@ -14,6 +14,7 @@
 #include "graphics/render/ChunksRenderer.hpp"
 #include "logic/scripting/scripting.hpp"
 #include "objects/Player.hpp"
+#include "objects/Players.hpp"
 #include "objects/Entities.hpp"
 #include "objects/EntityDef.hpp"
 #include "physics/Hitbox.hpp"
@@ -41,6 +42,7 @@ static std::shared_ptr<Label> create_label(wstringsupplier supplier) {
 
 // TODO: move to xml
 // TODO: move to xml finally
+// TODO: move to xml finally
 std::shared_ptr<UINode> create_debug_panel(
     Engine& engine, 
     Level& level, 
@@ -103,6 +105,10 @@ std::shared_ptr<UINode> create_debug_panel(
         return L"entities: "+std::to_wstring(level.entities->size())+L" next: "+
                std::to_wstring(level.entities->peekNextID());
     }));
+    panel->add(create_label([&]() {
+        return L"players: "+std::to_wstring(level.players->size())+L" local: "+
+               std::to_wstring(player.getId());
+    }));
     panel->add(create_label([&]() -> std::wstring {
         const auto& vox = player.selection.vox;
         std::wstringstream stream;
diff --git a/src/frontend/screens/LevelScreen.cpp b/src/frontend/screens/LevelScreen.cpp
index f045acee..f2933f0b 100644
--- a/src/frontend/screens/LevelScreen.cpp
+++ b/src/frontend/screens/LevelScreen.cpp
@@ -36,9 +36,10 @@
 
 static debug::Logger logger("level-screen");
 
-LevelScreen::LevelScreen(Engine& engine, std::unique_ptr<Level> levelPtr)
- : Screen(engine), postProcessing(std::make_unique<PostProcessing>()) 
-{
+LevelScreen::LevelScreen(
+    Engine& engine, std::unique_ptr<Level> levelPtr, int64_t localPlayer
+)
+    : Screen(engine), postProcessing(std::make_unique<PostProcessing>()) {
     Level* level = levelPtr.get();
 
     auto& settings = engine.getSettings();
@@ -46,7 +47,9 @@ LevelScreen::LevelScreen(Engine& engine, std::unique_ptr<Level> levelPtr)
     auto menu = engine.getGUI()->getMenu();
     menu->reset();
 
-    auto player = level->players->get(0);
+    auto player = level->players->get(localPlayer);
+    assert(player != nullptr);
+    
     controller =
         std::make_unique<LevelController>(&engine, std::move(levelPtr), player);
     playerController = std::make_unique<PlayerController>(
@@ -173,6 +176,7 @@ void LevelScreen::update(float delta) {
         updateHotkeys();
     }
 
+    auto level = controller->getLevel();
     auto player = playerController->getPlayer();
     auto camera = player->currentCamera;
 
@@ -189,7 +193,6 @@ void LevelScreen::update(float delta) {
         camera->dir, 
         glm::vec3(0, 1, 0)
     );
-    auto level = controller->getLevel();
     const auto& settings = engine.getSettings();
 
     if (!hud->isPause()) {
diff --git a/src/frontend/screens/LevelScreen.hpp b/src/frontend/screens/LevelScreen.hpp
index 6a3b4eab..13ad5bf7 100644
--- a/src/frontend/screens/LevelScreen.hpp
+++ b/src/frontend/screens/LevelScreen.hpp
@@ -34,7 +34,9 @@ class LevelScreen : public Screen {
     void initializeContent();
     void initializePack(ContentPackRuntime* pack);
 public:
-    LevelScreen(Engine& engine, std::unique_ptr<Level> level);
+    LevelScreen(
+        Engine& engine, std::unique_ptr<Level> level, int64_t localPlayer
+    );
     ~LevelScreen();
 
     void update(float delta) override;
diff --git a/src/logic/ChunksController.cpp b/src/logic/ChunksController.cpp
index 8bb0fff4..0f341322 100644
--- a/src/logic/ChunksController.cpp
+++ b/src/logic/ChunksController.cpp
@@ -92,7 +92,7 @@ bool ChunksController::loadVisible(const Player& player, uint padding) const {
     }
 
     const auto& chunk = chunks.getChunks()[nearZ * sizeX + nearX];
-    if (chunk != nullptr || !assigned) {
+    if (chunk != nullptr || !assigned || !player.isLoadingChunks()) {
         return false;
     }
     int offsetX = chunks.getOffsetX();
@@ -101,7 +101,9 @@ bool ChunksController::loadVisible(const Player& player, uint padding) const {
     return true;
 }
 
-bool ChunksController::buildLights(const Player& player, const std::shared_ptr<Chunk>& chunk) const {
+bool ChunksController::buildLights(
+    const Player& player, const std::shared_ptr<Chunk>& chunk
+) const {
     int surrounding = 0;
     for (int oz = -1; oz <= 1; oz++) {
         for (int ox = -1; ox <= 1; ox++) {
diff --git a/src/logic/EngineController.cpp b/src/logic/EngineController.cpp
index 86210cf4..90106ec9 100644
--- a/src/logic/EngineController.cpp
+++ b/src/logic/EngineController.cpp
@@ -143,7 +143,9 @@ static bool load_world_content(Engine& engine, const fs::path& folder) {
 }
 
 static void load_world(
-    Engine& engine, const std::shared_ptr<WorldFiles>& worldFiles
+    Engine& engine,
+    const std::shared_ptr<WorldFiles>& worldFiles,
+    int64_t localPlayer
 ) {
     try {
         auto content = engine.getContent();
@@ -151,7 +153,7 @@ static void load_world(
         auto& settings = engine.getSettings();
 
         auto level = World::load(worldFiles, settings, *content, packs);
-        engine.onWorldOpen(std::move(level));
+        engine.onWorldOpen(std::move(level), localPlayer);
     } catch (const world_load_error& error) {
         guiutil::alert(
             engine,
@@ -233,7 +235,7 @@ void EngineController::openWorld(const std::string& name, bool confirmConvert) {
         }
         return;
     }
-    load_world(engine, std::move(worldFiles));
+    load_world(engine, std::move(worldFiles), localPlayer);
 }
 
 inline uint64_t str2seed(const std::string& seedstr) {
@@ -279,9 +281,13 @@ void EngineController::createWorld(
         engine.getContentPacks()
     );
     if (!engine.isHeadless()) {
-        level->players->create();
+        level->players->create(localPlayer);
     }
-    engine.onWorldOpen(std::move(level));
+    engine.onWorldOpen(std::move(level), localPlayer);
+}
+
+void EngineController::setLocalPlayer(int64_t player) {
+    localPlayer = player;
 }
 
 void EngineController::reopenWorld(World* world) {
diff --git a/src/logic/EngineController.hpp b/src/logic/EngineController.hpp
index 948a8fce..a46973cf 100644
--- a/src/logic/EngineController.hpp
+++ b/src/logic/EngineController.hpp
@@ -12,6 +12,7 @@ class LevelController;
 class EngineController {
     Engine& engine;
 
+    int64_t localPlayer = -1;
     void onMissingContent(const std::shared_ptr<ContentReport>& report);
 public:
     EngineController(Engine& engine);
@@ -37,5 +38,7 @@ public:
         const std::string& generatorID
     );
 
+    void setLocalPlayer(int64_t player);
+
     void reopenWorld(World* world);
 };
diff --git a/src/logic/LevelController.cpp b/src/logic/LevelController.cpp
index 422807c6..5e537750 100644
--- a/src/logic/LevelController.cpp
+++ b/src/logic/LevelController.cpp
@@ -50,6 +50,10 @@ LevelController::LevelController(
     do {
         confirmed = 0;
         for (const auto& [_, player] : *level->players) {
+            if (!player->isLoadingChunks()) {
+                confirmed++;
+                continue;
+            }
             glm::vec3 position = player->getPosition();
             player->chunks->configure(
                 std::floor(position.x), std::floor(position.z), 1
@@ -69,6 +73,7 @@ void LevelController::update(float delta, bool pause) {
         if (player->isSuspended()) {
             continue;
         }
+        player->updateEntity();
         glm::vec3 position = player->getPosition();
         player->chunks->configure(
             position.x,
diff --git a/src/logic/PlayerController.cpp b/src/logic/PlayerController.cpp
index d81e2c5b..ea6037fa 100644
--- a/src/logic/PlayerController.cpp
+++ b/src/logic/PlayerController.cpp
@@ -305,7 +305,6 @@ void PlayerController::resetKeyboard() {
 }
 
 void PlayerController::updatePlayer(float delta) {
-    player.updateEntity();
     player.updateInput(input, delta);
 }
 
diff --git a/src/logic/scripting/lua/libs/libcore.cpp b/src/logic/scripting/lua/libs/libcore.cpp
index 3daebca5..cb5c7f43 100644
--- a/src/logic/scripting/lua/libs/libcore.cpp
+++ b/src/logic/scripting/lua/libs/libcore.cpp
@@ -55,10 +55,15 @@ static int l_new_world(lua::State* L) {
     auto name = lua::require_string(L, 1);
     auto seed = lua::require_string(L, 2);
     auto generator = lua::require_string(L, 3);
+    int64_t localPlayer = 0;
+    if (lua::gettop(L) >= 4) {
+        localPlayer = lua::tointeger(L, 4);
+    }
     if (level != nullptr) {
         throw std::runtime_error("world must be closed before");
     }
     auto controller = engine->getController();
+    controller->setLocalPlayer(localPlayer);
     controller->createWorld(name, seed, generator);
     return 0;
 }
@@ -71,6 +76,7 @@ static int l_open_world(lua::State* L) {
         throw std::runtime_error("world must be closed before");
     }
     auto controller = engine->getController();
+    controller->setLocalPlayer(0);
     controller->openWorld(name, false);
     return 0;
 }
diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index 5979d0f6..c20d5ee5 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -52,6 +52,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);
     }
@@ -272,15 +273,19 @@ static int l_set_name(lua::State* L) {
 }
 
 static int l_create(lua::State* L) {
-    auto player = level->players->create();
-    if (lua::isstring(L, 1)) {
-        player->setName(lua::require_string(L, 1));
+    int64_t playerId = Players::NONE;
+    if (lua::gettop(L) >= 2) {
+        playerId = lua::tointeger(L, 2);
     }
+    auto player = level->players->create(playerId);
+    player->setName(lua::require_string(L, 1));
     return lua::pushinteger(L, player->getId());
 }
 
 static int l_delete(lua::State* L) {
-    level->players->remove(lua::tointeger(L, 1));
+    auto id = lua::tointeger(L, 1);
+    level->players->suspend(id);
+    level->players->remove(id);
     return 0;
 }
 
diff --git a/src/objects/Players.cpp b/src/objects/Players.cpp
index edd74274..e200a20b 100644
--- a/src/objects/Players.cpp
+++ b/src/objects/Players.cpp
@@ -20,10 +20,19 @@ Player* Players::get(int64_t id) const {
     return found->second.get();
 }
 
-Player* Players::create() {
+Player* Players::create(int64_t id) {
+    int64_t& nextPlayerID = level.getWorld()->getInfo().nextPlayerId;
+    if (id == NONE) {
+        id = nextPlayerID++;
+    } else {
+        if (auto player = get(id)) {
+            return player;
+        }
+        nextPlayerID = std::max(id + 1, nextPlayerID);
+    }
     auto playerPtr = std::make_unique<Player>(
         level,
-        level.getWorld()->getInfo().nextPlayerId++,
+        id,
         "",
         glm::vec3(0, DEF_PLAYER_Y, 0),
         DEF_PLAYER_SPEED,
diff --git a/src/objects/Players.hpp b/src/objects/Players.hpp
index 74146ade..5c657a50 100644
--- a/src/objects/Players.hpp
+++ b/src/objects/Players.hpp
@@ -14,6 +14,9 @@ class Level;
 class Player;
 
 class Players : public Serializable {
+public:
+    static inline int64_t NONE = -1;
+private:
     Level& level;
     std::unordered_map<int64_t, std::unique_ptr<Player>> players;
 
@@ -23,7 +26,7 @@ public:
 
     Player* get(int64_t id) const;
 
-    Player* create();
+    Player* create(int64_t id=NONE);
 
     void suspend(int64_t id);
 

From 9cd3f3e4c8bfa9f254e3b2cfa2df0a57805da878 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 06:50:01 +0300
Subject: [PATCH 13/36] add entity:get_player()

---
 .../base/scripts/components/player_animator.lua    |  6 +++++-
 res/modules/internal/stdcomp.lua                   |  1 +
 src/logic/scripting/lua/libs/libentity.cpp         | 14 ++++++++++++--
 src/objects/Entities.hpp                           |  9 +++++++++
 src/objects/Player.cpp                             |  6 ++++++
 5 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/res/content/base/scripts/components/player_animator.lua b/res/content/base/scripts/components/player_animator.lua
index f85deddc..1fdf4722 100644
--- a/res/content/base/scripts/components/player_animator.lua
+++ b/res/content/base/scripts/components/player_animator.lua
@@ -12,7 +12,11 @@ local function refresh_model(id)
 end
 
 function on_render()
-    local invid, slotid = player.get_inventory(hud.get_player())
+    local pid = entity:get_player()
+    if pid == -1 then
+        return
+    end
+    local invid, slotid = player.get_inventory(pid)
     local id, _ = inventory.get(invid, slotid)
     if id ~= itemid then
         refresh_model(id)
diff --git a/res/modules/internal/stdcomp.lua b/res/modules/internal/stdcomp.lua
index 6c77af1d..dfa14175 100644
--- a/res/modules/internal/stdcomp.lua
+++ b/res/modules/internal/stdcomp.lua
@@ -66,6 +66,7 @@ local Entity = {__index={
     get_uid=function(self) return self.eid end,
     def_index=function(self) return entities.get_def(self.eid) end,
     def_name=function(self) return entities.def_name(entities.get_def(self.eid)) end,
+    get_player=function(self) return entities.get_player(self.eid) end,
 }}
 
 local entities = {}
diff --git a/src/logic/scripting/lua/libs/libentity.cpp b/src/logic/scripting/lua/libs/libentity.cpp
index 211bf5b1..cecac6e9 100644
--- a/src/logic/scripting/lua/libs/libentity.cpp
+++ b/src/logic/scripting/lua/libs/libentity.cpp
@@ -54,7 +54,7 @@ static int l_get_def(lua::State* L) {
     return 0;
 }
 
-static int l_show(lua::State* L) {
+static int l_spawn(lua::State* L) {
     auto level = controller->getLevel();
     auto defname = lua::tostring(L, 1);
     auto& def = content->entities.require(defname);
@@ -81,6 +81,15 @@ static int l_get_skeleton(lua::State* L) {
     return 0;
 }
 
+static int l_get_player(lua::State* L) {
+    entityid_t eid = lua::touinteger(L, 1);
+    auto level = controller->getLevel();
+    if (auto entity = level->entities->get(eid)) {
+        return lua::pushinteger(L, entity->getPlayer());
+    }
+    return 0;
+}
+
 static int l_set_skeleton(lua::State* L) {
     if (auto entity = get_entity(L, 1)) {
         std::string skeletonName = lua::require_string(L, 2);
@@ -221,10 +230,11 @@ const luaL_Reg entitylib[] = {
     {"def_hitbox", lua::wrap<l_def_hitbox>},
     {"get_def", lua::wrap<l_get_def>},
     {"defs_count", lua::wrap<l_defs_count>},
-    {"spawn", lua::wrap<l_show>},
+    {"spawn", lua::wrap<l_spawn>},
     {"despawn", lua::wrap<l_despawn>},
     {"get_skeleton", lua::wrap<l_get_skeleton>},
     {"set_skeleton", lua::wrap<l_set_skeleton>},
+    {"get_player", lua::wrap<l_get_player>},
     {"get_all_in_box", lua::wrap<l_get_all_in_box>},
     {"get_all_in_radius", lua::wrap<l_get_all_in_radius>},
     {"raycast", lua::wrap<l_raycast>},
diff --git a/src/objects/Entities.hpp b/src/objects/Entities.hpp
index 001b3dd9..3d183014 100644
--- a/src/objects/Entities.hpp
+++ b/src/objects/Entities.hpp
@@ -34,6 +34,7 @@ struct EntityId {
     entityid_t uid;
     const EntityDef& def;
     bool destroyFlag = false;
+    int64_t player = -1;
 };
 
 struct Transform {
@@ -161,6 +162,14 @@ public:
         return entity;
     }
 
+    int64_t getPlayer() const {
+        return registry.get<EntityId>(entity).player;
+    }
+
+    void setPlayer(int64_t id) {
+        registry.get<EntityId>(entity).player = id;
+    }
+
     void destroy();
 };
 
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index e0a4a49e..731627fe 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -65,8 +65,14 @@ void Player::updateEntity() {
     if (eid == 0) {
         auto& def = level.content.entities.require("base:player");
         eid = level.entities->spawn(def, getPosition());
+        if (auto entity = level.entities->get(eid)) {
+            entity->setPlayer(id);
+        }
     } else if (auto entity = level.entities->get(eid)) {
         position = entity->getTransform().pos;
+        if (auto entity = level.entities->get(eid)) {
+            entity->setPlayer(id);
+        }
     } else if (chunks->getChunkByVoxel(position)) {
         logger.error() << "player entity despawned or deleted; "
                           "will be respawned";

From 43dc88c6b5a6fd54b54b9fc3ca906a1a0084176f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 06:58:53 +0300
Subject: [PATCH 14/36] move player animation to base:player_animator component

---
 .../base/scripts/components/player_animator.lua  |  7 +++++++
 src/logic/PlayerController.cpp                   | 14 +++++++-------
 src/objects/Player.cpp                           | 16 +---------------
 3 files changed, 15 insertions(+), 22 deletions(-)

diff --git a/res/content/base/scripts/components/player_animator.lua b/res/content/base/scripts/components/player_animator.lua
index 1fdf4722..6419d543 100644
--- a/res/content/base/scripts/components/player_animator.lua
+++ b/res/content/base/scripts/components/player_animator.lua
@@ -3,7 +3,9 @@ local body = entity.rigidbody
 local rig = entity.skeleton
 
 local itemid = 0
+local headIndex = rig:index("head")
 local itemIndex = rig:index("item")
+local bodyIndex = rig:index("body")
 
 local function refresh_model(id)
     itemid = id
@@ -16,6 +18,11 @@ function on_render()
     if pid == -1 then
         return
     end
+    
+    local rx, ry, rz = player.get_rot(pid)
+    rig:set_matrix(headIndex, mat4.rotate({1, 0, 0}, ry))
+    rig:set_matrix(bodyIndex, mat4.rotate({0, 1, 0}, rx))
+
     local invid, slotid = player.get_inventory(pid)
     local id, _ = inventory.get(invid, slotid)
     if id ~= itemid then
diff --git a/src/logic/PlayerController.cpp b/src/logic/PlayerController.cpp
index ea6037fa..eafb2e32 100644
--- a/src/logic/PlayerController.cpp
+++ b/src/logic/PlayerController.cpp
@@ -170,8 +170,8 @@ void CameraControl::update(
         switchCamera();
     }
 
-    auto& spCamera = player.spCamera;
-    auto& tpCamera = player.tpCamera;
+    const auto& spCamera = player.spCamera;
+    const auto& tpCamera = player.tpCamera;
 
     refresh();
 
@@ -316,15 +316,15 @@ static int determine_rotation(
         if (name == "pipe") {
             if (norm.x < 0.0f)
                 return BLOCK_DIR_WEST;
-            else if (norm.x > 0.0f)
+            if (norm.x > 0.0f)
                 return BLOCK_DIR_EAST;
-            else if (norm.y > 0.0f)
+            if (norm.y > 0.0f)
                 return BLOCK_DIR_UP;
-            else if (norm.y < 0.0f)
+            if (norm.y < 0.0f)
                 return BLOCK_DIR_DOWN;
-            else if (norm.z > 0.0f)
+            if (norm.z > 0.0f)
                 return BLOCK_DIR_NORTH;
-            else if (norm.z < 0.0f)
+            if (norm.z < 0.0f)
                 return BLOCK_DIR_SOUTH;
         } else if (name == "pane") {
             if (abs(camDir.x) > abs(camDir.z)) {
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index 731627fe..38fdbc30 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -170,23 +170,9 @@ void Player::postUpdate() {
         }
     }
 
+    // TODO: ERASE & FORGET
     auto& skeleton = entity->getSkeleton();
-
     skeleton.visible = currentCamera != fpCamera;
-
-    auto body = skeleton.config->find("body");
-    auto head = skeleton.config->find("head");
-
-    if (body) {
-        skeleton.pose.matrices[body->getIndex()] = glm::rotate(
-            glm::mat4(1.0f), glm::radians(rotation.x), glm::vec3(0, 1, 0)
-        );
-    }
-    if (head) {
-        skeleton.pose.matrices[head->getIndex()] = glm::rotate(
-            glm::mat4(1.0f), glm::radians(rotation.y), glm::vec3(1, 0, 0)
-        );
-    }
 }
 
 void Player::teleport(glm::vec3 position) {

From 1a246e2ae01bb6179d0a719da2b81b8370b5dc79 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 07:40:34 +0300
Subject: [PATCH 15/36] feat: menu pages dispatching

---
 res/layouts/pages/scripts.xml.lua |  2 ++
 res/modules/gui_util.lua          | 20 +++++++++++++++++++-
 res/scripts/stdlib.lua            |  3 ++-
 3 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/res/layouts/pages/scripts.xml.lua b/res/layouts/pages/scripts.xml.lua
index 259792b8..3529b3d2 100644
--- a/res/layouts/pages/scripts.xml.lua
+++ b/res/layouts/pages/scripts.xml.lua
@@ -37,4 +37,6 @@ end
 
 function on_open()
     refresh()
+
+    input.add_callback("key:f5", refresh, document.root)
 end
diff --git a/res/modules/gui_util.lua b/res/modules/gui_util.lua
index d2983765..877d4b01 100644
--- a/res/modules/gui_util.lua
+++ b/res/modules/gui_util.lua
@@ -1,4 +1,6 @@
-local gui_util = {}
+local gui_util = {
+    local_dispatchers = {}
+}
 
 --- Parse `pagename?arg1=value1&arg2=value2` queries
 --- @param query page query string
@@ -25,6 +27,11 @@ end
 --- @return document_id
 function gui_util.load_page(query)
     local name, args = gui_util.parse_query(query)
+    for i = #gui_util.local_dispatchers, 1, -1 do
+        local newname, newargs = gui_util.local_dispatchers[i](name, args)
+        name = newname or name
+        args = newargs or args
+    end
     local filename = file.find(string.format("layouts/pages/%s.xml", name))
     if filename then
         name = file.prefix(filename)..":pages/"..name
@@ -33,4 +40,15 @@ function gui_util.load_page(query)
     end
 end
 
+function gui_util.add_page_dispatcher(dispatcher)
+    if type(dispatcher) ~= "function" then
+        error("function expected")
+    end
+    table.insert(gui_util.local_dispatchers, dispatcher)
+end
+
+function gui_util.reset_local()
+    gui_util.local_dispatchers = {}
+end
+
 return gui_util
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 71ba2f4f..81dd115d 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -201,7 +201,7 @@ _GUI_ROOT = Document.new("core:root")
 _MENU = _GUI_ROOT.menu
 menu = _MENU
 
-local gui_util = require "core:gui_util"
+gui_util = require "core:gui_util"
 __vc_page_loader = gui_util.load_page
 
 ---  Console library extension ---
@@ -408,6 +408,7 @@ end
 
 function __vc_on_world_quit()
     _rules.clear()
+    gui_util:reset_local()
 end
 
 local __vc_coroutines = {}

From 2adfbdb19226b2685848131073a56b354706433d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 18:17:12 +0300
Subject: [PATCH 16/36] fix rigidbody:is_enabled

---
 src/logic/scripting/lua/libs/lib__rigidbody.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/logic/scripting/lua/libs/lib__rigidbody.cpp b/src/logic/scripting/lua/libs/lib__rigidbody.cpp
index bb58e448..a5d3563a 100644
--- a/src/logic/scripting/lua/libs/lib__rigidbody.cpp
+++ b/src/logic/scripting/lua/libs/lib__rigidbody.cpp
@@ -17,7 +17,7 @@ static int l_set_vel(lua::State* L) {
 
 static int l_is_enabled(lua::State* L) {
     if (auto entity = get_entity(L, 1)) {
-        lua::pushboolean(L, entity->getRigidbody().enabled);
+        return lua::pushboolean(L, entity->getRigidbody().enabled);
     }
     return 0;
 }

From a45487b3c704b29484143edb32f17eb68e79ade1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 16 Jan 2025 23:11:00 +0300
Subject: [PATCH 17/36] move 'key:escape' handler to Lua

---
 res/scripts/stdlib.lua |  9 +++++++++
 src/frontend/hud.cpp   | 11 -----------
 2 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 81dd115d..cc1aa23f 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -385,6 +385,15 @@ function __vc_on_hud_open()
             hud.show_overlay("core:console", false, {"chat"})
         end)
     end)
+    input.add_callback("key:escape", function()
+        if hud.is_paused() then
+            hud.resume()
+        elseif hud.is_inventory_open() then
+            hud.close_inventory()
+        else
+            hud.pause()
+        end
+    end)
 end
 
 local RULES_FILE = "world:rules.toml"
diff --git a/src/frontend/hud.cpp b/src/frontend/hud.cpp
index 01798503..ff22523a 100644
--- a/src/frontend/hud.cpp
+++ b/src/frontend/hud.cpp
@@ -201,17 +201,6 @@ Hud::Hud(Engine& engine, LevelFrontend& frontend, Player& player)
             "' pos='0' size='256' gravity='top-right' margin='0,20,0,0'/>"
         );
     add(HudElement(hud_element_mode::permanent, nullptr, debugMinimap, true));
-
-    keepAlive(Events::keyCallbacks[keycode::ESCAPE].add([this]() -> bool {
-        if (pause) {
-            setPause(false);
-        } else if (inventoryOpen) {
-            closeInventory();
-        } else {
-            setPause(true);
-        }
-        return false;
-    }));
 }
 
 Hud::~Hud() {

From 036e13a2caa8d9e9ccb8984039ebe2e89c2a037c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 01:42:01 +0300
Subject: [PATCH 18/36] improve app scripts error handling

---
 res/scripts/stdlib.lua | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index cc1aa23f..0df1c387 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -480,7 +480,10 @@ function __process_post_runnables()
 
     local dead = {}
     for name, co in pairs(__vc_named_coroutines) do
-        coroutine.resume(co)
+        local success, err = coroutine.resume(co)
+        if not success then
+            debug.error(err)
+        end
         if coroutine.status(co) == "dead" then
             table.insert(dead, name)
         end

From 2fa71b3bf0ca2ee9034583a013a51b46bf54adf9 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 01:44:46 +0300
Subject: [PATCH 19/36] feat: players interpolation & add
 hud.set_allow_pause(...)

---
 .../scripts/components/player_animator.lua    |  2 +-
 res/modules/internal/stdcomp.lua              |  1 +
 src/frontend/hud.cpp                          | 30 +++++++---
 src/frontend/hud.hpp                          |  4 ++
 src/frontend/screens/LevelScreen.cpp          |  3 +-
 src/graphics/render/Decorator.cpp             |  7 ++-
 src/graphics/render/WorldRenderer.cpp         |  3 +-
 src/graphics/ui/GUI.cpp                       |  4 +-
 src/graphics/ui/elements/Menu.cpp             |  4 ++
 src/graphics/ui/elements/Menu.hpp             |  2 +
 src/logic/LevelController.cpp                 |  1 +
 src/logic/PlayerController.cpp                |  4 +-
 .../scripting/lua/libs/lib__skeleton.cpp      | 18 ++++++
 src/logic/scripting/lua/libs/libhud.cpp       |  6 ++
 src/logic/scripting/lua/libs/libplayer.cpp    |  5 +-
 src/objects/Entities.cpp                      | 17 +++++-
 src/objects/Entities.hpp                      |  4 ++
 src/objects/Player.cpp                        | 13 ++++
 src/objects/Player.hpp                        | 10 +++-
 src/objects/rigging.cpp                       | 28 ++++++---
 src/objects/rigging.hpp                       | 19 ++++--
 src/util/Interpolation.hpp                    | 60 +++++++++++++++++++
 src/window/Events.cpp                         | 18 +++---
 src/window/Events.hpp                         |  6 +-
 src/window/Window.cpp                         |  4 +-
 25 files changed, 232 insertions(+), 41 deletions(-)
 create mode 100644 src/util/Interpolation.hpp

diff --git a/res/content/base/scripts/components/player_animator.lua b/res/content/base/scripts/components/player_animator.lua
index 6419d543..8862c6c2 100644
--- a/res/content/base/scripts/components/player_animator.lua
+++ b/res/content/base/scripts/components/player_animator.lua
@@ -19,7 +19,7 @@ function on_render()
         return
     end
     
-    local rx, ry, rz = player.get_rot(pid)
+    local rx, ry, rz = player.get_rot(pid, true)
     rig:set_matrix(headIndex, mat4.rotate({1, 0, 0}, ry))
     rig:set_matrix(bodyIndex, mat4.rotate({0, 1, 0}, rx))
 
diff --git a/res/modules/internal/stdcomp.lua b/res/modules/internal/stdcomp.lua
index dfa14175..9e208038 100644
--- a/res/modules/internal/stdcomp.lua
+++ b/res/modules/internal/stdcomp.lua
@@ -49,6 +49,7 @@ local Skeleton = {__index={
     set_visible=function(self, i, b) return __skeleton.set_visible(self.eid, i, b) end,
     get_color=function(self) return __skeleton.get_color(self.eid) end,
     set_color=function(self, color) return __skeleton.set_color(self.eid, color) end,
+    set_interpolated=function(self, b) return __skeleton.set_interpolated(self.eid, b) end,
 }}
 
 local function new_Skeleton(eid)
diff --git a/src/frontend/hud.cpp b/src/frontend/hud.cpp
index ff22523a..d8f95715 100644
--- a/src/frontend/hud.cpp
+++ b/src/frontend/hud.cpp
@@ -223,7 +223,8 @@ void Hud::cleanup() {
 }
 
 void Hud::processInput(bool visible) {
-    if (!Window::isFocused() && !pause && !isInventoryOpen()) {
+    auto menu = gui.getMenu();
+    if (!Window::isFocused() && !menu->hasOpenPage() && !isInventoryOpen()) {
         setPause(true);
     }
     if (!pause && visible && Events::jactive(BIND_HUD_INVENTORY)) {
@@ -318,14 +319,13 @@ void Hud::update(bool visible) {
     if (!visible && inventoryOpen) {
         closeInventory();
     }
-    if (pause && menu->getCurrent().panel == nullptr) {
+    if (pause && !menu->hasOpenPage()) {
         setPause(false);
     }
-
     if (!gui.isFocusCaught()) {
         processInput(visible);
     }
-    if ((pause || inventoryOpen) == Events::_cursor_locked) {
+    if ((menu->hasOpenPage() || inventoryOpen) == Events::isCursorLocked()) {
         Events::toggleCursor();
     }
 
@@ -590,7 +590,9 @@ void Hud::draw(const DrawContext& ctx){
     const Viewport& viewport = ctx.getViewport();
     const uint width = viewport.getWidth();
     const uint height = viewport.getHeight();
+    auto menu = gui.getMenu();
 
+    darkOverlay->setVisible(menu->hasOpenPage());
     updateElementsPosition(viewport);
 
     uicamera->setFov(height);
@@ -676,19 +678,20 @@ void Hud::setPause(bool pause) {
     if (this->pause == pause) {
         return;
     }
-    this->pause = pause;
+    if (allowPause) {
+        this->pause = pause;
+    }
 
     if (inventoryOpen) {
         closeInventory();
     }
     
     const auto& menu = gui.getMenu();
-    if (pause) {
-        menu->setPage("pause");
-    } else {
+    if (menu->hasOpenPage()) {
         menu->reset();
+    } else {
+        menu->setPage("pause");
     }
-    darkOverlay->setVisible(pause);
     menu->setVisible(pause);
 }
 
@@ -721,3 +724,12 @@ void Hud::setDebugCheats(bool flag) {
     debugPanel->setZIndex(2);
     gui.add(debugPanel);
 }
+
+void Hud::setAllowPause(bool flag) {
+    if (pause) {
+        auto menu = gui.getMenu();
+        setPause(false);
+        menu->setPage("pause", true);
+    }
+    allowPause = flag;
+}
diff --git a/src/frontend/hud.hpp b/src/frontend/hud.hpp
index 2a537157..07affc66 100644
--- a/src/frontend/hud.hpp
+++ b/src/frontend/hud.hpp
@@ -113,6 +113,8 @@ class Hud : public util::ObjectsKeeper {
     bool showContentPanel = true;
     /// @brief Provide cheat controllers to the debug panel
     bool allowDebugCheats = true;
+    /// @brief Allow actual pause
+    bool allowPause = true;
     bool debug = false;
     /// @brief UI element will be dynamicly positioned near to inventory or in screen center
     std::shared_ptr<gui::UINode> secondUI;
@@ -206,6 +208,8 @@ public:
 
     void setDebugCheats(bool flag);
 
+    void setAllowPause(bool flag);
+
     static bool showGeneratorMinimap;
 
     /// @brief Runtime updating debug visualization texture
diff --git a/src/frontend/screens/LevelScreen.cpp b/src/frontend/screens/LevelScreen.cpp
index f2933f0b..0dce2bc0 100644
--- a/src/frontend/screens/LevelScreen.cpp
+++ b/src/frontend/screens/LevelScreen.cpp
@@ -168,8 +168,9 @@ void LevelScreen::updateHotkeys() {
 
 void LevelScreen::update(float delta) {
     gui::GUI* gui = engine.getGUI();
+    auto menu = gui->getMenu();
     
-    bool inputLocked = hud->isPause() || 
+    bool inputLocked = menu->hasOpenPage() ||
                        hud->isInventoryOpen() || 
                        gui->isFocusCaught();
     if (!gui->isFocusCaught()) {
diff --git a/src/graphics/render/Decorator.cpp b/src/graphics/render/Decorator.cpp
index e9fda381..e6331820 100644
--- a/src/graphics/render/Decorator.cpp
+++ b/src/graphics/render/Decorator.cpp
@@ -12,6 +12,7 @@
 #include "window/Camera.hpp"
 #include "objects/Player.hpp"
 #include "objects/Players.hpp"
+#include "objects/Entities.hpp"
 #include "logic/LevelController.hpp"
 #include "util/stringutil.hpp"
 #include "engine/Engine.hpp"
@@ -159,7 +160,11 @@ void Decorator::update(float delta, const Camera& camera) {
             renderer.texts->remove(textsIter->second);
             textsIter = playerTexts.erase(textsIter);
         } else {
-            note->setPosition(player->getPosition() + glm::vec3(0, 1, 0));
+            glm::vec3 position = player->getPosition();
+            if (auto entity = level.entities->get(player->getEntity())) {
+                position = entity->getInterpolatedPosition();
+            }
+            note->setPosition(position + glm::vec3(0, 1, 0));
             ++textsIter;
         }
     }
diff --git a/src/graphics/render/WorldRenderer.cpp b/src/graphics/render/WorldRenderer.cpp
index cefb61d5..4d36c286 100644
--- a/src/graphics/render/WorldRenderer.cpp
+++ b/src/graphics/render/WorldRenderer.cpp
@@ -274,8 +274,9 @@ void WorldRenderer::renderHands(
                  glm::mat4(1.0f), -glm::pi<float>() * 0.5f, glm::vec3(0, 1, 0)
              );
     prevRotation = rotation;
+    glm::vec3 cameraRotation = player.getRotation();
     auto offset = -(camera.position - player.getPosition());
-    float angle = glm::radians(player.rotation.x - 90);
+    float angle = glm::radians(cameraRotation.x - 90);
     float cos = glm::cos(angle);
     float sin = glm::sin(angle);
 
diff --git a/src/graphics/ui/GUI.cpp b/src/graphics/ui/GUI.cpp
index 4285179e..95d65540 100644
--- a/src/graphics/ui/GUI.cpp
+++ b/src/graphics/ui/GUI.cpp
@@ -166,7 +166,7 @@ void GUI::actFocused() {
         focus->keyPressed(key);
     }
 
-    if (!Events::_cursor_locked) {
+    if (!Events::isCursorLocked()) {
         if (Events::clicked(mousecode::BUTTON_1) && 
             (Events::jclicked(mousecode::BUTTON_1) || Events::delta.x || Events::delta.y))
         {
@@ -189,7 +189,7 @@ void GUI::act(float delta, const Viewport& vp) {
     auto prevfocus = focus;
 
     updateTooltip(delta);
-    if (!Events::_cursor_locked) {
+    if (!Events::isCursorLocked()) {
         actMouse(delta);
     } else {
         if (hover) {
diff --git a/src/graphics/ui/elements/Menu.cpp b/src/graphics/ui/elements/Menu.cpp
index 1756baec..da827489 100644
--- a/src/graphics/ui/elements/Menu.cpp
+++ b/src/graphics/ui/elements/Menu.cpp
@@ -91,6 +91,10 @@ Page& Menu::getCurrent() {
     return current;
 }
 
+bool Menu::hasOpenPage() const {
+    return current.panel != nullptr;
+}
+
 void Menu::clearHistory() {
     pageStack = std::stack<Page>();
 }
diff --git a/src/graphics/ui/elements/Menu.hpp b/src/graphics/ui/elements/Menu.hpp
index a6550907..478c985a 100644
--- a/src/graphics/ui/elements/Menu.hpp
+++ b/src/graphics/ui/elements/Menu.hpp
@@ -64,5 +64,7 @@ namespace gui {
     
         /// @brief Get current page
         Page& getCurrent();
+
+        bool hasOpenPage() const;
     };
 }
diff --git a/src/logic/LevelController.cpp b/src/logic/LevelController.cpp
index 5e537750..f99d7fd6 100644
--- a/src/logic/LevelController.cpp
+++ b/src/logic/LevelController.cpp
@@ -73,6 +73,7 @@ void LevelController::update(float delta, bool pause) {
         if (player->isSuspended()) {
             continue;
         }
+        player->rotationInterpolation.updateTimer(delta);
         player->updateEntity();
         glm::vec3 position = player->getPosition();
         player->chunks->configure(
diff --git a/src/logic/PlayerController.cpp b/src/logic/PlayerController.cpp
index eafb2e32..583eee66 100644
--- a/src/logic/PlayerController.cpp
+++ b/src/logic/PlayerController.cpp
@@ -54,7 +54,7 @@ void CameraControl::refresh() {
 }
 
 void CameraControl::updateMouse(PlayerInput& input) {
-    glm::vec3& rotation = player.rotation;
+    glm::vec3 rotation = player.getRotation();
 
     float sensitivity =
         (input.zoom ? settings.sensitivity.get() / 4.f
@@ -75,6 +75,8 @@ void CameraControl::updateMouse(PlayerInput& input) {
         rotation.x += 360.f;
     }
 
+    player.setRotation(rotation);
+
     camera->rotation = glm::mat4(1.0f);
     camera->rotate(
         glm::radians(rotation.y),
diff --git a/src/logic/scripting/lua/libs/lib__skeleton.cpp b/src/logic/scripting/lua/libs/lib__skeleton.cpp
index 1e0365b7..2cb9c44e 100644
--- a/src/logic/scripting/lua/libs/lib__skeleton.cpp
+++ b/src/logic/scripting/lua/libs/lib__skeleton.cpp
@@ -130,6 +130,22 @@ static int l_set_color(lua::State* L) {
     return 0;
 }
 
+static int l_is_interpolated(lua::State* L) {
+    if (auto entity = get_entity(L, 1)) {
+        auto& skeleton = entity->getSkeleton();
+        return lua::pushboolean(L, skeleton.interpolation.isEnabled());
+    }
+    return 0;
+}
+
+static int l_set_interpolated(lua::State* L) {
+    if (auto entity = get_entity(L, 1)) {
+        auto& skeleton = entity->getSkeleton();
+        skeleton.interpolation.setEnabled(lua::toboolean(L, 2));
+    }
+    return 0;
+}
+
 const luaL_Reg skeletonlib[] = {
     {"get_model", lua::wrap<l_get_model>},
     {"set_model", lua::wrap<l_set_model>},
@@ -142,4 +158,6 @@ const luaL_Reg skeletonlib[] = {
     {"set_visible", lua::wrap<l_set_visible>},
     {"get_color", lua::wrap<l_get_color>},
     {"set_color", lua::wrap<l_set_color>},
+    {"is_interpolated", lua::wrap<l_is_interpolated>},
+    {"set_interpolated", lua::wrap<l_set_interpolated>},
     {NULL, NULL}};
diff --git a/src/logic/scripting/lua/libs/libhud.cpp b/src/logic/scripting/lua/libs/libhud.cpp
index 642121cf..1c4245ba 100644
--- a/src/logic/scripting/lua/libs/libhud.cpp
+++ b/src/logic/scripting/lua/libs/libhud.cpp
@@ -170,6 +170,11 @@ static int l_set_debug_cheats(lua::State* L) {
     return 0;
 }
 
+static int l_set_allow_pause(lua::State* L) {
+    hud->setAllowPause(lua::toboolean(L, 1));
+    return 0;
+}
+
 const luaL_Reg hudlib[] = {
     {"open_inventory", lua::wrap<l_open_inventory>},
     {"close_inventory", lua::wrap<l_close_inventory>},
@@ -187,5 +192,6 @@ const luaL_Reg hudlib[] = {
     {"_is_content_access", lua::wrap<l_is_content_access>},
     {"_set_content_access", lua::wrap<l_set_content_access>},
     {"_set_debug_cheats", lua::wrap<l_set_debug_cheats>},
+    {"set_allow_pause", lua::wrap<l_set_allow_pause>},
     {NULL, NULL}
 };
diff --git a/src/logic/scripting/lua/libs/libplayer.cpp b/src/logic/scripting/lua/libs/libplayer.cpp
index c20d5ee5..12b78a97 100644
--- a/src/logic/scripting/lua/libs/libplayer.cpp
+++ b/src/logic/scripting/lua/libs/libplayer.cpp
@@ -61,7 +61,7 @@ static int l_set_vel(lua::State* L) {
 
 static int l_get_rot(lua::State* L) {
     if (auto player = get_player(L, 1)) {
-        return lua::pushvec_stack(L, player->rotation);
+        return lua::pushvec_stack(L, player->getRotation(lua::toboolean(L, 2)));
     }
     return 0;
 }
@@ -71,7 +71,7 @@ static int l_set_rot(lua::State* L) {
     if (!player) {
         return 0;
     }
-    glm::vec3& rotation = player->rotation;
+    glm::vec3 rotation = player->getRotation();
 
     auto x = lua::tonumber(L, 2);
     auto y = lua::tonumber(L, 3);
@@ -82,6 +82,7 @@ static int l_set_rot(lua::State* L) {
     rotation.x = x;
     rotation.y = y;
     rotation.z = z;
+    player->setRotation(rotation);
     return 0;
 }
 
diff --git a/src/objects/Entities.cpp b/src/objects/Entities.cpp
index 07b76585..32200cf8 100644
--- a/src/objects/Entities.cpp
+++ b/src/objects/Entities.cpp
@@ -38,6 +38,18 @@ void Transform::refresh() {
     dirty = false;
 }
 
+void Entity::setInterpolatedPosition(const glm::vec3& position) {
+    getSkeleton().interpolation.refresh(position);
+}
+
+glm::vec3 Entity::getInterpolatedPosition() const {
+    const auto& skeleton = getSkeleton();
+    if (skeleton.interpolation.isEnabled()) {
+        return skeleton.interpolation.getCurrent();
+    }
+    return getTransform().pos;
+}
+
 void Entity::destroy() {
     if (isValid()) {
         entities.despawn(id);
@@ -561,11 +573,14 @@ void Entities::render(
         if (transform.dirty) {
             transform.refresh();
         }
+        if (skeleton.interpolation.isEnabled()) {
+            skeleton.interpolation.updateTimer(delta);
+        }
         const auto& pos = transform.pos;
         const auto& size = transform.size;
         if (!frustum || frustum->isBoxVisible(pos - size, pos + size)) {
             const auto* rigConfig = skeleton.config;
-            rigConfig->render(assets, batch, skeleton, transform.combined);
+            rigConfig->render(assets, batch, skeleton, transform.combined, pos);
         }
     }
 }
diff --git a/src/objects/Entities.hpp b/src/objects/Entities.hpp
index 3d183014..6518b599 100644
--- a/src/objects/Entities.hpp
+++ b/src/objects/Entities.hpp
@@ -170,6 +170,10 @@ public:
         registry.get<EntityId>(entity).player = id;
     }
 
+    void setInterpolatedPosition(const glm::vec3& position);
+
+    glm::vec3 getInterpolatedPosition() const;
+
     void destroy();
 };
 
diff --git a/src/objects/Player.cpp b/src/objects/Player.cpp
index 38fdbc30..777fd8ed 100644
--- a/src/objects/Player.cpp
+++ b/src/objects/Player.cpp
@@ -181,6 +181,7 @@ void Player::teleport(glm::vec3 position) {
     if (auto entity = level.entities->get(eid)) {
         entity->getRigidbody().hitbox.position = position;
         entity->getTransform().setPos(position);
+        entity->setInterpolatedPosition(position);
     }
 }
 
@@ -296,6 +297,18 @@ glm::vec3 Player::getSpawnPoint() const {
     return spawnpoint;
 }
 
+glm::vec3 Player::getRotation(bool interpolated) const {
+    if (interpolated) {
+        return rotationInterpolation.getCurrent();
+    }
+    return rotation;
+}
+
+void Player::setRotation(const glm::vec3& rotation) {
+    this->rotation = rotation;
+    rotationInterpolation.refresh(rotation);
+}
+
 dv::value Player::serialize() const {
     auto root = dv::object();
 
diff --git a/src/objects/Player.hpp b/src/objects/Player.hpp
index 8caf7a63..b695c75e 100644
--- a/src/objects/Player.hpp
+++ b/src/objects/Player.hpp
@@ -7,6 +7,7 @@
 #include "interfaces/Serializable.hpp"
 #include "settings.hpp"
 #include "voxels/voxel.hpp"
+#include "util/Interpolation.hpp"
 
 class Chunks;
 class Camera;
@@ -55,11 +56,15 @@ class Player : public Serializable {
     bool loadingChunks = true;
     entityid_t eid;
     entityid_t selectedEid = 0;
+
+    glm::vec3 rotation {};
 public:
+    util::VecInterpolation<3, float, true> rotationInterpolation {true};
+
     std::unique_ptr<Chunks> chunks;
     std::shared_ptr<Camera> fpCamera, spCamera, tpCamera;
     std::shared_ptr<Camera> currentCamera;
-    glm::vec3 rotation {};
+    
     CursorSelection selection {};
 
     Player(
@@ -123,6 +128,9 @@ public:
     void setSpawnPoint(glm::vec3 point);
     glm::vec3 getSpawnPoint() const;
 
+    glm::vec3 getRotation(bool interpolated=false) const;
+    void setRotation(const glm::vec3& rotation);
+
     dv::value serialize() const override;
     void deserialize(const dv::value& src) override;
 
diff --git a/src/objects/rigging.cpp b/src/objects/rigging.cpp
index b08b8441..69ec5ce1 100644
--- a/src/objects/rigging.cpp
+++ b/src/objects/rigging.cpp
@@ -6,9 +6,8 @@
 #include "graphics/commons/Model.hpp"
 #include "graphics/render/ModelBatch.hpp"
 
-#define GLM_ENABLE_EXPERIMENTAL
 #include <glm/ext/matrix_transform.hpp>
-#include <glm/gtx/norm.hpp>
+#include <glm/gtx/matrix_decompose.hpp>
 
 using namespace rigging;
 
@@ -69,7 +68,7 @@ SkeletonConfig::SkeletonConfig(
 }
 
 size_t SkeletonConfig::update(
-    size_t index, Skeleton& skeleton, Bone* node, glm::mat4 matrix
+    size_t index, Skeleton& skeleton, Bone* node, const glm::mat4& matrix
 ) const {
     auto boneMatrix = skeleton.pose.matrices[index];
     auto boneOffset = node->getOffset();
@@ -90,17 +89,32 @@ size_t SkeletonConfig::update(
     return count;
 }
 
-void SkeletonConfig::update(Skeleton& skeleton, glm::mat4 matrix) const {
-    update(0, skeleton, root.get(), matrix);
+void SkeletonConfig::update(
+    Skeleton& skeleton, const glm::mat4& matrix, const glm::vec3& position
+) const {
+    if (skeleton.interpolation.isEnabled()) {
+        const auto& interpolation = skeleton.interpolation;
+        glm::vec3 scale, translation, skew;
+        glm::quat rotation;
+        glm::vec4 perspective;
+        glm::decompose(matrix, scale, rotation, translation, skew, perspective);
+
+        auto delta = interpolation.getCurrent() - position;
+        auto interpolatedMatrix = glm::translate(matrix, delta);
+        update(0, skeleton, root.get(), interpolatedMatrix);
+    } else {
+        update(0, skeleton, root.get(), matrix);
+    }
 }
 
 void SkeletonConfig::render(
     const Assets& assets,
     ModelBatch& batch,
     Skeleton& skeleton,
-    const glm::mat4& matrix
+    const glm::mat4& matrix,
+    const glm::vec3& position
 ) const {
-    update(skeleton, matrix);
+    update(skeleton, matrix, position);
 
     if (!skeleton.visible) {
         return;
diff --git a/src/objects/rigging.hpp b/src/objects/rigging.hpp
index de083f9b..2c326a4a 100644
--- a/src/objects/rigging.hpp
+++ b/src/objects/rigging.hpp
@@ -1,12 +1,15 @@
 #pragma once
 
-#include <glm/glm.hpp>
+#define GLM_ENABLE_EXPERIMENTAL
+#include <glm/gtx/norm.hpp>
 #include <memory>
 #include <string>
+#include <cmath>
 #include <unordered_map>
 #include <vector>
 
 #include "typedefs.hpp"
+#include "util/Interpolation.hpp"
 
 class Assets;
 class ModelBatch;
@@ -83,6 +86,8 @@ namespace rigging {
         bool visible;
         glm::vec3 tint {1.0f, 1.0f, 1.0f};
 
+        util::VecInterpolation<3, float> interpolation {false};
+
         Skeleton(const SkeletonConfig* config);
     };
 
@@ -100,7 +105,7 @@ namespace rigging {
         std::vector<Bone*> nodes;
 
         size_t update(
-            size_t index, Skeleton& skeleton, Bone* node, glm::mat4 matrix
+            size_t index, Skeleton& skeleton, Bone* node, const glm::mat4& matrix
         ) const;
     public:
         SkeletonConfig(
@@ -109,12 +114,18 @@ namespace rigging {
             size_t nodesCount
         );
 
-        void update(Skeleton& skeleton, glm::mat4 matrix) const;
+        void update(
+            Skeleton& skeleton,
+            const glm::mat4& matrix,
+            const glm::vec3& position
+        ) const;
+
         void render(
             const Assets& assets,
             ModelBatch& batch,
             Skeleton& skeleton,
-            const glm::mat4& matrix
+            const glm::mat4& matrix,
+            const glm::vec3& position
         ) const;
 
         Skeleton instance() const {
diff --git a/src/util/Interpolation.hpp b/src/util/Interpolation.hpp
new file mode 100644
index 00000000..d0f62a00
--- /dev/null
+++ b/src/util/Interpolation.hpp
@@ -0,0 +1,60 @@
+#pragma once
+
+#include <limits>
+#include <glm/glm.hpp>
+
+namespace util {
+    template<int N, typename T, bool angular=false>
+    class VecInterpolation {
+        bool enabled;
+        glm::vec<N, T> prevPos {std::numeric_limits<T>::quiet_NaN()};
+        glm::vec<N, T> nextPos {};
+        T refreshInterval = 0.0;
+        T timer = 0.0;
+        T intervalUpdateFactor = 0.1;
+    public:
+        VecInterpolation(bool enabled) : enabled(enabled) {}
+
+        void refresh(const glm::vec<N, T>& position) {
+            auto current = getCurrent();
+            prevPos = current;
+            nextPos = position;
+            refreshInterval = timer * intervalUpdateFactor +
+                              refreshInterval * (1.0 - intervalUpdateFactor);
+            timer = 0.0;
+
+            if constexpr (angular) {
+                for (int i = 0; i < N; i++) {
+                    T diff = nextPos[i] - prevPos[i];
+                    if (glm::abs(diff) > 180.0f) {
+                        nextPos[i] += (diff > 0.0f ? -360.0f : 360.0f);
+                    }
+                }
+            }
+        }
+
+        void updateTimer(T delta) {
+            timer += delta;
+        }
+
+        glm::vec<N, T> getCurrent() const {
+            if (refreshInterval < 0.001 || std::isnan(prevPos.x)) {
+                return nextPos;
+            }
+            T t = timer / refreshInterval;
+            return nextPos * t + prevPos * (1.0f - t);
+        }
+
+        T getRefreshInterval() const {
+            return refreshInterval;
+        }
+
+        bool isEnabled() const {
+            return enabled;
+        }
+
+        void setEnabled(bool enabled) {
+            this->enabled = enabled;
+        }
+    };
+}
diff --git a/src/window/Events.cpp b/src/window/Events.cpp
index 1652e595..49cdf929 100644
--- a/src/window/Events.cpp
+++ b/src/window/Events.cpp
@@ -18,8 +18,8 @@ uint Events::currentFrame = 0;
 int Events::scroll = 0;
 glm::vec2 Events::delta = {};
 glm::vec2 Events::cursor = {};
-bool Events::cursor_drag = false;
-bool Events::_cursor_locked = false;
+bool Events::cursorDrag = false;
+bool Events::cursorLocked = false;
 std::vector<uint> Events::codepoints;
 std::vector<keycode> Events::pressedKeys;
 std::unordered_map<std::string, Binding> Events::bindings;
@@ -61,10 +61,10 @@ bool Events::jclicked(int button) {
 }
 
 void Events::toggleCursor() {
-    cursor_drag = false;
-    _cursor_locked = !_cursor_locked;
+    cursorDrag = false;
+    cursorLocked = !cursorLocked;
     Window::setCursorMode(
-        _cursor_locked ? GLFW_CURSOR_DISABLED : GLFW_CURSOR_NORMAL
+        cursorLocked ? GLFW_CURSOR_DISABLED : GLFW_CURSOR_NORMAL
     );
 }
 
@@ -170,11 +170,11 @@ void Events::setButton(int button, bool b) {
 }
 
 void Events::setPosition(float xpos, float ypos) {
-    if (Events::cursor_drag) {
+    if (Events::cursorDrag) {
         Events::delta.x += xpos - Events::cursor.x;
         Events::delta.y += ypos - Events::cursor.y;
     } else {
-        Events::cursor_drag = true;
+        Events::cursorDrag = true;
     }
     Events::cursor.x = xpos;
     Events::cursor.y = ypos;
@@ -249,3 +249,7 @@ void Events::enableBindings() {
         binding.enable = true;
     }
 }
+
+bool Events::isCursorLocked() {
+    return cursorLocked;
+}
diff --git a/src/window/Events.hpp b/src/window/Events.hpp
index 67ab111a..92a97ab0 100644
--- a/src/window/Events.hpp
+++ b/src/window/Events.hpp
@@ -19,12 +19,12 @@ class Events {
     static bool keys[KEYS_BUFFER_SIZE];
     static uint frames[KEYS_BUFFER_SIZE];
     static uint currentFrame;
-    static bool cursor_drag;
+    static bool cursorDrag;
+    static bool cursorLocked;
 public:
     static int scroll;
     static glm::vec2 delta;
     static glm::vec2 cursor;
-    static bool _cursor_locked;
     static std::vector<uint> codepoints;
     static std::vector<keycode> pressedKeys;
     static std::unordered_map<std::string, Binding> bindings;
@@ -65,4 +65,6 @@ public:
         BindType bindType
     );
     static void enableBindings();
+
+    static bool isCursorLocked();
 };
diff --git a/src/window/Window.cpp b/src/window/Window.cpp
index b4361fd0..0c1cccee 100644
--- a/src/window/Window.cpp
+++ b/src/window/Window.cpp
@@ -389,7 +389,9 @@ void Window::toggleFullscreen() {
     GLFWmonitor* monitor = glfwGetPrimaryMonitor();
     const GLFWvidmode* mode = glfwGetVideoMode(monitor);
 
-    if (Events::_cursor_locked) Events::toggleCursor();
+    if (Events::isCursorLocked()){
+        Events::toggleCursor();
+    }
 
     if (fullscreen) {
         glfwGetWindowPos(window, &posX, &posY);

From 17c4cd20547f2af797af57a1c7ddbf4b4c37c134 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 03:58:22 +0300
Subject: [PATCH 20/36] fix libbyteutil

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

diff --git a/src/logic/scripting/lua/libs/libbyteutil.cpp b/src/logic/scripting/lua/libs/libbyteutil.cpp
index a757712f..d2c13175 100644
--- a/src/logic/scripting/lua/libs/libbyteutil.cpp
+++ b/src/logic/scripting/lua/libs/libbyteutil.cpp
@@ -198,8 +198,8 @@ static int l_tpack(lua::State* L) {
 }
 
 const luaL_Reg byteutillib[] = {
-    {"pack", l_pack},
-    {"tpack", l_tpack},
-    {"unpack", l_unpack},
+    {"pack", lua::wrap<l_pack>},
+    {"tpack", lua::wrap<l_tpack>},
+    {"unpack", lua::wrap<l_unpack>},
     {NULL, NULL}
 };

From 01b4b6f19ac8c5eee709248e7f7a5d334a137938 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 19:03:12 +0300
Subject: [PATCH 21/36] update docs

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

diff --git a/doc/en/scripting/builtins/libhud.md b/doc/en/scripting/builtins/libhud.md
index 72b1a4ed..06766422 100644
--- a/doc/en/scripting/builtins/libhud.md
+++ b/doc/en/scripting/builtins/libhud.md
@@ -62,4 +62,7 @@ hud.is_paused() -> bool
 
 -- Returns true if inventory is open or overlay is shown.
 hud.is_inventory_open() -> bool
+
+-- Sets whether to allow pausing. If false, the pause menu will not pause the game.
+hud.set_allow_pause(flag: bool)
 ```
diff --git a/doc/en/scripting/builtins/libplayer.md b/doc/en/scripting/builtins/libplayer.md
index 041bf442..e235377a 100644
--- a/doc/en/scripting/builtins/libplayer.md
+++ b/doc/en/scripting/builtins/libplayer.md
@@ -37,10 +37,10 @@ player.set_vel(playerid: int, x: number, y: number, z: number)
 Sets x, y, z player linear velocity
 
 ```lua
-player.get_rot(playerid: int) -> number, number, number
+player.get_rot(playerid: int, interpolated: bool) -> number, number, number
 ```
 
-Returns x, y, z of camera rotation (radians)
+Returns x, y, z of camera rotation (radians). Interpolation is relevant in cases where the rotation refresh rate is lower than the frame rate.
 
 ```lua
 player.set_rot(playerid: int, x: number, y: number, z: number)
diff --git a/doc/ru/scripting/builtins/libhud.md b/doc/ru/scripting/builtins/libhud.md
index d43867ac..311542cb 100644
--- a/doc/ru/scripting/builtins/libhud.md
+++ b/doc/ru/scripting/builtins/libhud.md
@@ -65,4 +65,7 @@ hud.is_paused() -> bool
 
 -- Возвращает true если открыт инвентарь или оверлей.
 hud.is_inventory_open() -> bool
+
+-- Устанавливает разрешение на паузу. При значении false меню паузы не приостанавливает игру.
+hud.set_allow_pause(flag: bool)
 ```
diff --git a/doc/ru/scripting/builtins/libplayer.md b/doc/ru/scripting/builtins/libplayer.md
index a9662015..35dda747 100644
--- a/doc/ru/scripting/builtins/libplayer.md
+++ b/doc/ru/scripting/builtins/libplayer.md
@@ -37,10 +37,10 @@ player.set_vel(playerid: int, x: number, y: number, z: number)
 Устанавливает x, y, z линейной скорости игрока
 
 ```lua
-player.get_rot(playerid: int) -> number, number, number
+player.get_rot(playerid: int, interpolated: bool=false) -> number, number, number
 ```
 
-Возвращает x, y, z вращения камеры (в радианах)
+Возвращает x, y, z вращения камеры (в радианах). Интерполяция актуальна в случаях, когда частота обновления вращения ниже частоты кадров.
 
 ```lua
 player.set_rot(playerid: int, x: number, y: number, z: number)

From 3266204c0eddb3cef09d626865c84ee85eb2689c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 19:24:07 +0300
Subject: [PATCH 22/36] update doc/*/scripting/builtins/libapp.md

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

diff --git a/doc/en/scripting/builtins/libapp.md b/doc/en/scripting/builtins/libapp.md
index ffc4d923..3a8712c7 100644
--- a/doc/en/scripting/builtins/libapp.md
+++ b/doc/en/scripting/builtins/libapp.md
@@ -77,12 +77,14 @@ Checks if content is loaded.
 
 ```lua
 app.new_world(
-    -- world name
+    -- world name, empty string will create a nameless world
     name: str,
     -- generation seed
     seed: str,
     -- generator name
     generator: str
+    -- local player id
+    [optional] local_player: int=0
 )
 ```
 
diff --git a/doc/ru/scripting/builtins/libapp.md b/doc/ru/scripting/builtins/libapp.md
index c0f3b741..eb504d25 100644
--- a/doc/ru/scripting/builtins/libapp.md
+++ b/doc/ru/scripting/builtins/libapp.md
@@ -77,12 +77,14 @@ app.is_content_loaded() -> bool
 
 ```lua
 app.new_world(
-    -- название мира
+    -- название мира, пустая строка приведёт к созданию безымянного мира
     name: str,
     -- зерно генерации
     seed: str,
     -- название генератора
     generator: str
+    -- id локального игрока
+    [опционально] local_player: int=0
 )
 ```
 

From 47e8e4e71eb08f5b06f323d1801a3945b60535ed Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 21:15:25 +0300
Subject: [PATCH 23/36] remove extra 'todo'

---
 src/content/ContentReport.cpp | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/content/ContentReport.cpp b/src/content/ContentReport.cpp
index 605b822c..7de04be5 100644
--- a/src/content/ContentReport.cpp
+++ b/src/content/ContentReport.cpp
@@ -76,8 +76,7 @@ std::shared_ptr<ContentReport> ContentReport::create(
     }
 
     auto root = files::read_json(filename);
-    // TODO: remove default value 2 in 0.24
-    uint regionsVersion = 2U;
+    uint regionsVersion = 2U; // old worlds compatibility (pre 0.23)
     root.at("region-version").get(regionsVersion);
     auto& blocklist = root["blocks"];
     auto& itemlist = root["items"];

From 20bd7666cdcd1f16cc17bd66173b626c8b3e8dc7 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 21:30:18 +0300
Subject: [PATCH 24/36] add download/upload info to debug panel

---
 src/frontend/debug_panel.cpp | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/frontend/debug_panel.cpp b/src/frontend/debug_panel.cpp
index 936c3b2e..779597e1 100644
--- a/src/frontend/debug_panel.cpp
+++ b/src/frontend/debug_panel.cpp
@@ -13,6 +13,7 @@
 #include "graphics/render/ParticlesRenderer.hpp"
 #include "graphics/render/ChunksRenderer.hpp"
 #include "logic/scripting/scripting.hpp"
+#include "network/Network.hpp"
 #include "objects/Player.hpp"
 #include "objects/Players.hpp"
 #include "objects/Entities.hpp"
@@ -58,6 +59,10 @@ std::shared_ptr<UINode> create_debug_panel(
     static int fpsMax = fps;
     static std::wstring fpsString = L"";
 
+    static size_t lastTotalDownload = 0;
+    static size_t lastTotalUpload = 0;
+    static std::wstring netSpeedString = L"";
+
     panel->listenInterval(0.016f, [&engine]() {
         fps = 1.0f / engine.getTime().getDelta();
         fpsMin = std::min(fps, fpsMin);
@@ -69,6 +74,19 @@ std::shared_ptr<UINode> create_debug_panel(
         fpsMin = fps;
         fpsMax = fps;
     });
+
+    panel->listenInterval(1.0f, [&engine]() {
+        const auto& network = engine.getNetwork();
+        size_t totalDownload = network.getTotalDownload();
+        size_t totalUpload = network.getTotalUpload();
+        netSpeedString =
+            L"download: " + std::to_wstring(totalDownload - lastTotalDownload) +
+            L" B/s upload: " + std::to_wstring(totalUpload - lastTotalUpload) +
+            L" B/s";
+        lastTotalDownload = totalDownload;
+        lastTotalUpload = totalUpload;
+    });
+
     panel->add(create_label([]() { return L"fps: "+fpsString;}));
    
     panel->add(create_label([]() {
@@ -86,6 +104,7 @@ std::shared_ptr<UINode> create_debug_panel(
     panel->add(create_label([]() {
         return L"lua-stack: " + std::to_wstring(scripting::get_values_on_stack());
     }));
+    panel->add(create_label([]() { return netSpeedString; }));
     panel->add(create_label([&engine]() {
         auto& settings = engine.getSettings();
         bool culling = settings.graphics.frustumCulling.get();

From d2bbd82dbe9e1743a979e25460946175d48649c9 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Fri, 17 Jan 2025 23:43:44 +0300
Subject: [PATCH 25/36] add 'discardAll' parameter to socket:close(...)

---
 src/logic/scripting/lua/libs/libnetwork.cpp |  2 +-
 src/network/Network.cpp                     | 13 +++++++++----
 src/network/Network.hpp                     |  2 +-
 3 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/src/logic/scripting/lua/libs/libnetwork.cpp b/src/logic/scripting/lua/libs/libnetwork.cpp
index 304cf5c8..678d46f2 100644
--- a/src/logic/scripting/lua/libs/libnetwork.cpp
+++ b/src/logic/scripting/lua/libs/libnetwork.cpp
@@ -73,7 +73,7 @@ static int l_connect(lua::State* L) {
 static int l_close(lua::State* L) {
     u64id_t id = lua::tointeger(L, 1);
     if (auto connection = engine->getNetwork().getConnection(id)) {
-        connection->close();
+        connection->close(true);
     }
     return 0;
 }
diff --git a/src/network/Network.cpp b/src/network/Network.cpp
index 7a99b0c5..24cfe718 100644
--- a/src/network/Network.cpp
+++ b/src/network/Network.cpp
@@ -400,10 +400,15 @@ public:
         return readBatch.size();
     }
 
-    void close() override {
-        if (state != ConnectionState::CLOSED) {
-            shutdown(descriptor, 2);
-            closesocket(descriptor);
+    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();
diff --git a/src/network/Network.hpp b/src/network/Network.hpp
index 0cc0803c..83244094 100644
--- a/src/network/Network.hpp
+++ b/src/network/Network.hpp
@@ -49,7 +49,7 @@ namespace network {
         virtual void connect(runnable callback) = 0;
         virtual int recv(char* buffer, size_t length) = 0;
         virtual int send(const char* buffer, size_t length) = 0;
-        virtual void close() = 0;
+        virtual void close(bool discardAll=false) = 0;
         virtual int available() = 0;
 
         virtual size_t pullUpload() = 0;

From eaff5643a3a118bc68cbfada8ecfb3232f7c9301 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 03:46:42 +0300
Subject: [PATCH 26/36] add Bytearray support to lua::tovalue

---
 src/logic/scripting/lua/lua_util.cpp | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/logic/scripting/lua/lua_util.cpp b/src/logic/scripting/lua/lua_util.cpp
index d008cf45..23d13d7f 100644
--- a/src/logic/scripting/lua/lua_util.cpp
+++ b/src/logic/scripting/lua/lua_util.cpp
@@ -133,6 +133,13 @@ dv::value lua::tovalue(State* L, int idx) {
                 return map;
             }
         }
+        case LUA_TUSERDATA: {
+            if (auto bytes = touserdata<LuaBytearray>(L, idx)) {
+                const auto& data = bytes->data();
+                return std::make_shared<dv::objects::Bytes>(data.data(), data.size());
+            }
+            [[fallthrough]];
+        }
         default:
             throw std::runtime_error(
                 "lua type " + std::string(lua_typename(L, type)) +

From c9adbe80eaa6258b7f50f15fea071aafb23f2f49 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 04:25:32 +0300
Subject: [PATCH 27/36] add Bytearray support to world.set_chunk_data(...)

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

diff --git a/src/logic/scripting/lua/libs/libworld.cpp b/src/logic/scripting/lua/libs/libworld.cpp
index 5d936842..bbba422d 100644
--- a/src/logic/scripting/lua/libs/libworld.cpp
+++ b/src/logic/scripting/lua/libs/libworld.cpp
@@ -160,13 +160,13 @@ static void integrate_chunk_client(Chunk& chunk) {
 static int l_set_chunk_data(lua::State* L) {
     int x = static_cast<int>(lua::tointeger(L, 1));
     int z = static_cast<int>(lua::tointeger(L, 2));
-    auto buffer = lua::touserdata<lua::LuaBytearray>(L, 3);
+    auto buffer = lua::require_bytearray(L, 3);
     auto chunk = level->chunks->getChunk(x, z);
     if (chunk == nullptr) {
-        return 0;
+        return lua::pushboolean(L, false);
     }
     compressed_chunks::decode(
-        *chunk, buffer->data().data(), buffer->data().size()
+        *chunk, buffer.data(), buffer.size()
     );
     if (controller->getChunksController()->lighting == nullptr) {
         return lua::pushboolean(L, true);

From b0a8e8e001891f2ba18b263cce4a40c61522054c Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 05:06:22 +0300
Subject: [PATCH 28/36] add 'core:chat' event

---
 res/scripts/stdcmd.lua | 2 +-
 res/scripts/stdlib.lua | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/res/scripts/stdcmd.lua b/res/scripts/stdcmd.lua
index ccb65a71..95b37007 100644
--- a/res/scripts/stdcmd.lua
+++ b/res/scripts/stdcmd.lua
@@ -260,7 +260,7 @@ console.add_command(
     "chat text:str",
     "Send chat message",
     function (args, kwargs)
-        console.log("[you] "..args[1])
+        console.chat("[you] "..args[1])
     end
 )
 
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 0df1c387..30eee105 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -225,6 +225,11 @@ function console.log(...)
     log_element:paste(text)
 end
 
+function console.chat(...)
+    console.log(...)
+    events.emit("core:chat", ...)
+end
+
 function gui.template(name, params)
     local text = file.read(file.find("layouts/templates/"..name..".xml"))
     for k,v in pairs(params) do

From 72d2d9c879d70c05019657f23fa22630dcb52d32 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 05:14:06 +0300
Subject: [PATCH 29/36] move Document and RadioGroup implementation to
 core:gui_util

---
 res/modules/gui_util.lua | 53 +++++++++++++++++++++++++++++++++++++
 res/scripts/stdlib.lua   | 56 +++-------------------------------------
 2 files changed, 57 insertions(+), 52 deletions(-)

diff --git a/res/modules/gui_util.lua b/res/modules/gui_util.lua
index 877d4b01..31f542dd 100644
--- a/res/modules/gui_util.lua
+++ b/res/modules/gui_util.lua
@@ -51,4 +51,57 @@ function gui_util.reset_local()
     gui_util.local_dispatchers = {}
 end
 
+-- class designed for simple UI-nodes access via properties syntax
+local Element = {}
+function Element.new(docname, name)
+    return setmetatable({docname=docname, name=name}, {
+        __index=function(self, k)
+            return gui.getattr(self.docname, self.name, k)
+        end,
+        __newindex=function(self, k, v)
+            gui.setattr(self.docname, self.name, k, v)
+        end
+    })
+end
+
+-- the engine automatically creates an instance for every ui document (layout)
+local Document = {}
+function Document.new(docname)
+    return setmetatable({name=docname}, {
+        __index=function(self, k)
+            local elem = Element.new(self.name, k)
+            rawset(self, k, elem)
+            return elem
+        end
+    })
+end
+
+local RadioGroup = {}
+function RadioGroup:set(key)
+    if type(self) ~= 'table' then
+        error("called as non-OOP via '.', use radiogroup:set")
+    end
+    if self.current then
+        self.elements[self.current].enabled = true
+    end
+    self.elements[key].enabled = false
+    self.current = key
+    if self.callback then
+        self.callback(key)
+    end
+end
+function RadioGroup:__call(elements, onset, default)
+    local group = setmetatable({
+        elements=elements, 
+        callback=onset, 
+        current=nil
+    }, {__index=RadioGroup})
+    group:set(default)
+    return group
+end
+setmetatable(RadioGroup, RadioGroup)
+
+gui_util.Document = Document
+gui_util.RadioGroup = RadioGroup
+
 return gui_util
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 30eee105..85321eef 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -146,64 +146,16 @@ function events.emit(event, ...)
     return result
 end
 
--- class designed for simple UI-nodes access via properties syntax
-local Element = {}
-function Element.new(docname, name)
-    return setmetatable({docname=docname, name=name}, {
-        __index=function(self, k)
-            return gui.getattr(self.docname, self.name, k)
-        end,
-        __newindex=function(self, k, v)
-            gui.setattr(self.docname, self.name, k, v)
-        end
-    })
-end
+gui_util = require "core:gui_util"
 
--- the engine automatically creates an instance for every ui document (layout)
-Document = {}
-function Document.new(docname)
-    return setmetatable({name=docname}, {
-        __index=function(self, k)
-            local elem = Element.new(self.name, k)
-            rawset(self, k, elem)
-            return elem
-        end
-    })
-end
-
-local _RadioGroup = {}
-function _RadioGroup:set(key)
-    if type(self) ~= 'table' then
-        error("called as non-OOP via '.', use radiogroup:set")
-    end
-    if self.current then
-        self.elements[self.current].enabled = true
-    end
-    self.elements[key].enabled = false
-    self.current = key
-    if self.callback then
-        self.callback(key)
-    end
-end
-function _RadioGroup:__call(elements, onset, default)
-    local group = setmetatable({
-        elements=elements, 
-        callback=onset, 
-        current=nil
-    }, {__index=_RadioGroup})
-    group:set(default)
-    return group
-end
-setmetatable(_RadioGroup, _RadioGroup)
-RadioGroup = _RadioGroup
+Document = gui_util.Document
+RadioGroup = gui_util.RadioGroup
+__vc_page_loader = gui_util.load_page
 
 _GUI_ROOT = Document.new("core:root")
 _MENU = _GUI_ROOT.menu
 menu = _MENU
 
-gui_util = require "core:gui_util"
-__vc_page_loader = gui_util.load_page
-
 ---  Console library extension ---
 console.cheats = {}
 

From 8e8fed2aa2d1a7152ba87cf5e2f463e1a649ae31 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 05:15:17 +0300
Subject: [PATCH 30/36] move core:gui_util to core:internal/gui_util

---
 res/modules/{ => internal}/gui_util.lua | 0
 res/scripts/stdlib.lua                  | 2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename res/modules/{ => internal}/gui_util.lua (100%)

diff --git a/res/modules/gui_util.lua b/res/modules/internal/gui_util.lua
similarity index 100%
rename from res/modules/gui_util.lua
rename to res/modules/internal/gui_util.lua
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index 85321eef..d9190bce 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -146,7 +146,7 @@ function events.emit(event, ...)
     return result
 end
 
-gui_util = require "core:gui_util"
+gui_util = require "core:internal/gui_util"
 
 Document = gui_util.Document
 RadioGroup = gui_util.RadioGroup

From 0ce5e23a2a5c684d48ca19a8f8706f85b2edd020 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 05:55:02 +0300
Subject: [PATCH 31/36] add 'min-length' panel property

---
 doc/en/xml-ui-layouts.md            |  1 +
 doc/ru/xml-ui-layouts.md            |  1 +
 src/graphics/ui/elements/Panel.cpp  | 14 ++++++++++++--
 src/graphics/ui/elements/Panel.hpp  |  4 ++++
 src/graphics/ui/elements/UINode.cpp |  6 +++---
 src/graphics/ui/gui_xml.cpp         |  3 +++
 6 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/doc/en/xml-ui-layouts.md b/doc/en/xml-ui-layouts.md
index 3f0bff07..d6bab384 100644
--- a/doc/en/xml-ui-layouts.md
+++ b/doc/en/xml-ui-layouts.md
@@ -65,6 +65,7 @@ Buttons and panels are also containers.
 Buttons are also panels.
 
 - `max-length` - maximal length of panel stretching before scrolling (if scrollable = true). Type: number
+- `min-length` - minimal length of panel. Type: number
 - `orientation` - panel orientation: horizontal/vertical.
 
 # Common elements
diff --git a/doc/ru/xml-ui-layouts.md b/doc/ru/xml-ui-layouts.md
index f562ee4c..cbcbbf7c 100644
--- a/doc/ru/xml-ui-layouts.md
+++ b/doc/ru/xml-ui-layouts.md
@@ -67,6 +67,7 @@
 
 В число панелей также входят кнопки.
 - `max-length` - максимальная длина, на которую растягивается панель до начала скроллинга (если scrollable = true). Тип: число
+- `min-length` - минимальная длина панели. Тип: число
 - `orientation` - ориентация панели: horizontal/vertical.
 
 # Основные элементы
diff --git a/src/graphics/ui/elements/Panel.cpp b/src/graphics/ui/elements/Panel.cpp
index af4a0de3..7bbc4231 100644
--- a/src/graphics/ui/elements/Panel.cpp
+++ b/src/graphics/ui/elements/Panel.cpp
@@ -23,6 +23,14 @@ int Panel::getMaxLength() const {
     return maxLength;
 }
 
+void Panel::setMinLength(int value) {
+    minLength = value;
+}
+
+int Panel::getMinLength() const {
+    return minLength;
+}
+
 void Panel::setPadding(glm::vec4 padding) {
     this->padding = padding;
     refresh();
@@ -34,9 +42,11 @@ glm::vec4 Panel::getPadding() const {
 
 void Panel::cropToContent() {
     if (maxLength > 0.0f) {
-        setSize(glm::vec2(getSize().x, glm::min(maxLength, actualLength)));
+        setSize(glm::vec2(
+            getSize().x, glm::max(minLength, glm::min(maxLength, actualLength))
+        ));
     } else {
-        setSize(glm::vec2(getSize().x, actualLength));
+        setSize(glm::vec2(getSize().x, glm::max(minLength, actualLength)));
     }
 }
 
diff --git a/src/graphics/ui/elements/Panel.hpp b/src/graphics/ui/elements/Panel.hpp
index d3d60c30..7e9759dd 100644
--- a/src/graphics/ui/elements/Panel.hpp
+++ b/src/graphics/ui/elements/Panel.hpp
@@ -9,6 +9,7 @@ namespace gui {
         Orientation orientation = Orientation::vertical;
         glm::vec4 padding {2.0f};
         float interval = 2.0f;
+        int minLength = 0;
         int maxLength = 0;
     public:
         Panel(
@@ -31,6 +32,9 @@ namespace gui {
         virtual void setMaxLength(int value);
         int getMaxLength() const;
 
+        virtual void setMinLength(int value);
+        int getMinLength() const;
+
         virtual void setPadding(glm::vec4 padding);
         glm::vec4 getPadding() const;
     };
diff --git a/src/graphics/ui/elements/UINode.cpp b/src/graphics/ui/elements/UINode.cpp
index a6fa38c2..ccb427e7 100644
--- a/src/graphics/ui/elements/UINode.cpp
+++ b/src/graphics/ui/elements/UINode.cpp
@@ -289,12 +289,12 @@ const std::string& UINode::getId() const {
 }
 
 void UINode::reposition() {
-    if (positionfunc) {
-        setPos(positionfunc());
-    }
     if (sizefunc) {
         setSize(sizefunc());
     }
+    if (positionfunc) {
+        setPos(positionfunc());
+    }
 }
 
 void UINode::setGravity(Gravity gravity) {
diff --git a/src/graphics/ui/gui_xml.cpp b/src/graphics/ui/gui_xml.cpp
index c705d16d..302b89fe 100644
--- a/src/graphics/ui/gui_xml.cpp
+++ b/src/graphics/ui/gui_xml.cpp
@@ -220,6 +220,9 @@ static void _readPanel(UiXmlReader& reader, const xml::xmlelement& element, Pane
     if (element.has("max-length")) {
         panel.setMaxLength(element.attr("max-length").asInt());
     }
+    if (element.has("min-length")) {
+        panel.setMinLength(element.attr("min-length").asInt());
+    }
     if (element.has("orientation")) {
         auto &oname = element.attr("orientation").getText();
         if (oname == "horizontal") {

From 209490192c0e996420f1e03907173642628345c0 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 06:37:27 +0300
Subject: [PATCH 32/36] add 'min-size' ui property

---
 doc/en/xml-ui-layouts.md            | 1 +
 doc/ru/xml-ui-layouts.md            | 1 +
 src/graphics/ui/elements/UINode.cpp | 6 +++++-
 src/graphics/ui/gui_xml.cpp         | 3 +++
 4 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/doc/en/xml-ui-layouts.md b/doc/en/xml-ui-layouts.md
index d6bab384..8856338a 100644
--- a/doc/en/xml-ui-layouts.md
+++ b/doc/en/xml-ui-layouts.md
@@ -35,6 +35,7 @@ Examples:
 - `margin` - element margin. Type: 4D vector
   *left, top, right, bottom*
 - `visible` - element visibility. Type: boolean (true/false)
+- `min-size` - minimal element size. Type: 2D vector.
 - `position-func` - position supplier for an element (two numbers), called on every parent container size update or on element adding on a container. May be called before *on_hud_open*
 - `size-func` - element size provider (two numbers), called when the size of the container in which the element is located changes, or when an element is added to the container. Can be called before on_hud_open is called.
 - `onclick` - lua function called when an element is clicked.
diff --git a/doc/ru/xml-ui-layouts.md b/doc/ru/xml-ui-layouts.md
index cbcbbf7c..00db0754 100644
--- a/doc/ru/xml-ui-layouts.md
+++ b/doc/ru/xml-ui-layouts.md
@@ -39,6 +39,7 @@
 - `margin` - внешний отступ элемента. Тип: 4D вектор. 
     Порядок: `"left,top,right,bottom"`
 - `visible` - видимость элемента. Тип: логический ("true"/"false").
+- `min-size` - минимальный размер элемента. Тип: 2D вектор.
 - `position-func` - поставщик позиции элемента (два числа), вызываемый при изменении размера контейнера, в котором находится элемент, либо при добавлении элемента в контейнер. Может быть вызван до вызова on_hud_open.
 - `size-func` - поставщик размера элемента (два числа), вызываемый при изменении размера контейнера, в котором находится элемент, либо при добавлении элемента в контейнер. Может быть вызван до вызова on_hud_open.
 - `onclick` - lua функция вызываемая при нажатии на элемент.
diff --git a/src/graphics/ui/elements/UINode.cpp b/src/graphics/ui/elements/UINode.cpp
index ccb427e7..4ebe8c7a 100644
--- a/src/graphics/ui/elements/UINode.cpp
+++ b/src/graphics/ui/elements/UINode.cpp
@@ -290,7 +290,11 @@ const std::string& UINode::getId() const {
 
 void UINode::reposition() {
     if (sizefunc) {
-        setSize(sizefunc());
+        auto newSize = sizefunc();
+        setSize(
+            {newSize.x < 0 ? size.x : newSize.x,
+             newSize.y < 0 ? size.y : newSize.y}
+        );
     }
     if (positionfunc) {
         setPos(positionfunc());
diff --git a/src/graphics/ui/gui_xml.cpp b/src/graphics/ui/gui_xml.cpp
index 302b89fe..972b118f 100644
--- a/src/graphics/ui/gui_xml.cpp
+++ b/src/graphics/ui/gui_xml.cpp
@@ -91,6 +91,9 @@ static void _readUINode(
     if (element.has("pos")) {
         node.setPos(element.attr("pos").asVec2());
     }
+    if (element.has("min-size")) {
+        node.setMinSize(element.attr("min-size").asVec2());
+    }
     if (element.has("size")) {
         node.setSize(element.attr("size").asVec2());
     }

From 731c72da7c8d8b621f58ffeba6634401c6af1494 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 07:16:57 +0300
Subject: [PATCH 33/36] add 'uinode:reposition()'

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

diff --git a/src/logic/scripting/lua/libs/libgui.cpp b/src/logic/scripting/lua/libs/libgui.cpp
index 48cf73cf..2947d80c 100644
--- a/src/logic/scripting/lua/libs/libgui.cpp
+++ b/src/logic/scripting/lua/libs/libgui.cpp
@@ -101,6 +101,12 @@ static int l_node_destruct(lua::State* L) {
     return 0;
 }
 
+static int l_node_reposition(lua::State* L) {
+    auto docnode = get_document_node(L);
+    docnode.node->reposition();
+    return 0;
+}
+
 static int l_container_clear(lua::State* L) {
     auto node = get_document_node(L, 1);
     if (auto container = std::dynamic_pointer_cast<Container>(node.node)) {
@@ -328,6 +334,10 @@ static int p_get_destruct(UINode*, lua::State* L) {
     return lua::pushcfunction(L, lua::wrap<l_node_destruct>);
 }
 
+static int p_get_reposition(UINode*, lua::State* L) {
+    return lua::pushcfunction(L, lua::wrap<l_node_reposition>);
+}
+
 static int p_get_clear(UINode* node, lua::State* L) {
     if (dynamic_cast<Container*>(node)) {
         return lua::pushcfunction(L, lua::wrap<l_container_clear>);
@@ -424,6 +434,7 @@ static int l_gui_getattr(lua::State* L) {
             {"moveInto", p_move_into},
             {"add", p_get_add},
             {"destruct", p_get_destruct},
+            {"reposition", p_get_reposition},
             {"clear", p_get_clear},
             {"setInterval", p_set_interval},
             {"placeholder", p_get_placeholder},

From c6951e09651149463528bdffbc2cba4ea41de4a4 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 07:17:52 +0300
Subject: [PATCH 34/36] add in-game chat & update gui post-runnables timing &
 fix panel elements removal

---
 res/layouts/console.xml.lua         | 11 ++++++
 res/layouts/ingame_chat.xml         |  8 ++++
 res/layouts/ingame_chat.xml.lua     | 59 +++++++++++++++++++++++++++++
 res/layouts/templates/chat_line.xml |  3 ++
 res/modules/internal/gui_util.lua   |  2 +-
 res/scripts/stdlib.lua              |  1 +
 src/engine/Engine.cpp               |  1 +
 src/graphics/ui/GUI.cpp             | 14 ++++---
 src/graphics/ui/GUI.hpp             |  2 +
 src/graphics/ui/elements/Panel.cpp  |  5 +++
 src/graphics/ui/elements/Panel.hpp  |  1 +
 11 files changed, 100 insertions(+), 7 deletions(-)
 create mode 100644 res/layouts/ingame_chat.xml
 create mode 100644 res/layouts/ingame_chat.xml.lua
 create mode 100644 res/layouts/templates/chat_line.xml

diff --git a/res/layouts/console.xml.lua b/res/layouts/console.xml.lua
index 11d7bd14..7e41ddf6 100644
--- a/res/layouts/console.xml.lua
+++ b/res/layouts/console.xml.lua
@@ -134,6 +134,10 @@ function add_to_history(text)
 end
 
 function submit(text)
+    if #text == 0 then
+        document.prompt.focused = true
+        return
+    end
     text = text:trim()
     add_to_history(text)
 
@@ -204,4 +208,11 @@ function on_open(mode)
     elseif mode then
         modes:set(mode)
     end
+    hud.close("core:ingame_chat")
+end
+
+function on_close()
+    time.post_runnable(function()
+        hud.open_permanent("core:ingame_chat")
+    end)
 end
diff --git a/res/layouts/ingame_chat.xml b/res/layouts/ingame_chat.xml
new file mode 100644
index 00000000..45ad4749
--- /dev/null
+++ b/res/layouts/ingame_chat.xml
@@ -0,0 +1,8 @@
+<panel size="300,0" margin="0,0,0,70" max-length='300' min-length='0'
+       size-func="gui.get_viewport()[1]/2,-1"
+       padding="0"
+       min-size="0"
+       color="0"
+       interval="0"
+       gravity="bottom-left" interactive="false">
+</panel>
diff --git a/res/layouts/ingame_chat.xml.lua b/res/layouts/ingame_chat.xml.lua
new file mode 100644
index 00000000..5e08ac9d
--- /dev/null
+++ b/res/layouts/ingame_chat.xml.lua
@@ -0,0 +1,59 @@
+local lines = {}
+local dead_lines = {}
+local nextid = 0
+local timeout = 7
+local fadeout = 1
+local initialized = false
+local max_lines = 15
+local animation_fps = 30
+
+local function remove_line(line)
+    document[line[1]]:destruct()
+    time.post_runnable(function() document.root:reposition() end)
+end
+
+local function update_line(line, uptime)
+    local diff = uptime - line[2]
+    if diff > timeout then
+        remove_line(line)
+        table.insert(dead_lines, i)
+    elseif diff > timeout-fadeout then
+        local opacity = (timeout - diff) / fadeout
+        document[line[1]].color = {0, 0, 0, opacity * 80}
+        document[line[1].."L"].color = {255, 255, 255, opacity * 255}
+    end
+end
+
+events.on("core:chat", function(message)
+    local current_time = time.uptime()
+    local id = 'l'..tostring(nextid)
+    document.root:add(gui.template("chat_line", {id=id}))
+    document.root:reposition()
+    document[id.."L"].text = message
+    nextid = nextid + 1
+    if #lines == max_lines then
+        remove_line(lines[1])
+        table.remove(lines, 1)
+    end
+    table.insert(lines, {id, current_time})
+end)
+
+function on_open()
+    if not initialized then
+        initialized = true
+        
+        document.root:setInterval(1/animation_fps, function ()
+            local uptime = time.uptime()
+            for _, line in ipairs(lines) do
+                update_line(line, uptime)
+            end
+            if #dead_lines > 0 then
+                for i = #dead_lines, 1, -1 do
+                    local index = dead_lines[i]
+                    table.remove(lines, i)
+                end
+                dead_lines = {}
+            end
+        end)
+    end
+end
diff --git a/res/layouts/templates/chat_line.xml b/res/layouts/templates/chat_line.xml
new file mode 100644
index 00000000..b9939218
--- /dev/null
+++ b/res/layouts/templates/chat_line.xml
@@ -0,0 +1,3 @@
+<container id='%{id}' color="#00000050" size="-1,20">
+    <label pos='5' id='%{id}L' markup='md'/>
+</container>
diff --git a/res/modules/internal/gui_util.lua b/res/modules/internal/gui_util.lua
index 31f542dd..3cf84a33 100644
--- a/res/modules/internal/gui_util.lua
+++ b/res/modules/internal/gui_util.lua
@@ -95,7 +95,7 @@ function RadioGroup:__call(elements, onset, default)
         elements=elements, 
         callback=onset, 
         current=nil
-    }, {__index=RadioGroup})
+    }, {__index=self})
     group:set(default)
     return group
 end
diff --git a/res/scripts/stdlib.lua b/res/scripts/stdlib.lua
index d9190bce..78228254 100644
--- a/res/scripts/stdlib.lua
+++ b/res/scripts/stdlib.lua
@@ -351,6 +351,7 @@ function __vc_on_hud_open()
             hud.pause()
         end
     end)
+    hud.open_permanent("core:ingame_chat")
 end
 
 local RULES_FILE = "world:rules.toml"
diff --git a/src/engine/Engine.cpp b/src/engine/Engine.cpp
index 00382420..ce29e8c1 100644
--- a/src/engine/Engine.cpp
+++ b/src/engine/Engine.cpp
@@ -217,6 +217,7 @@ void Engine::renderFrame() {
     Viewport viewport(Window::width, Window::height);
     DrawContext ctx(nullptr, viewport, nullptr);
     gui->draw(ctx, *assets);
+    gui->postAct();
 }
 
 void Engine::saveSettings() {
diff --git a/src/graphics/ui/GUI.cpp b/src/graphics/ui/GUI.cpp
index 95d65540..2cc28024 100644
--- a/src/graphics/ui/GUI.cpp
+++ b/src/graphics/ui/GUI.cpp
@@ -178,12 +178,6 @@ void GUI::actFocused() {
 }
 
 void GUI::act(float delta, const Viewport& vp) {
-    while (!postRunnables.empty()) {
-        runnable callback = postRunnables.back();
-        postRunnables.pop();
-        callback();
-    }
-
     container->setSize(vp.size());
     container->act(delta);
     auto prevfocus = focus;
@@ -206,6 +200,14 @@ void GUI::act(float delta, const Viewport& vp) {
     }
 }
 
+void GUI::postAct() {
+    while (!postRunnables.empty()) {
+        runnable callback = postRunnables.back();
+        postRunnables.pop();
+        callback();
+    }
+}
+
 void GUI::draw(const DrawContext& pctx, const Assets& assets) {
     auto ctx = pctx.sub(batch2D.get());
 
diff --git a/src/graphics/ui/GUI.hpp b/src/graphics/ui/GUI.hpp
index f8cea3ef..cb6b037e 100644
--- a/src/graphics/ui/GUI.hpp
+++ b/src/graphics/ui/GUI.hpp
@@ -106,6 +106,8 @@ namespace gui {
         /// @param assets active assets storage
         void draw(const DrawContext& pctx, const Assets& assets);
 
+        void postAct();
+
         /// @brief Add element to the main container
         /// @param node UI element
         void add(std::shared_ptr<UINode> node);
diff --git a/src/graphics/ui/elements/Panel.cpp b/src/graphics/ui/elements/Panel.cpp
index 7bbc4231..d90b8830 100644
--- a/src/graphics/ui/elements/Panel.cpp
+++ b/src/graphics/ui/elements/Panel.cpp
@@ -62,6 +62,11 @@ void Panel::add(const std::shared_ptr<UINode> &node) {
     fullRefresh();
 }
 
+void Panel::remove(const std::shared_ptr<UINode> &node) {
+    Container::remove(node);
+    fullRefresh();
+}
+
 void Panel::refresh() {
     UINode::refresh();
     std::stable_sort(nodes.begin(), nodes.end(), [](auto a, auto b) {
diff --git a/src/graphics/ui/elements/Panel.hpp b/src/graphics/ui/elements/Panel.hpp
index 7e9759dd..5a6399ce 100644
--- a/src/graphics/ui/elements/Panel.hpp
+++ b/src/graphics/ui/elements/Panel.hpp
@@ -25,6 +25,7 @@ namespace gui {
         Orientation getOrientation() const;
 
         virtual void add(const std::shared_ptr<UINode>& node) override;
+        virtual void remove(const std::shared_ptr<UINode>& node) override;
 
         virtual void refresh() override;
         virtual void fullRefresh() override;

From 432dc386eaf20fa356cf9c287aee1029e1709edf Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 07:35:53 +0300
Subject: [PATCH 35/36] update doc/*/scripting/ui.md

---
 doc/en/scripting/ui.md | 1 +
 doc/ru/scripting/ui.md | 1 +
 2 files changed, 2 insertions(+)

diff --git a/doc/en/scripting/ui.md b/doc/en/scripting/ui.md
index 5013b448..f5bb8401 100644
--- a/doc/en/scripting/ui.md
+++ b/doc/en/scripting/ui.md
@@ -56,6 +56,7 @@ Common element methods:
 | ------------------- | ----------------------------------------------------------------------------------- |
 | moveInto(container) | moves the element to the specified container (the element is specified, not the id) |
 | destruct()          | removes element                                                                     |
+| reposition()        | updates the element position based on the `positionfunc`                            |
 
 ## Containers
 
diff --git a/doc/ru/scripting/ui.md b/doc/ru/scripting/ui.md
index 3c203d37..7e10a180 100644
--- a/doc/ru/scripting/ui.md
+++ b/doc/ru/scripting/ui.md
@@ -56,6 +56,7 @@ document["worlds-panel"]:clear()
 | ------------------- | ----------------------------------------------------------------------- |
 | moveInto(container) | перемещает элемент в указанный контейнер (указывается элемент, а не id) |
 | destruct()          | удаляет элемент                                                         |
+| reposition()        | обновляет позицию элемента на основе функции позиционирования           |
 
 ## Контейнеры
 

From 147cf5b417cb259d24c877d3d3f6c39ddfb491b4 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sat, 18 Jan 2025 07:39:17 +0300
Subject: [PATCH 36/36] fix in-game chat animation interval

---
 res/layouts/ingame_chat.xml.lua | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/res/layouts/ingame_chat.xml.lua b/res/layouts/ingame_chat.xml.lua
index 5e08ac9d..52f38ce7 100644
--- a/res/layouts/ingame_chat.xml.lua
+++ b/res/layouts/ingame_chat.xml.lua
@@ -42,7 +42,7 @@ function on_open()
     if not initialized then
         initialized = true
         
-        document.root:setInterval(1/animation_fps, function ()
+        document.root:setInterval(1/animation_fps * 1000, function ()
             local uptime = time.uptime()
             for _, line in ipairs(lines) do
                 update_line(line, uptime)