From 32d74427e5f65def9558ec18ad323d6355c6f82b Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 14:52:05 +0200
Subject: [PATCH 01/15] chore: move SConstruct to repo root

---
 gdextension/SConstruct => SConstruct | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename gdextension/SConstruct => SConstruct (100%)

diff --git a/gdextension/SConstruct b/SConstruct
similarity index 100%
rename from gdextension/SConstruct
rename to SConstruct

From 6134d5130cb6235f6564a5e22fc5c668dfc1f5b5 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 15:01:50 +0200
Subject: [PATCH 02/15] update SConstruct to be used from repo root and add
 --project option

---
 .gitignore |  1 +
 SConstruct | 64 ++++++++++++++++++++++++++++++++++--------------------
 2 files changed, 42 insertions(+), 23 deletions(-)

diff --git a/.gitignore b/.gitignore
index 8fcda8a..b8dbf90 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,6 +2,7 @@
 demo/addons/
 demo/script_templates/
 icons/*.import
+godot-cpp
 
 # Godot auto generated files
 *.gen.*
diff --git a/SConstruct b/SConstruct
index 122f0be..9b11d95 100644
--- a/SConstruct
+++ b/SConstruct
@@ -2,6 +2,28 @@
 import os
 import sys
 
+# This is SConstruct file for building GDExtension variant using SCONS build system.
+# For module variant, see SCsub file.
+
+# For custom projects, you can customize output path for artifacts: scons --project=PATH_TO_YOUR_PROJECT
+# - artifacts are placed into "addons/limboai/bin" subdirectory inside the project directory.
+# - for example: scons --project="../my_project"
+#   - artifacts will be placed into "../my_project/addons/limboai/bin" relative to "limboai/" source dir.
+# - if not specified, the artifacts will be places in the demo/ project.
+# - For plugin to be loaded, create "addons/limboai/bin" directory in your project and copy limboai.gdextension file to it.
+
+AddOption(
+    "--project",
+    dest="project",
+    type="string",
+    nargs=1,
+    action="store",
+    metavar="DIR",
+    default="demo",
+    help="Specify project directory.",
+)
+project_dir = GetOption("project")
+
 env = SConscript("godot-cpp/SConstruct")
 
 # For reference:
@@ -13,48 +35,44 @@ env = SConscript("godot-cpp/SConstruct")
 # - LINKFLAGS are for linking flags
 
 # Generate version header.
-sys.path.append("./limboai")
 import limboai_version
 
-os.chdir("./limboai")
 limboai_version.generate_module_version_header()
-os.chdir("..")
-sys.path.remove("./limboai")
 
 # Tweak this if you want to use different folders, or more folders, to store your source code in.
-env.Append(CPPPATH=["limboai/"])
 env.Append(CPPDEFINES=["LIMBOAI_GDEXTENSION"])
-sources = Glob("limboai/*.cpp")
-sources += Glob("limboai/blackboard/*.cpp")
-sources += Glob("limboai/blackboard/bb_param/*.cpp")
-sources += Glob("limboai/bt/*.cpp")
-sources += Glob("limboai/bt/tasks/*.cpp")
-sources += Glob("limboai/bt/tasks/blackboard/*.cpp")
-sources += Glob("limboai/bt/tasks/composites/*.cpp")
-sources += Glob("limboai/bt/tasks/decorators/*.cpp")
-sources += Glob("limboai/bt/tasks/scene/*.cpp")
-sources += Glob("limboai/bt/tasks/utility/*.cpp")
-sources += Glob("limboai/gdextension/*.cpp")
-sources += Glob("limboai/editor/debugger/*.cpp")
-sources += Glob("limboai/editor/*.cpp")
-sources += Glob("limboai/hsm/*.cpp")
-sources += Glob("limboai/util/*.cpp")
+sources = Glob("*.cpp")
+sources += Glob("blackboard/*.cpp")
+sources += Glob("blackboard/bb_param/*.cpp")
+sources += Glob("bt/*.cpp")
+sources += Glob("bt/tasks/*.cpp")
+sources += Glob("bt/tasks/blackboard/*.cpp")
+sources += Glob("bt/tasks/composites/*.cpp")
+sources += Glob("bt/tasks/decorators/*.cpp")
+sources += Glob("bt/tasks/scene/*.cpp")
+sources += Glob("bt/tasks/utility/*.cpp")
+sources += Glob("gdextension/*.cpp")
+sources += Glob("editor/debugger/*.cpp")
+sources += Glob("editor/*.cpp")
+sources += Glob("hsm/*.cpp")
+sources += Glob("util/*.cpp")
 
 # Generate documentation header.
 if env["target"] in ["editor", "template_debug"]:
-    doc_data = env.GodotCPPDocData("limboai/gen/doc_data.gen.cpp", source=Glob("limboai/doc_classes/*.xml"))
+    doc_data = env.GodotCPPDocData("gen/doc_data.gen.cpp", source=Glob("doc_classes/*.xml"))
     sources.append(doc_data)
 
 if env["platform"] == "macos":
     library = env.SharedLibrary(
-        "demo/addons/limboai/bin/liblimboai.{}.{}.framework/liblimboai.{}.{}".format(
+        project_dir
+        + "/addons/limboai/bin/liblimboai.{}.{}.framework/liblimboai.{}.{}".format(
             env["platform"], env["target"], env["platform"], env["target"]
         ),
         source=sources,
     )
 else:
     library = env.SharedLibrary(
-        "demo/addons/limboai/bin/liblimboai{}{}".format(env["suffix"], env["SHLIBSUFFIX"]),
+        project_dir + "/addons/limboai/bin/liblimboai{}{}".format(env["suffix"], env["SHLIBSUFFIX"]),
         source=sources,
     )
 

From 650e381659f631da4a7811a4d53dbdb763a0c35c Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 15:15:59 +0200
Subject: [PATCH 03/15] update setup_gdextension.sh to work with new
 GDExtension project structure

---
 gdextension/setup_gdextension.sh | 79 +++++++++-----------------------
 1 file changed, 22 insertions(+), 57 deletions(-)

diff --git a/gdextension/setup_gdextension.sh b/gdextension/setup_gdextension.sh
index 4329e29..86550e0 100755
--- a/gdextension/setup_gdextension.sh
+++ b/gdextension/setup_gdextension.sh
@@ -1,27 +1,24 @@
 #!/bin/bash
 
-## This script creates project structure needed for LimboAI development using GDExtension.
-## Works only on Unix-likes. You can still use the directory layout below, if you are on Windows.
+## This script sets up limboai project for development with GDExtension.
+## It adds missing files to the demo project for development with GDExtension, and downloads godot-cpp.
+## Tested only on Unix-likes. You can perform similar steps manually, if you are on Windows. Check Overview below.
 ##
 ## Instructions:
-## 1) Create the project root directory, name doesn't matter.
-## 2) Inside the project root directory, clone the limboai repository:
+## 1) Clone the limboai repository:
 ##    git clone https://github.com/limbonaut/limboai
-## 3) From the project root directory, run:
-##    bash ./limboai/gdextension/setup_gdextension.sh
+## 2) From the limboai root directory, run:
+##    bash ./gdextension/setup_gdextension.sh
 ##
-## Directory layout:
-##   project/ -- call this script from here, directory name doesn't matter.
-##   project/limboai/ -- LimboAI repository should be here after you clone it.
-##   project/godot-cpp/ -- will be created by this script, unless cloned manually.
-##   project/demo/ -- symbolic link (leads to limboai/demo).
-##   project/demo/addons/limboai/limboai.gdextension -- symbolid link (leads to limboai/gdextension/limboai.gdextension).
-##   project/demo/addons/limboai/icons/ -- symbolic link (leads to icons/).
-##   project/SConstruct -- symbolic link (leads to limboai/gdextension/SContruct).
+## Overview:
+##   limboai/ -- LimboAI repository after you clone it - call this script from here.
+##   limboai/godot-cpp/ -- git repo that will be cloned by this script, unless already exists.
+##   limboai/demo/addons/limboai/limboai.gdextension -- symbolic link created (leads to limboai/gdextension/limboai.gdextension).
+##   limboai/demo/addons/limboai/icons/ -- symbolic link created (leads to limboai/icons/).
 ##
-##   Note: Symbolic links will be created by this script.
+##   Note: Script creates symbolic links unless --copy-all is set, in which case it copies the files.
 ##
-## Dependencies: bash, git, python3.
+## Dependencies: bash, git, python3, trash (optional).
 
 # Script Settings
 GODOT_CPP_VERSION=4.2
@@ -32,16 +29,16 @@ HIGHLIGHT_COLOR='\033[1;36m' # Light Cyan
 NC='\033[0m' # No Color
 ERROR_COLOR="\033[0;31m"  # Red
 
-usage() { echo "Usage: $0 [--copy-demo] [--copy-all] [--trash-old]"; }
+usage() { echo "Usage: $0 [--copy-all] [--trash-old]"; }
 
 msg () {  echo -e "$@"; }
 highlight() { echo -e "${HIGHLIGHT_COLOR}$@${NC}"; }
 error () { echo -e "${ERROR_COLOR}$@${NC}" >&2; }
 
-if [ ! -d "${PWD}/limboai/" ]; then
-    error Aborting: \"limboai\" subdirectory is not found.
-    msg Tip: Run this script from the project root directory with limboai repository cloned into \"limboai\" subdirectory.
-    msg Command: bash ./limboai/gdextension/setup_gdextension.sh
+if [ ! -d "${PWD}/demo/" ]; then
+    error Aborting: \"demo\" subdirectory is not found.
+    msg Tip: Run this script from the limboai root directory.
+    msg Command: bash ./gdextension/setup_gdextension.sh
     exit 1
 fi
 
@@ -50,7 +47,6 @@ trap exit SIGINT
 
 set -e
 
-copy_demo=0
 copy_all=0
 trash_old=0
 
@@ -58,10 +54,6 @@ trash_old=0
 for i in "$@"
 do
     case "${i}" in
-	--copy-demo)
-	    copy_demo=1
-	    shift
-	    ;;
 	--copy-all)
 	    copy_demo=1
 	    copy_all=1
@@ -80,7 +72,7 @@ done
 
 highlight Setup started.
 
-${PYTHON} limboai/gdextension/update_icons.py --silent
+${PYTHON} gdextension/update_icons.py --silent
 highlight -- Icon declarations updated.
 
 transfer="ln -s"
@@ -95,7 +87,7 @@ if [ ${trash_old} == 1 ]; then
         error trash command not available. Aborting.
         exit 1
     fi
-    trash SConstruct limboai/demo/addons demo || /bin/true
+    trash demo/addons/limboai || /bin/true
     highlight -- Trashed old setup.
 fi
 
@@ -107,33 +99,10 @@ else
     highlight -- Skipping \"godot-cpp\". Directory already exists!
 fi
 
-if [ ! -f "${PWD}/SConstruct" ]; then
-    ${transfer} limboai/gdextension/SConstruct SConstruct
-    highlight -- ${transfer_word} SConstruct.
-else
-    highlight -- Skipping \"SConstruct\". File already exists!
-fi
-
-if [ ! -e "${PWD}/demo" ]; then
-    if [ ${copy_demo} == 1 ]; then
-        cp -R limboai/demo demo
-        highlight -- Copied demo.
-    else
-        ln -s limboai/demo demo
-        highlight -- Linked demo project.
-    fi
-else
-    highlight -- Skipping \"demo\". File already exists!
-fi
-
 if [ ! -e "${PWD}/demo/addons/limboai/bin/limboai.gdextension" ]; then
     mkdir -p ./demo/addons/limboai/bin/
     cd ./demo/addons/limboai/bin/
-    if [ -f "../../../../gdextension/limboai.gdextension" ]; then
-        ${transfer} ../../../../gdextension/limboai.gdextension limboai.gdextension
-    else
-        ${transfer} ../../../../limboai/gdextension/limboai.gdextension limboai.gdextension
-    fi
+    ${transfer} ../../../../gdextension/limboai.gdextension limboai.gdextension
     cd -
     highlight -- ${transfer_word} limboai.gdextension.
 else
@@ -142,11 +111,7 @@ fi
 
 if [ ! -e "${PWD}/demo/addons/limboai/icons/" ]; then
     cd ./demo/addons/limboai/
-    if [ -d "../../../icons" ]; then
-        ${transfer} ../../../icons icons
-    else
-        ${transfer} ../../../limboai/icons icons
-    fi
+    ${transfer} ../../../icons icons
     cd -
     highlight -- ${transfer_word} icons.
 else

From 7b0d0aa779493ec6878fceec1526ce91c3e614c2 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 15:24:04 +0200
Subject: [PATCH 04/15] GHA: Update GDExtension workflow for new structure

---
 .github/actions/init-version-gdext/action.yml |  2 +-
 .github/workflows/gdextension.yml             | 25 +++++++++----------
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/.github/actions/init-version-gdext/action.yml b/.github/actions/init-version-gdext/action.yml
index ca39fd9..8cd29c5 100644
--- a/.github/actions/init-version-gdext/action.yml
+++ b/.github/actions/init-version-gdext/action.yml
@@ -15,7 +15,7 @@ runs:
 
         echo "GDEXTENSION_VERSION=${GDEXTENSION_VERSION}" >> "$GITHUB_ENV"
 
-        cd ../limboai
+        cd ..
         echo "LIMBOAI_VERSION=$( (git describe --tags --exact-match HEAD || git rev-parse --short HEAD) | sed 's/\(.*\)-\(.*\)/\1.\2/g' )" >> "$GITHUB_ENV"
 
     - name: Set NAME_PREFIX
diff --git a/.github/workflows/gdextension.yml b/.github/workflows/gdextension.yml
index e27e397..75543ee 100644
--- a/.github/workflows/gdextension.yml
+++ b/.github/workflows/gdextension.yml
@@ -167,6 +167,12 @@ jobs:
       BIN: liblimboai.${{matrix.opts.platform}}.${{matrix.opts.target}}.${{matrix.opts.arch}}
 
     steps:
+      - name: Clone LimboAI module
+        uses: actions/checkout@v4
+        with:
+          fetch-tags: true
+          ref: ${{ inputs.limboai-ref }}
+
       - name: Clone godot-cpp
         uses: actions/checkout@v4
         with:
@@ -175,15 +181,8 @@ jobs:
           path: godot-cpp
           ref: ${{ inputs.godot-cpp-ref }}
 
-      - name: Clone LimboAI module
-        uses: actions/checkout@v4
-        with:
-          path: limboai
-          fetch-tags: true
-          ref: ${{ inputs.limboai-ref }}
-
       # Inits GDEXTENSION_VERSION, LIMBOAI_VERSION and NAME_PREFIX environment variables.
-      - uses: ./limboai/.github/actions/init-version-gdext
+      - uses: ./.github/actions/init-version-gdext
 
       - name: Output NAME_PREFIX
         id: output-name-prefix
@@ -191,7 +190,7 @@ jobs:
 
       - name: Setup Linux toolchain
         if: matrix.opts.platform == 'linux'
-        uses: ./limboai/.github/actions/setup-linux-toolchain
+        uses: ./.github/actions/setup-linux-toolchain
         with:
           arch: ${{matrix.opts.arch}}
 
@@ -260,7 +259,7 @@ jobs:
       - name: Setup project structure for GDExtension
         shell: bash
         run: |
-          bash ./limboai/gdextension/setup_gdextension.sh --copy-all
+          bash ./gdextension/setup_gdextension.sh --copy-all
           echo "---"
           ls -l
           echo "---"
@@ -279,9 +278,9 @@ jobs:
         run: |
           mkdir out
           mv demo/addons/ out/
-          cp limboai/{README,LICENSE,LOGO_LICENSE}.md out/addons/limboai/
-          cp -R limboai/demo/demo/ out/demo/
-          cp limboai/demo/LICENSE_ASSETS.md out/demo/
+          cp {README,LICENSE,LOGO_LICENSE}.md out/addons/limboai/
+          cp -R demo/demo/ out/demo/
+          cp demo/LICENSE_ASSETS.md out/demo/
           rm -f out/addons/limboai/bin/*.{exp,lib,pdb}
           echo "${LIMBOAI_VERSION}" > out/addons/limboai/version.txt
           echo "---"

From d5becadd5976316320c16fe9aac43aa79f6b6a2e Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 16:07:38 +0200
Subject: [PATCH 05/15] Add script to fix icon imports in the demo project

---
 gdextension/fix_demo_imports.sh | 51 +++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100755 gdextension/fix_demo_imports.sh

diff --git a/gdextension/fix_demo_imports.sh b/gdextension/fix_demo_imports.sh
new file mode 100755
index 0000000..278605e
--- /dev/null
+++ b/gdextension/fix_demo_imports.sh
@@ -0,0 +1,51 @@
+#!/bin/bash
+
+## This script fixes icon imports in the demo project.
+## It enables scaling and color conversion for SVG icons in the demo project.
+##
+## Dependencies: bash, sed, find.
+
+# Colors
+HIGHLIGHT_COLOR='\033[1;36m' # Light Cyan
+NC='\033[0m' # No Color
+ERROR_COLOR="\033[0;31m"  # Red
+
+usage() { echo -e "Usage: $0 [--silent]\nRun from limboai root directory!"; }
+
+msg () {  echo -e "$@"; }
+highlight() { echo -e "${HIGHLIGHT_COLOR}$@${NC}"; }
+error () { echo -e "${ERROR_COLOR}$@${NC}" >&2; }
+
+# Exit if a command returns non-zero status.
+set -e
+
+if [ ! -d "${PWD}/demo/" ]; then
+    error Aborting: \"demo\" subdirectory is not found.
+    msg Tip: Run this script from the limboai root directory.
+    msg Command: bash ./gdextension/fix_demo_imports.sh
+    exit 1
+fi
+
+if test -z "$(find demo/addons/limboai/icons/ -maxdepth 1 -name '*.svg' -print -quit)"; then
+    error "No icons found in the demo project!"
+    msg Make sure to copy/link the icons into the demo project \(icons/ -\> demo/addons/limboai/icons/\).
+    exit 1
+fi
+
+if test -z "$(find demo/addons/limboai/icons/ -maxdepth 1 -name '*.import' -print -quit)"; then
+    error "No icon import files found!"
+    msg Make sure to open the demo project in Godot Editor before running this script.
+    exit 1
+fi
+
+highlight "--- Listing icons dir:"
+ls demo/addons/limboai/icons/
+highlight "---"
+
+highlight Applying scale settings...
+sed -i 's|editor/scale_with_editor_scale=false|editor/scale_with_editor_scale=true|' demo/addons/limboai/icons/*.import
+
+highlight Applying color conversion settings...
+sed -i 's|editor/convert_colors_with_editor_theme=false|editor/convert_colors_with_editor_theme=true|' demo/addons/limboai/icons/*.import
+
+highlight Done!

From 25287413334756696e328619a87d88c5630eddcb Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 17:11:51 +0200
Subject: [PATCH 06/15] Rename update_icons.py to update_icon_entries.py

---
 gdextension/setup_gdextension.sh                        | 2 +-
 gdextension/{update_icons.py => update_icon_entries.py} | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)
 rename gdextension/{update_icons.py => update_icon_entries.py} (92%)

diff --git a/gdextension/setup_gdextension.sh b/gdextension/setup_gdextension.sh
index 86550e0..c6c471d 100755
--- a/gdextension/setup_gdextension.sh
+++ b/gdextension/setup_gdextension.sh
@@ -72,7 +72,7 @@ done
 
 highlight Setup started.
 
-${PYTHON} gdextension/update_icons.py --silent
+${PYTHON} gdextension/update_icon_entries.py --silent
 highlight -- Icon declarations updated.
 
 transfer="ln -s"
diff --git a/gdextension/update_icons.py b/gdextension/update_icon_entries.py
similarity index 92%
rename from gdextension/update_icons.py
rename to gdextension/update_icon_entries.py
index a8dcf59..8af2b36 100755
--- a/gdextension/update_icons.py
+++ b/gdextension/update_icon_entries.py
@@ -1,7 +1,7 @@
 #!/usr/bin/python
 """
-Usage: update_icons.py [--silent]
-Update icon declarations in limboai.gdextension file.
+Usage: update_icon_entries.py [--silent]
+Update icon entries in limboai.gdextension file.
 
 Options:
   -s, --silent      Don't print anything.
@@ -79,7 +79,7 @@ def main():
 
     if not silent:
         print(content)
-        print("======= Icon declarations updated =======")
+        print("======= Icon entries updated =======")
 
 
 if __name__ == "__main__":

From 629062ea26d2f2c724f379be095d31e26ba9e96f Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 17:19:51 +0200
Subject: [PATCH 07/15] Update icon entries during scons build

---
 SConstruct                         | 14 +++++++--
 gdextension/update_icon_entries.py | 46 +++++++++++++++---------------
 2 files changed, 35 insertions(+), 25 deletions(-)

diff --git a/SConstruct b/SConstruct
index 9b11d95..377e793 100644
--- a/SConstruct
+++ b/SConstruct
@@ -35,9 +35,19 @@ env = SConscript("godot-cpp/SConstruct")
 # - LINKFLAGS are for linking flags
 
 # Generate version header.
-import limboai_version
+from limboai_version import generate_module_version_header
 
-limboai_version.generate_module_version_header()
+print("Generating LimboAI version header...")
+generate_module_version_header()
+
+# Update icon entries in limboai.gdextension file.
+# Note: This will remove everything after [icons] section, and rebuild it with generated icon entries.
+sys.path.append("gdextension")
+from update_icon_entries import update_icon_entries
+
+print("Updating LimboAI icon entries...")
+update_icon_entries(silent=True)
+sys.path.remove("gdextension")
 
 # Tweak this if you want to use different folders, or more folders, to store your source code in.
 env.Append(CPPDEFINES=["LIMBOAI_GDEXTENSION"])
diff --git a/gdextension/update_icon_entries.py b/gdextension/update_icon_entries.py
index 8af2b36..c27eb09 100755
--- a/gdextension/update_icon_entries.py
+++ b/gdextension/update_icon_entries.py
@@ -28,28 +28,7 @@ def get_script_dir():
     return os.path.dirname(os.path.realpath(__file__))
 
 
-def main():
-    silent = False
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "s", ["silent"])
-    except getopt.GetoptError as e:
-        print(
-            "%s: %s!\n"
-            % (
-                os.path.basename(__file__),
-                e.msg,
-            )
-        )
-        usage()
-        sys.exit(2)
-
-    for opt, arg in opts:
-        if opt in ("-h", "--help"):
-            usage()
-            sys.exit(0)
-        elif opt in ("-s", "--silent"):
-            silent = True
-
+def update_icon_entries(silent=False):
     config_dir = get_script_dir()
     config_path = os.path.join(config_dir, "limboai.gdextension")
     content = ""
@@ -83,4 +62,25 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    silent = False
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "s", ["silent"])
+    except getopt.GetoptError as e:
+        print(
+            "%s: %s!\n"
+            % (
+                os.path.basename(__file__),
+                e.msg,
+            )
+        )
+        usage()
+        sys.exit(2)
+
+    for opt, arg in opts:
+        if opt in ("-h", "--help"):
+            usage()
+            sys.exit(0)
+        elif opt in ("-s", "--silent"):
+            silent = True
+
+    update_icon_entries(silent)

From 304bd862204a3456111b8ca39d56fd19595da944 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Wed, 7 Aug 2024 17:47:50 +0200
Subject: [PATCH 08/15] Write icon entries to manifest only if changed

---
 gdextension/update_icon_entries.py | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/gdextension/update_icon_entries.py b/gdextension/update_icon_entries.py
index c27eb09..850b048 100755
--- a/gdextension/update_icon_entries.py
+++ b/gdextension/update_icon_entries.py
@@ -32,15 +32,16 @@ def update_icon_entries(silent=False):
     config_dir = get_script_dir()
     config_path = os.path.join(config_dir, "limboai.gdextension")
     content = ""
+    new_content = ""
 
     f = open(config_path, "r")
     for line in f:
-        if line.startswith("[icons]"):
-            break
         content += line
     f.close()
 
-    content += "[icons]\n\n"
+    index = content.find("[icons]")
+    new_content = content[0:index]
+    new_content += "[icons]\n\n"
 
     icon_files = []
     icons_dir = os.path.join(config_dir, "../icons/")
@@ -50,15 +51,18 @@ def update_icon_entries(silent=False):
 
     icon_files.sort()
     for icon_file in icon_files:
-        content += os.path.splitext(icon_file)[0] + ' = "res://addons/limboai/icons/' + icon_file + '"\n'
+        new_content += os.path.splitext(icon_file)[0] + ' = "res://addons/limboai/icons/' + icon_file + '"\n'
 
-    f = open(config_path, "w")
-    f.write(content)
-    f.close()
-
-    if not silent:
-        print(content)
-        print("======= Icon entries updated =======")
+    if new_content != content:
+        f = open(config_path, "w")
+        f.write(new_content)
+        f.close()
+        if not silent:
+            print(new_content)
+            print("=== Icon entries updated ===")
+    else:
+        if not silent:
+            print("=== No update needed for icon entries ===")
 
 
 if __name__ == "__main__":

From bf33917cfdfb21d34ab4883ea96bf8331b2cf8c2 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Thu, 8 Aug 2024 13:14:44 +0200
Subject: [PATCH 09/15] Add help and verification for --project option in
 SConstruct

---
 SConstruct | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/SConstruct b/SConstruct
index 377e793..c8f194f 100644
--- a/SConstruct
+++ b/SConstruct
@@ -5,12 +5,12 @@ import sys
 # This is SConstruct file for building GDExtension variant using SCONS build system.
 # For module variant, see SCsub file.
 
-# For custom projects, you can customize output path for artifacts: scons --project=PATH_TO_YOUR_PROJECT
-# - artifacts are placed into "addons/limboai/bin" subdirectory inside the project directory.
-# - for example: scons --project="../my_project"
-#   - artifacts will be placed into "../my_project/addons/limboai/bin" relative to "limboai/" source dir.
-# - if not specified, the artifacts will be places in the demo/ project.
-# - For plugin to be loaded, create "addons/limboai/bin" directory in your project and copy limboai.gdextension file to it.
+# Use --project=DIR to customize output path for built targets.
+# - Built targets are placed into "DIR/addons/limboai/bin".
+# - For example: scons --project="../my_project"
+#   - built targets will be placed into "../my_project/addons/limboai/bin".
+# - If not specified, built targets are put into the demo/ project.
+# - For plugin to be loaded, copy limboai.gdextension into "addons/limboai/bin" dir.
 
 AddOption(
     "--project",
@@ -20,9 +20,20 @@ AddOption(
     action="store",
     metavar="DIR",
     default="demo",
-    help="Specify project directory.",
+    help="Specify project directory",
 )
+
+help_text = """
+Options:
+  --project=DIR     Specify project directory (default: "demo");
+                    built targets will be placed in DIR/addons/limboai/bin
+"""
+Help(help_text)
+
 project_dir = GetOption("project")
+if not os.path.isdir(project_dir):
+    print("Project directory not found: " + project_dir)
+    Exit(1)
 
 env = SConscript("godot-cpp/SConstruct")
 

From 98accb1aa8f4273be687c5975934132c363288fd Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Thu, 8 Aug 2024 14:41:25 +0200
Subject: [PATCH 10/15] Automatically deploy limboai.gdextension on build

---
 SConstruct | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/SConstruct b/SConstruct
index c8f194f..d210422 100644
--- a/SConstruct
+++ b/SConstruct
@@ -10,7 +10,6 @@ import sys
 # - For example: scons --project="../my_project"
 #   - built targets will be placed into "../my_project/addons/limboai/bin".
 # - If not specified, built targets are put into the demo/ project.
-# - For plugin to be loaded, copy limboai.gdextension into "addons/limboai/bin" dir.
 
 AddOption(
     "--project",
@@ -83,6 +82,7 @@ if env["target"] in ["editor", "template_debug"]:
     doc_data = env.GodotCPPDocData("gen/doc_data.gen.cpp", source=Glob("doc_classes/*.xml"))
     sources.append(doc_data)
 
+# Build library.
 if env["platform"] == "macos":
     library = env.SharedLibrary(
         project_dir
@@ -97,4 +97,11 @@ else:
         source=sources,
     )
 
-Default(library)
+# Deploy limboai.gdextension into PROJECT/addons/limboai/bin.
+deploy_manifest = env.Command(
+    project_dir + "/addons/limboai/bin/limboai.gdextension",
+    "gdextension/limboai.gdextension",
+    Copy("$TARGET", "$SOURCE"),
+)
+
+Default(library, deploy_manifest)

From 7708a118404edb9fe3a8957d018067d4e915478f Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Thu, 8 Aug 2024 21:54:19 +0200
Subject: [PATCH 11/15] Deploy icons on scons build (optionally)

---
 SConstruct | 47 ++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 38 insertions(+), 9 deletions(-)

diff --git a/SConstruct b/SConstruct
index d210422..06bc33a 100644
--- a/SConstruct
+++ b/SConstruct
@@ -2,7 +2,7 @@
 import os
 import sys
 
-# This is SConstruct file for building GDExtension variant using SCONS build system.
+# This is SConstruct file for building GDExtension variant using SCons build system.
 # For module variant, see SCsub file.
 
 # Use --project=DIR to customize output path for built targets.
@@ -34,7 +34,23 @@ if not os.path.isdir(project_dir):
     print("Project directory not found: " + project_dir)
     Exit(1)
 
-env = SConscript("godot-cpp/SConstruct")
+# Parse LimboAI-specific variables.
+vars = Variables()
+vars.AddVariables(
+    BoolVariable("deploy_manifest", help="Deploy limboai.gdextension into PROJECT/addons/limboai/bin", default=True),
+    BoolVariable("deploy_icons", help="Deploy icons into PROJECT/addons/limboai/icons", default=True),
+)
+env = Environment(tools=["default"], PLATFORM="", variables=vars)
+Help(vars.GenerateHelpText(env))
+
+# Read LimboAI-specific variables.
+deploy_manifest = env["deploy_manifest"]
+deploy_icons = env["deploy_icons"]
+
+# Remove processed variables from ARGUMENTS to avoid godot-cpp warnings.
+for o in vars.options:
+    if o.key in ARGUMENTS:
+        del ARGUMENTS[o.key]
 
 # For reference:
 # - CCFLAGS are compilation flags shared between C and C++
@@ -44,6 +60,8 @@ env = SConscript("godot-cpp/SConstruct")
 # - CPPDEFINES are for pre-processor defines
 # - LINKFLAGS are for linking flags
 
+env = SConscript("godot-cpp/SConstruct")
+
 # Generate version header.
 from limboai_version import generate_module_version_header
 
@@ -97,11 +115,22 @@ else:
         source=sources,
     )
 
-# Deploy limboai.gdextension into PROJECT/addons/limboai/bin.
-deploy_manifest = env.Command(
-    project_dir + "/addons/limboai/bin/limboai.gdextension",
-    "gdextension/limboai.gdextension",
-    Copy("$TARGET", "$SOURCE"),
-)
+Default(library)
 
-Default(library, deploy_manifest)
+# Deploy icons into PROJECT/addons/limboai/icons.
+if deploy_icons:
+    cmd_deploy_icons = env.Command(
+        project_dir + "/addons/limboai/icons/",
+        "icons/",
+        Copy("$TARGET", "$SOURCE"),
+    )
+    Default(cmd_deploy_icons)
+
+# Deploy limboai.gdextension into PROJECT/addons/limboai/bin.
+if deploy_manifest:
+    cmd_deploy_manifest = env.Command(
+        project_dir + "/addons/limboai/bin/limboai.gdextension",
+        "gdextension/limboai.gdextension",
+        Copy("$TARGET", "$SOURCE"),
+    )
+    Default(cmd_deploy_manifest)

From 10b90b70fea16fb9c8e0e392192295d1acc90014 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Thu, 8 Aug 2024 22:55:51 +0200
Subject: [PATCH 12/15] GHA: Don't use setup_gdextension.sh (no longer needed)

---
 .github/workflows/gdextension.yml | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/.github/workflows/gdextension.yml b/.github/workflows/gdextension.yml
index 75543ee..0a83767 100644
--- a/.github/workflows/gdextension.yml
+++ b/.github/workflows/gdextension.yml
@@ -256,15 +256,6 @@ jobs:
             ${{env.BIN}}-${{inputs.godot-cpp-ref}}-${{inputs.limboai-ref}}
             ${{env.BIN}}-${{inputs.godot-cpp-ref}}
 
-      - name: Setup project structure for GDExtension
-        shell: bash
-        run: |
-          bash ./gdextension/setup_gdextension.sh --copy-all
-          echo "---"
-          ls -l
-          echo "---"
-          ls -l -R ./demo/
-
       - name: Compilation
         shell: bash
         env:

From 80e3ff705dac63c4055bcfb494915fa17b13860c Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Fri, 9 Aug 2024 13:13:26 +0200
Subject: [PATCH 13/15] Remove setup_gdextension.sh & update README

---
 README.md                        |  17 ++++-
 gdextension/setup_gdextension.sh | 121 -------------------------------
 2 files changed, 15 insertions(+), 123 deletions(-)
 delete mode 100755 gdextension/setup_gdextension.sh

diff --git a/README.md b/README.md
index 838eb1c..8cabf07 100644
--- a/README.md
+++ b/README.md
@@ -93,13 +93,26 @@ LimboAI can be used as either a C++ module or as a GDExtension shared library. G
 
 ### Compiling from source
 
->**🛈 For GDExtension:** Refer to comments in [setup_gdextension.sh](./gdextension/setup_gdextension.sh) file.
-
 - Download the Godot Engine source code and put this module source into the `modules/limboai` directory.
 - Consult the Godot Engine documentation for instructions on [how to build from source code](https://docs.godotengine.org/en/stable/contributing/development/compiling/index.html).
 - If you plan to export a game utilizing the LimboAI module, you'll also need to build export templates.
 - To execute unit tests, compile the engine with `tests=yes` and run it with `--test --tc="*[LimboAI]*"`.
 
+#### For GDExtension
+
+- You'll need SCons build tool and a C++ compiler. See also [Compiling](https://docs.godotengine.org/en/stable/contributing/development/compiling/index.html).
+- Clone godot-cpp repository into `limboai/godot-cpp/` directory, and switch to a supported release tag or branch.
+- Run `scons target=editor` to build the plugin library for your current platform.
+  - By default, built targets are placed in the demo project: `demo/addons/limboai/bin/`
+- Check `scons -h` for other options and targets.
+
+```bash
+git clone https://github.com/limbonaut/limboai
+cd limboai/
+git clone -b master https://github.com/godotengine/godot-cpp.git
+scons target=editor
+```
+
 ## Using the plugin
 
 - [Online Documentation](https://limboai.readthedocs.io/en/latest/index.html)
diff --git a/gdextension/setup_gdextension.sh b/gdextension/setup_gdextension.sh
deleted file mode 100755
index c6c471d..0000000
--- a/gdextension/setup_gdextension.sh
+++ /dev/null
@@ -1,121 +0,0 @@
-#!/bin/bash
-
-## This script sets up limboai project for development with GDExtension.
-## It adds missing files to the demo project for development with GDExtension, and downloads godot-cpp.
-## Tested only on Unix-likes. You can perform similar steps manually, if you are on Windows. Check Overview below.
-##
-## Instructions:
-## 1) Clone the limboai repository:
-##    git clone https://github.com/limbonaut/limboai
-## 2) From the limboai root directory, run:
-##    bash ./gdextension/setup_gdextension.sh
-##
-## Overview:
-##   limboai/ -- LimboAI repository after you clone it - call this script from here.
-##   limboai/godot-cpp/ -- git repo that will be cloned by this script, unless already exists.
-##   limboai/demo/addons/limboai/limboai.gdextension -- symbolic link created (leads to limboai/gdextension/limboai.gdextension).
-##   limboai/demo/addons/limboai/icons/ -- symbolic link created (leads to limboai/icons/).
-##
-##   Note: Script creates symbolic links unless --copy-all is set, in which case it copies the files.
-##
-## Dependencies: bash, git, python3, trash (optional).
-
-# Script Settings
-GODOT_CPP_VERSION=4.2
-PYTHON=python
-
-# Colors
-HIGHLIGHT_COLOR='\033[1;36m' # Light Cyan
-NC='\033[0m' # No Color
-ERROR_COLOR="\033[0;31m"  # Red
-
-usage() { echo "Usage: $0 [--copy-all] [--trash-old]"; }
-
-msg () {  echo -e "$@"; }
-highlight() { echo -e "${HIGHLIGHT_COLOR}$@${NC}"; }
-error () { echo -e "${ERROR_COLOR}$@${NC}" >&2; }
-
-if [ ! -d "${PWD}/demo/" ]; then
-    error Aborting: \"demo\" subdirectory is not found.
-    msg Tip: Run this script from the limboai root directory.
-    msg Command: bash ./gdextension/setup_gdextension.sh
-    exit 1
-fi
-
-# Interrupt execution and exit on Ctrl-C
-trap exit SIGINT
-
-set -e
-
-copy_all=0
-trash_old=0
-
-# Parsing arguments
-for i in "$@"
-do
-    case "${i}" in
-	--copy-all)
-	    copy_demo=1
-	    copy_all=1
-	    shift
-	    ;;
-    --trash-old)
-        trash_old=1
-        shift
-        ;;
-	*)
-	    usage
-        exit 1
-	    ;;
-    esac
-done
-
-highlight Setup started.
-
-${PYTHON} gdextension/update_icon_entries.py --silent
-highlight -- Icon declarations updated.
-
-transfer="ln -s"
-transfer_word="Linked"
-if [ ${copy_all} == 1 ]; then
-    transfer="cp -R"
-    transfer_word="Copied"
-fi
-
-if [ ${trash_old} == 1 ]; then
-    if ! command -v trash &> /dev/null; then
-        error trash command not available. Aborting.
-        exit 1
-    fi
-    trash demo/addons/limboai || /bin/true
-    highlight -- Trashed old setup.
-fi
-
-if [ ! -d "${PWD}/godot-cpp/" ]; then
-    highlight -- Cloning godot-cpp...
-    git clone -b ${GODOT_CPP_VERSION} https://github.com/godotengine/godot-cpp
-    highlight -- Finished cloning godot-cpp.
-else
-    highlight -- Skipping \"godot-cpp\". Directory already exists!
-fi
-
-if [ ! -e "${PWD}/demo/addons/limboai/bin/limboai.gdextension" ]; then
-    mkdir -p ./demo/addons/limboai/bin/
-    cd ./demo/addons/limboai/bin/
-    ${transfer} ../../../../gdextension/limboai.gdextension limboai.gdextension
-    cd -
-    highlight -- ${transfer_word} limboai.gdextension.
-else
-    highlight -- Skipping limboai.gdextension. File already exists!
-fi
-
-if [ ! -e "${PWD}/demo/addons/limboai/icons/" ]; then
-    cd ./demo/addons/limboai/
-    ${transfer} ../../../icons icons
-    cd -
-    highlight -- ${transfer_word} icons.
-else
-    highlight -- Skipping icons. File already exists!
-fi
-
-highlight Setup complete.

From 1e1fb5adaf16c3fa23b893b1d489af4515830c22 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Fri, 9 Aug 2024 14:13:01 +0200
Subject: [PATCH 14/15] Clone godot-cpp if not found during scons build

---
 README.md          |  9 +--------
 SConstruct         | 37 ++++++++++++++++++++++++++-----------
 limboai_version.py |  1 +
 3 files changed, 28 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 8cabf07..069edf0 100644
--- a/README.md
+++ b/README.md
@@ -101,18 +101,11 @@ LimboAI can be used as either a C++ module or as a GDExtension shared library. G
 #### For GDExtension
 
 - You'll need SCons build tool and a C++ compiler. See also [Compiling](https://docs.godotengine.org/en/stable/contributing/development/compiling/index.html).
-- Clone godot-cpp repository into `limboai/godot-cpp/` directory, and switch to a supported release tag or branch.
 - Run `scons target=editor` to build the plugin library for your current platform.
+  - SCons will automatically clone the godot-cpp/ repository if it doesn't already exist in the `limboai/godot-cpp` directory.
   - By default, built targets are placed in the demo project: `demo/addons/limboai/bin/`
 - Check `scons -h` for other options and targets.
 
-```bash
-git clone https://github.com/limbonaut/limboai
-cd limboai/
-git clone -b master https://github.com/godotengine/godot-cpp.git
-scons target=editor
-```
-
 ## Using the plugin
 
 - [Online Documentation](https://limboai.readthedocs.io/en/latest/index.html)
diff --git a/SConstruct b/SConstruct
index 06bc33a..c3a9e6c 100644
--- a/SConstruct
+++ b/SConstruct
@@ -1,15 +1,32 @@
 #!/usr/bin/env python
+"""
+This is SConstruct file for building GDExtension variant using SCons build system.
+For module variant, see SCsub file.
+
+Use --project=DIR to customize output path for built targets.
+ - Built targets are placed into "DIR/addons/limboai/bin".
+ - For example: scons --project="../my_project"
+   - built targets will be placed into "../my_project/addons/limboai/bin".
+ - If not specified, built targets are put into the demo/ project.
+"""
+
 import os
 import sys
+import subprocess
+from limboai_version import generate_module_version_header, godot_cpp_ref
 
-# This is SConstruct file for building GDExtension variant using SCons build system.
-# For module variant, see SCsub file.
-
-# Use --project=DIR to customize output path for built targets.
-# - Built targets are placed into "DIR/addons/limboai/bin".
-# - For example: scons --project="../my_project"
-#   - built targets will be placed into "../my_project/addons/limboai/bin".
-# - If not specified, built targets are put into the demo/ project.
+# Check if godot-cpp/ exists
+if not os.path.exists("godot-cpp"):
+    print("Directory godot-cpp/ not found. Cloning repository...")
+    result = subprocess.run(
+        ["git", "clone", "-b", godot_cpp_ref, "https://github.com/godotengine/godot-cpp.git"],
+        check=True,
+        # capture_output=True
+    )
+    if result.returncode != 0:
+        print("Error: Cloning godot-cpp repository failed.")
+        Exit(1)
+    print("Finished cloning godot-cpp repository.")
 
 AddOption(
     "--project",
@@ -32,7 +49,7 @@ Help(help_text)
 project_dir = GetOption("project")
 if not os.path.isdir(project_dir):
     print("Project directory not found: " + project_dir)
-    Exit(1)
+    Exit(2)
 
 # Parse LimboAI-specific variables.
 vars = Variables()
@@ -63,8 +80,6 @@ for o in vars.options:
 env = SConscript("godot-cpp/SConstruct")
 
 # Generate version header.
-from limboai_version import generate_module_version_header
-
 print("Generating LimboAI version header...")
 generate_module_version_header()
 
diff --git a/limboai_version.py b/limboai_version.py
index 09a89e8..eb62f16 100644
--- a/limboai_version.py
+++ b/limboai_version.py
@@ -5,6 +5,7 @@ minor = 2
 patch = 0
 status = "dev"
 doc_branch = "latest"
+godot_cpp_ref = "master"
 
 # Code that generates version header
 

From 3a40de482f3faec231b99e87970dbdf87f1dc4c5 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Sat, 10 Aug 2024 10:31:36 +0200
Subject: [PATCH 15/15] Fix icon *.import files on scons build

Enables editor scaling and color conversion in LimboAI icon imports.
This won't work until icons are actually imported in the godot editor, but that's okay - it's a convenience feature.
---
 SConstruct                      |  17 +++--
 gdextension/fix_demo_imports.sh |  51 --------------
 gdextension/fix_icon_imports.py | 114 ++++++++++++++++++++++++++++++++
 3 files changed, 127 insertions(+), 55 deletions(-)
 delete mode 100755 gdextension/fix_demo_imports.sh
 create mode 100755 gdextension/fix_icon_imports.py

diff --git a/SConstruct b/SConstruct
index c3a9e6c..b4fa6e7 100644
--- a/SConstruct
+++ b/SConstruct
@@ -15,6 +15,10 @@ import sys
 import subprocess
 from limboai_version import generate_module_version_header, godot_cpp_ref
 
+sys.path.append("gdextension")
+from update_icon_entries import update_icon_entries
+from fix_icon_imports import fix_icon_imports
+
 # Check if godot-cpp/ exists
 if not os.path.exists("godot-cpp"):
     print("Directory godot-cpp/ not found. Cloning repository...")
@@ -85,12 +89,17 @@ generate_module_version_header()
 
 # Update icon entries in limboai.gdextension file.
 # Note: This will remove everything after [icons] section, and rebuild it with generated icon entries.
-sys.path.append("gdextension")
-from update_icon_entries import update_icon_entries
-
 print("Updating LimboAI icon entries...")
 update_icon_entries(silent=True)
-sys.path.remove("gdextension")
+
+# Fix icon imports in the PROJECT/addons/limboai/icons/.
+# Enables scaling and color conversion in the editor for imported SVG icons.
+try:
+    fix_icon_imports(project_dir)
+except FileNotFoundError as e:
+    print(e)
+except Exception as e:
+    print("Unknown error: " + str(e))
 
 # Tweak this if you want to use different folders, or more folders, to store your source code in.
 env.Append(CPPDEFINES=["LIMBOAI_GDEXTENSION"])
diff --git a/gdextension/fix_demo_imports.sh b/gdextension/fix_demo_imports.sh
deleted file mode 100755
index 278605e..0000000
--- a/gdextension/fix_demo_imports.sh
+++ /dev/null
@@ -1,51 +0,0 @@
-#!/bin/bash
-
-## This script fixes icon imports in the demo project.
-## It enables scaling and color conversion for SVG icons in the demo project.
-##
-## Dependencies: bash, sed, find.
-
-# Colors
-HIGHLIGHT_COLOR='\033[1;36m' # Light Cyan
-NC='\033[0m' # No Color
-ERROR_COLOR="\033[0;31m"  # Red
-
-usage() { echo -e "Usage: $0 [--silent]\nRun from limboai root directory!"; }
-
-msg () {  echo -e "$@"; }
-highlight() { echo -e "${HIGHLIGHT_COLOR}$@${NC}"; }
-error () { echo -e "${ERROR_COLOR}$@${NC}" >&2; }
-
-# Exit if a command returns non-zero status.
-set -e
-
-if [ ! -d "${PWD}/demo/" ]; then
-    error Aborting: \"demo\" subdirectory is not found.
-    msg Tip: Run this script from the limboai root directory.
-    msg Command: bash ./gdextension/fix_demo_imports.sh
-    exit 1
-fi
-
-if test -z "$(find demo/addons/limboai/icons/ -maxdepth 1 -name '*.svg' -print -quit)"; then
-    error "No icons found in the demo project!"
-    msg Make sure to copy/link the icons into the demo project \(icons/ -\> demo/addons/limboai/icons/\).
-    exit 1
-fi
-
-if test -z "$(find demo/addons/limboai/icons/ -maxdepth 1 -name '*.import' -print -quit)"; then
-    error "No icon import files found!"
-    msg Make sure to open the demo project in Godot Editor before running this script.
-    exit 1
-fi
-
-highlight "--- Listing icons dir:"
-ls demo/addons/limboai/icons/
-highlight "---"
-
-highlight Applying scale settings...
-sed -i 's|editor/scale_with_editor_scale=false|editor/scale_with_editor_scale=true|' demo/addons/limboai/icons/*.import
-
-highlight Applying color conversion settings...
-sed -i 's|editor/convert_colors_with_editor_theme=false|editor/convert_colors_with_editor_theme=true|' demo/addons/limboai/icons/*.import
-
-highlight Done!
diff --git a/gdextension/fix_icon_imports.py b/gdextension/fix_icon_imports.py
new file mode 100755
index 0000000..ecfccb6
--- /dev/null
+++ b/gdextension/fix_icon_imports.py
@@ -0,0 +1,114 @@
+#!/usr/bin/python
+"""
+Usage: fix_icon_imports.py [--silent] PROJECT_DIR
+Fix icon imports in PROJECT_DIR/addons/limboai/icons/.
+
+Options:
+  -s, --silent      Don't print anything.
+  -h, --help        Print this message.
+
+Dependencies: python3.
+
+Use of this source code is governed by an MIT-style
+license that can be found in the LICENSE file or at
+https://opensource.org/licenses/MIT.
+"""
+
+import os
+import glob
+import sys
+import getopt
+
+
+def usage():
+    print(__doc__.strip())
+
+
+def get_limboai_icon_import_files(project_path="demo/"):
+    if not os.path.isdir(project_path):
+        raise FileNotFoundError("Project directory not found: " + project_path)
+
+    icons_path = os.path.join(project_path, "addons/limboai/icons/")
+    if not os.path.isdir(icons_path):
+        raise FileNotFoundError("Icons directory not found: " + icons_path)
+
+    return glob.glob(icons_path + "*.import")
+
+
+def fix_import_file(file_path):
+    if not os.path.isfile(file_path):
+        raise FileNotFoundError("File not found: " + file_path)
+
+    old_lines = []
+    new_lines = []
+
+    file = open(file_path, "r")
+    old_lines = file.readlines()
+    file.close()
+
+    for line in old_lines:
+        line = line.replace("editor/scale_with_editor_scale=false", "editor/scale_with_editor_scale=true")
+        line = line.replace(
+            "editor/convert_colors_with_editor_theme=false", "editor/convert_colors_with_editor_theme=true"
+        )
+        new_lines.append(line)
+
+    if old_lines != new_lines:
+        file = open(file_path, "w")
+        for line in new_lines:
+            file.write(line)
+        file.close()
+        return True
+    return False
+
+
+def fix_icon_imports(project_path="demo/", silent=False):
+    if not silent:
+        print("Checking icon import files...")
+
+    project_import_files = get_limboai_icon_import_files(project_path)
+
+    for import_file in project_import_files:
+        changed = fix_import_file(import_file)
+        if changed and not silent:
+            print("Updated icon import file: " + import_file)
+
+
+if __name__ == "__main__":
+    silent = False
+    project_path = "demo/"
+
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "s", ["silent"])
+    except getopt.GetoptError as e:
+        print(
+            "%s: %s!\n"
+            % (
+                os.path.basename(__file__),
+                e.msg,
+            )
+        )
+        usage()
+        sys.exit(2)
+
+    if len(args) > 1:
+        usage()
+        sys.exit(2)
+    elif len(args) == 1:
+        project_path = args[0]
+
+    for opt, arg in opts:
+        if opt in ("-h", "--help"):
+            usage()
+            sys.exit(0)
+        elif opt in ("-s", "--silent"):
+            silent = True
+
+    try:
+        fix_icon_imports(project_path, silent)
+    except FileNotFoundError as e:
+        print(e)
+        exit(1)
+
+    if not silent:
+        print("Done!")