CSG Blockout for Godot 4

CSG Blockout is a high-performance level design and prototyping tool built to streamline 3D grayboxing directly inside Godot 4—without lag and without relying on external 3D modeling software.

Documentation

• 🇺🇸 English Tutorial: Read TUTORIAL_EN.md
• 🇨🇳 中文完整教程: 阅读 TUTORIAL_CN.md
• GitHub Repository: qwqzhanqwq/Godot-CSG-Blockout

High-Performance Features

• Ultra-Fast Pie Menu Workflow: Press Shift + A in the 3D viewport to instantly spawn CSG primitives and execute boolean operations (Union, Intersection, Subtraction).
• Lag-Free Spatial Hash Spreader (CSGSpreader3D): Powered by an O(1) Spatial Hash Grid algorithm, it allows smooth, real-time procedural scattering of massive geometry without editor freeze or collision stutter.
• Versatile Array Systems (CSGRepeater3D): Rapidly generate repeating environments using Grid, Circular, Spiral, and Noise distribution patterns.
• Zero-overhead Mesh Baking Pipeline: Convert heavy real-time CSG trees into optimized MeshInstance3D static meshes and trimesh collisions to eliminate runtime boolean overhead and keep your FPS rock-solid.

Quick Start & Installation

Installation

1. Download and place the addons/CSG_Blockout folder into your project's res://addons/ directory.
2. Open Godot, go to Project -> Project Settings -> Plugins.
3. Check the Enable checkbox next to "CSG Blockout".

Quick Workflow

1. Create Root: Add a CSGCombiner3D node as your base geometric container.
2. Quick Add: Press Shift + A in the 3D viewport to invoke the Pie Menu or use the viewport sidebar.
3. Array & Scatter: Use CSGRepeater3D for structured layouts and CSGSpreader3D for buttery-smooth scattering.
4. Bake for Performance: Follow the documented baking workflow to strip CSG overhead, generating static meshes and tight collisions for production-ready levels.

License & Support

• License: MIT License
• Issue Tracker: Report Bugs or Suggestions on GitHub