added CSG toolkit

.gitea/workflows/dev-branch.yaml

@@ -0,0 +1,42 @@
+name: Create tag and build when new code gets to main
+run-name: Create tag and build when new code gets to main
+on:
+  push:
+    branches:
+      - '**'        # matches every branch
+      - '!main'     # except main
+      - '!release/*'  # except release branches
+    tags-ignore:
+      - "**"
+
+env:
+  GODOT_VERSION: 4.6
+  GAME_NAME: MovementTests
+  ITCHIO_USERNAME: Minimata
+  ITCHIO_GAMEID: MovementTests
+
+jobs:
+  Export:
+    runs-on: godot
+    steps:
+      - name: Checkout with LFS
+        uses: https://git.game-dev.space/minimata/checkout-with-lfs.git@main
+
+      - name: Run tests
+        uses: godot-gdunit-labs/gdUnit4-action@v1
+        with:
+          godot-version: ${GODOT_VERSION}
+          godot-net: true
+          godot-force-mono: true
+          dotnet-version: 'net9.0'
+          paths: |
+            res://tests/
+          timeout: 1
+          publish-report: false
+          upload-report: false
+
+      - name: Upload test report
+        uses: actions/upload-artifact@v3-node20
+        with:
+          name: Test Report
+          path: ${{ github.workspace }}/reports/test-result.html

.gitea/workflows/main.yaml

@@ -8,6 +8,7 @@ on:
       - "**"
 
 env:
+  GODOT_VERSION: 4.6
   GAME_NAME: MovementTests
   ITCHIO_USERNAME: Minimata
   ITCHIO_GAMEID: MovementTests
@@ -21,6 +22,7 @@ jobs:
       - name: Check out repository code
         uses: actions/checkout@v4
         with:
+          token: ${{ secrets.TOKEN }}
           lfs: false
       - name: Remove buggy pre-push hook
         run: |
@@ -35,79 +37,80 @@ jobs:
           PRERELEASE: false
           INITIAL_VERSION: 0.1.0
           DEFAULT_BUMP: patch
-
-  Export:
-    runs-on: ubuntu-latest
-    needs: BumpTag
-    container:
-      image: barichello/godot-ci:mono-4.5
-
+  
+  Test:
+    runs-on: godot
+#    env:
+#      RUNNER_TOOL_CACHE: /toolcache # Runner Tool Cache
     steps:
-      - name: Install node, curl and zip
-        run: |
-          apt update && apt -y install curl zip nodejs          
       - name: Checkout with LFS
         uses: https://git.game-dev.space/minimata/checkout-with-lfs.git@main
+
+      - name: Run tests
+        uses: godot-gdunit-labs/gdUnit4-action@v1
         with:
-          checkout-version: 3
-            
-      - name: Import resources and build solution
+          godot-version: ${GODOT_VERSION}
+          godot-net: true
+          godot-force-mono: true
+          dotnet-version: 'net9.0'
+          paths: |
+            res://tests/
+          timeout: 1
+          publish-report: false
+          upload-report: false
+
+      - name: Upload test report
+        uses: actions/upload-artifact@v3-node20
+        with:
+          name: Test Report
+          path: ${{ github.workspace }}/reports/test-result.html
+
+  Export:
+    runs-on: godot
+    needs: 
+      - BumpTag
+
+    steps:
+      - name: Checkout with LFS
+        uses: https://git.game-dev.space/minimata/checkout-with-lfs.git@main
+
+      - name: Setup Godot
+        id: setup-godot
+        uses: https://git.game-dev.space/minimata/setup-godot.git@main
+        with:
+          godot-version: '4.6'
+          dotnet-version: 'net9.0'
+      
+      - name: Remove GDUnit addon
         run: |
-          godot --headless --editor --build-solutions --quit --import --path $PWD          
+          rm -rf ${{ gitea.workspace }}/addons/gdUnit4
+      
       - name: Build Windows
         run: |
           mkdir -v -p build/windows
-          godot --headless --verbose --build-solutions --export-release "Windows Desktop" build/windows/${{ env.GAME_NAME }}.exe
+          ${{ steps.setup-godot.outputs.godot_bin }} --headless --verbose --export-release "Windows Desktop" build/windows/${{ env.GAME_NAME }}.exe
           zip -r Windows.zip build/windows
-      - name: Build Windows ARM
-        run: |
-          mkdir -v -p build/windowsArm
-          godot --headless --verbose --build-solutions --export-release "Windows ARM" build/windowsArm/${{ env.GAME_NAME }}.exe
-          zip -r WindowsArm.zip build/windowsArm
-#      - name: Linux Build
-#        run: |
-#          mkdir -v -p build/linux
-#          godot --headless --verbose --export-release "Linux/X11" build/linux/${{ env.GAME_NAME }}.x86_64
-#          zip -r Linux.zip build/linux
-#      - name: Mac Build
-#        run: |
-#          mkdir -v -p build/mac
-#          godot --headless --verbose --export-release "macOS" build/mac/${{ env.GAME_NAME }}.zip
-#          zip -r Mac.zip build/mac     
           
-      - name: Upload to Itch
-        uses: KikimoraGames/itch-publish@v0.0.3
-        with:
-          butlerApiKey: ${{ secrets.BUTLER_TOKEN }}
-          itchUsername: ${{ env.ITCHIO_USERNAME }}
-          itchGameId: ${{ env.ITCHIO_GAMEID }}
-          buildNumber: ${{ needs.BumpTag.outputs.tag_name }}
-          gameData: Windows.zip
-          buildChannel: windows
-      - name: Upload to Itch
-        uses: KikimoraGames/itch-publish@v0.0.3
-        with:
-          butlerApiKey: ${{ secrets.BUTLER_TOKEN }}
-          itchUsername: ${{ env.ITCHIO_USERNAME }}
-          itchGameId: ${{ env.ITCHIO_GAMEID }}
-          buildNumber: ${{ needs.BumpTag.outputs.tag_name }}
-          gameData: WindowsArm.zip
-          buildChannel: windows-arm
-#      - name: Upload to Itch
-#        uses: KikimoraGames/itch-publish@v0.0.3
-#        with:
-#          butlerApiKey: ${{ secrets.BUTLER_TOKEN }}
-#          itchUsername: ${{ env.ITCHIO_USERNAME }}
-#          itchGameId: ${{ env.ITCHIO_GAMEID }}
-#          buildNumber: ${{ needs.BumpTag.outputs.tag_name }}
-#          gameData: Linux.zip
-#          buildChannel: linux  
-#      - name: Upload to Itch
-#        uses: KikimoraGames/itch-publish@v0.0.3
-#        with:
-#          butlerApiKey: ${{ secrets.BUTLER_TOKEN }}
-#          itchUsername: ${{ env.ITCHIO_USERNAME }}
-#          itchGameId: ${{ env.ITCHIO_GAMEID }}
-#          buildNumber: ${{ needs.BumpTag.outputs.tag_name }}
-#          gameData: Mac.zip
-#          buildChannel: mac
+      - name: Setup Butler
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          mkdir ./tools 2>/dev/null || true
+          pushd tools
+            curl -sSLfo ./butler.zip "https://broth.itch.zone/butler/linux-amd64/LATEST/archive/default"
+            unzip butler.zip
+            chmod +x ./butler
+          popd
+          ./tools/butler -V
+
+      - name: Upload to itch.io
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          versionArgument="--userversion ${{ needs.BumpTag.outputs.tag_name }}"
+          ./tools/butler push \
+            "Windows.zip" \
+            ${{ env.ITCHIO_USERNAME }}/${{ env.ITCHIO_GAMEID }}:windows ${versionArgument}
+

.gitea/workflows/release-branch.yaml

@@ -0,0 +1,116 @@
+name: Create tag and build when new code gets to main
+run-name: Create tag and build when new code gets to main
+on:
+  push:
+    branches:
+      - 'release/*'  # only release branches
+    tags-ignore:
+      - "**"
+
+env:
+  GODOT_VERSION: 4.6
+  GAME_NAME: MovementTests
+  ITCHIO_USERNAME: Minimata
+  ITCHIO_GAMEID: MovementTests
+
+jobs:
+  ReleaseName:
+    runs-on: ubuntu-latest
+    if: ${{ contains(gitea.ref_name, 'release/') }}
+    outputs:
+      release_name: ${{ steps.split.outputs._1 }}
+    steps:
+      - uses: winterjung/split@v2
+        id: split
+        with:
+          msg: ${{ gitea.ref_name }}
+          separator: '/'
+
+  Release:
+    runs-on: godot
+    if: ${{ contains(gitea.ref_name, 'release/') }}
+    needs: ReleaseName
+
+    steps:
+      - name: Checkout with LFS
+        uses: https://git.game-dev.space/minimata/checkout-with-lfs.git@main
+
+      - name: Setup Godot
+        id: setup-godot
+        uses: https://git.game-dev.space/minimata/setup-godot.git@main
+        with:
+          godot-version: '4.6'
+          dotnet-version: 'net9.0'
+          
+      - name: Setup Butler
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          mkdir ./tools 2>/dev/null || true
+          pushd tools
+            curl -sSLfo ./butler.zip "https://broth.itch.zone/butler/linux-amd64/LATEST/archive/default"
+            unzip butler.zip
+            chmod +x ./butler
+          popd
+          ./tools/butler -V
+          
+      - name: Build Windows
+        run: |
+          mkdir -v -p build/windows
+          godot --headless --verbose --build-solutions --export-release "Windows Desktop" build/windows/${{ env.GAME_NAME }}.exe
+          zip -r Windows.zip build/windows
+      - name: Upload Windows to itch.io
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          versionArgument="--userversion ${{ needs.ReleaseName.outputs.release_name }}"
+          ./tools/butler push \
+            "Windows.zip" \
+            ${{ env.ITCHIO_USERNAME }}/${{ env.ITCHIO_GAMEID }}:windows ${versionArgument}
+          
+      - name: Build Windows ARM
+        run: |
+          mkdir -v -p build/windowsArm
+          godot --headless --verbose --build-solutions --export-release "Windows ARM" build/windowsArm/${{ env.GAME_NAME }}.exe
+          zip -r WindowsArm.zip build/windowsArm
+      - name: Upload Windows to itch.io
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          versionArgument="--userversion ${{ needs.ReleaseName.outputs.release_name }}"
+          ./tools/butler push \
+            "WindowsArm.zip" \
+            ${{ env.ITCHIO_USERNAME }}/${{ env.ITCHIO_GAMEID }}:windows-arm ${versionArgument}
+          
+      - name: Linux Build
+        run: |
+          mkdir -v -p build/linux
+          godot --headless --verbose --export-release "Linux/X11" build/linux/${{ env.GAME_NAME }}.x86_64
+          zip -r Linux.zip build/linux
+      - name: Upload Windows to itch.io
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          versionArgument="--userversion ${{ needs.ReleaseName.outputs.release_name }}"
+          ./tools/butler push \
+            "Linux.zip" \
+            ${{ env.ITCHIO_USERNAME }}/${{ env.ITCHIO_GAMEID }}:linux ${versionArgument}
+          
+      - name: Mac Build
+        run: |
+          mkdir -v -p build/mac
+          godot --headless --verbose --export-release "macOS" build/mac/${{ env.GAME_NAME }}.zip
+          zip -r Mac.zip build/mac     
+      - name: Upload Windows to itch.io
+        shell: bash
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_TOKEN }}
+        run: |
+          versionArgument="--userversion ${{ needs.ReleaseName.outputs.release_name }}"
+          ./tools/butler push \
+            "Mac.zip" \
+            ${{ env.ITCHIO_USERNAME }}/${{ env.ITCHIO_GAMEID }}:mac ${versionArgument}

.gitignore

@@ -10,6 +10,7 @@
 .import/
 
 /builds
+/communication
 
 # Imported translations (automatically generated from CSV files)
 *.translation

.runsettings

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RunSettings>
+    <RunConfiguration>
+        <MaxCpuCount>1</MaxCpuCount>
+        <ResultsDirectory>./TestResults</ResultsDirectory>
+        <TargetFrameworks>net8.0;net9.0</TargetFrameworks>
+        <TestSessionTimeout>180000</TestSessionTimeout>
+        <TreatNoTestsAsError>true</TreatNoTestsAsError>
+        <EnvironmentVariables>
+            <GODOT_BIN>d:\development\Godot_v4.5-stable_mono_win64\Godot_v4.5-stable_mono_win64.exe</GODOT_BIN>
+        </EnvironmentVariables>
+    </RunConfiguration>
+
+    <LoggerRunSettings>
+        <Loggers>
+            <Logger friendlyName="console" enabled="True">
+                <Configuration>
+                    <Verbosity>detailed</Verbosity>
+                </Configuration>
+            </Logger>
+            <Logger friendlyName="html" enabled="True">
+                <Configuration>
+                    <LogFileName>test-result.html</LogFileName>
+                </Configuration>
+            </Logger>
+            <Logger friendlyName="trx" enabled="True">
+                <Configuration>
+                    <LogFileName>test-result.trx</LogFileName>
+                </Configuration>
+            </Logger>
+        </Loggers>
+    </LoggerRunSettings>
+
+    <GdUnit4>
+        <!-- Additional Godot runtime parameters. These are passed to the Godot executable when running tests.-->
+        <Parameters>"--verbose"</Parameters>
+  
+        <!-- Controls the display name format of test cases in the test results.
+                 Allowed values:
+                 - SimpleName: Uses only the method name (e.g., "TestMethod")
+                 - FullyQualifiedName: Uses the full path including class and method name (e.g., "MyNamespace.MyClass.TestMethod")
+                 Default: SimpleName -->
+        <DisplayName>FullyQualifiedName</DisplayName>
+  
+        <!-- When set to true, standard output (stdout) from test cases is captured
+                 and included in the test result. This can be useful for debugging. -->
+        <CaptureStdOut>true</CaptureStdOut>
+  
+        <!-- The maximum duration allowed for a Godot project compilation process in milliseconds.
+                         After this timeout period expires, the compilation process is forcefully terminated.
+                         For large or complex Godot projects, you may need to increase this value.
+                         Default: 20000 (20 seconds) -->
+        <CompileProcessTimeout>20000</CompileProcessTimeout>
+    </GdUnit4>
+</RunSettings>

Movement tests.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Godot.NET.Sdk/4.5.0">
+<Project Sdk="Godot.NET.Sdk/4.6.0">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
     <EnableDynamicLoading>true</EnableDynamicLoading>
     <RootNamespace>Movementtests</RootNamespace>
   </PropertyGroup>
   <ItemGroup>
+    <Content Include=".runsettings" />
     <Content Include="export_presets.cfg" />
     <Content Include="menus\assets\git_logo\Git-Logo-2Color.png" />
     <Content Include="menus\assets\git_logo\Git-Logo-2Color.png.import" />
@@ -128,4 +129,14 @@
   <ItemGroup>
     <PackageReference Include="RustyOptions" Version="0.10.1" />
   </ItemGroup>
+  <!-- gdUnit4 package dependencies -->
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.0" />
+    <PackageReference Include="gdUnit4.api" Version="5.1.0-rc3" />
+    <PackageReference Include="gdUnit4.test.adapter" Version="3.0.0" />
+    <PackageReference Include="gdUnit4.analyzers" Version="1.0.0">
+      <PrivateAssets>none</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
 </Project>

Movement tests.csproj.old.1

@@ -0,0 +1,142 @@
+<Project Sdk="Godot.NET.Sdk/4.5.0">
+  <PropertyGroup>
+    <TargetFramework>net9.0</TargetFramework>
+    <EnableDynamicLoading>true</EnableDynamicLoading>
+    <RootNamespace>Movementtests</RootNamespace>
+  </PropertyGroup>
+  <ItemGroup>
+    <Content Include=".runsettings" />
+    <Content Include="export_presets.cfg" />
+    <Content Include="menus\assets\git_logo\Git-Logo-2Color.png" />
+    <Content Include="menus\assets\git_logo\Git-Logo-2Color.png.import" />
+    <Content Include="menus\assets\git_logo\LICENSE.txt" />
+    <Content Include="menus\assets\godot_engine_logo\LICENSE.txt" />
+    <Content Include="menus\assets\godot_engine_logo\logo_vertical_color_dark.png" />
+    <Content Include="menus\assets\godot_engine_logo\logo_vertical_color_dark.png.import" />
+    <Content Include="menus\assets\icon.png" />
+    <Content Include="menus\assets\icon.png.import" />
+    <Content Include="menus\ATTRIBUTION.md" />
+    <Content Include="menus\resources\themes\expedition.tres" />
+    <Content Include="menus\resources\themes\gravity.tres" />
+    <Content Include="menus\resources\themes\grow.tres" />
+    <Content Include="menus\resources\themes\lab.tres" />
+    <Content Include="menus\resources\themes\lore.tres" />
+    <Content Include="menus\resources\themes\steal_this_theme.tres" />
+    <Content Include="menus\scenes\credits\scrollable_credits.gd" />
+    <Content Include="menus\scenes\credits\scrollable_credits.gd.uid" />
+    <Content Include="menus\scenes\credits\scrollable_credits.tscn" />
+    <Content Include="menus\scenes\credits\scrolling_credits.gd" />
+    <Content Include="menus\scenes\credits\scrolling_credits.gd.uid" />
+    <Content Include="menus\scenes\credits\scrolling_credits.tscn" />
+    <Content Include="menus\scenes\end_credits\end_credits.gd" />
+    <Content Include="menus\scenes\end_credits\end_credits.gd.uid" />
+    <Content Include="menus\scenes\end_credits\end_credits.tscn" />
+    <Content Include="menus\scenes\game_scene\configurable_sub_viewport.gd" />
+    <Content Include="menus\scenes\game_scene\configurable_sub_viewport.gd.uid" />
+    <Content Include="menus\scenes\game_scene\game_ui.tscn" />
+    <Content Include="menus\scenes\game_scene\input_display_label.gd" />
+    <Content Include="menus\scenes\game_scene\input_display_label.gd.uid" />
+    <Content Include="menus\scenes\game_scene\levels\level.gd" />
+    <Content Include="menus\scenes\game_scene\levels\level.gd.uid" />
+    <Content Include="menus\scenes\game_scene\levels\level_1.tscn" />
+    <Content Include="menus\scenes\game_scene\levels\level_2.tscn" />
+    <Content Include="menus\scenes\game_scene\levels\level_3.tscn" />
+    <Content Include="menus\scenes\game_scene\tutorials\tutorial_1.tscn" />
+    <Content Include="menus\scenes\game_scene\tutorials\tutorial_2.tscn" />
+    <Content Include="menus\scenes\game_scene\tutorials\tutorial_3.tscn" />
+    <Content Include="menus\scenes\game_scene\tutorial_manager.gd" />
+    <Content Include="menus\scenes\game_scene\tutorial_manager.gd.uid" />
+    <Content Include="menus\scenes\loading_screen\level_loading_screen.tscn" />
+    <Content Include="menus\scenes\loading_screen\loading_screen.gd" />
+    <Content Include="menus\scenes\loading_screen\loading_screen.gd.uid" />
+    <Content Include="menus\scenes\loading_screen\loading_screen.tscn" />
+    <Content Include="menus\scenes\loading_screen\loading_screen_with_shader_caching.gd" />
+    <Content Include="menus\scenes\loading_screen\loading_screen_with_shader_caching.gd.uid" />
+    <Content Include="menus\scenes\loading_screen\loading_screen_with_shader_caching.tscn" />
+    <Content Include="menus\scenes\menus\level_select_menu\level_select_menu.gd" />
+    <Content Include="menus\scenes\menus\level_select_menu\level_select_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\level_select_menu\level_select_menu.tscn" />
+    <Content Include="menus\scenes\menus\main_menu\main_menu.gd" />
+    <Content Include="menus\scenes\menus\main_menu\main_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\main_menu\main_menu.tscn" />
+    <Content Include="menus\scenes\menus\main_menu\main_menu_with_animations.gd" />
+    <Content Include="menus\scenes\menus\main_menu\main_menu_with_animations.gd.uid" />
+    <Content Include="menus\scenes\menus\main_menu\main_menu_with_animations.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\audio\audio_input_option_control.gd" />
+    <Content Include="menus\scenes\menus\options_menu\audio\audio_input_option_control.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\audio\audio_input_option_control.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\audio\audio_options_menu.gd" />
+    <Content Include="menus\scenes\menus\options_menu\audio\audio_options_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\audio\audio_options_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\game\game_options_menu.gd" />
+    <Content Include="menus\scenes\menus\options_menu\game\game_options_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\game\game_options_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\game\reset_game_control\reset_game_control.gd" />
+    <Content Include="menus\scenes\menus\options_menu\game\reset_game_control\reset_game_control.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\game\reset_game_control\reset_game_control.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\input\input_extras_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\input\input_options_menu.gd" />
+    <Content Include="menus\scenes\menus\options_menu\input\input_options_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\input\input_options_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\input\input_options_menu_with_mouse_sensitivity.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\master_options_menu.gd" />
+    <Content Include="menus\scenes\menus\options_menu\master_options_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\master_options_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\master_options_menu_with_tabs.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\mini_options_menu.gd" />
+    <Content Include="menus\scenes\menus\options_menu\mini_options_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\mini_options_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\mini_options_menu_with_reset.gd" />
+    <Content Include="menus\scenes\menus\options_menu\mini_options_menu_with_reset.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\mini_options_menu_with_reset.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\video\video_options_menu.gd" />
+    <Content Include="menus\scenes\menus\options_menu\video\video_options_menu.gd.uid" />
+    <Content Include="menus\scenes\menus\options_menu\video\video_options_menu.tscn" />
+    <Content Include="menus\scenes\menus\options_menu\video\video_options_menu_with_extras.tscn" />
+    <Content Include="menus\scenes\opening\opening.gd" />
+    <Content Include="menus\scenes\opening\opening.gd.uid" />
+    <Content Include="menus\scenes\opening\opening.tscn" />
+    <Content Include="menus\scenes\opening\opening_with_logo.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\game_won_menu.gd" />
+    <Content Include="menus\scenes\overlaid_menus\game_won_menu.gd.uid" />
+    <Content Include="menus\scenes\overlaid_menus\game_won_menu.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\level_lost_menu.gd" />
+    <Content Include="menus\scenes\overlaid_menus\level_lost_menu.gd.uid" />
+    <Content Include="menus\scenes\overlaid_menus\level_lost_menu.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\level_won_menu.gd" />
+    <Content Include="menus\scenes\overlaid_menus\level_won_menu.gd.uid" />
+    <Content Include="menus\scenes\overlaid_menus\level_won_menu.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\mini_options_overlaid_menu.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\overlaid_menu.gd" />
+    <Content Include="menus\scenes\overlaid_menus\overlaid_menu.gd.uid" />
+    <Content Include="menus\scenes\overlaid_menus\overlaid_menu.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\overlaid_menu_container.gd" />
+    <Content Include="menus\scenes\overlaid_menus\overlaid_menu_container.gd.uid" />
+    <Content Include="menus\scenes\overlaid_menus\overlaid_menu_container.tscn" />
+    <Content Include="menus\scenes\overlaid_menus\pause_menu.gd" />
+    <Content Include="menus\scenes\overlaid_menus\pause_menu.gd.uid" />
+    <Content Include="menus\scenes\overlaid_menus\pause_menu.tscn" />
+    <Content Include="menus\scripts\game_state.gd" />
+    <Content Include="menus\scripts\game_state.gd.uid" />
+    <Content Include="menus\scripts\level_list_and_state_manager.gd" />
+    <Content Include="menus\scripts\level_list_and_state_manager.gd.uid" />
+    <Content Include="menus\scripts\level_state.gd" />
+    <Content Include="menus\scripts\level_state.gd.uid" />
+  </ItemGroup>
+  <ItemGroup>
+    <Folder Include="addons\" />
+  </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="RustyOptions" Version="0.10.1" />
+  </ItemGroup>
+  <!-- gdUnit4 package dependencies -->
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.0"/>
+    <PackageReference Include="gdUnit4.api" Version="5.1.0-rc3"/>
+    <PackageReference Include="gdUnit4.test.adapter" Version="3.0.0"/>
+    <PackageReference Include="gdUnit4.analyzers" Version="1.0.0">
+      <PrivateAssets>none</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+</Project>

