Modulo X: Professional Modular Level Design for Godot 4.6+

Version: 1.1.4
Compatibility: Godot 4.6+ (GDExtension + GDScript)
Platform: Windows x86_64
License: Custom Commercial (Use in unlimited projects, no redistribution)

Stop dragging files from the FileSystem and guessing asset rotations.
Modulo X is a productivity plugin focused on Flow & Context, replacing the manual process of object placement with a dedicated dock, real-time previews, and smart alignment tools.

Now powered by a C++ native core for maximum performance, with Radial Gizmo, Wall Snap, Face Alignment, Build/Paint Modes, Brush Scatter, Auto-Collision, and License Validation.

---

🆕 What's New in v1.1.4 — Holographic Ghost Preview

• Ghost Preview now shows original textures: The placement preview preserves your asset's actual materials — textures, colors, and patterns are visible at 60% opacity with a subtle green glow
• Face Alignment is now truly usable: You can read text, see images, and verify orientation before placing on walls — no more guessing if a sign is upside-down
• Proper 3D depth: Removed flat Unshaded rendering — ghost now receives lighting and casts shadows for better spatial reading
• ShaderMaterial fallback: Works correctly even for assets using custom shaders

⚡ What's New in v1.1.3 — 530x Faster Demo Activation

• Demo activation: 30s → 58ms: Root cause was Windows resolving localhost to IPv6 first — fixed by using 127.0.0.1 explicitly
• Real-time Request Monitor: Admin panel now shows endpoint timing with ms-level latency badges and auto-refresh
• Audit logging: Godot Output now shows [HH:MM:SS] [LicenseManager] with exact ms duration per request

---

🛠️ Core Features

⚡ Native C++ Core

• 5 Native Modules: GeometryScanner, PlacementEngine, BrushCore, CollisionGenerator, LicenseValidator
• ~35 Exposed Methods: All callable from GDScript via GDExtension bridge
• DLL Required: Mandatory for all placement operations — ensures performance and security

🧱 Build Mode — Precision Placement

• Grid Snapping: Configurable grid size (0.5 - 10.0m) with adjustable Y-height
• Surface Snapping: Automatically detects and snaps to object surfaces (AABB top)
• Wall Snap: Detects vertical surfaces and snaps objects to walls
• Face Alignment: Auto-rotates objects to stand up against walls (inclined walls too!)
• Wall Rotation: R/Scroll rotates objects in-place on wall surfaces
• Axis Lock (X/Y/Z): Lock axes for precise corridor/wall alignment
• Ghost Preview (Holographic): Semi-transparent preview shows original textures — verify orientation and labels before placing
• Quick Rotation: R for 90°, scroll for 15° increments

🎨 Paint Mode — Scatter Brush

• Brush Engine: Click and drag to scatter objects in an area
• Configurable: Radius, density, random rotation, random scale
• Multi-Asset Palette: Ctrl+Click to add multiple assets for mixed scatter
• Eraser (E key): Remove objects in brush area
• Visual Feedback: Circle indicator shows brush area and mode

🎯 Radial Gizmo — Quick Actions

• V Key: Press during placement to open a circular contextual menu
• Build Mode: Rotate ±90°, Wall Snap, Face Align, Reset Rotation, Cancel
• Paint Mode: Radius ±, Density ±, Eraser, Clear Area

🛡️ Auto-Collision Generation (NEW)

• Instant Collision: Automatically creates collision shapes when placing assets
• Multiple Types: Box (fast), Convex (recommended), Trimesh (precise)
• Smart Detection: C++ module recommends best shape type based on mesh complexity
• CSG Support: Works with all CSG shape types

👁️ Live 3D Preview

• Real-time Preview: Hover over any asset to see the actual 3D model rotating
• Professional Lighting: 3-point lighting system for optimal visibility
• Zoom Slider: Adjustable thumbnail sizes (40-160px)

🔍 Smart Browser

• Search Bar: Filter assets by name in real time
• Favorites: Shift+Click to star assets (persists between sessions)
• Recent Assets: Quick access to last 20 used assets
• Universal Assets: .tscn, .glb, .gltf, .obj, .tres, .res

🔄 Professional Workflow

• Native Undo/Redo: Full Ctrl+Z support integrated with Godot's history
• Geometry Scanner: C++ auto-detects front face and optimal camera angles
• Non-Destructive: All operations preserve scene hierarchy

---

⌨️ Keyboard Shortcuts

Key	Action
V	Radial Gizmo (hold + hover + release)
R	Rotate 90° (works on walls too)
Scroll	Rotate 15° / Brush radius
G	Toggle grid
E	Toggle eraser (Paint mode)
X/Y/Z	Lock axis
LMB	Place / Paint
RMB	Cancel
Ctrl+Z	Undo

---

🔑 Licensing

• 7-Day Free Demo: Full functionality, no restrictions during trial
• License Key: One-time purchase, activate with your unique key
• 2 Machines: Use on up to 2 computers per license
• Offline Support: Works without internet after initial activation
• Free Updates: All future updates included at no extra cost

---

📦 What's Included

• Plugin: GDScript wrappers + compiled C++ native DLL (Windows x86_64)
• StarterContent: 8 CSG-based prototype assets for immediate use
• Documentation: Complete guides in English and Portuguese (pt-br)

---

📋 Requirements

• Godot: 4.6 or higher
• Platform: Windows x86_64 (Linux/macOS coming soon)
• Assets: Any 3D format (.tscn, .glb, .gltf, .obj, .tres, .res)

---

📸 Quick Start

1. Extract and copy addons/modulo_x/ to your project
2. Enable in Project > Project Settings > Plugins
3. The activation dialog will appear — start your 7-day demo or enter your key
4. Find the Holodeck Browser dock on the right
5. Choose your mode: 🧱 Build for precision or 🎨 Paint for scatter
6. Click an asset and place it — collision is auto-generated!
7. Press V for the Radial Gizmo, R to rotate!

That's it! You're ready to build.

---

📜 License Terms

Custom Commercial License

✅ You CAN:

• Use in unlimited commercial game projects
• Modify the GDScript wrapper code for your needs
• Sell games created with this plugin
• Use in client projects

❌ You CANNOT:

• Resell or redistribute the plugin
• Reverse-engineer or decompile the native DLL
• Include in asset packs or bundles
• Share on public repositories
• Give to other developers

Think of it like Photoshop: you can use it to create and sell your art, but you can't give/sell Photoshop itself to others.

---

🤝 Support & Feedback

This plugin was built by devs, for devs. Found a bug or have suggestions?

• Bug Reports: Use the comments section below
• Feature Requests: Share your ideas — they shape future updates!
• Documentation: Complete guides in English and Portuguese included

Buy once, own forever. All future updates included.

---

Modulo X — Professional level design at game jam speed.