|
SceneManipulator - a powerful editor overlay that brings advanced object manipulation tools directly to your scene view.
|
- 🎯 Precision Alignment: Align objects to minimum, center, or maximum bounds on any axis with visual icons and real-time preview.
- 📐 Smart Arrangements: Organize objects in lines, grids, circles, or random patterns with customizable spacing controls.
- 🧲 Advanced Snapping: Comprehensive snapping system including ground detection, surface alignment, grid snapping, and intelligent stacking.
- 📏 Real-time Measurements: Display distances between objects, total bounds, volume calculations, and surface area with optional visual gizmos.
- 👁️ Live Preview System: Hover over any button to see a real-time preview of the transformation before applying it.
- 🔄 Smart Rotation Tools: Set absolute rotations, add relative rotations, reset to zero, or randomize Y-axis with preview support.
- 📊 Detailed Statistics: Get comprehensive information about selected objects including chain distances, direct distances, and bounding box data.
- 🛠️ Utility Functions: Quick duplicate, delete, and grouping operations with proper undo support.
- 🎨 Visual Feedback: Scene view gizmos show distance measurements and connections between selected objects.
- ⚡ Seamless Integration: Works as a Unity overlay, always accessible in your scene view without cluttering the interface.
Choose your preferred installation method below. The recommended method is via Git URL.
1. Install via Git URL (Recommended)
This method installs the package directly from GitHub and allows you to update it easily.
- In Unity, open the Package Manager (
Window > Package Manager). - Click the + button and select "Add package from git URL...".
- Enter the following URL and click "Add":
https://github.com/Alaxxxx/SceneManipulator.git
2. Install via .unitypackage
Ideal if you prefer a specific, stable version of the asset.
- Go to the Releases page.
- Download the
.unitypackagefile from the latest release. - In your Unity project, go to
Assets > Import Package > Custom Package...and select the downloaded file.
3. Manual Installation (from .zip)
- Download this repository as a ZIP file by clicking
Code > Download ZIP. - Unzip the file.
- Drag the unzipped package folder into your project's
Assetsdirectory.
Once installed, SceneManipulator automatically adds an overlay to your Unity Scene View:
- Open Scene View: The SceneManipulator overlay appears automatically
- Select Objects: Select one or more GameObjects in your scene
- Use Tools: Access positioning, alignment, arrangement, and snapping tools
- Preview Changes: Hover over buttons to see live previews before applying
🎯 Positioning
- Set absolute world positions for all selected objects
- Center selection around world origin
- Snap objects to ground with collision detection
- Move objects directly to origin
📐 Alignment
- Align objects along X, Y, or Z axes
- Choose minimum, center, or maximum alignment targets
- Visual icons for intuitive operation
- Real-time preview on hover
🔄 Rotation
- Set absolute rotations or add relative rotations
- Quick reset to zero rotation
- Randomize Y-axis rotation for natural variation
- Preview rotation changes before applying
📊 Arrangement
- Line: Arrange objects along X, Y, or Z axes
- Grid: Create uniform grids on the XZ plane
- Circle: Distribute objects in circular patterns
- Random: Scatter objects around the first selection
🧲 Snapping
- Ground Snap: Intelligent ground detection with surface alignment
- Bounds Snap: Position objects relative to reference bounds
- Grid Snap: Align to customizable grid points
- Stack: Vertical stacking with padding control
📏 Measurement
- Distance calculations between objects
- Bounding box dimensions and volume
- Surface area calculations
- Visual gizmo display (toggleable)
Enable "Show Distance Gizmos" to display:
- Distance lines between consecutive objects
- Directional arrows showing object relationships
- Floating distance labels in scene view
- Comprehensive measurement statistics
The system intelligently calculates object bounds using:
- Renderer components for visual objects
- Fallback to transform position for objects without renderers
- Hierarchical bounds calculation for complex objects
- Proper handling of scaled and rotated objects
This project is open-source under the MIT License, and any form of contribution is welcome and greatly appreciated!
If you find SceneManipulator useful in your workflow, the easiest way to show your support is by giving it a star ⭐️ on GitHub! It helps a lot with the project's visibility and motivates continued development.
Here are other ways you can get involved:
- 💡 Share Ideas & Report Bugs: Have a great idea for a new manipulation tool or found a bug? Open an issue to share the details.
- 🔌 Contribute Code: Feel free to fork the repository and submit a pull request for bug fixes or new features.
- 🗣️ Spread the Word: Know other Unity developers? Share this tool with them!
- 📹 Create Content: Made a tutorial or showcase? We'd love to feature it!
Every contribution, from a simple star to a pull request, is incredibly valuable. Thank you for your support!