Movement tests.sln.DotSettings.user

@@ -1,4 +1,12 @@
 <wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:String x:Key="/Default/CodeInspection/ExcludedFiles/FilesAndFoldersToSkip2/=7020124F_002D9FFC_002D4AC3_002D8F3D_002DAAB8E0240759_002Ff_003AAction_00601_002Ecs_002Fl_003AC_0021_003FUsers_003FMinimata_003FAppData_003FRoaming_003FJetBrains_003FRider2025_002E1_003Fresharper_002Dhost_003FDecompilerCache_003Fdecompiler_003F7c0f83388bfc4d2c9d09befcec9dd79bc90908_003Fb8_003F4d300c4d_003FAction_00601_002Ecs/@EntryIndexedValue">ForceIncluded</s:String>
+	<s:String x:Key="/Default/CodeInspection/ExcludedFiles/FilesAndFoldersToSkip2/=7020124F_002D9FFC_002D4AC3_002D8F3D_002DAAB8E0240759_002Ff_003AAction_00602_002Ecs_002Fl_003AC_0021_003FUsers_003FMinimata_003FAppData_003FRoaming_003FJetBrains_003FRider2025_002E1_003Fresharper_002Dhost_003FDecompilerCache_003Fdecompiler_003F7c0f83388bfc4d2c9d09befcec9dd79bc90908_003F87_003Fded27e2d_003FAction_00602_002Ecs/@EntryIndexedValue">ForceIncluded</s:String>
+	<s:String x:Key="/Default/CodeInspection/ExcludedFiles/FilesAndFoldersToSkip2/=7020124F_002D9FFC_002D4AC3_002D8F3D_002DAAB8E0240759_002Ff_003AEnemy_005FScriptMethods_002Egenerated_002Ecs_002Fl_003AC_0021_003FUsers_003FMinimata_003FAppData_003FRoaming_003FJetBrains_003FRider2025_002E1_003Fresharper_002Dhost_003FSourcesCache_003F8e71dc81611862c01a2cb998a1f327de14747655_003FEnemy_005FScriptMethods_002Egenerated_002Ecs/@EntryIndexedValue">ForceIncluded</s:String>
+	<s:String x:Key="/Default/CodeInspection/ExcludedFiles/FilesAndFoldersToSkip2/=7020124F_002D9FFC_002D4AC3_002D8F3D_002DAAB8E0240759_002Ff_003ANode_002Ecs_002Fl_003AC_0021_003FUsers_003FMinimata_003FAppData_003FRoaming_003FJetBrains_003FRider2025_002E1_003Fresharper_002Dhost_003FSourcesCache_003F716d154fef5cbe863cd637bd32beda6e3cec5f12e8fed2dc5b2d8149a0d558ab_003FNode_002Ecs/@EntryIndexedValue">ForceIncluded</s:String>
 	<s:String x:Key="/Default/CodeInspection/ExcludedFiles/FilesAndFoldersToSkip2/=7020124F_002D9FFC_002D4AC3_002D8F3D_002DAAB8E0240759_002Ff_003ANode_002Ecs_002Fl_003AC_0021_003FUsers_003FMinimata_003FAppData_003FRoaming_003FJetBrains_003FRider2025_002E1_003Fresharper_002Dhost_003FSourcesCache_003Fdf73a4db74df89d59655c5fb6326406f47fbfa9af1fa81518fe0a07c49d34133_003FNode_002Ecs/@EntryIndexedValue">ForceIncluded</s:String>
 	<s:String x:Key="/Default/CodeInspection/ExcludedFiles/FilesAndFoldersToSkip2/=7020124F_002D9FFC_002D4AC3_002D8F3D_002DAAB8E0240759_002Ff_003ASceneTree_002Ecs_002Fl_003AC_0021_003FUsers_003FMinimata_003FAppData_003FRoaming_003FJetBrains_003FRider2025_002E1_003Fresharper_002Dhost_003FSourcesCache_003F8d6960554e939a669841b1ece03d27df4ab42f92bb80be3767eaec8cdaccf84b_003FSceneTree_002Ecs/@EntryIndexedValue">ForceIncluded</s:String>
+	<s:String x:Key="/Default/Environment/UnitTesting/UnitTestSessionStore/Sessions/=dd9a7ac6_002Dbb9b_002D4001_002Db145_002D15e6509b7e78/@EntryIndexedValue">&lt;SessionState ContinuousTestingMode="0" IsActive="True" Name="All tests from Solution" xmlns="urn:schemas-jetbrains-com:jetbrains-ut-session"&gt;&#xD;
+  &lt;Solution /&gt;&#xD;
+&lt;/SessionState&gt;</s:String>
+	<s:String x:Key="/Default/Housekeeping/UnitTestingMru/UnitTestRunner/RunConfigurationFilename/@EntryValue">D:\Godot\Projects\movement-tests\.runsettings</s:String>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=floorplane/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

addons/csg_toolkit/SETTINGS.md

@@ -0,0 +1,42 @@
+# CSG Toolkit Settings
+
+The CSG Toolkit now uses Godot's built-in **ProjectSettings** system instead of a custom configuration file.
+
+## Accessing Settings
+
+Settings can be accessed in two ways:
+
+1. **Through the CSG Toolkit config window** (recommended for users)
+   - Click the config button in the CSG Toolkit sidebar
+   - Modify settings using the UI
+   - Click "Save" to persist changes
+
+2. **Directly in Project Settings** (for advanced users)
+   - Go to Project → Project Settings
+   - Navigate to the "Addons" section
+   - Look for `addons/csg_toolkit/*` settings
+
+## Available Settings
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `addons/csg_toolkit/default_behavior` | Enum | Sibling | Default insertion behavior (Sibling or Child) |
+| `addons/csg_toolkit/action_key` | Key | Shift | Primary action key for shortcuts |
+| `addons/csg_toolkit/secondary_action_key` | Key | Alt | Secondary action key for behavior inversion |
+| `addons/csg_toolkit/auto_hide` | Boolean | true | Auto-hide sidebar when no CSG nodes selected |
+
+## Migration from Old Config
+
+If you were using an older version with `csg_toolkit_config.cfg`:
+- The old config file is no longer used
+- Settings are now stored in `project.godot`
+- Settings will be initialized with defaults on first run
+- You'll need to reconfigure your preferences if migrating
+
+## Advantages of ProjectSettings
+
+- Settings are version-controlled with your project
+- Visible and editable in Project Settings editor
+- Better integration with Godot's editor
+- No separate config file to manage
+- Settings persist per-project automatically

addons/csg_toolkit/csg_toolkit.gd

@@ -0,0 +1,57 @@
+@tool
+class_name CsgToolkit extends EditorPlugin
+@onready var config: CsgTkConfig:
+	get:
+		return get_tree().root.get_node_or_null(AUTOLOAD_NAME) as CsgTkConfig
+
+var sidebar: CSGSideToolkitBar
+var topbar: CSGTopToolkitBar
+var shortcut_manager: CsgShortcutManager
+
+const AUTOLOAD_NAME = "CsgToolkitAutoload"
+static var csg_plugin_path
+static var undo_manager: EditorUndoRedoManager
+
+func _enter_tree():
+	# Config
+	add_autoload_singleton(AUTOLOAD_NAME, "res://addons/csg_toolkit/scripts/csg_toolkit_config.gd")
+	csg_plugin_path = get_path()
+	undo_manager = get_undo_redo()
+	
+	# Nodes
+	add_custom_type("CSGRepeater3D", "CSGCombiner3D", preload("res://addons/csg_toolkit/scripts/csg_repeater_3d.gd"), null)
+	add_custom_type("CSGSpreader3D", "CSGCombiner3D", preload("res://addons/csg_toolkit/scripts/csg_spreader_3d.gd"), null)
+	
+	# Sidebar
+	var sidebarScene = preload("res://addons/csg_toolkit/scenes/csg_side_toolkit_bar.tscn")
+	sidebar = sidebarScene.instantiate()
+	add_control_to_container(EditorPlugin.CONTAINER_SPATIAL_EDITOR_SIDE_LEFT, sidebar)
+	# Ensure sidebar can be found by shortcut manager if needed
+	sidebar.add_to_group("CSGSideToolkit")
+	
+	# Topbar
+	var topbarScene = preload("res://addons/csg_toolkit/scenes/csg_top_toolkit_bar.tscn")
+	topbar = topbarScene.instantiate()
+	add_control_to_container(EditorPlugin.CONTAINER_SPATIAL_EDITOR_MENU, topbar)
+
+	# Shortcut Manager
+	shortcut_manager = CsgShortcutManager.new()
+	get_tree().root.add_child(shortcut_manager)
+	shortcut_manager.sidebar = sidebar
+
+func _exit_tree():
+	remove_custom_type("CSGRepeater3D")
+	remove_custom_type("CSGSpreader3D")
+	undo_manager = null
+	
+	remove_autoload_singleton(AUTOLOAD_NAME)
+	
+	# Note: ProjectSettings for CSG Toolkit are preserved in project.godot
+	# They can be manually removed from Project Settings if desired
+	
+	remove_control_from_container(EditorPlugin.CONTAINER_SPATIAL_EDITOR_SIDE_LEFT, sidebar)
+	sidebar.free()
+	remove_control_from_container(EditorPlugin.CONTAINER_SPATIAL_EDITOR_MENU, topbar)
+	topbar.free()
+	if shortcut_manager and is_instance_valid(shortcut_manager):
+		shortcut_manager.queue_free()

addons/csg_toolkit/csg_toolkit.gd.uid

@@ -0,0 +1 @@
+uid://cmwnf4lkck6mm

addons/csg_toolkit/demo/demo.tscn

@@ -0,0 +1,71 @@
+[gd_scene format=3 uid="uid://bltlelosbn4ky"]
+
+[ext_resource type="Script" uid="uid://c68dxahp0v5xg" path="res://addons/csg_toolkit/scripts/csg_repeater_3d.gd" id="1_mnwru"]
+[ext_resource type="Script" uid="uid://3il6xs7cr7gj" path="res://addons/csg_toolkit/scripts/patterns/noise_pattern.gd" id="2_mnwru"]
+
+[sub_resource type="ProceduralSkyMaterial" id="ProceduralSkyMaterial_i7qq0"]
+sky_horizon_color = Color(0.66224277, 0.6717428, 0.6867428, 1)
+ground_horizon_color = Color(0.66224277, 0.6717428, 0.6867428, 1)
+
+[sub_resource type="Sky" id="Sky_lhy2n"]
+sky_material = SubResource("ProceduralSkyMaterial_i7qq0")
+
+[sub_resource type="Environment" id="Environment_mnwru"]
+background_mode = 2
+sky = SubResource("Sky_lhy2n")
+tonemap_mode = 2
+glow_enabled = true
+
+[sub_resource type="Resource" id="Resource_fg620"]
+script = ExtResource("2_mnwru")
+bounds = Vector3(10, 1, 10)
+noise_threshold = 0.9
+noise_frequency = 16.0
+use_template_size = true
+metadata/_custom_type_script = "uid://3il6xs7cr7gj"
+
+[node name="Node" type="Node3D" unique_id=1351203367]
+
+[node name="WorldEnvironment" type="WorldEnvironment" parent="." unique_id=190667961]
+environment = SubResource("Environment_mnwru")
+
+[node name="DirectionalLight3D" type="DirectionalLight3D" parent="." unique_id=656509290]
+transform = Transform3D(-0.8660254, -0.43301278, 0.25, 0, 0.49999997, 0.86602545, -0.50000006, 0.75, -0.43301266, 0, 0, 0)
+shadow_enabled = true
+
+[node name="Camera3D" type="Camera3D" parent="." unique_id=1763227161]
+transform = Transform3D(-0.93186235, 0, -0.36281216, 0, 1, 0, 0.36281216, 0, -0.9318623, -5.236788, 3.9650297, -6.404826)
+current = true
+
+[node name="CSGRepeater3D" type="CSGCombiner3D" parent="." unique_id=873109275]
+script = ExtResource("1_mnwru")
+template_node_path = NodePath("CSGCombiner3D2")
+estimated_instances = 27
+pattern = SubResource("Resource_fg620")
+randomize_rotation = false
+randomize_rot_x = false
+randomize_rot_y = false
+randomize_rot_z = false
+randomize_scale = false
+scale_variance = 0.15
+randomize_scale_x = false
+randomize_scale_y = false
+randomize_scale_z = false
+metadata/_custom_type_script = "uid://c68dxahp0v5xg"
+
+[node name="CSGCombiner3D2" type="CSGCombiner3D" parent="CSGRepeater3D" unique_id=109113911]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -0.31901503, -0.3383956, -7.8776984)
+visible = false
+
+[node name="CSGBox3D" type="CSGBox3D" parent="CSGRepeater3D/CSGCombiner3D2" unique_id=110356410]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0.48632813)
+size = Vector3(1, 1, 1.9726563)
+
+[node name="CSGBox3D2" type="CSGBox3D" parent="CSGRepeater3D/CSGCombiner3D2/CSGBox3D" unique_id=194604460]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -0.51814646, 0.37408447, -0.24641752)
+size = Vector3(1, 1.748169, 1)
+
+[node name="CSGBox3D" type="CSGBox3D" parent="CSGRepeater3D/CSGCombiner3D2/CSGBox3D" unique_id=763032662]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.4555664, 0.08105469)
+operation = 2
+size = Vector3(1, 1.9111328, 0.8378906)

addons/csg_toolkit/demo/new_shader_material.tres

@@ -0,0 +1,3 @@
+[gd_resource type="ShaderMaterial" format=3 uid="uid://bvlrolerfilhd"]
+
+[resource]

addons/csg_toolkit/plugin.cfg

@@ -0,0 +1,7 @@
+[plugin]
+
+name="CSG Toolkit - Enhance Your Blockout Speed"
+description="Enhance your blockout workflow with the CSG Toolkit. This tool adds quick access buttons to the left toolbar for easy addition of CSG nodes. By pressing SHIFT, you can efficiently add the selected CSG as a child node. The toolkit also automatically preselects operations, streamlining your process. Additionally, shortcuts are available for CSG nodes or children of CSG combiners, further boosting your productivity."
+author="LuckyTepot"
+version="1.7.0"
+script="csg_toolkit.gd"

addons/csg_toolkit/res/demo-image.png.import

