luapanda patch

README.md

@@ -164,6 +164,16 @@ The original engine is used in S.T.A.L.K.E.R. Call of Pripyat game released by G
     * The step of zoom adjustment is more precise. Also, it's possible to adjust the step of zoom with the console command zoom_step_count [1.0, 10.0], this option is also applicable to the binoculars.
   * In the new version all implementations from fakelens.script have moved directly to the engine. fakelens.script remained as a layer between the engine and scopeRadii.script
 
+* Debug scripts with VSCode and LuaPanda, made by IXRay Platform
+  * Add `-luapanda` arguments when launching your game
+  * To use it, you need to install VSCode and LuaPanda extension: https://marketplace.visualstudio.com/items?itemName=stuartwang.luapanda
+  * Open your `gamedata/scripts` folder in VSCode
+  * Copy `.vscode` folder from the archive into your `gamedata/scripts` folder: https://github.com/themrdemonized/xray-monolith/tree/all-in-one-vs2022-wpo/gamedata/scripts/.vscode
+  * Return to VSCode, go to `Run and Debug` section and start debugging or press F5 key
+  * Open in-game console with `~` key and type `run_string attach_debugger()`. If you do everything correctly and engine is working properly too, you will get an entry breakpoint at `global.lua` file in VSCode.
+  * You have to re-enable the debugger every time you start a new game or load a save, so you have to type `run_string attach_debugger()` in console again.
+  * Debugger is working dynamically, so you can add/remove files from your VSCode folder and it will automatically update the list of files available for debugging.
+
 * All settings can be edited from the game options in "Modded Exes" tab
 ![image](http://puu.sh/JC40Y/9315119150.jpg)
 

gamedata/scripts/.vscode/launch.json

@@ -0,0 +1,19 @@
+
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "lua",
+            "request": "launch",
+            "name": "LuaPanda",
+            "description": "IX-Ray Lua Debug",
+            "cwd": "${workspaceFolder}",
+            "luaFileExtension": "script",
+            "connectionPort": 8818,
+            "stopOnEntry": true,
+            "useCHook": true,
+            "autoPathMode": true,
+            "updateTips": true
+        }
+    ]
+}

gamedata/scripts/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "Lua.diagnostics.disable": [
+        "undefined-global"
+    ]
+}

gamedata/scripts/_g_patches.script

@@ -666,3 +666,11 @@ _G.IsLauncher = function(o, c)
 	}
 	return c and launcher[c] or false
 end
+
+log = _G.log
+_G.log = function(str)
+	log(str)
+	if DebuggerMode then
+        LuaPanda.printToVSCode(str,1,2)
+    end
+end

gamedata/scripts/boot/debug.lua

@@ -0,0 +1,3 @@
+if string.find(command_line(), "-luapanda") then
+    require("luapanda")
+end

gamedata/scripts/boot/init.lua

@@ -12,6 +12,9 @@ require("boot.paths")
 -- Setup package.loaders machinery
 require("boot.loader")
 
+-- Setup luapanda
+require("boot.debug")
+
 -- Setup engine interface
 require("boot.function_object")
 

gamedata/scripts/init.lua

@@ -43,7 +43,9 @@ _LUA_G = _G
 --- Emplace an error-checked lua compiler with customizable environment
 _LOADSTRING = loadstring
 function loadstring(src, namespace_name, script_name)
-   print("* [lua] loading " .. namespace_name)
+   if namespace_name then
+      print("* [lua] loading " .. namespace_name)
+   end
 
    local f, err = _LOADSTRING(src, namespace_name)
    if not f then

gamedata/scripts/packages/lib/luapanda/init.lua

@@ -0,0 +1,44 @@
+require("luapanda.lua_panda")
+--// General
+jit.opt.start(2)
+
+string.gfind = string.gmatch
+math.mod = math.fmod
+
+--// LuaPandas
+DebuggerMode = false
+
+log('LuaPanda: Loading...')
+
+function debug_jit_off()
+    if DebuggerMode then
+        if jit then jit.off() end
+    end
+end
+
+function debug_jit_on()
+    if DebuggerMode then
+        if jit then jit.on() end
+    end
+end
+
+function attach_debugger()
+    if DebuggerMode then
+        log('LuaPanda: Disabling jit...')
+        debug_jit_off()
+        log('LuaPanda: Reconnecting')
+        LuaPanda.reConnect()
+        log('LuaPanda: reconnected')
+        debug_jit_on()
+        log('LuaPanda: Started')
+    else
+        log('LuaPanda: Disabling jit...')
+        debug_jit_off()
+        log('LuaPanda: Connecting')
+        LuaPanda.start("127.0.0.1", 8818)
+        log('LuaPanda: Connected')
+        DebuggerMode = true
+        debug_jit_on()
+        log('LuaPanda: Started')
+    end
+end