diff --git a/addons/csg_toolkit/SETTINGS.md b/addons/csg_toolkit/SETTINGS.md
new file mode 100644
index 00000000..93fdcf43
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/csg_toolkit.gd b/addons/csg_toolkit/csg_toolkit.gd
new file mode 100644
index 00000000..ca2b166c
--- /dev/null
+++ b/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()
diff --git a/addons/csg_toolkit/csg_toolkit.gd.uid b/addons/csg_toolkit/csg_toolkit.gd.uid
new file mode 100644
index 00000000..5048361d
--- /dev/null
+++ b/addons/csg_toolkit/csg_toolkit.gd.uid
@@ -0,0 +1 @@
+uid://cmwnf4lkck6mm
diff --git a/addons/csg_toolkit/demo/demo.tscn b/addons/csg_toolkit/demo/demo.tscn
new file mode 100644
index 00000000..9c196985
--- /dev/null
+++ b/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)
diff --git a/addons/csg_toolkit/demo/new_shader_material.tres b/addons/csg_toolkit/demo/new_shader_material.tres
new file mode 100644
index 00000000..0a37a359
--- /dev/null
+++ b/addons/csg_toolkit/demo/new_shader_material.tres
@@ -0,0 +1,3 @@
+[gd_resource type="ShaderMaterial" format=3 uid="uid://bvlrolerfilhd"]
+
+[resource]
diff --git a/addons/csg_toolkit/demo/red.material b/addons/csg_toolkit/demo/red.material
new file mode 100644
index 00000000..d390d6aa
Binary files /dev/null and b/addons/csg_toolkit/demo/red.material differ
diff --git a/addons/csg_toolkit/plugin.cfg b/addons/csg_toolkit/plugin.cfg
new file mode 100644
index 00000000..4bd94cae
--- /dev/null
+++ b/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"
diff --git a/addons/csg_toolkit/res/demo-image.png b/addons/csg_toolkit/res/demo-image.png
new file mode 100644
index 00000000..5b382b9e
--- /dev/null
+++ b/addons/csg_toolkit/res/demo-image.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bf8e2e8b2a6feac4e4ad9fb97901068ac5d553e9cb0bfea8d3c05551c7a3a7d7
+size 449995
diff --git a/addons/csg_toolkit/res/demo-image.png.import b/addons/csg_toolkit/res/demo-image.png.import
new file mode 100644
index 00000000..332b5530
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icon.png b/addons/csg_toolkit/res/icon.png
new file mode 100644
index 00000000..d45dbeee
--- /dev/null
+++ b/addons/csg_toolkit/res/icon.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:65208b25047213261b5d5c2cd470ba7caa7c10131eb9ff0f5b77883bfa6fe625
+size 178469
diff --git a/addons/csg_toolkit/res/icon.png.import b/addons/csg_toolkit/res/icon.png.import
new file mode 100644
index 00000000..279fd554
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/box.svg b/addons/csg_toolkit/res/icons/box.svg
new file mode 100644
index 00000000..d86e36b6
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/box.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/box.svg.import b/addons/csg_toolkit/res/icons/box.svg.import
new file mode 100644
index 00000000..6cb640ca
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/config.svg b/addons/csg_toolkit/res/icons/config.svg
new file mode 100644
index 00000000..0b78a881
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/config.svg
@@ -0,0 +1,4 @@
+
diff --git a/addons/csg_toolkit/res/icons/config.svg.import b/addons/csg_toolkit/res/icons/config.svg.import
new file mode 100644
index 00000000..a131e344
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/cyliner.svg b/addons/csg_toolkit/res/icons/cyliner.svg
new file mode 100644
index 00000000..d25e39a6
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/cyliner.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/cyliner.svg.import b/addons/csg_toolkit/res/icons/cyliner.svg.import
new file mode 100644
index 00000000..b05a04ca
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/empty-material.svg b/addons/csg_toolkit/res/icons/empty-material.svg
new file mode 100644
index 00000000..0cac3119
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/empty-material.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/empty-material.svg.import b/addons/csg_toolkit/res/icons/empty-material.svg.import
new file mode 100644
index 00000000..e92a21cc
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/intersection.svg b/addons/csg_toolkit/res/icons/intersection.svg
new file mode 100644
index 00000000..60213607
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/intersection.svg
@@ -0,0 +1,4 @@
+
diff --git a/addons/csg_toolkit/res/icons/intersection.svg.import b/addons/csg_toolkit/res/icons/intersection.svg.import
new file mode 100644
index 00000000..23ab4c45
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/mesh.svg b/addons/csg_toolkit/res/icons/mesh.svg
new file mode 100644
index 00000000..8f65ccce
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/mesh.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/mesh.svg.import b/addons/csg_toolkit/res/icons/mesh.svg.import
new file mode 100644
index 00000000..bbcb859b
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/polygon.svg b/addons/csg_toolkit/res/icons/polygon.svg
new file mode 100644
index 00000000..4fa9d96a
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/polygon.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/polygon.svg.import b/addons/csg_toolkit/res/icons/polygon.svg.import
new file mode 100644
index 00000000..8b1e69e6
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/sphere.svg b/addons/csg_toolkit/res/icons/sphere.svg
new file mode 100644
index 00000000..a51db6ef
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/sphere.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/sphere.svg.import b/addons/csg_toolkit/res/icons/sphere.svg.import
new file mode 100644
index 00000000..71399b23
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/subtraction.svg b/addons/csg_toolkit/res/icons/subtraction.svg
new file mode 100644
index 00000000..a99d3cfc
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/subtraction.svg
@@ -0,0 +1,4 @@
+
diff --git a/addons/csg_toolkit/res/icons/subtraction.svg.import b/addons/csg_toolkit/res/icons/subtraction.svg.import
new file mode 100644
index 00000000..a2752e7e
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/torus.svg b/addons/csg_toolkit/res/icons/torus.svg
new file mode 100644
index 00000000..39661b40
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/torus.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/addons/csg_toolkit/res/icons/torus.svg.import b/addons/csg_toolkit/res/icons/torus.svg.import
new file mode 100644
index 00000000..82bea616
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/icons/union.svg b/addons/csg_toolkit/res/icons/union.svg
new file mode 100644
index 00000000..ed725622
--- /dev/null
+++ b/addons/csg_toolkit/res/icons/union.svg
@@ -0,0 +1,6 @@
+
diff --git a/addons/csg_toolkit/res/icons/union.svg.import b/addons/csg_toolkit/res/icons/union.svg.import
new file mode 100644
index 00000000..8c7af1af
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/image.png.import b/addons/csg_toolkit/res/image.png.import
new file mode 100644
index 00000000..c7596095
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/res/operation_group.tres b/addons/csg_toolkit/res/operation_group.tres
new file mode 100644
index 00000000..3f03eea3
--- /dev/null
+++ b/addons/csg_toolkit/res/operation_group.tres
@@ -0,0 +1,3 @@
+[gd_resource type="ButtonGroup" format=3 uid="uid://wxtkg1wlxka8"]
+
+[resource]
diff --git a/addons/csg_toolkit/scenes/config_window.tscn b/addons/csg_toolkit/scenes/config_window.tscn
new file mode 100644
index 00000000..2655fd7a
--- /dev/null
+++ b/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"]
diff --git a/addons/csg_toolkit/scenes/csg_quick_actions.tscn b/addons/csg_toolkit/scenes/csg_quick_actions.tscn
new file mode 100644
index 00000000..c41d7eba
--- /dev/null
+++ b/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")
diff --git a/addons/csg_toolkit/scenes/csg_side_toolkit_bar.tscn b/addons/csg_toolkit/scenes/csg_side_toolkit_bar.tscn
new file mode 100644
index 00000000..3a4c43ee
--- /dev/null
+++ b/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"]
diff --git a/addons/csg_toolkit/scenes/csg_top_toolkit_bar.tscn b/addons/csg_toolkit/scenes/csg_top_toolkit_bar.tscn
new file mode 100644
index 00000000..a0d7db40
--- /dev/null
+++ b/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"]
diff --git a/addons/csg_toolkit/scenes/demo.tscn b/addons/csg_toolkit/scenes/demo.tscn
new file mode 100644
index 00000000..9610e4cd
--- /dev/null
+++ b/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="."]
diff --git a/addons/csg_toolkit/scripts/config_window.gd b/addons/csg_toolkit/scripts/config_window.gd
new file mode 100644
index 00000000..b9acae46
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/scripts/config_window.gd.uid b/addons/csg_toolkit/scripts/config_window.gd.uid
new file mode 100644
index 00000000..a0010562
--- /dev/null
+++ b/addons/csg_toolkit/scripts/config_window.gd.uid
@@ -0,0 +1 @@
+uid://b7isqiq2asnu6
diff --git a/addons/csg_toolkit/scripts/csg_repeater_3d.gd b/addons/csg_toolkit/scripts/csg_repeater_3d.gd
new file mode 100644
index 00000000..e5aa1ef7
--- /dev/null
+++ b/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()
diff --git a/addons/csg_toolkit/scripts/csg_repeater_3d.gd.uid b/addons/csg_toolkit/scripts/csg_repeater_3d.gd.uid
new file mode 100644
index 00000000..fee0dfc1
--- /dev/null
+++ b/addons/csg_toolkit/scripts/csg_repeater_3d.gd.uid
@@ -0,0 +1 @@
+uid://c68dxahp0v5xg
diff --git a/addons/csg_toolkit/scripts/csg_shortcut_manager.gd b/addons/csg_toolkit/scripts/csg_shortcut_manager.gd
new file mode 100644
index 00000000..759dcc01
--- /dev/null
+++ b/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)
diff --git a/addons/csg_toolkit/scripts/csg_shortcut_manager.gd.uid b/addons/csg_toolkit/scripts/csg_shortcut_manager.gd.uid
new file mode 100644
index 00000000..eb12c067
--- /dev/null
+++ b/addons/csg_toolkit/scripts/csg_shortcut_manager.gd.uid
@@ -0,0 +1 @@
+uid://1bqvx7teqnrl
diff --git a/addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd b/addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd
new file mode 100644
index 00000000..0782bdf3
--- /dev/null
+++ b/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()
diff --git a/addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd.uid b/addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd.uid
new file mode 100644
index 00000000..00d6fc89
--- /dev/null
+++ b/addons/csg_toolkit/scripts/csg_side_toolkit_bar.gd.uid
@@ -0,0 +1 @@
+uid://dr5f1egll7hdq
diff --git a/addons/csg_toolkit/scripts/csg_spreader_3d.gd b/addons/csg_toolkit/scripts/csg_spreader_3d.gd
new file mode 100644
index 00000000..56cf7731
--- /dev/null
+++ b/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())
diff --git a/addons/csg_toolkit/scripts/csg_spreader_3d.gd.uid b/addons/csg_toolkit/scripts/csg_spreader_3d.gd.uid
new file mode 100644
index 00000000..b82587fa
--- /dev/null
+++ b/addons/csg_toolkit/scripts/csg_spreader_3d.gd.uid
@@ -0,0 +1 @@
+uid://rgfomqnhbhpk
diff --git a/addons/csg_toolkit/scripts/csg_toolkit_config.gd b/addons/csg_toolkit/scripts/csg_toolkit_config.gd
new file mode 100644
index 00000000..5dab80cb
--- /dev/null
+++ b/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)
diff --git a/addons/csg_toolkit/scripts/csg_toolkit_config.gd.uid b/addons/csg_toolkit/scripts/csg_toolkit_config.gd.uid
new file mode 100644
index 00000000..5fdd12b6
--- /dev/null
+++ b/addons/csg_toolkit/scripts/csg_toolkit_config.gd.uid
@@ -0,0 +1 @@
+uid://w8ad8q4lneis
diff --git a/addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd b/addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd
new file mode 100644
index 00000000..4771c6cd
--- /dev/null
+++ b/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")
diff --git a/addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd.uid b/addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd.uid
new file mode 100644
index 00000000..6ef21114
--- /dev/null
+++ b/addons/csg_toolkit/scripts/csg_top_toolkit_bar.gd.uid
@@ -0,0 +1 @@
+uid://dk6dt8fk1s43s
diff --git a/addons/csg_toolkit/scripts/patterns/circular_pattern.gd b/addons/csg_toolkit/scripts/patterns/circular_pattern.gd
new file mode 100644
index 00000000..3a3012b8
--- /dev/null
+++ b/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)
diff --git a/addons/csg_toolkit/scripts/patterns/circular_pattern.gd.uid b/addons/csg_toolkit/scripts/patterns/circular_pattern.gd.uid
new file mode 100644
index 00000000..971810e1
--- /dev/null
+++ b/addons/csg_toolkit/scripts/patterns/circular_pattern.gd.uid
@@ -0,0 +1 @@
+uid://b3ws8vwtsqmjt
diff --git a/addons/csg_toolkit/scripts/patterns/csg_pattern.gd b/addons/csg_toolkit/scripts/patterns/csg_pattern.gd
new file mode 100644
index 00000000..ce85aa99
--- /dev/null
+++ b/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()
diff --git a/addons/csg_toolkit/scripts/patterns/csg_pattern.gd.uid b/addons/csg_toolkit/scripts/patterns/csg_pattern.gd.uid
new file mode 100644
index 00000000..d6486e37
--- /dev/null
+++ b/addons/csg_toolkit/scripts/patterns/csg_pattern.gd.uid
@@ -0,0 +1 @@
+uid://dbavf0pl65chb
diff --git a/addons/csg_toolkit/scripts/patterns/grid_pattern.gd b/addons/csg_toolkit/scripts/patterns/grid_pattern.gd
new file mode 100644
index 00000000..6b126b64
--- /dev/null
+++ b/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
diff --git a/addons/csg_toolkit/scripts/patterns/grid_pattern.gd.uid b/addons/csg_toolkit/scripts/patterns/grid_pattern.gd.uid
new file mode 100644
index 00000000..ebbd89f8
--- /dev/null
+++ b/addons/csg_toolkit/scripts/patterns/grid_pattern.gd.uid
@@ -0,0 +1 @@
+uid://bc1sxg4vy464o
diff --git a/addons/csg_toolkit/scripts/patterns/noise_pattern.gd b/addons/csg_toolkit/scripts/patterns/noise_pattern.gd
new file mode 100644
index 00000000..42c4af1f
--- /dev/null
+++ b/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)
diff --git a/addons/csg_toolkit/scripts/patterns/noise_pattern.gd.uid b/addons/csg_toolkit/scripts/patterns/noise_pattern.gd.uid
new file mode 100644
index 00000000..c8ca9535
--- /dev/null
+++ b/addons/csg_toolkit/scripts/patterns/noise_pattern.gd.uid
@@ -0,0 +1 @@
+uid://3il6xs7cr7gj
diff --git a/addons/csg_toolkit/scripts/patterns/spiral_pattern.gd b/addons/csg_toolkit/scripts/patterns/spiral_pattern.gd
new file mode 100644
index 00000000..a0d1600f
--- /dev/null
+++ b/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)
diff --git a/addons/csg_toolkit/scripts/patterns/spiral_pattern.gd.uid b/addons/csg_toolkit/scripts/patterns/spiral_pattern.gd.uid
new file mode 100644
index 00000000..3c62d799
--- /dev/null
+++ b/addons/csg_toolkit/scripts/patterns/spiral_pattern.gd.uid
@@ -0,0 +1 @@
+uid://belgcjd0ys212
diff --git a/project.godot b/project.godot
index 74d8a029..075ee89c 100644
--- a/project.godot
+++ b/project.godot
@@ -27,6 +27,7 @@ SceneLoader="*uid://cbwmrnp0af35y"
ProjectMusicController="*uid://r5t485lr3p7t"
ProjectUISoundController="*uid://cc37235kj4384"
Shaker="*uid://c7flmumgr5w3u"
+CsgToolkitAutoload="*uid://w8ad8q4lneis"
[display]
@@ -43,7 +44,7 @@ movie_writer/movie_file="D:/Godot/Projects/movement-tests/communication/movie.av
[editor_plugins]
-enabled=PackedStringArray("res://addons/gdUnit4/plugin.cfg", "res://addons/godot_state_charts/plugin.cfg", "res://addons/guide/plugin.cfg", "res://addons/maaacks_game_template/plugin.cfg", "res://addons/shaker/plugin.cfg")
+enabled=PackedStringArray("res://addons/csg_toolkit/plugin.cfg", "res://addons/gdUnit4/plugin.cfg", "res://addons/godot_state_charts/plugin.cfg", "res://addons/guide/plugin.cfg", "res://addons/maaacks_game_template/plugin.cfg", "res://addons/shaker/plugin.cfg")
[gui]