@@ -0,0 +1,40 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://d3biubbsy5rmr"
+path="res://.godot/imported/demo-image.png-239231e5e25f0563a6646f0443acfa4e.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/demo-image.png"
+dest_files=["res://.godot/imported/demo-image.png-239231e5e25f0563a6646f0443acfa4e.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1

addons/csg_toolkit/res/icon.png.import

@@ -0,0 +1,40 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://c10bvkyvb2xdd"
+path="res://.godot/imported/icon.png-4ba3e0a5d510aafd8e055683d8699174.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icon.png"
+dest_files=["res://.godot/imported/icon.png-4ba3e0a5d510aafd8e055683d8699174.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1

addons/csg_toolkit/res/icons/box.svg

@@ -0,0 +1 @@
+<svg height="16" width="16" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><mask id="a"><path d="M0 0h16v10a2 2 0 0 0-2-2h-2a2 2 0 0 0-2 2 2 2 0 0 0-2 2v2a2 2 0 0 0 2 2H0z" fill="#fff"/></mask><path d="M12 9a1 1 0 0 0-1 1v1h2v2h1a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1zm1 4h-2v-2h-1a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1z" fill="#5fb2ff"/><path d="m8 2 6 3v6l-6 3-6-3V5zm0 12V8l6-3M8 8 2 5" fill="none" stroke-width="2" stroke="#fc7f7f" mask="url(#a)"/></svg>

addons/csg_toolkit/res/icons/box.svg.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://cjxx30pcamj36"
+path="res://.godot/imported/box.svg-24afd61c89464af4af9f4d845ca57b9a.ctex"
+metadata={
+"has_editor_variant": true,
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/box.svg"
+dest_files=["res://.godot/imported/box.svg-24afd61c89464af4af9f4d845ca57b9a.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=true
+editor/convert_colors_with_editor_theme=true

addons/csg_toolkit/res/icons/config.svg

@@ -0,0 +1,4 @@
+<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg">
+<circle cx="24" cy="24" r="10" stroke="#fc7f7f" stroke-width="4"/>
+<circle cx="24" cy="24" r="14" stroke="#fc7f7f" stroke-width="4" stroke-dasharray="8 2"/>
+</svg>

addons/csg_toolkit/res/icons/config.svg.import

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://clgooji83dl4u"
+path="res://.godot/imported/config.svg-dd635575de604576026d414163f67266.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/config.svg"
+dest_files=["res://.godot/imported/config.svg-dd635575de604576026d414163f67266.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/csg_toolkit/res/icons/cyliner.svg

@@ -0,0 +1 @@
+<svg height="16" viewBox="0 0 16 16" width="16" xmlns="http://www.w3.org/2000/svg"><mask id="a"><path d="M0 0h16v10a2 2 0 0 0-2-2h-2a2 2 0 0 0-2 2 2 2 0 0 0-2 2v2a2 2 0 0 0 2 2H0z" fill="#fff"/></mask><path d="M12 9a1 1 0 0 0-1 1v1h2v2h1a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1zm1 4h-2v-2h-1a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1z" fill="#5fb2ff"/><path d="M2 4v8a6 2 0 0 0 12 0V4A6 2 0 0 0 2 4a6 2 0 0 0 12 0" stroke-width="2" fill="none" stroke="#fc7f7f" mask="url(#a)"/></svg>

addons/csg_toolkit/res/icons/cyliner.svg.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://dioxt3oaqvsi3"
+path="res://.godot/imported/cyliner.svg-50489df51cf1e8dde56b511c63cd2437.ctex"
+metadata={
+"has_editor_variant": true,
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/cyliner.svg"
+dest_files=["res://.godot/imported/cyliner.svg-50489df51cf1e8dde56b511c63cd2437.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=true
+editor/convert_colors_with_editor_theme=true

addons/csg_toolkit/res/icons/empty-material.svg

@@ -0,0 +1 @@
+<svg height="16" viewBox="0 0 16 16" width="16" xmlns="http://www.w3.org/2000/svg"><linearGradient x2="0" y2="16" gradientUnits="userSpaceOnUse" id="a"><stop offset=".1875" stop-color="#ff4545"/><stop stop-color="#ffe345"/><stop offset=".3125" stop-color="#ffe345"/><stop stop-color="#80ff45"/><stop offset=".4375" stop-color="#80ff45"/><stop stop-color="#45ffa2"/><stop offset=".5625" stop-color="#45ffa2"/><stop stop-color="#45d7ff"/><stop offset=".6875" stop-color="#45d7ff"/><stop stop-color="#8045ff"/><stop offset=".8125" stop-color="#8045ff"/><stop stop-color="#ff4596"/></linearGradient><path d="m8 2 6 3v6l-6 3-6-3V5zm0 12V8l6-3M8 8 2 5" fill="none" stroke-width="2" stroke-linejoin="round" stroke="url(#a)"/></svg>

addons/csg_toolkit/res/icons/empty-material.svg.import

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://cg5jbylrlg00x"
+path="res://.godot/imported/empty-material.svg-3f6f61e9606d6bae9d37867d9ac3ad0b.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/empty-material.svg"
+dest_files=["res://.godot/imported/empty-material.svg-3f6f61e9606d6bae9d37867d9ac3ad0b.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/csg_toolkit/res/icons/intersection.svg

@@ -0,0 +1,4 @@
+<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M22.5 16.204C19.8099 17.7602 18 20.6687 18 24C18 27.3313 19.8099 30.2398 22.5 31.796C25.1901 30.2398 27 27.3313 27 24C27 20.6687 25.1901 17.7602 22.5 16.204Z" fill="#fc7f7f"/>
+<path d="M22.5 16.204C19.8099 17.7602 18 20.6687 18 24C18 27.3313 19.8099 30.2398 22.5 31.796M22.5 16.204C23.8238 15.4383 25.3607 15 27 15C31.9706 15 36 19.0294 36 24C36 28.9706 31.9706 33 27 33C25.3607 33 23.8238 32.5617 22.5 31.796M22.5 16.204C21.1762 15.4383 19.6393 15 18 15C13.0294 15 9 19.0294 9 24C9 28.9706 13.0294 33 18 33C19.6393 33 21.1762 32.5617 22.5 31.796M22.5 16.204C25.1901 17.7602 27 20.6687 27 24C27 27.3313 25.1901 30.2398 22.5 31.796" stroke="#fc7f7f"/>
+</svg>

addons/csg_toolkit/res/icons/intersection.svg.import

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://2kohi3tb3c70"
+path="res://.godot/imported/intersection.svg-a7d56bc571616c4c8343b7fe260d4607.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/intersection.svg"
+dest_files=["res://.godot/imported/intersection.svg-a7d56bc571616c4c8343b7fe260d4607.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/csg_toolkit/res/icons/mesh.svg

@@ -0,0 +1 @@
+<svg height="16" viewBox="0 0 16 16" width="16" xmlns="http://www.w3.org/2000/svg"><path d="M4.73 2A2 2 0 1 0 2 4.73v6.541A2 2 0 1 0 4.729 14H8v-2H4.729A2 2 0 0 0 4 11.271V5.415l4.914 4.916A2 2 0 0 1 9.998 10a2 2 0 0 1 .33-1.084L5.414 4h5.856a2 2 0 0 0 .73.729V8h2V4.729A2 2 0 1 0 11.27 2z" fill="#fc7f7f"/><path d="M12 9a1 1 0 0 0-1 1v1h2v2h1a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1zm1 4h-2v-2h-1a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1z" fill="#5fb2ff"/></svg>

addons/csg_toolkit/res/icons/mesh.svg.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://bnpu878eanspj"
+path="res://.godot/imported/mesh.svg-156308ec8458ed846eae996bc130ccbc.ctex"
+metadata={
+"has_editor_variant": true,
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/mesh.svg"
+dest_files=["res://.godot/imported/mesh.svg-156308ec8458ed846eae996bc130ccbc.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=true
+editor/convert_colors_with_editor_theme=true

addons/csg_toolkit/res/icons/polygon.svg

@@ -0,0 +1 @@
+<svg height="16" viewBox="0 0 16 16" width="16" xmlns="http://www.w3.org/2000/svg"><path d="m8 2 6 3.5v5L8 14l-6-3.5v-5h6zm6 3.5L8 9 2 5.5M8 9v5" fill="none" stroke-linejoin="round" stroke-width="2" stroke="#fc7f7f"/></svg>

addons/csg_toolkit/res/icons/polygon.svg.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://cjps2pofcsfc0"
+path="res://.godot/imported/polygon.svg-9526fe3ac0cb0791e6339d67ae6afbcf.ctex"
+metadata={
+"has_editor_variant": true,
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/polygon.svg"
+dest_files=["res://.godot/imported/polygon.svg-9526fe3ac0cb0791e6339d67ae6afbcf.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=true
+editor/convert_colors_with_editor_theme=true

addons/csg_toolkit/res/icons/sphere.svg

@@ -0,0 +1 @@
+<svg height="16" viewBox="0 0 16 16" width="16" xmlns="http://www.w3.org/2000/svg"><mask id="a"><path d="M0 0h16v10a2 2 0 0 0-2-2h-2a2 2 0 0 0-2 2 2 2 0 0 0-2 2v2a2 2 0 0 0 2 2H0z" fill="#fff"/></mask><path d="M12 9a1 1 0 0 0-1 1v1h2v2h1a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1zm1 4h-2v-2h-1a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1z" fill="#5fb2ff"/><path d="M8 2a6 6 0 0 0 0 12A6 6 0 0 0 8 2v12M2.05 7.4a6 2 0 0 0 11.9 0" fill="none" stroke-width="2" stroke="#fc7f7f" mask="url(#a)"/></svg>

addons/csg_toolkit/res/icons/sphere.svg.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://kpld1ou63wlf"
+path="res://.godot/imported/sphere.svg-c7c8c1311207415ed880ee6c5e1e06f9.ctex"
+metadata={
+"has_editor_variant": true,
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/sphere.svg"
+dest_files=["res://.godot/imported/sphere.svg-c7c8c1311207415ed880ee6c5e1e06f9.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=true
+editor/convert_colors_with_editor_theme=true

addons/csg_toolkit/res/icons/subtraction.svg

@@ -0,0 +1,4 @@
+<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9 24C9 28.9706 13.0294 33 18 33C19.6393 33 21.1762 32.5617 22.5 31.796C19.8099 30.2398 18 27.3313 18 24C18 20.6687 19.8099 17.7602 22.5 16.204C21.1762 15.4383 19.6393 15 18 15C13.0294 15 9 19.0294 9 24Z" fill="#fc7f7f"/>
+<path d="M22.5 16.204C19.8099 17.7602 18 20.6687 18 24C18 27.3313 19.8099 30.2398 22.5 31.796M22.5 16.204C23.8238 15.4383 25.3607 15 27 15C31.9706 15 36 19.0294 36 24C36 28.9706 31.9706 33 27 33C25.3607 33 23.8238 32.5617 22.5 31.796M22.5 16.204C21.1762 15.4383 19.6393 15 18 15C13.0294 15 9 19.0294 9 24C9 28.9706 13.0294 33 18 33C19.6393 33 21.1762 32.5617 22.5 31.796M22.5 16.204C25.1901 17.7602 27 20.6687 27 24C27 27.3313 25.1901 30.2398 22.5 31.796" stroke="#fc7f7f" stroke-width="2"/>
+</svg>

addons/csg_toolkit/res/icons/subtraction.svg.import

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://snbhkpq6sh4j"
+path="res://.godot/imported/subtraction.svg-9afd3882eada513c9c6754b2b38f150f.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/subtraction.svg"
+dest_files=["res://.godot/imported/subtraction.svg-9afd3882eada513c9c6754b2b38f150f.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/csg_toolkit/res/icons/torus.svg

@@ -0,0 +1 @@
+<svg height="16" viewBox="0 0 16 16" width="16" xmlns="http://www.w3.org/2000/svg"><mask id="a"><path d="M0 0h16v10a2 2 0 0 0-2-2h-2a2 2 0 0 0-2 2 2 2 0 0 0-2 2v2a2 2 0 0 0 2 2H0z" fill="#fff"/></mask><path d="M12 9a1 1 0 0 0-1 1v1h2v2h1a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1zm1 4h-2v-2h-1a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1z" fill="#5fb2ff"/><ellipse cx="8" cy="7.5" fill="none" rx="6" ry="3.5" stroke="#fc7f7f" stroke-width="2" mask="url(#a)"/></svg>

addons/csg_toolkit/res/icons/torus.svg.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://gbgmyv4bknqo"
+path="res://.godot/imported/torus.svg-73f1780e51211292acb9e9d40bb4276f.ctex"
+metadata={
+"has_editor_variant": true,
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/torus.svg"
+dest_files=["res://.godot/imported/torus.svg-73f1780e51211292acb9e9d40bb4276f.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=true
+editor/convert_colors_with_editor_theme=true

addons/csg_toolkit/res/icons/union.svg

@@ -0,0 +1,6 @@
+<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9 24C9 28.9706 13.0294 33 18 33C19.6393 33 21.1762 32.5617 22.5 31.796C19.8099 30.2398 18 27.3313 18 24C18 20.6687 19.8099 17.7602 22.5 16.204C21.1762 15.4383 19.6393 15 18 15C13.0294 15 9 19.0294 9 24Z" fill="#fc7f7f"/>
+<path d="M27 33C31.9706 33 36 28.9706 36 24C36 19.0294 31.9706 15 27 15C25.3607 15 23.8238 15.4383 22.5 16.204C25.1901 17.7602 27 20.6687 27 24C27 27.3313 25.1901 30.2398 22.5 31.796C23.8238 32.5617 25.3607 33 27 33Z" fill="#fc7f7f"/>
+<path d="M22.5 16.204C19.8099 17.7602 18 20.6687 18 24C18 27.3313 19.8099 30.2398 22.5 31.796C25.1901 30.2398 27 27.3313 27 24C27 20.6687 25.1901 17.7602 22.5 16.204Z" fill="#fc7f7f"/>
+<path d="M22.5 16.204C19.8099 17.7602 18 20.6687 18 24C18 27.3313 19.8099 30.2398 22.5 31.796M22.5 16.204C23.8238 15.4383 25.3607 15 27 15C31.9706 15 36 19.0294 36 24C36 28.9706 31.9706 33 27 33C25.3607 33 23.8238 32.5617 22.5 31.796M22.5 16.204C21.1762 15.4383 19.6393 15 18 15C13.0294 15 9 19.0294 9 24C9 28.9706 13.0294 33 18 33C19.6393 33 21.1762 32.5617 22.5 31.796M22.5 16.204C25.1901 17.7602 27 20.6687 27 24C27 27.3313 25.1901 30.2398 22.5 31.796" fill="#fc7f7f" />
+</svg>

addons/csg_toolkit/res/icons/union.svg.import

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://sc7itwu80oi3"
+path="res://.godot/imported/union.svg-330af8601d6493b573ab68d43d4b23f3.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/icons/union.svg"
+dest_files=["res://.godot/imported/union.svg-330af8601d6493b573ab68d43d4b23f3.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/csg_toolkit/res/image.png.import

@@ -0,0 +1,34 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://d0dy7wteea7l5"
+path="res://.godot/imported/image.png-e18db3df6f24d50b719c17a226c337bd.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/csg_toolkit/res/image.png"
+dest_files=["res://.godot/imported/image.png-e18db3df6f24d50b719c17a226c337bd.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1

addons/csg_toolkit/res/operation_group.tres

@@ -0,0 +1,3 @@
+[gd_resource type="ButtonGroup" format=3 uid="uid://wxtkg1wlxka8"]
+
+[resource]

addons/csg_toolkit/scenes/config_window.tscn

@@ -0,0 +1,125 @@
+[gd_scene load_steps=4 format=3 uid="uid://dts41g6camqwq"]
+
+[ext_resource type="Script" uid="uid://b7isqiq2asnu6" path="res://addons/csg_toolkit/scripts/config_window.gd" id="1_pigko"]
+
+[sub_resource type="StyleBoxEmpty" id="StyleBoxEmpty_ng5lh"]
+
+[sub_resource type="StyleBoxEmpty" id="StyleBoxEmpty_vj6tm"]
+
+[node name="ConfigWindow" type="Window"]
+oversampling_override = 1.0
+title = "CSG Toolit Configuration"
+initial_position = 1
+size = Vector2i(480, 360)
+popup_window = true
+script = ExtResource("1_pigko")
+
+[node name="MarginContainer" type="MarginContainer" parent="."]
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+theme_override_constants/margin_left = 8
+theme_override_constants/margin_top = 8
+theme_override_constants/margin_right = 8
+theme_override_constants/margin_bottom = 8
+
+[node name="VBoxContainer" type="VBoxContainer" parent="MarginContainer"]
+layout_mode = 2
+size_flags_horizontal = 3
+theme_override_constants/separation = 8
+
+[node name="HBoxContainer" type="HBoxContainer" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+
+[node name="Label" type="Label" parent="MarginContainer/VBoxContainer/HBoxContainer"]
+layout_mode = 2
+text = "Default Behavior"
+
+[node name="VSeparator" type="VSeparator" parent="MarginContainer/VBoxContainer/HBoxContainer"]
+layout_mode = 2
+size_flags_horizontal = 3
+theme_override_styles/separator = SubResource("StyleBoxEmpty_ng5lh")
+
+[node name="OptionButton" type="OptionButton" parent="MarginContainer/VBoxContainer/HBoxContainer"]
+layout_mode = 2
+selected = 0
+item_count = 2
+popup/item_0/text = "Sibling"
+popup/item_0/id = 0
+popup/item_1/text = "Child"
+popup/item_1/id = 1
+
+[node name="HBoxContainer2" type="HBoxContainer" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+
+[node name="Label" type="Label" parent="MarginContainer/VBoxContainer/HBoxContainer2"]
+layout_mode = 2
+text = "Action Key"
+
+[node name="VSeparator" type="VSeparator" parent="MarginContainer/VBoxContainer/HBoxContainer2"]
+layout_mode = 2
+size_flags_horizontal = 3
+theme_override_styles/separator = SubResource("StyleBoxEmpty_ng5lh")
+
+[node name="Button" type="Button" parent="MarginContainer/VBoxContainer/HBoxContainer2"]
+layout_mode = 2
+text = "Shift"
+
+[node name="HBoxContainer4" type="HBoxContainer" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+
+[node name="Label" type="Label" parent="MarginContainer/VBoxContainer/HBoxContainer4"]
+layout_mode = 2
+text = "Behvaior Toggle"
+
+[node name="VSeparator" type="VSeparator" parent="MarginContainer/VBoxContainer/HBoxContainer4"]
+layout_mode = 2
+size_flags_horizontal = 3
+theme_override_styles/separator = SubResource("StyleBoxEmpty_ng5lh")
+
+[node name="Button" type="Button" parent="MarginContainer/VBoxContainer/HBoxContainer4"]
+layout_mode = 2
+text = "Shift"
+
+[node name="HBoxContainer3" type="HBoxContainer" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+
+[node name="Label" type="Label" parent="MarginContainer/VBoxContainer/HBoxContainer3"]
+layout_mode = 2
+text = "Auto Hide"
+
+[node name="VSeparator" type="VSeparator" parent="MarginContainer/VBoxContainer/HBoxContainer3"]
+layout_mode = 2
+size_flags_horizontal = 3
+theme_override_styles/separator = SubResource("StyleBoxEmpty_ng5lh")
+
+[node name="CheckButton" type="CheckBox" parent="MarginContainer/VBoxContainer/HBoxContainer3"]
+layout_mode = 2
+button_pressed = true
+
+[node name="HSeparator" type="HSeparator" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+size_flags_vertical = 3
+theme_override_styles/separator = SubResource("StyleBoxEmpty_vj6tm")
+
+[node name="Save" type="Button" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+text = "Save"
+
+[node name="HSeparator2" type="HSeparator" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+
+[node name="Ko-Fi" type="LinkButton" parent="MarginContainer/VBoxContainer"]
+layout_mode = 2
+size_flags_horizontal = 4
+text = "Support me on Ko-Fi"
+underline = 1
+uri = "https://ko-fi.com/luckyteapot"
+
+[connection signal="item_selected" from="MarginContainer/VBoxContainer/HBoxContainer/OptionButton" to="." method="_on_option_button_item_selected"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/HBoxContainer2/Button" to="." method="_on_button_pressed"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/HBoxContainer4/Button" to="." method="_on_second_button_pressed"]
+[connection signal="toggled" from="MarginContainer/VBoxContainer/HBoxContainer3/CheckButton" to="." method="_on_check_box_toggled"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/Save" to="." method="_on_save_pressed"]

addons/csg_toolkit/scenes/csg_quick_actions.tscn

@@ -0,0 +1,20 @@
+[gd_scene load_steps=2 format=3 uid="uid://dhpjubljm0tf0"]
+
+[ext_resource type="Texture2D" uid="uid://cjxx30pcamj36" path="res://addons/csg_toolkit/res/icons/box.svg" id="1_n1dqv"]
+
+[node name="CsgQuickActions" type="Control"]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="CenterContainer" type="CenterContainer" parent="."]
+layout_mode = 0
+offset_right = 40.0
+offset_bottom = 40.0
+
+[node name="Box" type="TextureButton" parent="CenterContainer"]
+layout_mode = 2
+texture_normal = ExtResource("1_n1dqv")

addons/csg_toolkit/scenes/csg_side_toolkit_bar.tscn

@@ -0,0 +1,179 @@
+[gd_scene load_steps=15 format=3 uid="uid://cdjxmp0p1bbup"]
+
+[ext_resource type="Script" uid="uid://dr5f1egll7hdq" path="res://addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd" id="1_awo4p"]
+[ext_resource type="Texture2D" uid="uid://cjxx30pcamj36" path="res://addons/csg_toolkit/res/icons/box.svg" id="2_p4f7r"]
+[ext_resource type="Texture2D" uid="uid://dioxt3oaqvsi3" path="res://addons/csg_toolkit/res/icons/cyliner.svg" id="3_j7s68"]
+[ext_resource type="Texture2D" uid="uid://bnpu878eanspj" path="res://addons/csg_toolkit/res/icons/mesh.svg" id="4_328ee"]
+[ext_resource type="Texture2D" uid="uid://cjps2pofcsfc0" path="res://addons/csg_toolkit/res/icons/polygon.svg" id="5_0os5t"]
+[ext_resource type="Texture2D" uid="uid://kpld1ou63wlf" path="res://addons/csg_toolkit/res/icons/sphere.svg" id="6_ju1pi"]
+[ext_resource type="Texture2D" uid="uid://gbgmyv4bknqo" path="res://addons/csg_toolkit/res/icons/torus.svg" id="7_6hoxg"]
+[ext_resource type="Texture2D" uid="uid://sc7itwu80oi3" path="res://addons/csg_toolkit/res/icons/union.svg" id="8_gmt87"]
+[ext_resource type="Texture2D" uid="uid://2kohi3tb3c70" path="res://addons/csg_toolkit/res/icons/intersection.svg" id="9_55ipi"]
+[ext_resource type="Texture2D" uid="uid://snbhkpq6sh4j" path="res://addons/csg_toolkit/res/icons/subtraction.svg" id="10_8u5xb"]
+[ext_resource type="Texture2D" uid="uid://cg5jbylrlg00x" path="res://addons/csg_toolkit/res/icons/empty-material.svg" id="11_ten1m"]
+[ext_resource type="Texture2D" uid="uid://clgooji83dl4u" path="res://addons/csg_toolkit/res/icons/config.svg" id="12_3gawg"]
+
+[sub_resource type="ButtonGroup" id="ButtonGroup_2ipgb"]
+
+[sub_resource type="StyleBoxEmpty" id="StyleBoxEmpty_ixko7"]
+
+[node name="MarginContainer" type="MarginContainer"]
+visible = false
+custom_minimum_size = Vector2(52, 0)
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+offset_right = -2.0
+grow_horizontal = 2
+grow_vertical = 2
+theme_override_constants/margin_top = 8
+theme_override_constants/margin_bottom = 8
+script = ExtResource("1_awo4p")
+
+[node name="ScrollContainer" type="ScrollContainer" parent="."]
+layout_mode = 2
+horizontal_scroll_mode = 0
+
+[node name="HBoxContainer" type="VBoxContainer" parent="ScrollContainer"]
+custom_minimum_size = Vector2(0, 120)
+layout_mode = 2
+size_flags_horizontal = 6
+size_flags_vertical = 3
+theme_override_constants/separation = 16
+alignment = 1
+
+[node name="CSG" type="VBoxContainer" parent="ScrollContainer/HBoxContainer"]
+layout_mode = 2
+alignment = 1
+
+[node name="Box" type="Button" parent="ScrollContainer/HBoxContainer/CSG"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Box"
+icon = ExtResource("2_p4f7r")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Cylinder" type="Button" parent="ScrollContainer/HBoxContainer/CSG"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Cylinder"
+theme_override_constants/icon_max_width = 24
+icon = ExtResource("3_j7s68")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Mesh" type="Button" parent="ScrollContainer/HBoxContainer/CSG"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Mesh"
+theme_override_constants/icon_max_width = 24
+icon = ExtResource("4_328ee")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Polygon" type="Button" parent="ScrollContainer/HBoxContainer/CSG"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Polygon"
+theme_override_constants/icon_max_width = 24
+icon = ExtResource("5_0os5t")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Sphere" type="Button" parent="ScrollContainer/HBoxContainer/CSG"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Sphere"
+theme_override_constants/icon_max_width = 24
+icon = ExtResource("6_ju1pi")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Torus" type="Button" parent="ScrollContainer/HBoxContainer/CSG"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Torus"
+theme_override_constants/icon_max_width = 24
+icon = ExtResource("7_6hoxg")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Operation" type="VBoxContainer" parent="ScrollContainer/HBoxContainer"]
+layout_mode = 2
+alignment = 1
+
+[node name="Union" type="Button" parent="ScrollContainer/HBoxContainer/Operation"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Union"
+theme_override_constants/icon_max_width = 24
+toggle_mode = true
+button_group = SubResource("ButtonGroup_2ipgb")
+icon = ExtResource("8_gmt87")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Intersection" type="Button" parent="ScrollContainer/HBoxContainer/Operation"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Intersection"
+theme_override_constants/icon_max_width = 24
+toggle_mode = true
+button_group = SubResource("ButtonGroup_2ipgb")
+icon = ExtResource("9_55ipi")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Subtraction" type="Button" parent="ScrollContainer/HBoxContainer/Operation"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Subtraction"
+theme_override_constants/icon_max_width = 24
+toggle_mode = true
+button_group = SubResource("ButtonGroup_2ipgb")
+icon = ExtResource("10_8u5xb")
+icon_alignment = 1
+expand_icon = true
+
+[node name="Material" type="VBoxContainer" parent="ScrollContainer/HBoxContainer"]
+layout_mode = 2
+alignment = 1
+
+[node name="MaterialPicker" type="Button" parent="ScrollContainer/HBoxContainer/Material"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Material"
+icon = ExtResource("11_ten1m")
+icon_alignment = 1
+expand_icon = true
+
+[node name="HSeparator" type="HSeparator" parent="ScrollContainer/HBoxContainer"]
+layout_mode = 2
+size_flags_vertical = 3
+theme_override_styles/separator = SubResource("StyleBoxEmpty_ixko7")
+
+[node name="Options" type="VBoxContainer" parent="ScrollContainer/HBoxContainer"]
+layout_mode = 2
+size_flags_horizontal = 4
+alignment = 1
+
+[node name="Config" type="Button" parent="ScrollContainer/HBoxContainer/Options"]
+custom_minimum_size = Vector2(42, 42)
+layout_mode = 2
+tooltip_text = "Config"
+theme_override_constants/icon_max_width = 24
+icon = ExtResource("12_3gawg")
+icon_alignment = 1
+
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/CSG/Box" to="." method="_on_box_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/CSG/Cylinder" to="." method="_on_cylinder_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/CSG/Mesh" to="." method="_on_mesh_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/CSG/Polygon" to="." method="_on_polygon_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/CSG/Sphere" to="." method="_on_sphere_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/CSG/Torus" to="." method="_on_torus_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/Operation/Union" to="." method="_on_operation_pressed" binds= [0]]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/Operation/Intersection" to="." method="_on_operation_pressed" binds= [1]]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/Operation/Subtraction" to="." method="_on_operation_pressed" binds= [2]]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/Material/MaterialPicker" to="." method="_on_material_picker_pressed"]
+[connection signal="pressed" from="ScrollContainer/HBoxContainer/Options/Config" to="." method="_on_config_pressed"]

addons/csg_toolkit/scenes/csg_top_toolkit_bar.tscn

@@ -0,0 +1,16 @@
+[gd_scene load_steps=2 format=3 uid="uid://dgldacs362p7g"]
+
+[ext_resource type="Script" uid="uid://dk6dt8fk1s43s" path="res://addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd" id="1_154hl"]
+
+[node name="HBoxContainer" type="HBoxContainer"]
+visible = false
+offset_right = 40.0
+offset_bottom = 40.0
+script = ExtResource("1_154hl")
+
+[node name="Refresh" type="Button" parent="."]
+layout_mode = 2
+text = "Refresh"
+flat = true
+
+[connection signal="pressed" from="Refresh" to="." method="_on_refresh_pressed"]

addons/csg_toolkit/scenes/demo.tscn

@@ -0,0 +1,5 @@
+[gd_scene format=3 uid="uid://b6adrnqobv5fi"]
+
+[node name="Demo" type="Node3D"]
+
+[node name="CSGBox3D" type="CSGBox3D" parent="."]

addons/csg_toolkit/scripts/config_window.gd

@@ -0,0 +1,46 @@
+@tool
+extends Window
+
+@onready var config: CsgTkConfig:
+	get: return get_tree().root.get_node(CsgToolkit.AUTOLOAD_NAME) as CsgTkConfig
+
+@onready var default_behavior_option: OptionButton = $MarginContainer/VBoxContainer/HBoxContainer/OptionButton
+@onready var action_key_button: Button = $MarginContainer/VBoxContainer/HBoxContainer2/Button
+@onready var behvaior_toogle_button: Button = $MarginContainer/VBoxContainer/HBoxContainer4/Button
+@onready var auto_hide_switch: CheckBox = $MarginContainer/VBoxContainer/HBoxContainer3/CheckButton
+
+signal key_press(key: InputEventKey)
+ 
+func _ready():
+	default_behavior_option.select(config.default_behavior)
+	action_key_button.text = OS.get_keycode_string(config.action_key)
+	behvaior_toogle_button.text = OS.get_keycode_string(config.secondary_action_key)
+	auto_hide_switch.button_pressed = config.auto_hide
+
+func _on_option_button_item_selected(index):
+	match index:
+		0: config.default_behavior = CsgTkConfig.CSGBehavior.SIBLING
+		1: config.default_behavior = CsgTkConfig.CSGBehavior.CHILD
+
+func _unhandled_input(event):
+	if event is InputEventKey:
+		if event.pressed:
+			key_press.emit(event)
+
+func _on_save_pressed():
+	config.save_config()
+	hide()
+
+func _on_button_pressed():
+	var key_event: InputEventKey = await key_press
+	config.action_key = key_event.keycode
+	action_key_button.text = key_event.as_text_key_label()
+
+func _on_second_button_pressed():
+	var key_event: InputEventKey = await key_press
+	config.secondary_action_key = key_event.keycode
+	behvaior_toogle_button.text = key_event.as_text_key_label()
+
+
+func _on_check_box_toggled(toggled_on):
+	config.auto_hide = toggled_on

addons/csg_toolkit/scripts/config_window.gd.uid

@@ -0,0 +1 @@
+uid://b7isqiq2asnu6

addons/csg_toolkit/scripts/csg_repeater_3d.gd

@@ -0,0 +1,522 @@
+@tool
+class_name CSGRepeater3D extends CSGCombiner3D
+
+# NOTE: Registered as custom type in plugin (csg_toolkit.gd) inheriting CSGCombiner3D.
+# Ensure pattern resource scripts are loaded (Godot should handle via class_name, but we force references for safety):
+const _REF_GRID = preload("res://addons/csg_toolkit/scripts/patterns/grid_pattern.gd") # ensure subclass scripts loaded
+const _REF_CIRC = preload("res://addons/csg_toolkit/scripts/patterns/circular_pattern.gd")
+const _REF_SPIRAL = preload("res://addons/csg_toolkit/scripts/patterns/spiral_pattern.gd")
+const _REF_NOISE = preload("res://addons/csg_toolkit/scripts/patterns/noise_pattern.gd")
+
+const REPEATER_NODE_META = "REPEATED_NODE_META"
+const MAX_INSTANCES = 20000
+
+var _dirty: bool = false
+var _template_node_path: NodePath
+@export var template_node_path: NodePath:
+	get: return _template_node_path
+	set(value):
+		_template_node_path = value
+		_mark_dirty()
+
+var _template_node_scene: PackedScene
+@export var template_node_scene: PackedScene:
+	get: return _template_node_scene
+	set(value):
+		_template_node_scene = value
+		_mark_dirty()
+
+var _hide_template: bool = true
+@export var hide_template: bool = true:
+	get: return _hide_template
+	set(value):
+		_hide_template = value
+		_update_template_visibility()
+
+## repeat & spacing removed (migrated into pattern resources)
+
+@export_group("Pattern Options")
+# A single exported pattern resource (`pattern`) defines generation behavior.
+
+
+@export_group("Variation Options")
+# Rotation variation properties now managed via custom property list for collapsible enable group.
+var _randomize_rotation: bool = false
+var randomize_rotation: bool:
+	get: return _randomize_rotation
+	set(value):
+		_randomize_rotation = value
+		_mark_dirty()
+		notify_property_list_changed()
+
+var _randomize_rot_x: bool = false
+var randomize_rot_x: bool:
+	get: return _randomize_rot_x
+	set(value):
+		_randomize_rot_x = value
+		if _randomize_rotation: _mark_dirty()
+		notify_property_list_changed()
+
+var _randomize_rot_y: bool = false
+var randomize_rot_y: bool:
+	get: return _randomize_rot_y
+	set(value):
+		_randomize_rot_y = value
+		if _randomize_rotation: _mark_dirty()
+		notify_property_list_changed()
+
+var _randomize_rot_z: bool = false
+var randomize_rot_z: bool:
+	get: return _randomize_rot_z
+	set(value):
+		_randomize_rot_z = value
+		if _randomize_rotation: _mark_dirty()
+		notify_property_list_changed()
+
+# Per-axis rotation variance in degrees (0 = full 0..360 random for that axis; >0 jitters around original)
+var _rotation_variance_x_deg: float = 0.0
+var rotation_variance_x_deg: float:
+	get: return _rotation_variance_x_deg
+	set(value):
+		_rotation_variance_x_deg = clamp(value, 0.0, 360.0)
+		if _randomize_rotation and _randomize_rot_x: _mark_dirty()
+
+var _rotation_variance_y_deg: float = 0.0
+var rotation_variance_y_deg: float:
+	get: return _rotation_variance_y_deg
+	set(value):
+		_rotation_variance_y_deg = clamp(value, 0.0, 360.0)
+		if _randomize_rotation and _randomize_rot_y: _mark_dirty()
+
+var _rotation_variance_z_deg: float = 0.0
+var rotation_variance_z_deg: float:
+	get: return _rotation_variance_z_deg
+	set(value):
+		_rotation_variance_z_deg = clamp(value, 0.0, 360.0)
+		if _randomize_rotation and _randomize_rot_z: _mark_dirty()
+
+var _randomize_scale: bool = false
+var randomize_scale: bool:
+	get: return _randomize_scale
+	set(value):
+		_randomize_scale = value
+		_mark_dirty()
+		notify_property_list_changed()
+
+var _scale_variance: float = 0.0
+var scale_variance: float:
+	get: return _scale_variance
+	set(value):
+		_scale_variance = clamp(value, 0.0, 1.0)
+		if _randomize_scale:
+			_mark_dirty()
+
+# Per-axis scale variance (if zero => use global variance when axis toggle active)
+var _scale_variance_x: float = 0.0
+var scale_variance_x: float:
+	get: return _scale_variance_x
+	set(value):
+		_scale_variance_x = clamp(value, 0.0, 1.0)
+		if _randomize_scale and _randomize_scale_x: _mark_dirty()
+
+var _scale_variance_y: float = 0.0
+var scale_variance_y: float:
+	get: return _scale_variance_y
+	set(value):
+		_scale_variance_y = clamp(value, 0.0, 1.0)
+		if _randomize_scale and _randomize_scale_y: _mark_dirty()
+
+var _scale_variance_z: float = 0.0
+var scale_variance_z: float:
+	get: return _scale_variance_z
+	set(value):
+		_scale_variance_z = clamp(value, 0.0, 1.0)
+		if _randomize_scale and _randomize_scale_z: _mark_dirty()
+
+# Per-axis scale randomization toggles (optional – if none enabled acts as uniform variance on all axes)
+var _randomize_scale_x: bool = false
+var randomize_scale_x: bool:
+	get: return _randomize_scale_x
+	set(value):
+		_randomize_scale_x = value
+		if _randomize_scale: _mark_dirty()
+		notify_property_list_changed()
+
+var _randomize_scale_y: bool = false
+var randomize_scale_y: bool:
+	get: return _randomize_scale_y
+	set(value):
+		_randomize_scale_y = value
+		if _randomize_scale: _mark_dirty()
+		notify_property_list_changed()
+
+var _randomize_scale_z: bool = false
+var randomize_scale_z: bool:
+	get: return _randomize_scale_z
+	set(value):
+		_randomize_scale_z = value
+		if _randomize_scale: _mark_dirty()
+		notify_property_list_changed()
+
+var _position_jitter: float = 0.0
+@export var position_jitter: float = 0.0:
+	get: return _position_jitter
+	set(value):
+		_position_jitter = max(0.0, value)
+		_mark_dirty()
+
+var _random_seed: int = 0
+@export var random_seed: int = 0:
+	get: return _random_seed
+	set(value):
+		_random_seed = value
+		_mark_dirty()
+
+# Estimated instance count (read-only in inspector; updated internally)
+@export var estimated_instances: int = 0
+
+var rng: RandomNumberGenerator
+var _generation_in_progress := false
+var _pattern: CSGPattern
+@export var pattern: CSGPattern:
+	get: return _pattern
+	set(value):
+		if value == _pattern:
+			return
+		# Reject non-CSGPattern resources
+		if value != null and not (value is CSGPattern):
+			push_warning("Assigned pattern is not a CSGPattern-derived resource; ignoring.")
+			return
+		# Prevent assigning the abstract base directly (must use subclass)
+		if value != null and value.get_class() == "CSGPattern":
+			push_warning("Cannot assign base CSGPattern directly. Please use a concrete pattern (Grid, Circular, Spiral...).")
+			return
+		# Disconnect old
+		if _pattern and _pattern.is_connected("changed", Callable(self, "_on_pattern_changed")):
+			_pattern.disconnect("changed", Callable(self, "_on_pattern_changed"))
+		_pattern = value
+		if _pattern and not _pattern.is_connected("changed", Callable(self, "_on_pattern_changed")):
+			_pattern.connect("changed", Callable(self, "_on_pattern_changed"))
+		_mark_dirty()
+
+func _ready():
+	rng = RandomNumberGenerator.new()
+	# Provide a default pattern if none assigned (through setter for signal wiring).
+	if pattern == null:
+		pattern = CSGGridPattern.new()
+	_mark_dirty()
+	# Generate instances in-game on ready
+	if not Engine.is_editor_hint():
+		call_deferred("repeat_template")
+
+func _on_pattern_changed():
+	# Called when the assigned pattern resource's exported properties are edited in inspector.
+	_mark_dirty()
+
+func _process(_delta):
+	if not Engine.is_editor_hint(): return
+	if _dirty and not _generation_in_progress:
+		_dirty = false
+		call_deferred("repeat_template")
+
+func _exit_tree():
+	# Clean up any remaining repeated nodes
+	clear_children()
+
+func _mark_dirty():
+	_dirty = true
+
+func _update_template_visibility():
+	if not is_inside_tree():
+		return
+	var template_node = get_node_or_null(template_node_path)
+	if template_node and template_node is Node3D:
+		template_node.visible = not _hide_template
+
+func clear_children():
+	# Clear existing children except the template node
+	var children_to_remove = []
+	for child in get_children(true):
+		if child.has_meta(REPEATER_NODE_META):
+			children_to_remove.append(child)
+	# Remove children immediately for better performance
+	for child in children_to_remove:
+		remove_child(child)
+		child.queue_free()
+
+func repeat_template():
+	if _generation_in_progress:
+		return
+	_generation_in_progress = true
+	clear_children()
+
+	var template_node = get_node_or_null(template_node_path)
+	var using_scene = false
+	# Determine template source
+	if not template_node:
+		if not template_node_scene or not template_node_scene.can_instantiate():
+			_generation_in_progress = false
+			return
+		template_node = template_node_scene.instantiate()
+		using_scene = true
+		add_child(template_node)
+
+	# Use pattern estimation for cap check
+	var template_size := _get_template_size(template_node)
+	var ctx_cap := {"template_size": template_size, "rng": rng, "position_jitter": _position_jitter}
+	var estimate := 0
+	if pattern:
+		estimate = pattern.get_estimated_count(ctx_cap)
+	if estimate <= 1:
+		if using_scene:
+			remove_child(template_node)
+			template_node.queue_free()
+		_generation_in_progress = false
+		return
+	if estimate > MAX_INSTANCES:
+		push_warning("CSGRepeater3D: Estimated count %s exceeds cap %s. Aborting generation." % [estimate, MAX_INSTANCES])
+		_generation_in_progress = false
+		return
+
+	rng.seed = _random_seed
+	# template_size already computed earlier (template_size variable)
+	var positions = _generate_positions(template_size)
+	estimated_instances = positions.size() - 1
+
+	for i in range(positions.size()):
+		var position = positions[i]
+		if i == 0 and position.is_zero_approx():
+			continue
+		var instance = template_node.duplicate()
+		if instance == null:
+			continue
+		instance.set_meta(REPEATER_NODE_META, true)
+		instance.transform.origin = position
+		# Ensure instance is visible regardless of template visibility
+		if instance is Node3D:
+			instance.visible = true
+		_apply_variations(instance)
+		add_child(instance)
+
+	if using_scene:
+		remove_child(template_node)
+		template_node.queue_free()
+	else:
+		_update_template_visibility()
+	_generation_in_progress = false
+
+func _generate_positions(template_size: Vector3) -> Array:
+	var ctx: Dictionary = {"template_size": template_size, "rng": rng, "position_jitter": _position_jitter}
+	if pattern == null:
+		return []
+	return pattern.generate(ctx)
+
+
+# -- Geometry-based spacing helpers -------------------------------------------------
+
+func _get_template_size(template_node: Node) -> Vector3:
+	if template_node == null or not (template_node is Node3D):
+		return Vector3.ONE
+	var aabb := _get_combined_aabb(template_node)
+	var size: Vector3 = aabb.size
+	if size.x <= 0.0001: size.x = 1.0
+	if size.y <= 0.0001: size.y = 1.0
+	if size.z <= 0.0001: size.z = 1.0
+	return size
+
+func _get_combined_aabb(node: Node) -> AABB:
+	var found := false
+	var combined := AABB()
+	if node is Node3D and node.has_method("get_aabb"):
+		var aabb = node.get_aabb()
+		combined = aabb
+		found = true
+	for child in node.get_children():
+		if child is Node3D:
+			var child_aabb = _get_combined_aabb(child)
+			if child_aabb.size != Vector3.ZERO:
+				if not found:
+					combined = child_aabb
+					found = true
+				else:
+					combined = combined.merge(child_aabb)
+	return combined if found else AABB(Vector3.ZERO, Vector3.ZERO)
+
+func _apply_material_recursive(node: Node, material: Material):
+	if node is CSGShape3D:
+		node.material_override = material
+	for child in node.get_children():
+		_apply_material_recursive(child, material)
+
+
+func _apply_variations(instance: Node3D):
+	if _randomize_rotation:
+		var final_rot := instance.rotation
+		if _randomize_rot_x:
+			if _rotation_variance_x_deg > 0.0:
+				final_rot.x += rng.randf_range(-deg_to_rad(_rotation_variance_x_deg), deg_to_rad(_rotation_variance_x_deg))
+			else:
+				final_rot.x = rng.randf() * TAU
+		if _randomize_rot_y:
+			if _rotation_variance_y_deg > 0.0:
+				final_rot.y += rng.randf_range(-deg_to_rad(_rotation_variance_y_deg), deg_to_rad(_rotation_variance_y_deg))
+			else:
+				final_rot.y = rng.randf() * TAU
+		if _randomize_rot_z:
+			if _rotation_variance_z_deg > 0.0:
+				final_rot.z += rng.randf_range(-deg_to_rad(_rotation_variance_z_deg), deg_to_rad(_rotation_variance_z_deg))
+			else:
+				final_rot.z = rng.randf() * TAU
+		instance.rotation = final_rot
+	if _randomize_scale:
+		# If any axis toggles are on, apply independent variance per axis; else uniform.
+		var use_axes = _randomize_scale_x or _randomize_scale_y or _randomize_scale_z
+		if use_axes:
+			var sx = instance.scale.x
+			var sy = instance.scale.y
+			var sz = instance.scale.z
+			if _randomize_scale_x:
+				var vx = (_scale_variance_x if _scale_variance_x > 0.0 else _scale_variance)
+				sx *= max(0.1, 1.0 + rng.randf_range(-vx, vx))
+			if _randomize_scale_y:
+				var vy = (_scale_variance_y if _scale_variance_y > 0.0 else _scale_variance)
+				sy *= max(0.1, 1.0 + rng.randf_range(-vy, vy))
+			if _randomize_scale_z:
+				var vz = (_scale_variance_z if _scale_variance_z > 0.0 else _scale_variance)
+				sz *= max(0.1, 1.0 + rng.randf_range(-vz, vz))
+			instance.scale = Vector3(sx, sy, sz)
+		else:
+			var scale_factor = max(0.1, 1.0 + rng.randf_range(-_scale_variance, _scale_variance))
+			instance.scale *= scale_factor
+
+func regenerate():
+	_mark_dirty()
+
+# -- Custom property list (Godot 4.5 group enable support) -------------------------
+func _get_property_list() -> Array:
+	var props: Array = []
+
+	# Keep default exported properties (engine already exposes them). Only inject
+	# the rotation variation cluster with group enable + subgroup organization.
+
+	# Group header for random rotation feature.
+	# Variation Options parent group
+	props.append({
+		"name": "Variation Options",
+		"type": TYPE_NIL,
+		"usage": PROPERTY_USAGE_GROUP
+	})
+	# Rotation subgroup under Variation Options
+	props.append({
+		"name": "Rotation Randomization",
+		"type": TYPE_NIL,
+		"usage": PROPERTY_USAGE_SUBGROUP
+	})
+	# Enabling checkbox on group header via PROPERTY_HINT_GROUP_ENABLE.
+	props.append({
+		"name": "randomize_rotation",
+		"type": TYPE_BOOL,
+		"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR,
+		"hint": PROPERTY_HINT_GROUP_ENABLE
+	})
+	# Per-axis random toggles
+	props.append(_prop_bool("randomize_rot_x"))
+	if _randomize_rotation and _randomize_rot_x:
+		props.append({
+			"name": "rotation_variance_x_deg",
+			"type": TYPE_FLOAT,
+			"hint": PROPERTY_HINT_RANGE,
+			"hint_string": "0,360,0.1,degrees",
+			"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR
+		})
+	props.append(_prop_bool("randomize_rot_y"))
+	if _randomize_rotation and _randomize_rot_y:
+		props.append({
+			"name": "rotation_variance_y_deg",
+			"type": TYPE_FLOAT,
+			"hint": PROPERTY_HINT_RANGE,
+			"hint_string": "0,360,0.1,degrees",
+			"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR
+		})
+	props.append(_prop_bool("randomize_rot_z"))
+	if _randomize_rotation and _randomize_rot_z:
+		props.append({
+			"name": "rotation_variance_z_deg",
+			"type": TYPE_FLOAT,
+			"hint": PROPERTY_HINT_RANGE,
+			"hint_string": "0,360,0.1,degrees",
+			"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR
+		})
+
+	# Subgroup for locked rotations (should reside inside Rotation Randomization group)
+	# (Locked rotations removed as per user request)
+
+	# Scale variation subgroup under Variation Options
+	props.append({
+		"name": "Scale Variation",
+		"type": TYPE_NIL,
+		"usage": PROPERTY_USAGE_SUBGROUP
+	})
+	props.append({
+		"name": "randomize_scale",
+		"type": TYPE_BOOL,
+		"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR,
+		"hint": PROPERTY_HINT_GROUP_ENABLE
+	})
+	props.append(_prop_float_range("scale_variance", "0,1,0.01"))
+	props.append(_prop_bool("randomize_scale_x"))
+	if _randomize_scale and _randomize_scale_x:
+		props.append(_prop_float_range("scale_variance_x", "0,1,0.01"))
+	props.append(_prop_bool("randomize_scale_y"))
+	if _randomize_scale and _randomize_scale_y:
+		props.append(_prop_float_range("scale_variance_y", "0,1,0.01"))
+	props.append(_prop_bool("randomize_scale_z"))
+	if _randomize_scale and _randomize_scale_z:
+		props.append(_prop_float_range("scale_variance_z", "0,1,0.01"))
+
+	return props
+
+func _prop_bool(name: String) -> Dictionary:
+	return {
+		"name": name,
+		"type": TYPE_BOOL,
+		"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR
+	}
+
+func _prop_float_deg(name: String, value: float) -> Dictionary:
+	return {
+		"name": name,
+		"type": TYPE_FLOAT,
+		"hint": PROPERTY_HINT_RANGE,
+		"hint_string": "-360,360,0.1,degrees",
+		"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR
+	}
+
+func _prop_float_range(name: String, hint_str: String) -> Dictionary:
+	return {
+		"name": name,
+		"type": TYPE_FLOAT,
+		"hint": PROPERTY_HINT_RANGE,
+		"hint_string": hint_str,
+		"usage": PROPERTY_USAGE_STORAGE | PROPERTY_USAGE_EDITOR
+	}
+
+func get_instance_count() -> int:
+	if pattern == null:
+		return 0
+	var ctx := {"template_size": Vector3.ONE, "rng": rng, "position_jitter": _position_jitter}
+	return max(0, pattern.get_estimated_count(ctx) - 1)
+
+func apply_template():
+	if get_child_count() == 0:
+		return
+	var stack = []
+	stack.append_array(get_children())
+	while stack.size() > 0:
+		var node = stack.pop_back()
+		node.set_owner(owner)
+		stack.append_array(node.get_children())
+
+# Alias for clarity in UI
+func bake_instances():
+	apply_template()

addons/csg_toolkit/scripts/csg_repeater_3d.gd.uid

@@ -0,0 +1 @@
+uid://c68dxahp0v5xg

addons/csg_toolkit/scripts/csg_shortcut_manager.gd

@@ -0,0 +1,86 @@
+@tool
+extends Node
+class_name CsgShortcutManager
+
+# Provides global key handling for quick CSG creation & operation switching (Layers 1 & 2)
+# Delegates actual creation to the sidebar instance to reuse UndoRedo + material logic.
+
+var sidebar: CSGSideToolkitBar
+var config: CsgTkConfig
+
+# Mapping shape keycode -> factory id (string used for log / optional future use)
+var _shape_key_map: Dictionary = {
+	KEY_B: CSGBox3D,
+	KEY_S: CSGSphere3D,
+	KEY_C: CSGCylinder3D,
+	KEY_T: CSGTorus3D,
+	KEY_M: CSGMesh3D,
+	KEY_P: CSGPolygon3D,
+}
+
+# Layer 2 operation selection numbers
+var _op_number_map: Dictionary = {
+	KEY_1: 0, # Union
+	KEY_2: 1, # Intersection
+	KEY_3: 2, # Subtraction
+}
+
+# Optional cycle order
+var _op_cycle: Array = [0,1,2]
+var _cycle_index := 0
+
+func _enter_tree():
+	set_process_unhandled_key_input(true)
+
+func _unhandled_key_input(event: InputEvent):
+	if not event is InputEventKey: return
+	var ev := event as InputEventKey
+	if not ev.pressed or ev.echo: return
+	if config == null:
+		config = get_tree().root.get_node_or_null(CsgToolkit.AUTOLOAD_NAME) as CsgTkConfig
+	if sidebar == null:
+		# Try to find existing sidebar if not explicitly set
+		var candidates = get_tree().get_nodes_in_group("CSGSideToolkit")
+		if candidates.size() > 0:
+			sidebar = candidates[0]
+	# Prevent interfering with text input fields
+	var focus_owner = get_viewport().gui_get_focus_owner()
+	if focus_owner and (focus_owner is LineEdit or focus_owner is TextEdit):
+		return
+	
+	# Operation & shape shortcuts only trigger when primary action key is held (secondary key reserved for behavior inversion in creation)
+	if Input.is_key_pressed(config.action_key):
+		if ev.physical_keycode in _op_number_map:
+			var op_val = _op_number_map[ev.physical_keycode]
+			sidebar.set_operation(op_val)
+			_print_feedback("Op -> %s" % _op_label(op_val))
+			return
+		# Cycle operation with backtick (`) or TAB
+		if ev.physical_keycode in [KEY_APOSTROPHE, KEY_QUOTELEFT, KEY_TAB]:
+			_cycle_index = (_cycle_index + 1) % _op_cycle.size()
+			var cyc_op = _op_cycle[_cycle_index]
+			sidebar.set_operation(cyc_op)
+			_print_feedback("Op Cycle -> %s" % _op_label(cyc_op))
+			return
+		# Direct shape create (Layer 1)
+		if ev.physical_keycode in _shape_key_map:
+			_create_shape(_shape_key_map[ev.physical_keycode])
+			return
+
+func _create_shape(type_ref: Variant):
+	if sidebar == null:
+		_print_feedback("No sidebar found for creation")
+		return
+	# Delegates to sidebar logic (handles operation, insertion mode, UndoRedo, materials)
+	sidebar.create_csg(type_ref)
+	_print_feedback("Create %s (%s)" % [type_ref, _op_label(sidebar.operation)])
+
+func _op_label(op: int) -> String:
+	match op:
+		0: return "Union"
+		1: return "Intersect"
+		2: return "Subtract"
+		_: return str(op)
+
+func _print_feedback(msg: String):
+	print("CSG Toolkit: %s" % msg)

addons/csg_toolkit/scripts/csg_shortcut_manager.gd.uid

@@ -0,0 +1 @@
+uid://1bqvx7teqnrl

addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd

@@ -0,0 +1,236 @@
+@tool
+class_name CSGSideToolkitBar extends Control
+
+@onready var config: CsgTkConfig:
+	get:
+		return get_tree().root.get_node_or_null(CsgToolkit.AUTOLOAD_NAME) as CsgTkConfig
+
+var operation: CSGShape3D.Operation = CSGShape3D.OPERATION_UNION
+var selected_material: BaseMaterial3D
+var selected_shader: ShaderMaterial
+
+@onready var picker_button: Button = $ScrollContainer/HBoxContainer/Material/MaterialPicker
+
+func _enter_tree():
+	EditorInterface.get_selection().selection_changed.connect(_on_selection_changed)
+
+func _exit_tree():
+	EditorInterface.get_selection().selection_changed.disconnect(_on_selection_changed)
+
+func _on_selection_changed():
+	if not config.auto_hide:
+		return
+	var selection = EditorInterface.get_selection().get_selected_nodes()
+	if selection.any(func (node): return node is CSGShape3D):
+		show()
+	else:
+		hide()
+
+func _ready():
+	picker_button.icon_alignment = HORIZONTAL_ALIGNMENT_CENTER
+	# Connect material picker button if not connected via scene
+	if not picker_button.pressed.is_connected(_on_material_picker_pressed):
+		picker_button.pressed.connect(_on_material_picker_pressed)
+	set_process_unhandled_key_input(true)
+
+func _unhandled_key_input(event: InputEvent):
+	# Shortcut: action_key + 1/2/3 to set operation (Union / Intersection / Subtraction)
+	if not (event is InputEventKey):
+		return
+	var ev := event as InputEventKey
+	if ev.pressed and not ev.echo:
+		# Ensure action key is held (config.action_key)
+		if Input.is_key_pressed(config.action_key):
+			match ev.physical_keycode:
+				KEY_1, KEY_KP_1:
+					set_operation(0)
+					_accept_shortcut_feedback("Union")
+				KEY_2, KEY_KP_2:
+					set_operation(1)
+					_accept_shortcut_feedback("Intersection")
+				KEY_3, KEY_KP_3:
+					set_operation(2)
+					_accept_shortcut_feedback("Subtraction")
+
+func _accept_shortcut_feedback(label: String):
+	# Provide lightweight visual/editor feedback. Avoid static call to non-existent get_status_bar in Godot 4.
+	# Fallback: print to output.
+	var ei = EditorInterface
+	if ei:
+		# Some editor builds expose status bar via base control's children - skip deep search for now.
+		print("CSG Operation: %s" % label)
+	else:
+		print("CSG Operation: %s" % label)
+
+func _on_box_pressed():
+	create_csg(CSGBox3D)
+
+func _on_cylinder_pressed():
+	create_csg(CSGCylinder3D)
+
+func _on_mesh_pressed():
+	create_csg(CSGMesh3D)
+
+func _on_polygon_pressed():
+	create_csg(CSGPolygon3D)
+
+func _on_sphere_pressed():
+	create_csg(CSGSphere3D)
+
+func _on_torus_pressed():
+	create_csg(CSGTorus3D)
+
+# Operation Toggle (accept optional arg for signal variations)
+func _on_operation_pressed(val := 0):
+	set_operation(val)
+
+func _on_config_pressed():
+	var config_view_scene = preload("res://addons/csg_toolkit/scenes/config_window.tscn")
+	var config_view = config_view_scene.instantiate()
+	config_view.close_requested.connect(func ():
+		get_tree().root.remove_child(config_view)
+		config_view.queue_free()
+	)
+	get_tree().root.add_child(config_view)
+
+func _request_material():
+	var dialog = EditorFileDialog.new()
+	dialog.title = "Select Material"
+	dialog.display_mode = EditorFileDialog.DISPLAY_LIST
+	dialog.filters = ["*.tres, *.material, *.res"]
+	dialog.file_mode = EditorFileDialog.FILE_MODE_OPEN_FILE
+	dialog.position = ((EditorInterface.get_base_control().size / 2) as Vector2i) - dialog.size
+	dialog.close_requested.connect(func ():
+		get_tree().root.remove_child(dialog)
+		dialog.queue_free()
+	)
+	get_tree().root.add_child(dialog)
+	dialog.show()
+	var res_path = await dialog.file_selected
+	var res = ResourceLoader.load(res_path)
+	if res == null:
+		return
+	if res is BaseMaterial3D:
+		update_material(res)
+	elif res is ShaderMaterial:
+		update_shader(res)
+	else:
+		return
+	var previewer = EditorInterface.get_resource_previewer()
+	previewer.queue_edited_resource_preview(res, self, "_update_picker_icon", null)
+
+func _update_picker_icon(path, preview, thumbnail, userdata):
+	if preview:
+		picker_button.icon = preview
+
+func set_operation(val: int):
+	match val:
+		0: operation = CSGShape3D.OPERATION_UNION
+		1: operation = CSGShape3D.OPERATION_INTERSECTION
+		2: operation = CSGShape3D.OPERATION_SUBTRACTION
+		_: operation = CSGShape3D.OPERATION_UNION
+
+func update_material(material: BaseMaterial3D):
+	selected_material = material
+	selected_shader = null
+
+func update_shader(shader: ShaderMaterial):
+	selected_material = null
+	selected_shader = shader
+
+func create_csg(type: Variant):
+	var selection = EditorInterface.get_selection()
+	var selected_nodes = selection.get_selected_nodes()
+	if selected_nodes.is_empty() or !(selected_nodes[0] is CSGShape3D):
+		push_warning("Select a CSGShape3D to add a new CSG node")
+		return
+	var selected_node: CSGShape3D = selected_nodes[0]
+	var csg: CSGShape3D
+	match type:
+		CSGBox3D: csg = CSGBox3D.new()
+		CSGCylinder3D: csg = CSGCylinder3D.new()
+		CSGSphere3D: csg = CSGSphere3D.new()
+		CSGMesh3D: csg = CSGMesh3D.new()
+		CSGPolygon3D: csg = CSGPolygon3D.new()
+		CSGTorus3D: csg = CSGTorus3D.new()
+
+	csg.operation = operation
+	if selected_material:
+		csg.material = selected_material
+	elif selected_shader:
+		csg.material = selected_shader
+
+	if (selected_node.get_owner() == null):
+		return
+
+	var parent: Node
+	var add_as_child := false
+
+	# Behavior inversion now uses secondary_action_key (e.g. Alt) instead of primary action key
+	var invert := Input.is_key_pressed(config.secondary_action_key)
+	if config.default_behavior == CsgTkConfig.CSGBehavior.SIBLING:
+		add_as_child = invert
+	else:
+		add_as_child = !invert
+
+	parent = selected_node if add_as_child else selected_node.get_parent()
+	if parent == null:
+		return
+
+	# Try undo manager path if plugin provided one
+	if CsgToolkit.undo_manager:
+		var insert_index := parent.get_child_count()
+		CsgToolkit.undo_manager.create_action("Add %s" % csg.get_class())
+		# DO methods
+		CsgToolkit.undo_manager.add_do_method(self, "_undoable_add_csg", parent, csg, selected_node.get_owner(), selected_node.global_position, insert_index)
+		CsgToolkit.undo_manager.add_do_method(self, "_select_created_csg", csg)
+		# UNDO methods
+		CsgToolkit.undo_manager.add_undo_method(self, "_undoable_remove_csg", parent, csg)
+		CsgToolkit.undo_manager.add_undo_method(self, "_clear_selection_if", csg)
+		CsgToolkit.undo_manager.commit_action()
+	else:
+		parent.add_child(csg, true)
+		csg.owner = selected_node.get_owner()
+		csg.global_position = selected_node.global_position
+		call_deferred("_select_created_csg", csg)
+
+func _deferred_select(csg: Node):
+	call_deferred("_select_created_csg", csg)
+
+func _undoable_add_csg(parent: Node, csg: CSGShape3D, owner_ref: Node, global_pos: Vector3, insert_index: int):
+	if csg.get_parent() != parent:
+		parent.add_child(csg, true)
+		if insert_index >= 0 and insert_index < parent.get_child_count():
+			parent.move_child(csg, insert_index)
+	csg.owner = owner_ref
+	csg.global_position = global_pos
+
+func _undoable_remove_csg(parent: Node, csg: CSGShape3D):
+	if csg.get_parent() == parent:
+		parent.remove_child(csg)
+	# Intentionally do NOT free node so redo can re-add it. If you need memory, implement a recreate pattern instead.
+
+func _clear_selection_if(csg: Node):
+	var selection = EditorInterface.get_selection()
+	if selection:
+		var nodes: Array = selection.get_selected_nodes()
+		if csg in nodes:
+			selection.remove_node(csg)
+
+func _select_created_csg(csg: Node):
+	var selection = EditorInterface.get_selection()
+	selection.clear()
+	selection.add_node(csg)
+
+func _add_as_child(selected_node: CSGShape3D, csg: CSGShape3D):
+	selected_node.add_child(csg, true)
+	csg.owner = selected_node.get_owner()
+	csg.global_position = selected_node.global_position
+
+func _add_as_sibling(selected_node: CSGShape3D, csg: CSGShape3D):
+	selected_node.get_parent().add_child(csg, true)
+	csg.owner = selected_node.get_owner()
+	csg.global_position = selected_node.global_position
+
+func _on_material_picker_pressed() -> void:
+	_request_material()

addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd.uid

@@ -0,0 +1 @@
+uid://dr5f1egll7hdq

addons/csg_toolkit/scripts/csg_spreader_3d.gd

@@ -0,0 +1,280 @@
+@tool
+class_name CSGSpreader3D extends CSGCombiner3D
+
+const SPREADER_NODE_META = "SPREADER_NODE_META"
+const MAX_INSTANCES = 20000
+
+var _dirty: bool = false
+var _generation_in_progress := false
+var _template_node_path: NodePath
+@export var template_node_path: NodePath:
+	get: return _template_node_path
+	set(value):
+		_template_node_path = value
+		_mark_dirty()
+
+var _hide_template: bool = true
+@export var hide_template: bool = true:
+	get: return _hide_template
+	set(value):
+		_hide_template = value
+		_update_template_visibility()
+
+var _spread_area_3d: Shape3D = null
+@export var spread_area_3d: Shape3D = null:
+	get: return _spread_area_3d
+	set(value):
+		_spread_area_3d = value
+		_mark_dirty()
+
+var _max_count: int = 10
+@export var max_count: int = 10:
+	get: return _max_count
+	set(value):
+		_max_count = clamp(value, 1, 100000)
+		_mark_dirty()
+
+@export_group("Spread Options")
+var _noise_threshold: float = 0.5
+@export var noise_threshold: float = 0.5:
+	get: return _noise_threshold
+	set(value):
+		_noise_threshold = clamp(value, 0.0, 1.0)
+		_mark_dirty()
+
+var _seed: int = 0
+@export var seed: int = 0:
+	get: return _seed
+	set(value):
+		_seed = value
+		_mark_dirty()
+
+var _allow_rotation: bool = false
+@export var allow_rotation: bool = false:
+	get: return _allow_rotation
+	set(value):
+		_allow_rotation = value
+		_mark_dirty()
+
+var _allow_scale: bool = false
+@export var allow_scale: bool = false:
+	get: return _allow_scale
+	set(value):
+		_allow_scale = value
+		_mark_dirty()
+
+var _snap_distance = 0
+@export var snap_distance = 0:
+	get: return _snap_distance
+	set(value):
+		_snap_distance = value
+		_mark_dirty()
+
+@export_group("Collision Options")
+var _avoid_overlaps: bool = false
+@export var avoid_overlaps: bool = false:
+	get: return _avoid_overlaps
+	set(value):
+		_avoid_overlaps = value
+		_mark_dirty()
+
+var _min_distance: float = 1.0
+@export var min_distance: float = 1.0:
+	get: return _min_distance
+	set(value):
+		_min_distance = max(0.0, value)
+		_mark_dirty()
+
+var _max_placement_attempts: int = 100
+@export var max_placement_attempts: int = 100:
+	get: return _max_placement_attempts
+	set(value):
+		_max_placement_attempts = clamp(value, 10, 1000)
+		_mark_dirty()
+
+@export var estimated_instances: int = 0
+
+var rng: RandomNumberGenerator
+
+func _ready():
+	rng = RandomNumberGenerator.new()
+	_mark_dirty()
+	# Generate instances in-game on ready
+	if not Engine.is_editor_hint():
+		call_deferred("spread_template")
+
+func _process(_delta):
+	if not Engine.is_editor_hint(): return
+	if _dirty and not _generation_in_progress:
+		_dirty = false
+		call_deferred("spread_template")
+
+func _exit_tree():
+	if not Engine.is_editor_hint():
+		return
+	clear_children()
+
+func _mark_dirty():
+	_dirty = true
+
+func _update_template_visibility():
+	if not is_inside_tree():
+		return
+	var template_node = get_node_or_null(template_node_path)
+	if template_node and template_node is Node3D:
+		template_node.visible = not _hide_template
+
+func clear_children():
+	var children_to_remove = []
+	for child in get_children(true):
+		if child.has_meta(SPREADER_NODE_META):
+			children_to_remove.append(child)
+	for child in children_to_remove:
+		remove_child(child)
+		child.queue_free()
+
+func get_random_position_in_area() -> Vector3:
+	if spread_area_3d is SphereShape3D:
+		var radius = spread_area_3d.get_radius()
+		var u = rng.randf()
+		var v = rng.randf()
+		var theta = u * TAU
+		var phi = acos(2.0 * v - 1.0)
+		var r = radius * pow(rng.randf(), 1.0/3.0)
+		return Vector3(r * sin(phi) * cos(theta), r * sin(phi) * sin(theta), r * cos(phi))
+	if spread_area_3d is BoxShape3D:
+		var size = spread_area_3d.size
+		return Vector3(
+			rng.randf_range(-size.x * 0.5, size.x * 0.5),
+			rng.randf_range(-size.y * 0.5, size.y * 0.5),
+			rng.randf_range(-size.z * 0.5, size.z * 0.5)
+		)
+	if spread_area_3d is CapsuleShape3D:
+		var radius = spread_area_3d.get_radius()
+		var height = spread_area_3d.get_height() * 0.5
+		if rng.randf() < noise_threshold:
+			var angle = rng.randf() * TAU
+			var r = radius * sqrt(rng.randf())
+			return Vector3(r * cos(angle), rng.randf_range(-height, height), r * sin(angle))
+		else:
+			var hemisphere_y = height if rng.randf() < noise_threshold else -height
+			var u = rng.randf()
+			var v = rng.randf()
+			var theta = u * TAU
+			var phi = acos(1.0 - v)
+			var r = radius * pow(rng.randf(), 1.0/3.0)
+			return Vector3(
+				r * sin(phi) * cos(theta),
+				hemisphere_y + r * cos(phi) * (1 if hemisphere_y > 0 else -1),
+				r * sin(phi) * sin(theta)
+			)
+	if spread_area_3d is CylinderShape3D:
+		var radius = spread_area_3d.get_radius()
+		var height = spread_area_3d.get_height() * 0.5
+		var angle = rng.randf() * TAU
+		var r = radius * sqrt(rng.randf())
+		return Vector3(r * cos(angle), rng.randf_range(-height, height), r * sin(angle))
+	if spread_area_3d is HeightMapShape3D:
+		var width = spread_area_3d.map_width
+		var depth = spread_area_3d.map_depth
+		if width <= 0 or depth <= 0 or spread_area_3d.map_data.size() == 0:
+			return Vector3.ZERO
+		var x = rng.randi_range(0, width - 1)
+		var z = rng.randi_range(0, depth - 1)
+		var index = x + z * width
+		if index < spread_area_3d.map_data.size():
+			return Vector3(x, spread_area_3d.map_data[index], z)
+		return Vector3.ZERO
+	if spread_area_3d is WorldBoundaryShape3D:
+		var bound = 100.0
+		return Vector3(rng.randf_range(-bound, bound), 0, rng.randf_range(-bound, bound))
+	if spread_area_3d is ConvexPolygonShape3D or spread_area_3d is ConcavePolygonShape3D:
+		var pts = spread_area_3d.points if spread_area_3d.has_method("get_points") else []
+		if pts.size() == 0:
+			return Vector3.ZERO
+		var min_point = pts[0]
+		var max_point = pts[0]
+		for p in pts:
+			min_point = min_point.min(p)
+			max_point = max_point.max(p)
+		return Vector3(
+			rng.randf_range(min_point.x, max_point.x),
+			rng.randf_range(min_point.y, max_point.y),
+			rng.randf_range(min_point.z, max_point.z)
+		)
+	push_warning("CSGSpreader3D: Shape type not supported")
+	return Vector3.ZERO
+
+func spread_template():
+	if _generation_in_progress:
+		return
+	_generation_in_progress = true
+	if not spread_area_3d:
+		_generation_in_progress = false
+		return
+	clear_children()
+	var template_node = get_node_or_null(template_node_path)
+	if not template_node:
+		_generation_in_progress = false
+		return
+
+	rng.seed = _seed
+	var instances_created = 0
+	var placed_positions = []
+	var budget = min(_max_count, MAX_INSTANCES)
+	if _max_count > MAX_INSTANCES:
+		push_warning("CSGSpreader3D: max_count %s exceeds cap %s. Limiting." % [_max_count, MAX_INSTANCES])
+	for i in range(budget):
+		var noise_value = rng.randf()
+		if noise_value <= _noise_threshold:
+			continue
+		var position_found = false
+		var final_position = Vector3.ZERO
+		var attempts = _max_placement_attempts if _avoid_overlaps else 1
+		for attempt in range(attempts):
+			var test_position = get_random_position_in_area()
+			if not _avoid_overlaps:
+				final_position = test_position
+				position_found = true
+				break
+			var overlap = false
+			for existing_pos in placed_positions:
+				if test_position.distance_to(existing_pos) < _min_distance:
+					overlap = true
+					break
+			if not overlap:
+				final_position = test_position
+				position_found = true
+				break
+		if not position_found:
+			continue
+		var instance = template_node.duplicate()
+		if instance == null:
+			continue
+		instance.set_meta(SPREADER_NODE_META, true)
+		instance.transform.origin = final_position
+		# Ensure instance is visible regardless of template visibility
+		if instance is Node3D:
+			instance.visible = true
+		placed_positions.append(final_position)
+		if _allow_rotation:
+			var rotation_y = rng.randf_range(0, TAU)
+			instance.rotate_y(rotation_y)
+		if _allow_scale:
+			var scale_factor = rng.randf_range(0.5, 2.0)
+			instance.scale *= scale_factor
+		add_child(instance)
+		instances_created += 1
+	estimated_instances = instances_created
+	_update_template_visibility()
+	_generation_in_progress = false
+
+func bake_instances():
+	if get_child_count() == 0:
+		return
+	var stack = []
+	stack.append_array(get_children())
+	while stack.size() > 0:
+		var node = stack.pop_back()
+		node.set_owner(owner)
+		stack.append_array(node.get_children())

addons/csg_toolkit/scripts/csg_spreader_3d.gd.uid

@@ -0,0 +1 @@
+uid://rgfomqnhbhpk

addons/csg_toolkit/scripts/csg_toolkit_config.gd

@@ -0,0 +1,99 @@
+@tool
+extends Node
+class_name CsgTkConfig
+
+# ProjectSettings paths
+const SETTING_DEFAULT_BEHAVIOR = "addons/csg_toolkit/default_behavior"
+const SETTING_ACTION_KEY = "addons/csg_toolkit/action_key"
+const SETTING_SECONDARY_ACTION_KEY = "addons/csg_toolkit/secondary_action_key"
+const SETTING_AUTO_HIDE = "addons/csg_toolkit/auto_hide"
+
+# Default values
+const DEFAULT_DEFAULT_BEHAVIOR = CSGBehavior.SIBLING
+const DEFAULT_ACTION_KEY = KEY_SHIFT
+const DEFAULT_SECONDARY_ACTION_KEY = KEY_ALT
+const DEFAULT_AUTO_HIDE = true
+
+# Configurable properties
+
+## Default behavior when adding new CSG nodes
+var default_behavior: CSGBehavior = CSGBehavior.SIBLING:
+	get: return _get_setting(SETTING_DEFAULT_BEHAVIOR, DEFAULT_DEFAULT_BEHAVIOR)
+	set(value): _set_setting(SETTING_DEFAULT_BEHAVIOR, value)
+
+## Key to hold for primary action (e.g., adding CSG nodes)
+var action_key: Key = KEY_SHIFT:
+	get: return _get_setting(SETTING_ACTION_KEY, DEFAULT_ACTION_KEY)
+	set(value): _set_setting(SETTING_ACTION_KEY, value)
+
+## Key to hold for secondary action (e.g., alternative CSG operations)
+var secondary_action_key: Key = KEY_ALT:
+	get: return _get_setting(SETTING_SECONDARY_ACTION_KEY, DEFAULT_SECONDARY_ACTION_KEY)
+	set(value): _set_setting(SETTING_SECONDARY_ACTION_KEY, value)
+
+## Whether to auto-hide the CSG toolkit UI when not in use
+var auto_hide: bool = true:
+	get: return _get_setting(SETTING_AUTO_HIDE, DEFAULT_AUTO_HIDE)
+	set(value): _set_setting(SETTING_AUTO_HIDE, value)
+
+signal config_saved()
+
+enum CSGBehavior { SIBLING, CHILD }
+
+func _enter_tree():
+	_ensure_settings_exist()
+
+func _ensure_settings_exist():
+	"""Register settings in ProjectSettings if they don't exist."""
+	if not ProjectSettings.has_setting(SETTING_DEFAULT_BEHAVIOR):
+		ProjectSettings.set_setting(SETTING_DEFAULT_BEHAVIOR, DEFAULT_DEFAULT_BEHAVIOR)
+		ProjectSettings.set_initial_value(SETTING_DEFAULT_BEHAVIOR, DEFAULT_DEFAULT_BEHAVIOR)
+		ProjectSettings.add_property_info({
+			"name": SETTING_DEFAULT_BEHAVIOR,
+			"type": TYPE_INT,
+			"hint": PROPERTY_HINT_ENUM,
+			"hint_string": "Sibling,Child"
+		})
+	
+	if not ProjectSettings.has_setting(SETTING_ACTION_KEY):
+		ProjectSettings.set_setting(SETTING_ACTION_KEY, DEFAULT_ACTION_KEY)
+		ProjectSettings.set_initial_value(SETTING_ACTION_KEY, DEFAULT_ACTION_KEY)
+		ProjectSettings.add_property_info({
+			"name": SETTING_ACTION_KEY,
+			"type": TYPE_INT,
+			"hint": PROPERTY_HINT_NONE
+		})
+	
+	if not ProjectSettings.has_setting(SETTING_SECONDARY_ACTION_KEY):
+		ProjectSettings.set_setting(SETTING_SECONDARY_ACTION_KEY, DEFAULT_SECONDARY_ACTION_KEY)
+		ProjectSettings.set_initial_value(SETTING_SECONDARY_ACTION_KEY, DEFAULT_SECONDARY_ACTION_KEY)
+		ProjectSettings.add_property_info({
+			"name": SETTING_SECONDARY_ACTION_KEY,
+			"type": TYPE_INT,
+			"hint": PROPERTY_HINT_NONE
+		})
+	
+	if not ProjectSettings.has_setting(SETTING_AUTO_HIDE):
+		ProjectSettings.set_setting(SETTING_AUTO_HIDE, DEFAULT_AUTO_HIDE)
+		ProjectSettings.set_initial_value(SETTING_AUTO_HIDE, DEFAULT_AUTO_HIDE)
+		ProjectSettings.add_property_info({
+			"name": SETTING_AUTO_HIDE,
+			"type": TYPE_BOOL
+		})
+
+func _get_setting(path: String, default_value: Variant) -> Variant:
+	"""Get a setting from ProjectSettings."""
+	return ProjectSettings.get_setting(path, default_value)
+
+func _set_setting(path: String, value: Variant):
+	"""Set a setting in ProjectSettings."""
+	ProjectSettings.set_setting(path, value)
+
+func save_config():
+	"""Save settings to project.godot file."""
+	var err = ProjectSettings.save()
+	if err == OK:
+		print("CsgToolkit: Saved Config to ProjectSettings")
+		config_saved.emit()
+	else:
+		push_error("CsgToolkit: Failed to save config - error code %d" % err)

addons/csg_toolkit/scripts/csg_toolkit_config.gd.uid

@@ -0,0 +1 @@
+uid://w8ad8q4lneis

addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd

@@ -0,0 +1,41 @@
+@tool
+class_name CSGTopToolkitBar extends Control
+
+func _enter_tree():
+	EditorInterface.get_selection().selection_changed.connect(_on_selection_changed)
+	_on_selection_changed()
+	# Attempt to find buttons and add tooltips if present
+	var refresh_btn = find_child("Refresh", true, false)
+	if refresh_btn and refresh_btn is Button:
+		refresh_btn.tooltip_text = "Regenerate preview instances"
+	var bake_btn = find_child("Bake", true, false)
+	if bake_btn and bake_btn is Button:
+		bake_btn.tooltip_text = "Bake generated instances into the scene (makes them persistent)"
+
+func _exit_tree():
+	EditorInterface.get_selection().selection_changed.disconnect(_on_selection_changed)
+
+func _on_selection_changed():
+	var selection = EditorInterface.get_selection().get_selected_nodes()
+	if selection.is_empty():
+		hide()
+	elif selection[0] is CSGRepeater3D or selection[0] is CSGSpreader3D:
+		show()
+	else:
+		hide()
+
+func _on_refresh_pressed():
+	var selection = EditorInterface.get_selection().get_selected_nodes()
+	if (selection.is_empty()):
+		return
+	if selection[0] is CSGRepeater3D:
+		selection[0].call("repeat_template")
+	elif selection[0] is CSGSpreader3D:
+		selection[0].call("spread_template")
+
+func _on_bake_pressed():
+	var selection = EditorInterface.get_selection().get_selected_nodes()
+	if selection.is_empty():
+		return
+	if selection[0] is CSGRepeater3D or selection[0] is CSGSpreader3D:
+		selection[0].call("bake_instances")

addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd.uid

@@ -0,0 +1 @@
+uid://dk6dt8fk1s43s

addons/csg_toolkit/scripts/patterns/circular_pattern.gd

@@ -0,0 +1,31 @@
+@tool
+class_name CSGCircularPattern
+extends CSGPattern
+
+@export var radius: float = 5.0
+@export var points: int = 8
+@export var layers: int = 1
+## If 0 use template_size.y
+@export var layer_height: float = 0.0
+## Additional gap added per layer beyond base height
+@export var layer_spacing: float = 0.0 
+
+func _generate(ctx: Dictionary) -> Array:
+	var positions: Array = []
+	var template_size: Vector3 = ctx.get("template_size", Vector3.ONE)
+	var rad: float = max(0.0, radius)
+	var count: int = max(1, points)
+	if count <= 1:
+		return [Vector3.ZERO]
+	var lyr_count = max(1, layers)
+	var base_y = layer_height if layer_height > 0.0 else template_size.y
+	var step_y = base_y + max(0.0, layer_spacing)
+	for i in range(count):
+		var angle = (i * TAU) / count
+		var base_pos = Vector3(cos(angle) * rad, 0, sin(angle) * rad)
+		for layer in range(lyr_count):
+			positions.append(base_pos + Vector3(0, layer * step_y, 0))
+	return positions
+
+func get_estimated_count(ctx: Dictionary) -> int:
+	return max(1, points) * max(1, layers)

addons/csg_toolkit/scripts/patterns/circular_pattern.gd.uid

@@ -0,0 +1 @@
+uid://b3ws8vwtsqmjt

addons/csg_toolkit/scripts/patterns/csg_pattern.gd

@@ -0,0 +1,19 @@
+@tool
+@abstract
+class_name CSGPattern
+extends Resource
+
+## Base pattern interface. Subclasses implement _generate(RepeaterContext) returning Array[Vector3].
+
+# Common interface call
+func generate(ctx: Dictionary) -> Array:
+	# ctx expected keys: repeat: Vector3i, spacing: Vector3, rng: RandomNumberGenerator, step_spacing: Vector3, user: Node (repeater)
+	return _generate(ctx)
+
+func _generate(_ctx: Dictionary) -> Array:
+	return []
+
+func get_estimated_count(ctx: Dictionary) -> int:
+	# Default: fallback to generating (may be overridden for performance/accuracy)
+	var arr = _generate(ctx)
+	return arr.size()

addons/csg_toolkit/scripts/patterns/csg_pattern.gd.uid

@@ -0,0 +1 @@
+uid://dbavf0pl65chb

addons/csg_toolkit/scripts/patterns/grid_pattern.gd

@@ -0,0 +1,33 @@
+@tool
+class_name CSGGridPattern
+extends CSGPattern
+
+@export var count_x: int = 2
+@export var count_y: int = 1
+@export var count_z: int = 1
+@export var spacing: Vector3 = Vector3.ZERO
+
+## If true, automatically adds template AABB size to spacing for proper object separation
+@export var use_template_size: bool = true
+
+func _generate(ctx: Dictionary) -> Array:
+	var positions: Array = []
+	var template_size: Vector3 = ctx.get("template_size", Vector3.ONE)
+	var jitter: float = ctx.get("position_jitter", 0.0)
+	var rng: RandomNumberGenerator = ctx.rng
+	var cx = max(1, count_x)
+	var cy = max(1, count_y)
+	var cz = max(1, count_z)
+	var base_step: Vector3 = (template_size if use_template_size else Vector3.ZERO) + spacing
+	for x in range(cx):
+		for y in range(cy):
+			for z in range(cz):
+				var position = Vector3(x * base_step.x, y * base_step.y, z * base_step.z)
+				if jitter > 0.0:
+					position += Vector3(
+						rng.randf_range(-jitter, jitter),
+						rng.randf_range(-jitter, jitter),
+						rng.randf_range(-jitter, jitter)
+					)
+				positions.append(position)
+	return positions

addons/csg_toolkit/scripts/patterns/grid_pattern.gd.uid

@@ -0,0 +1 @@
+uid://bc1sxg4vy464o

addons/csg_toolkit/scripts/patterns/noise_pattern.gd

@@ -0,0 +1,124 @@
+@tool
+class_name CSGNoisePattern
+extends CSGPattern
+
+## Generates instance positions based on noise sampling in a 3D volume
+## Instances are placed where noise value exceeds the threshold
+
+## 
+@export var bounds: Vector3 = Vector3(10, 10, 10)
+
+## 
+@export var sample_density: Vector3i = Vector3i(20, 1, 20)
+
+## 
+@export_range(0.0, 1.0) var noise_threshold: float = 0.5
+
+## 
+@export var noise_seed: int = 0
+
+##
+@export_range(0.01, 100) var noise_frequency: float = 0.1
+
+## 
+@export_enum("Simplex", "Simplex Smooth", "Cellular", "Perlin", "Value Cubic", "Value") var noise_type: int = 0
+
+##
+@export_enum("None", "OpenSimplex2", "OpenSimplex2S", "Cellular", "Perlin", "Value Cubic", "Value") var fractal_type: int = 0
+
+##
+@export_range(1, 8) var fractal_octaves: int = 3
+
+## 
+@export var use_template_size: bool = false
+
+var noise: FastNoiseLite
+
+func _init():
+	noise = FastNoiseLite.new()
+	_update_noise()
+
+func _update_noise():
+	if not noise:
+		noise = FastNoiseLite.new()
+	
+	noise.seed = noise_seed
+	noise.frequency = noise_frequency
+	noise.fractal_octaves = fractal_octaves
+	
+	# Map noise_type enum to FastNoiseLite types
+	match noise_type:
+		0: noise.noise_type = FastNoiseLite.TYPE_SIMPLEX
+		1: noise.noise_type = FastNoiseLite.TYPE_SIMPLEX_SMOOTH
+		2: noise.noise_type = FastNoiseLite.TYPE_CELLULAR
+		3: noise.noise_type = FastNoiseLite.TYPE_PERLIN
+		4: noise.noise_type = FastNoiseLite.TYPE_VALUE_CUBIC
+		5: noise.noise_type = FastNoiseLite.TYPE_VALUE
+	
+	# Map fractal_type enum to FastNoiseLite fractal types
+	match fractal_type:
+		0: noise.fractal_type = FastNoiseLite.FRACTAL_NONE
+		1: noise.fractal_type = FastNoiseLite.FRACTAL_FBM
+		2: noise.fractal_type = FastNoiseLite.FRACTAL_RIDGED
+		3: noise.fractal_type = FastNoiseLite.FRACTAL_PING_PONG
+
+func _generate(ctx: Dictionary) -> Array:
+	_update_noise()
+	
+	var positions: Array = []
+	var template_size: Vector3 = ctx.get("template_size", Vector3.ONE) if use_template_size else Vector3.ZERO
+	var jitter: float = ctx.get("position_jitter", 0.0)
+	var rng: RandomNumberGenerator = ctx.get("rng", RandomNumberGenerator.new())
+	
+	var effective_bounds = bounds
+	var sample_count = sample_density
+	
+	# Calculate step size for sampling
+	var step = Vector3(
+		effective_bounds.x / max(1, sample_count.x),
+		effective_bounds.y / max(1, sample_count.y),
+		effective_bounds.z / max(1, sample_count.z)
+	)
+	
+	# Start from negative half to center the pattern around origin
+	var start_pos = -effective_bounds * 0.5
+	
+	# Sample noise at regular intervals
+	for x in range(sample_count.x):
+		for y in range(sample_count.y):
+			for z in range(sample_count.z):
+				var sample_pos = start_pos + Vector3(
+					x * step.x + step.x * 0.5,
+					y * step.y + step.y * 0.5,
+					z * step.z + step.z * 0.5
+				)
+				
+				# Get noise value at this position (normalized to 0-1)
+				var noise_value = (noise.get_noise_3d(sample_pos.x, sample_pos.y, sample_pos.z) + 1.0) * 0.5
+				
+				# Only place instance if noise exceeds threshold
+				if noise_value >= noise_threshold:
+					var final_pos = sample_pos
+					
+					# Apply template size offset if enabled
+					if use_template_size:
+						final_pos += template_size * Vector3(x, y, z)
+					
+					# Apply jitter
+					if jitter > 0.0:
+						final_pos += Vector3(
+							rng.randf_range(-jitter, jitter),
+							rng.randf_range(-jitter, jitter),
+							rng.randf_range(-jitter, jitter)
+						)
+					
+					positions.append(final_pos)
+	
+	return positions
+
+func get_estimated_count(ctx: Dictionary) -> int:
+	# Rough estimate: total samples * (1 - threshold)
+	# Higher threshold = fewer instances
+	var total_samples = max(1, sample_density.x) * max(1, sample_density.y) * max(1, sample_density.z)
+	var estimated = int(total_samples * (1.0 - noise_threshold))
+	return max(1, estimated)

addons/csg_toolkit/scripts/patterns/noise_pattern.gd.uid

@@ -0,0 +1 @@
+uid://3il6xs7cr7gj

addons/csg_toolkit/scripts/patterns/spiral_pattern.gd

@@ -0,0 +1,39 @@
+@tool
+class_name CSGSpiralPattern
+extends CSGPattern
+
+@export var turns: float = 2.0
+@export var start_radius: float = 0.5
+@export var end_radius: float = 5.0
+## If > 0 overrides vertical spread based on repeat & step
+@export var total_height: float = 0.0
+@export var use_radius_curve: bool = false
+@export var radius_curve: Curve
+@export var points: int = 32
+
+func _generate(ctx: Dictionary) -> Array:
+	var positions: Array = []
+	var template_size: Vector3 = ctx.get("template_size", Vector3.ONE)
+	var t_turns: float = max(0.1, turns)
+	var r_start: float = max(0.0, start_radius)
+	var r_end: float = max(r_start, end_radius)
+	var total: int = max(2, points)
+	if total <= 1:
+		return [Vector3.ZERO]
+	for i in range(total):
+		var t: float = float(i) / float(total - 1)
+		var angle = t * t_turns * TAU
+		var curve_t = t
+		if use_radius_curve and radius_curve and radius_curve.get_point_count() > 0:
+			curve_t = clamp(radius_curve.sample(t), 0.0, 1.0)
+		var radius = lerp(r_start, r_end, curve_t)
+		var y_pos: float = t * (total_height if total_height > 0.0 else template_size.y * 1.0)
+		positions.append(Vector3(
+			cos(angle) * radius,
+			y_pos,
+			sin(angle) * radius
+		))
+	return positions
+
+func get_estimated_count(ctx: Dictionary) -> int:
+	return max(2, points)

addons/csg_toolkit/scripts/patterns/spiral_pattern.gd.uid

@@ -0,0 +1 @@
+uid://belgcjd0ys212

addons/gdUnit4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Mike Schulze
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

addons/gdUnit4/bin/GdUnitCmdTool.gd

@@ -0,0 +1,21 @@
+#!/usr/bin/env -S godot -s
+extends SceneTree
+
+
+var _cli_runner: GdUnitTestCIRunner
+
+
+func _initialize() -> void:
+	DisplayServer.window_set_mode(DisplayServer.WINDOW_MODE_MINIMIZED)
+	_cli_runner = GdUnitTestCIRunner.new()
+	root.add_child(_cli_runner)
+
+
+# do not use print statements on _finalize it results in random crashes
+func _finalize() -> void:
+	queue_delete(_cli_runner)
+	if OS.is_stdout_verbose():
+		prints("Finallize ..")
+		prints("-Orphan nodes report-----------------------")
+		Window.print_orphan_nodes()
+		prints("Finallize .. done")

addons/gdUnit4/bin/GdUnitCmdTool.gd.uid

@@ -0,0 +1 @@
+uid://i04mdqgjjfsa

addons/gdUnit4/bin/GdUnitCopyLog.gd

@@ -0,0 +1,167 @@
+#!/usr/bin/env -S godot -s
+extends MainLoop
+
+const GdUnitTools := preload("res://addons/gdUnit4/src/core/GdUnitTools.gd")
+
+# gdlint: disable=max-line-length
+const LOG_FRAME_TEMPLATE = """
+<!DOCTYPE html>
+<html style="display: inline-grid;">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Godot Logging</title>
+	<link rel="stylesheet" href="css/styles.css">
+</head>
+
+<body style="background-color: #eee;">
+	<div class="godot-report-frame"">
+${content}
+	</div>
+</body>
+</html>
+"""
+
+const NO_LOG_MESSAGE = """
+<h3>No logging available!</h3>
+</br>
+<p>In order for logging to take place, you must activate the Activate file logging option in the project settings.</p>
+<p>You can enable the logging under:
+<b>Project Settings</b> > <b>Debug</b> > <b>File Logging</b> > <b>Enable File Logging</b> in the project settings.</p>
+"""
+
+#warning-ignore-all:return_value_discarded
+var _cmd_options := CmdOptions.new([
+		CmdOption.new(
+			"-rd, --report-directory",
+			"-rd <directory>",
+			"Specifies the output directory in which the reports are to be written. The default is res://reports/.",
+			TYPE_STRING,
+			true
+		)
+	])
+
+
+var _report_root_path: String
+var _current_report_path: String
+var _debug_cmd_args := PackedStringArray()
+
+
+func _init() -> void:
+	set_report_directory(GdUnitFileAccess.current_dir() + "reports")
+	set_current_report_path()
+
+
+func _process(_delta: float) -> bool:
+	# check if reports exists
+	if not reports_available():
+		prints("no reports found")
+		return true
+
+	# only process if godot logging is enabled
+	if not GdUnitSettings.is_log_enabled():
+		write_report(NO_LOG_MESSAGE, "")
+		return true
+
+	# parse possible custom report path,
+	var cmd_parser := CmdArgumentParser.new(_cmd_options, "GdUnitCmdTool.gd")
+	# ignore erros and exit quitly
+	if cmd_parser.parse(get_cmdline_args(), true).is_error():
+		return true
+	CmdCommandHandler.new(_cmd_options).register_cb("-rd", set_report_directory)
+
+	var godot_log_file := scan_latest_godot_log()
+	var result := read_log_file_content(godot_log_file)
+	if result.is_error():
+		write_report(result.error_message(), godot_log_file)
+		return true
+	write_report(result.value_as_string(), godot_log_file)
+	return true
+
+
+func set_current_report_path() -> void:
+	# scan for latest report directory
+	var iteration := GdUnitFileAccess.find_last_path_index(
+		_report_root_path, GdUnitConstants.REPORT_DIR_PREFIX
+	)
+	_current_report_path = "%s/%s%d" % [_report_root_path, GdUnitConstants.REPORT_DIR_PREFIX, iteration]
+
+
+func set_report_directory(path: String) -> void:
+	_report_root_path = path
+
+
+func get_log_report_html() -> String:
+	return _current_report_path + "/godot_report_log.html"
+
+
+func reports_available() -> bool:
+	return DirAccess.dir_exists_absolute(_report_root_path)
+
+
+func scan_latest_godot_log() -> String:
+	var path := GdUnitSettings.get_log_path().get_base_dir()
+	var files_sorted := Array()
+	for file in GdUnitFileAccess.scan_dir(path):
+		var file_name := "%s/%s" % [path, file]
+		files_sorted.append(file_name)
+	# sort by name, the name contains the timestamp so we sort at the end by timestamp
+	files_sorted.sort()
+	return files_sorted.back()
+
+
+func read_log_file_content(log_file: String) -> GdUnitResult:
+	var file := FileAccess.open(log_file, FileAccess.READ)
+	if file == null:
+		return GdUnitResult.error(
+			"Can't find log file '%s'. Error: %s"
+			% [log_file, error_string(FileAccess.get_open_error())]
+		)
+	var content := "<pre>" + file.get_as_text()
+	# patch out console format codes
+	for color_index in range(0, 256):
+		var to_replace := "[38;5;%dm" % color_index
+		content = content.replace(to_replace, "")
+	content += "</pre>"
+	content = content\
+		.replace("", "")\
+		.replace(GdUnitCSIMessageWriter.CSI_BOLD, "")\
+		.replace(GdUnitCSIMessageWriter.CSI_ITALIC, "")\
+		.replace(GdUnitCSIMessageWriter.CSI_UNDERLINE, "")
+	return GdUnitResult.success(content)
+
+
+func write_report(content: String, godot_log_file: String) -> GdUnitResult:
+	var file := FileAccess.open(get_log_report_html(), FileAccess.WRITE)
+	if file == null:
+		return GdUnitResult.error(
+			"Can't open to write '%s'. Error: %s"
+			% [get_log_report_html(), error_string(FileAccess.get_open_error())]
+		)
+	var report_html := LOG_FRAME_TEMPLATE.replace("${content}", content)
+	file.store_string(report_html)
+	_update_index_html(godot_log_file)
+	return GdUnitResult.success(file)
+
+
+func _update_index_html(godot_log_file: String) -> void:
+	var index_path := "%s/index.html" % _current_report_path
+	var index_file := FileAccess.open(index_path, FileAccess.READ_WRITE)
+	if index_file == null:
+		push_error(
+			"Can't add log path '%s' to `%s`. Error: %s"
+			% [godot_log_file, index_path, error_string(FileAccess.get_open_error())]
+		)
+		return
+	var content := index_file.get_as_text()\
+		.replace("${log_report}", get_log_report_html())\
+		.replace("${godot_log_file}", godot_log_file)
+	# overide it
+	index_file.seek(0)
+	index_file.store_string(content)
+
+
+func get_cmdline_args() -> PackedStringArray:
+	if _debug_cmd_args.is_empty():
+		return OS.get_cmdline_args()
+	return _debug_cmd_args

addons/gdUnit4/bin/GdUnitCopyLog.gd.uid

@@ -0,0 +1 @@
+uid://lcya8t25hn0j

addons/gdUnit4/plugin.cfg

@@ -0,0 +1,7 @@
+[plugin]
+
+name="gdUnit4"
+description="Unit Testing Framework for Godot Scripts"
+author="Mike Schulze"
+version="6.1.0"
+script="plugin.gd"

addons/gdUnit4/plugin.gd

@@ -0,0 +1,101 @@
+@tool
+extends EditorPlugin
+
+var _gd_inspector: Control
+var _gd_console: Control
+var _filesystem_context_menu: EditorContextMenuPlugin
+var _editor_context_menu: EditorContextMenuPlugin
+var _editor_code_context_menu: EditorContextMenuPlugin
+
+
+func _enter_tree() -> void:
+	var inferred_declaration: int = ProjectSettings.get_setting("debug/gdscript/warnings/inferred_declaration")
+
+	var is_gdunit_excluded_warnings: bool = false
+	if Engine.get_version_info().hex >= 0x40600:
+		var dirctrory_rules: Dictionary = ProjectSettings.get_setting("debug/gdscript/warnings/directory_rules")
+		if dirctrory_rules.has("res://addons/gdUnit4") and dirctrory_rules["res://addons/gdUnit4"] == 0:
+			is_gdunit_excluded_warnings = true
+	else:
+		is_gdunit_excluded_warnings = ProjectSettings.get_setting("debug/gdscript/warnings/exclude_addons")
+	if !is_gdunit_excluded_warnings and inferred_declaration != 0:
+		printerr("GdUnit4: 'inferred_declaration' is set to Warning/Error!")
+		if Engine.get_version_info().hex >= 0x40600:
+			printerr("GdUnit4 is not 'inferred_declaration' save, you have to excluded the addon (debug/gdscript/warnings/directory_rules)")
+		else:
+			printerr("GdUnit4 is not 'inferred_declaration' save, you have to excluded addons (debug/gdscript/warnings/exclude_addons)")
+		printerr("Loading GdUnit4 Plugin failed.")
+		return
+
+	if check_running_in_test_env():
+		@warning_ignore("return_value_discarded")
+		GdUnitCSIMessageWriter.new().prints_warning("It was recognized that GdUnit4 is running in a test environment, therefore the GdUnit4 plugin will not be executed!")
+		return
+
+	if Engine.get_version_info().hex < 0x40500:
+		prints("This GdUnit4 plugin version '%s' requires Godot version '4.5' or higher to run." % GdUnit4Version.current())
+		return
+	GdUnitSettings.setup()
+	# Install the GdUnit Inspector
+	_gd_inspector = (load("res://addons/gdUnit4/src/ui/GdUnitInspector.tscn") as PackedScene).instantiate()
+	_add_context_menus()
+	add_control_to_dock(EditorPlugin.DOCK_SLOT_LEFT_UR, _gd_inspector)
+	# Install the GdUnit Console
+	_gd_console = (load("res://addons/gdUnit4/src/ui/GdUnitConsole.tscn") as PackedScene).instantiate()
+	var control: Control = add_control_to_bottom_panel(_gd_console, "gdUnitConsole")
+	@warning_ignore("unsafe_method_access")
+	await _gd_console.setup_update_notification(control)
+	if GdUnit4CSharpApiLoader.is_api_loaded():
+		prints("GdUnit4Net version '%s' loaded." % GdUnit4CSharpApiLoader.version())
+	else:
+		prints("No GdUnit4Net found.")
+	# Connect to be notified for script changes to be able to discover new tests
+	GdUnitTestDiscoverGuard.instance()
+	@warning_ignore("return_value_discarded")
+	resource_saved.connect(_on_resource_saved)
+	prints("Loading GdUnit4 Plugin success")
+
+
+func _exit_tree() -> void:
+	if check_running_in_test_env():
+		return
+	if is_instance_valid(_gd_inspector):
+		remove_control_from_docks(_gd_inspector)
+		_gd_inspector.free()
+	_remove_context_menus()
+	if is_instance_valid(_gd_console):
+		remove_control_from_bottom_panel(_gd_console)
+		_gd_console.free()
+	var gdUnitTools: GDScript = load("res://addons/gdUnit4/src/core/GdUnitTools.gd")
+	@warning_ignore("unsafe_method_access")
+	gdUnitTools.dispose_all(true)
+	prints("Unload GdUnit4 Plugin success")
+
+
+func check_running_in_test_env() -> bool:
+	var args: PackedStringArray = OS.get_cmdline_args()
+	args.append_array(OS.get_cmdline_user_args())
+	return DisplayServer.get_name() == "headless" or args.has("--selftest") or args.has("--add") or args.has("-a") or args.has("--quit-after") or args.has("--import")
+
+
+func _add_context_menus() -> void:
+	_filesystem_context_menu = preload("res://addons/gdUnit4/src/ui/menu/GdUnitEditorFileSystemContextMenuHandler.gd").new()
+	_editor_context_menu = preload("res://addons/gdUnit4/src/ui/menu/GdUnitScriptEditorContextMenuHandler.gd").new()
+	_editor_code_context_menu = preload("res://addons/gdUnit4/src/ui/menu/GdUnitScriptEditorContextMenuHandler.gd").new()
+	add_context_menu_plugin(EditorContextMenuPlugin.CONTEXT_SLOT_FILESYSTEM, _filesystem_context_menu)
+	add_context_menu_plugin(EditorContextMenuPlugin.CONTEXT_SLOT_SCRIPT_EDITOR, _editor_context_menu)
+	add_context_menu_plugin(EditorContextMenuPlugin.CONTEXT_SLOT_SCRIPT_EDITOR_CODE, _editor_code_context_menu)
+
+
+func _remove_context_menus() -> void:
+	if is_instance_valid(_filesystem_context_menu):
+		remove_context_menu_plugin(_filesystem_context_menu)
+	if is_instance_valid(_editor_context_menu):
+		remove_context_menu_plugin(_editor_context_menu)
+	if is_instance_valid(_editor_code_context_menu):
+		remove_context_menu_plugin(_editor_code_context_menu)
+
+
+func _on_resource_saved(resource: Resource) -> void:
+	if resource is Script:
+		await GdUnitTestDiscoverGuard.instance().discover(resource as Script)

addons/gdUnit4/plugin.gd.uid

@@ -0,0 +1 @@
+uid://8wxua8uw7x7k

addons/gdUnit4/runtest.cmd

@@ -0,0 +1,62 @@
+@echo off
+setlocal enabledelayedexpansion
+
+:: Initialize variables
+set "godot_binary="
+set "filtered_args="
+
+:: Process all arguments
+set "i=0"
+:parse_args
+if "%~1"=="" goto end_parse_args
+
+if "%~1"=="--godot_binary" (
+    set "godot_binary=%~2"
+    shift
+    shift
+) else (
+    set "filtered_args=!filtered_args! %~1"
+    shift
+)
+goto parse_args
+:end_parse_args
+
+:: If --godot_binary wasn't provided, fallback to environment variable
+if "!godot_binary!"=="" (
+    set "godot_binary=%GODOT_BIN%"
+)
+
+:: Check if we have a godot_binary value from any source
+if "!godot_binary!"=="" (
+    echo Godot binary path is not specified.
+    echo Please either:
+    echo   - Set the environment variable: set GODOT_BIN=C:\path\to\godot.exe
+    echo   - Or use the --godot_binary argument: --godot_binary C:\path\to\godot.exe
+    exit /b 1
+)
+
+:: Check if the Godot binary exists
+if not exist "!godot_binary!" (
+    echo Error: The specified Godot binary '!godot_binary!' does not exist.
+    exit /b 1
+)
+
+:: Get Godot version and check if it's a mono build
+for /f "tokens=*" %%i in ('"!godot_binary!" --version') do set GODOT_VERSION=%%i
+echo !GODOT_VERSION! | findstr /I "mono" >nul
+if !errorlevel! equ 0 (
+    echo Godot .NET detected
+    echo Compiling c# classes ... Please Wait
+    dotnet build --debug
+    echo done !errorlevel!
+)
+
+:: Run the tests with the filtered arguments
+"!godot_binary!" --path . -s -d res://addons/gdUnit4/bin/GdUnitCmdTool.gd !filtered_args!
+set exit_code=%ERRORLEVEL%
+echo Run tests ends with %exit_code%
+
+:: Run the copy log command
+"!godot_binary!" --headless --path . --quiet -s res://addons/gdUnit4/bin/GdUnitCopyLog.gd !filtered_args! > nul
+set exit_code2=%ERRORLEVEL%
+exit /b %exit_code%

addons/gdUnit4/runtest.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+
+# Check for command-line argument
+godot_binary=""
+filtered_args=""
+
+# Process all arguments with a more compatible approach
+while [ $# -gt 0 ]; do
+    if [ "$1" = "--godot_binary" ] && [ $# -gt 1 ]; then
+        # Get the next argument as the value
+        godot_binary="$2"
+        shift 2
+    else
+        # Keep non-godot_binary arguments for passing to Godot
+        filtered_args="$filtered_args $1"
+        shift
+    fi
+done
+
+# If --godot_binary wasn't provided, fallback to environment variable
+if [ -z "$godot_binary" ]; then
+    godot_binary="$GODOT_BIN"
+fi
+
+# Check if we have a godot_binary value from any source
+if [ -z "$godot_binary" ]; then
+    echo "Godot binary path is not specified."
+    echo "Please either:"
+    echo "  - Set the environment variable: export GODOT_BIN=/path/to/godot"
+    echo "  - Or use the --godot_binary argument: --godot_binary /path/to/godot"
+    exit 1
+fi
+
+# Check if the Godot binary exists and is executable
+if [ ! -f "$godot_binary" ]; then
+    echo "Error: The specified Godot binary '$godot_binary' does not exist."
+    exit 1
+fi
+
+if [ ! -x "$godot_binary" ]; then
+    echo "Error: The specified Godot binary '$godot_binary' is not executable."
+    exit 1
+fi
+
+# Get Godot version and check if it's a .NET build
+GODOT_VERSION=$("$godot_binary" --version)
+if echo "$GODOT_VERSION" | grep -i "mono" > /dev/null; then
+    echo "Godot .NET detected"
+    echo "Compiling c# classes ... Please Wait"
+    dotnet build --debug
+    echo "done $?"
+fi
+
+# Run the tests with the filtered arguments
+"$godot_binary" --path . -s -d res://addons/gdUnit4/bin/GdUnitCmdTool.gd $filtered_args
+exit_code=$?
+echo "Run tests ends with $exit_code"
+
+# Run the copy log command
+"$godot_binary" --headless --path . --quiet -s res://addons/gdUnit4/bin/GdUnitCopyLog.gd $filtered_args > /dev/null
+exit_code2=$?
+exit $exit_code

addons/gdUnit4/src/Comparator.gd

@@ -0,0 +1,12 @@
+class_name Comparator
+extends Resource
+
+enum {
+	EQUAL,
+	LESS_THAN,
+	LESS_EQUAL,
+	GREATER_THAN,
+	GREATER_EQUAL,
+	BETWEEN_EQUAL,
+	NOT_BETWEEN_EQUAL,
+}

addons/gdUnit4/src/Comparator.gd.uid

@@ -0,0 +1 @@
+uid://duj13ipuced2q

addons/gdUnit4/src/Fuzzers.gd

@@ -0,0 +1,80 @@
+## Factory class providing convenient static methods to create various fuzzer instances.[br]
+##
+## Fuzzers is a utility class that simplifies the creation of different fuzzer types
+## for testing purposes. It provides static factory methods that create pre-configured
+## fuzzers with sensible defaults, making it easier to set up fuzz testing in your
+## test suites without manually instantiating each fuzzer type.[br]
+##
+## This class acts as a central access point for all fuzzer types, improving code
+## readability and reducing boilerplate in test cases.[br]
+##
+## @tutorial(Fuzzing Testing): https://en.wikipedia.org/wiki/Fuzzing
+class_name Fuzzers
+extends Resource
+
+
+## Generates random strings with length between [param min_length] and
+## [param max_length] (inclusive), using characters from [param charset].
+## See [StringFuzzer] for detailed documentation and examples.
+static func rand_str(min_length: int, max_length: int, charset := StringFuzzer.DEFAULT_CHARSET) -> StringFuzzer:
+	return StringFuzzer.new(min_length, max_length, charset)
+
+
+## Creates a [BoolFuzzer] for generating random boolean values.[br]
+##
+## See [BoolFuzzer] for detailed documentation and examples.
+static func boolean() -> BoolFuzzer:
+	return BoolFuzzer.new()
+
+
+## Creates an [IntFuzzer] for generating random integers within a range.[br]
+##
+## Generates random integers between [param from] and [param to] (inclusive)
+## using [constant IntFuzzer.NORMAL] mode.
+## See [IntFuzzer] for detailed documentation and examples.
+static func rangei(from: int, to: int) -> IntFuzzer:
+	return IntFuzzer.new(from, to)
+
+
+## Creates a [FloatFuzzer] for generating random floats within a range.[br]
+##
+## Generates random float values between [param from] and [param to] (inclusive).
+## See [FloatFuzzer] for detailed documentation and examples.
+static func rangef(from: float, to: float) -> FloatFuzzer:
+	return FloatFuzzer.new(from, to)
+
+
+## Creates a [Vector2Fuzzer] for generating random 2D vectors within a range.[br]
+##
+## Generates random Vector2 values where each component is bounded by
+## [param from] and [param to] (inclusive).
+## See [Vector2Fuzzer] for detailed documentation and examples.
+static func rangev2(from: Vector2, to: Vector2) -> Vector2Fuzzer:
+	return Vector2Fuzzer.new(from, to)
+
+
+## Creates a [Vector3Fuzzer] for generating random 3D vectors within a range.[br]
+##
+## Generates random Vector3 values where each component is bounded by
+## [param from] and [param to] (inclusive).
+## See [Vector3Fuzzer] for detailed documentation and examples.
+static func rangev3(from: Vector3, to: Vector3) -> Vector3Fuzzer:
+	return Vector3Fuzzer.new(from, to)
+
+
+## Creates an [IntFuzzer] that generates only even integers.[br]
+##
+## Generates random even integers between [param from] and [param to] (inclusive)
+## using [constant IntFuzzer.EVEN] mode.
+## See [IntFuzzer] for detailed documentation about even number generation.
+static func eveni(from: int, to: int) -> IntFuzzer:
+	return IntFuzzer.new(from, to, IntFuzzer.EVEN)
+
+
+## Creates an [IntFuzzer] that generates only odd integers.[br]
+##
+## Generates random odd integers between [param from] and [param to] (inclusive)
+## using [constant IntFuzzer.ODD] mode.
+## See [IntFuzzer] for detailed documentation about odd number generation.
+static func oddi(from: int, to: int) -> IntFuzzer:
+	return IntFuzzer.new(from, to, IntFuzzer.ODD)

addons/gdUnit4/src/Fuzzers.gd.uid

@@ -0,0 +1 @@
+uid://wd2ydmpylh1e

addons/gdUnit4/src/GdUnitArrayAssert.gd

@@ -0,0 +1,122 @@
+## An Assertion Tool to verify array values
+@abstract class_name GdUnitArrayAssert
+extends GdUnitAssert
+
+
+## Verifies that the current value is null.
+@abstract func is_null() -> GdUnitArrayAssert
+
+
+## Verifies that the current value is not null.
+@abstract func is_not_null() -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is equal to the given one.
+@abstract func is_equal(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is equal to the given one, ignoring case considerations.
+@abstract func is_equal_ignoring_case(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is not equal to the given one.
+@abstract func is_not_equal(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is not equal to the given one, ignoring case considerations.
+@abstract func is_not_equal_ignoring_case(...expected: Array) -> GdUnitArrayAssert
+
+
+## Overrides the default failure message by given custom message.
+@abstract func override_failure_message(message: String) -> GdUnitArrayAssert
+
+
+## Appends a custom message to the failure message.
+@abstract func append_failure_message(message: String) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is empty, it has a size of 0.
+@abstract func is_empty() -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is not empty, it has a size of minimum 1.
+@abstract func is_not_empty() -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is the same. [br]
+## Compares the current by object reference equals
+@abstract func is_same(expected: Variant) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array is NOT the same. [br]
+## Compares the current by object reference equals
+@abstract func is_not_same(expected: Variant) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array has a size of given value.
+@abstract func has_size(expectd: int) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array contains the given values, in any order.[br]
+## The values are compared by deep parameter comparision, for object reference compare you have to use [method contains_same]
+@abstract func contains(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array contains exactly only the given values and nothing else, in same order.[br]
+## The values are compared by deep parameter comparision, for object reference compare you have to use [method contains_same_exactly]
+@abstract func contains_exactly(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array contains exactly only the given values and nothing else, in any order.[br]
+## The values are compared by deep parameter comparision, for object reference compare you have to use [method contains_same_exactly_in_any_order]
+@abstract func contains_exactly_in_any_order(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array contains the given values, in any order.[br]
+## The values are compared by object reference, for deep parameter comparision use [method contains]
+@abstract func contains_same(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array contains exactly only the given values and nothing else, in same order.[br]
+## The values are compared by object reference, for deep parameter comparision use [method contains_exactly]
+@abstract func contains_same_exactly(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array contains exactly only the given values and nothing else, in any order.[br]
+## The values are compared by object reference, for deep parameter comparision use [method contains_exactly_in_any_order]
+@abstract func contains_same_exactly_in_any_order(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array do NOT contains the given values, in any order.[br]
+## The values are compared by deep parameter comparision, for object reference compare you have to use [method not_contains_same]
+## [b]Example:[/b]
+## [codeblock]
+## # will succeed
+## assert_array([1, 2, 3, 4, 5]).not_contains(6)
+## # will fail
+## assert_array([1, 2, 3, 4, 5]).not_contains(2, 6)
+## [/codeblock]
+@abstract func not_contains(...expected: Array) -> GdUnitArrayAssert
+
+
+## Verifies that the current Array do NOT contains the given values, in any order.[br]
+## The values are compared by object reference, for deep parameter comparision use [method not_contains]
+## [b]Example:[/b]
+## [codeblock]
+## # will succeed
+## assert_array([1, 2, 3, 4, 5]).not_contains(6)
+## # will fail
+## assert_array([1, 2, 3, 4, 5]).not_contains(2, 6)
+## [/codeblock]
+@abstract func not_contains_same(...expected: Array) -> GdUnitArrayAssert
+
+
+## Extracts all values by given function name and optional arguments into a new ArrayAssert.
+## If the elements not accessible by `func_name` the value is converted to `"n.a"`, expecting null values
+@abstract func extract(func_name: String, ...func_args: Array) -> GdUnitArrayAssert
+
+
+## Extracts all values by given extractor's into a new ArrayAssert.
+## If the elements not extractable than the value is converted to `"n.a"`, expecting null values
+## -- The argument type is Array[GdUnitValueExtractor]
+@abstract func extractv(...extractors: Array) -> GdUnitArrayAssert

addons/gdUnit4/src/GdUnitArrayAssert.gd.uid

@@ -0,0 +1 @@
+uid://bwaeyokx1kgfd

addons/gdUnit4/src/GdUnitAssert.gd

@@ -0,0 +1,47 @@
+## Base interface of all GdUnit asserts
+@abstract class_name GdUnitAssert
+extends RefCounted
+
+
+## Verifies that the current value is null.
+@abstract func is_null() -> GdUnitAssert
+
+
+## Verifies that the current value is not null.
+@abstract func is_not_null() -> GdUnitAssert
+
+
+## Verifies that the current value is equal to expected one.
+@abstract func is_equal(expected: Variant) -> GdUnitAssert
+
+
+## Verifies that the current value is not equal to expected one.
+@abstract func is_not_equal(expected: Variant) -> GdUnitAssert
+
+
+## Overrides the default failure message by given custom message.[br]
+## This function allows you to replace the automatically generated failure message with a more specific
+## or user-friendly message that better describes the test failure context.[br]
+## Usage:
+##     [codeblock]
+##		# Override with custom context-specific message
+##		func test_player_inventory():
+##		    assert_that(player.get_item_count("sword"))\
+##		        .override_failure_message("Player should have exactly one sword")\
+##		        .is_equal(1)
+##     [/codeblock]
+@abstract func override_failure_message(message: String) -> GdUnitAssert
+
+
+## Appends a custom message to the failure message.[br]
+## This can be used to add additional information to the generated failure message
+## while keeping the original assertion details for better debugging context.[br]
+## Usage:
+##     [codeblock]
+##		# Add context to existing failure message
+##		func test_player_health():
+##		    assert_that(player.health)\
+##		        .append_failure_message("Player was damaged by: %s" % last_damage_source)\
+##		        .is_greater(0)
+##     [/codeblock]
+@abstract func append_failure_message(message: String) -> GdUnitAssert

addons/gdUnit4/src/GdUnitAssert.gd.uid

@@ -0,0 +1 @@
+uid://qqwrtj2mj3xi

addons/gdUnit4/src/GdUnitAwaiter.gd

@@ -0,0 +1,72 @@
+class_name GdUnitAwaiter
+extends RefCounted
+
+
+# Waits for a specified signal in an interval of 50ms sent from the <source>, and terminates with an error after the specified timeout has elapsed.
+# source: the object from which the signal is emitted
+# signal_name: signal name
+# args: the expected signal arguments as an array
+# timeout: the timeout in ms, default is set to 2000ms
+func await_signal_on(source :Object, signal_name :String, args :Array = [], timeout_millis :int = 2000) -> Variant:
+	# fail fast if the given source instance invalid
+	var assert_that := GdUnitAssertImpl.new(signal_name)
+	var line_number := GdUnitAssertions.get_line_number()
+	if not is_instance_valid(source):
+		@warning_ignore("return_value_discarded")
+		assert_that.report_error(GdAssertMessages.error_await_signal_on_invalid_instance(source, signal_name, args), line_number)
+		return await (Engine.get_main_loop() as SceneTree).process_frame
+	# fail fast if the given source instance invalid
+	if not is_instance_valid(source):
+		@warning_ignore("return_value_discarded")
+		assert_that.report_error(GdAssertMessages.error_await_signal_on_invalid_instance(source, signal_name, args), line_number)
+		return await await_idle_frame()
+	var awaiter := GdUnitSignalAwaiter.new(timeout_millis)
+	var value :Variant = await awaiter.on_signal(source, signal_name, args)
+	if awaiter.is_interrupted():
+		var failure := "await_signal_on(%s, %s) timed out after %sms" % [signal_name, args, timeout_millis]
+		@warning_ignore("return_value_discarded")
+		assert_that.report_error(failure, line_number)
+	return value
+
+
+# Waits for a specified signal sent from the <source> between idle frames and aborts with an error after the specified timeout has elapsed
+# source: the object from which the signal is emitted
+# signal_name: signal name
+# args: the expected signal arguments as an array
+# timeout: the timeout in ms, default is set to 2000ms
+func await_signal_idle_frames(source :Object, signal_name :String, args :Array = [], timeout_millis :int = 2000) -> Variant:
+	var line_number := GdUnitAssertions.get_line_number()
+	# fail fast if the given source instance invalid
+	if not is_instance_valid(source):
+		@warning_ignore("return_value_discarded")
+		GdUnitAssertImpl.new(signal_name)\
+			.report_error(GdAssertMessages.error_await_signal_on_invalid_instance(source, signal_name, args), line_number)
+		return await await_idle_frame()
+	var awaiter := GdUnitSignalAwaiter.new(timeout_millis, true)
+	var value :Variant = await awaiter.on_signal(source, signal_name, args)
+	if awaiter.is_interrupted():
+		var failure := "await_signal_idle_frames(%s, %s) timed out after %sms" % [signal_name, args, timeout_millis]
+		@warning_ignore("return_value_discarded")
+		GdUnitAssertImpl.new(signal_name).report_error(failure, line_number)
+	return value
+
+
+# Waits for for a given amount of milliseconds
+# example:
+#    # waits for 100ms
+#    await GdUnitAwaiter.await_millis(myNode, 100).completed
+# use this waiter and not `await get_tree().create_timer().timeout to prevent errors when a test case is timed out
+func await_millis(milliSec :int) -> void:
+	var timer :Timer = Timer.new()
+	timer.set_name("gdunit_await_millis_timer_%d" % timer.get_instance_id())
+	(Engine.get_main_loop() as SceneTree).root.add_child(timer)
+	timer.add_to_group("GdUnitTimers")
+	timer.set_one_shot(true)
+	timer.start(milliSec / 1000.0)
+	await timer.timeout
+	timer.queue_free()
+
+
+# Waits until the next idle frame
+func await_idle_frame() -> void:
+	await (Engine.get_main_loop() as SceneTree).process_frame

addons/gdUnit4/src/GdUnitAwaiter.gd.uid

@@ -0,0 +1 @@
+uid://fnv7o85xbiiq

addons/gdUnit4/src/GdUnitBoolAssert.gd

@@ -0,0 +1,35 @@
+## An Assertion Tool to verify boolean values
+@abstract class_name GdUnitBoolAssert
+extends GdUnitAssert
+
+
+## Verifies that the current value is null.
+@abstract func is_null() -> GdUnitBoolAssert
+
+
+## Verifies that the current value is not null.
+@abstract func is_not_null() -> GdUnitBoolAssert
+
+
+## Verifies that the current value is equal to the given one.
+@abstract func is_equal(expected: Variant) -> GdUnitBoolAssert
+
+
+## Verifies that the current value is not equal to the given one.
+@abstract func is_not_equal(expected: Variant) -> GdUnitBoolAssert
+
+
+## Overrides the default failure message by given custom message.
+@abstract func override_failure_message(message: String) -> GdUnitBoolAssert
+
+
+## Appends a custom message to the failure message.
+@abstract func append_failure_message(message: String) -> GdUnitBoolAssert
+
+
+## Verifies that the current value is true.
+@abstract func is_true() -> GdUnitBoolAssert
+
+
+## Verifies that the current value is false.
+@abstract func is_false() -> GdUnitBoolAssert

addons/gdUnit4/src/GdUnitBoolAssert.gd.uid

@@ -0,0 +1 @@
+uid://bav21rax06rdf

addons/gdUnit4/src/GdUnitConstants.gd

@@ -0,0 +1,10 @@
+class_name GdUnitConstants
+extends RefCounted
+
+const NO_ARG :Variant = "<--null-->"
+
+const EXPECT_ASSERT_REPORT_FAILURES := "expect_assert_report_failures"
+
+## The maximum number of report history files to store
+const DEFAULT_REPORT_HISTORY_COUNT = 20
+const REPORT_DIR_PREFIX = "report_"

addons/gdUnit4/src/GdUnitConstants.gd.uid

@@ -0,0 +1 @@
+uid://b750alnjl31nv

addons/gdUnit4/src/GdUnitDictionaryAssert.gd

@@ -0,0 +1,79 @@
+## An Assertion Tool to verify dictionary
+@abstract class_name GdUnitDictionaryAssert
+extends GdUnitAssert
+
+
+## Verifies that the current value is null.
+@abstract func is_null() -> GdUnitDictionaryAssert
+
+
+## Verifies that the current value is not null.
+@abstract func is_not_null() -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary is equal to the given one, ignoring order.
+@abstract func is_equal(expected: Variant) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary is not equal to the given one, ignoring order.
+@abstract func is_not_equal(expected: Variant) -> GdUnitDictionaryAssert
+
+
+## Overrides the default failure message by given custom message.
+@abstract func override_failure_message(message: String) -> GdUnitDictionaryAssert
+
+
+## Appends a custom message to the failure message.
+@abstract func append_failure_message(message: String) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary is empty, it has a size of 0.
+@abstract func is_empty() -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary is not empty, it has a size of minimum 1.
+@abstract func is_not_empty() -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary is the same. [br]
+## Compares the current by object reference equals
+@abstract func is_same(expected: Variant) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary is NOT the same. [br]
+## Compares the current by object reference equals
+@abstract func is_not_same(expected: Variant) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary has a size of given value.
+@abstract func has_size(expected: int) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary contains the given key(s).[br]
+## The keys are compared by deep parameter comparision, for object reference compare you have to use [method contains_same_keys]
+@abstract func contains_keys(...expected: Array) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary contains the given key and value.[br]
+## The key and value are compared by deep parameter comparision, for object reference compare you have to use [method contains_same_key_value]
+@abstract func contains_key_value(key: Variant, value: Variant) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary not contains the given key(s).[br]
+## The keys are compared by deep parameter comparision, for object reference compare you have to use [method not_contains_same_keys]
+@abstract func not_contains_keys(...expected: Array) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary contains the given key(s).[br]
+## The keys are compared by object reference, for deep parameter comparision use [method contains_keys]
+@abstract func contains_same_keys(expected: Array) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary contains the given key and value.[br]
+## The key and value are compared by object reference, for deep parameter comparision use [method contains_key_value]
+@abstract func contains_same_key_value(key: Variant, value: Variant) -> GdUnitDictionaryAssert
+
+
+## Verifies that the current dictionary not contains the given key(s).
+## The keys are compared by object reference, for deep parameter comparision use [method not_contains_keys]
+@abstract func not_contains_same_keys(...expected: Array) -> GdUnitDictionaryAssert

addons/gdUnit4/src/GdUnitDictionaryAssert.gd.uid

@@ -0,0 +1 @@
+uid://cfqx4148ov21q

addons/gdUnit4/src/GdUnitFailureAssert.gd

@@ -0,0 +1,52 @@
+## An assertion tool to verify GDUnit asserts.
+## This assert is for internal use only, to verify that failed asserts work as expected.
+@abstract class_name GdUnitFailureAssert
+extends GdUnitAssert
+
+
+## Verifies that the current value is null.
+@abstract func is_null() -> GdUnitFailureAssert
+
+
+## Verifies that the current value is not null.
+@abstract func is_not_null() -> GdUnitFailureAssert
+
+
+## Verifies that the current value is equal to the given one.
+@abstract func is_equal(expected: Variant) -> GdUnitFailureAssert
+
+
+## Verifies that the current value is not equal to expected one.
+@abstract func is_not_equal(expected: Variant) -> GdUnitFailureAssert
+
+
+## Overrides the default failure message by given custom message.
+@abstract func override_failure_message(message: String) -> GdUnitFailureAssert
+
+
+## Appends a custom message to the failure message.
+@abstract func append_failure_message(message: String) -> GdUnitFailureAssert
+
+
+## Verifies if the executed assert was successful
+@abstract func is_success() -> GdUnitFailureAssert
+
+
+## Verifies if the executed assert has failed
+@abstract func is_failed() -> GdUnitFailureAssert
+
+
+## Verifies the failure line is equal to expected one.
+@abstract func has_line(expected: int) -> GdUnitFailureAssert
+
+
+## Verifies the failure message is equal to expected one.
+@abstract func has_message(expected: String) -> GdUnitFailureAssert
+
+
+## Verifies that the failure message starts with the expected message.
+@abstract func starts_with_message(expected: String) -> GdUnitFailureAssert
+
+
+## Verifies that the failure message contains the expected message.
+@abstract func contains_message(expected: String) -> GdUnitFailureAssert

addons/gdUnit4/src/GdUnitFailureAssert.gd.uid

@@ -0,0 +1 @@
+uid://hqhd4a063x3n