From 6bbc78098dfd15b353b2d1d28d37133f4fe3651d Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Sun, 2 Aug 2026 18:32:54 +0300
Subject: [PATCH] add app.is_instance_alive & rename app.terminate to
 app.terminate_instance

---
 doc/en/scripting/builtins/libapp.md     |  3 +++
 doc/ru/scripting/builtins/libapp.md     |  5 ++++-
 src/logic/scripting/lua/libs/libapp.cpp | 14 ++++++++++++--
 3 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/doc/en/scripting/builtins/libapp.md b/doc/en/scripting/builtins/libapp.md
index 35084d9bd..61be41d5d 100644
--- a/doc/en/scripting/builtins/libapp.md
+++ b/doc/en/scripting/builtins/libapp.md
@@ -204,6 +204,9 @@ app.start_background_instance(
     output_file: string | nil
 ) -> int
 
+-- Checks if the engine sub-instance is alive.
+app.is_instance_alive(handle: int) -> boolean
+
 -- Stops the engine sub-instance.
 -- Returns true if the instance was alive at the time of the call.
 app.terminate(handle: int) -> boolean
diff --git a/doc/ru/scripting/builtins/libapp.md b/doc/ru/scripting/builtins/libapp.md
index 920283ce3..bbdf5cd2f 100644
--- a/doc/ru/scripting/builtins/libapp.md
+++ b/doc/ru/scripting/builtins/libapp.md
@@ -156,7 +156,10 @@ app.start_background_instance(
     output_file: string | nil
 ) -> int
 
+-- Проверяет, жив ли под-экземпляр движка.
+app.is_instance_alive(handle: int) -> boolean
+
 -- Останавливает под-экземпляр движка.
 -- Возвращает true если экземпляр был жив в момент вызова.
-app.terminate(handle: int) -> boolean
+app.terminate_instance(handle: int) -> boolean
 ```
diff --git a/src/logic/scripting/lua/libs/libapp.cpp b/src/logic/scripting/lua/libs/libapp.cpp
index e86b6d88e..9157b33a6 100644
--- a/src/logic/scripting/lua/libs/libapp.cpp
+++ b/src/logic/scripting/lua/libs/libapp.cpp
@@ -425,7 +425,16 @@ static int l_start_background_instance(lua::State* L) {
     return lua::pushinteger(L, handle);
 }
 
-static int l_terminate(lua::State* L) {
+static int l_is_instance_alive(lua::State* L) {
+    int handle = lua::tointeger(L, 1);
+    if (handle < 0 || handle >= ::processes.size()) {
+        throw std::runtime_error("invalid process handle");
+    }
+    auto& process = ::processes[handle];
+    return lua::pushboolean(L, process && process->isActive());
+}
+
+static int l_terminate_instance(lua::State* L) {
     int handle = lua::tointeger(L, 1);
     if (handle < 0 || handle >= ::processes.size()) {
         throw std::runtime_error("invalid process handle");
@@ -472,6 +481,7 @@ const luaL_Reg applib[] = {
     {"create_memory_device", lua::wrap<l_create_memory_device>},
     {"start_debug_instance", lua::wrap<l_start_debug_instance>},
     {"start_background_instance", lua::wrap<l_start_background_instance>},
-    {"terminate", lua::wrap<l_terminate>},
+    {"is_instance_alive", lua::wrap<l_is_instance_alive>},
+    {"terminate_instance", lua::wrap<l_terminate_instance>},
     {nullptr, nullptr}
 };