Merge latest into main

.gitignore

@@ -6,3 +6,4 @@ __pycache__
 /test_release/
 __test*
 *.bak
+check_lua_versions.sh

README.md

@@ -1,14 +1,10 @@
 
 <p align="center">
 <picture>
-    <source srcset="https://github.com/user-attachments/assets/5888846f-88b6-4a35-bf83-51e31cdfdcff" media="(prefers-color-scheme: light)">
-    <source srcset="https://github.com/user-attachments/assets/27af88d4-265f-4c58-83ef-d68cba14f1f9" media="(prefers-color-scheme: dark)">
-    <img alt="AlyxLib Logo" src="https://github.com/user-attachments/assets/27af88d4-265f-4c58-83ef-d68cba14f1f9" width="250">
+    <img alt="AlyxLib Logo" src="./assets/alyxlib_logo_256x256.png" width="128">
 </picture>
 </p>
 
-&nbsp;
-
 <div align="center">
 
 [![License](https://img.shields.io/badge/License-MIT-04663E)](#license)

deployment_manifest.json

@@ -0,0 +1,140 @@
+{
+  "Categories": {
+
+    "vscript": [
+      {
+        "type": "symlink",
+        "description": "AlyxLib library symlink",
+        "source": "{AlyxLib}/scripts/vscripts/alyxlib",
+        "destination": "{AddonContent}/scripts/vscripts/alyxlib",
+        "remove": true
+      },
+      {
+        "type": "symlink",
+        "description": "gameinit.lua symlink",
+        "source": "{AlyxLib}/scripts/vscripts/game/gameinit.lua",
+        "destination": "{AddonContent}/scripts/vscripts/game/gameinit.lua",
+        "remove": true
+      },
+      {
+        "type": "copy",
+        "description": "Addon main init.lua file",
+        "source": "{AlyxLib}/templates/script_init_main.txt",
+        "destination": "{AddonContent}/scripts/vscripts/{ModName}/init.lua"
+      },
+      {
+        "type": "template",
+        "description": "Workshop mod init file",
+        "source": "{AlyxLib}/templates/script_init_workshop.txt",
+        "destination": "{AddonContent}/scripts/vscripts/mods/init/0000000000.lua",
+        "replacements": "{ModName}",
+        "rules": [
+          {
+            "type": "FileNameDoesNotExist",
+            "target": "destination",
+            "value": "rx:^\\d+\\.lua$",
+            "description": "Possible workshop init file already exists so a new one will not be created."
+          }
+        ]
+      },
+      {
+        "type": "template",
+        "description": "Local mod init file",
+        "source": "{AlyxLib}/templates/script_init_local.txt",
+        "destination": "{AddonContent}/scripts/vscripts/mods/init/{AddonFolderName}.lua",
+        "replacements": "{ModName}"
+      },
+      {
+        "type": "symlink",
+        "description": "Scripts symlink in addon game folder",
+        "source": "{AddonContent}/scripts",
+        "destination": "{AddonGame}/scripts"
+      }
+    ],
+
+    "editor-vscode": [
+      {
+        "type": "symlink",
+        "description": "AlyxLib snippets symlink for VSCode",
+        "source": "{AlyxLib}/.vscode/alyxlib.code-snippets",
+        "destination": "{AddonContent}/.vscode/alyxlib.code-snippets"
+      },
+      {
+        "type": "symlink",
+        "description": "VScript snippets symlink for VSCode",
+        "source": "{AlyxLib}/.vscode/vlua_snippets.code-snippets",
+        "destination": "{AddonContent}/.vscode/vlua_snippets.code-snippets"
+      },
+      {
+        "type": "copy",
+        "description": "AlyxLib VSCode settings file",
+        "source": "{AlyxLib}/templates/vscode_settings.txt",
+        "destination": "{AddonContent}/.vscode/settings.json",
+        "rules": [
+          {
+            "type": "FileDoesNotExist",
+            "target": "destination",
+            "description": "VSCode settings file already exists, so it will not be replaced"
+          }
+        ]
+      }
+    ],
+
+    "panorama": [
+      {
+        "type": "symlink",
+        "description": "Panorama Lua integration symlink",
+        "source": "{AlyxLib}/panorama/scripts/custom_game/panorama_lua.js",
+        "destination": "{AddonContent}/panorama/scripts/custom_game/panorama_lua.js"
+      },
+      {
+        "type": "symlink",
+        "description": "Panorama code completion symlink",
+        "source": "{AlyxLib}/panorama/scripts/custom_game/panoramadoc.js",
+        "destination": "{AddonContent}/panorama/scripts/custom_game/panoramadoc.js"
+      }
+    ],
+
+    "sounds": [
+      {
+        "type": "copy",
+        "description": "Addon soundevents file",
+        "source": "{AlyxLib}/templates/soundevents.txt",
+        "destination": "{AddonContent}/soundevents/{AddonFolderName}_soundevents.vsndevts"
+      },
+      {
+        "type": "delete",
+        "description": "Delete default soundevents file",
+        "source": "{AddonContent}/soundevents/addon_template_soundevents.vsndevts",
+        "rules": [
+          {
+            "type": "Hash",
+            "value": "768e1cb207576e41b92718e0559f876095618a23f7a116a829a7b5d578591eeb",
+            "description": "Default soundevents file has been modified, so it won't be deleted"
+          }
+        ]
+      },
+
+      {
+        "type": "template",
+        "description": "Addon soundevents manifest file",
+        "source": "{AlyxLib}/templates/resource_manifest.txt",
+        "destination": "{AddonContent}/resourcemanifests/{AddonFolderName}_addon_resources.vrman",
+        "replacements": "{AddonFolderName}"
+      },
+      {
+        "type": "delete",
+        "description": "Delete default soundevents manifest file",
+        "source": "{AddonContent}/resourcemanifests/addon_template_addon_resources.vrman",
+        "rules": [
+          {
+            "type": "Hash",
+            "value": "495d7301afadbed3eece2d16250608b4e4c9529fd3d34a8f93fbf61479c6ab13",
+            "description": "Default soundevents manifest file has been modified, so it won't be deleted"
+          }
+        ]
+      }
+    ]
+
+  }
+}

panorama/layout/custom_game/alyxlib_debug_menu.xml

@@ -0,0 +1,85 @@
+<root>
+    <styles>
+        <include src="s2r://panorama/styles/game_menus/game_menu_main.vcss_c" />
+        <include src="s2r://panorama/styles/language_shared.vcss_c" />
+        <include src="s2r://panorama/styles/custom_game/alyxlib_debug_menu.vcss_c" />
+    </styles>
+    <scripts>
+        <include src="s2r://panorama/scripts/custom_game/panorama_lua.vjs_c" />
+        <include src="s2r://panorama/scripts/custom_game/alyxlib_debug_menu.vjs_c" />
+    </scripts>
+    <GameMenuPanel class="game_menu_root" onactivate="GameMenuNavigation_Cmd( 'GoTo Root' )">
+        <Panel class="base_container" id="layout_root">
+
+            <Panel class="vr_affordance_container">
+
+                <Panel id="vr_affordance_left" class="VRaffordance">
+                    <Panel id="vr_affordance_interior"/>
+                </Panel>
+                <Panel id="vr_affordance_right" class="VRaffordance">
+                    <Panel id="vr_affordance_interior"/>
+                </Panel>
+
+                <Panel id="background_panel" class="bg">
+                    <Panel class="header">
+                        <Label class="header" text="Debug Menu" />
+                    </Panel>
+                    <Panel class="empty_row" />
+                    <Panel class="row">
+                        <Panel id="CategoriesContainer" class="col_body">
+
+                            <!-- Close menu button -->
+                            <Button id="CloseMenuButton" onactivate="CloseMenu()">
+                                <Label class="button_label" text="Close Menu"/>
+                                <Image class="button_bullet" src="s2r://panorama/images/game_menu_ui/btn_bullet_child_page_png.vtex" />
+                            </Button>
+
+                            <!-- Cycle left -->
+                            <Panel id="CategoryCycler" class="cycle_item custom_cycle">
+                                <Button id="CycleCategoryLeftButton" class="CycleCategoryLeft" onactivate="CycleCategories(-1)">
+                                    <Panel class="cycle_image cycle_image_left"/>
+                                </Button>
+
+                                <!-- Category buttons are kept here -->
+                                <Panel id="CategoryBar" class="CategoryBar" />
+
+                                <!-- Cycle right -->
+                                <Button id="CycleCategoryRightButton" class="CycleCategoryRight" onactivate="CycleCategories(1)">
+                                    <Panel class="cycle_image cycle_image_right"/>
+                                </Button>
+                            </Panel>
+
+                            <!-- Category sub menu separator -->
+                            <Panel class="row_divider">
+                                <Panel class="button_label">
+                                    <Panel class="row_divider_line" />
+                                </Panel>
+                                <Panel class="button_bullet" />
+                            </Panel>
+
+                            <Button id="ScrollHelperUp" class="scroll_helper up">
+                                <Panel style="flow-children: right; horizontal-align: center;">
+                                    <Panel class="chevron_arrow" />
+                                    <Panel class="chevron_arrow" />
+                                    <Panel class="chevron_arrow" />
+                                </Panel>
+                            </Button>
+
+                            <!-- Individual submenus are added here at the end of CategoriesContainer -->
+
+                        </Panel>
+                    </Panel>
+                        <Button id="ScrollHelperDown" class="scroll_helper down">
+                            <Panel style="flow-children: right; horizontal-align: center;">
+                                <Panel class="chevron_arrow" />
+                                <Panel class="chevron_arrow" />
+                                <Panel class="chevron_arrow" />
+                            </Panel>
+                        </Button>
+                    <!-- <Panel class="empty_row" />
+                    <Panel class="empty_row_bottomR_corner" /> -->
+                </Panel>
+            </Panel>
+        </Panel>
+    </GameMenuPanel>
+</root>