Opening the Tool

1. In Unity, go to Tools > Peykarimeh > Prefab Brush
2. The Prefab Brush Pro window will open - dock it wherever convenient in your workspace

Initial Setup

Before you start painting, you need to:

1. Create or Select Settings: Choose a settings preset from the dropdown at the top
2. Add Prefabs: Drag prefabs from your Project window into the prefab list
3. Set Parent Object: Assign a Transform as the parent for all placed objects
4. Configure Ground Layer: Set which layer(s) the tool should paint on

Basic Parameters

Placement Settings

Rotation Options

Scale Variation

Height Control

Slope Filtering

Preview Modes

Surface Modes

Line & Curve Brush Modes

Line and Curve brushes feature two distinct placement modes:

Direction Alignment

Multi-Selection

You can select multiple prefabs for varied placement:

1. Ctrl + Click: Add/remove prefabs from selection
2. Weight System: Assign different spawn probabilities
3. Mixed Placement: Tool randomly chooses from selected prefabs

Universal Controls

Brush-Specific Shortcuts

Creating Natural Environments

1. Start with Terrain: Use Spray Brush for base vegetation
2. Add Clusters: Use Circle/Square Stamps for grouped objects
3. Create Paths: Use Line or Curve Brush for trails
4. Fine-tune: Use Move Brush to adjust positioning
5. Clean up: Use Erase Brush to create clearings

Building Structured Layouts

1. Plan with Single: Place key structures first
2. Fill with Stamps: Use Square Stamp for grid layouts
3. Connect with Lines:
   • Single Mode: Perfect straight walls, fences with auto-spacing
   • Spread Mode: Dense hedgerows or thick barriers
4. Add Details: Spray Brush for small decorative elements

Performance Optimization

• Use Simple Preview for large-scale work
• Enable Slope Filtering to avoid invalid placements
• Set appropriate Min Distance to prevent overcrowding
• Group similar objects under organized parent objects

Artistic Variation

• Enable Random Rotation for natural looks
• Use Random Scale for organic variety
• Mix multiple prefabs with different weights
• Combine Random Height with terrain adaptation

Creating Presets

1. Configure your brush settings
2. Click "Create New Settings"
3. Name your preset (e.g., "Forest Trees", "Stone Walls")
4. Settings are saved as ScriptableObjects in your project

Switching Presets

• Use the dropdown at the top of the tool
• Instantly switch between different workflows
• Each preset remembers all settings and prefab lists

Best Practices

• Create separate presets for different object types
• Name presets clearly ("Environment_Trees", "Props_Rocks")
• Share preset files with your team for consistency

Landscape Design

• Trees: Spray Brush + Random Scale + Random Rotation
• Rocks: Circle Stamp + Slope Filtering + Height Variation
• Grass Clumps: Spray Brush + Small Min Distance
• Paths: Line/Curve Brush with path prefabs

Architecture & Props

• Building Placement: Single Brush for precision
• Fence Lines: Line Brush (Single Mode) with Direction Alignment enabled
• Wall Segments: Line Brush (Spread Mode) for thick walls
• Decorative Items: Square Stamp for organized layouts
• Random Props: Spray Brush with multiple prefab selection

Game Level Creation

• Collectibles: Circle Stamp for power-up clusters
• Obstacles: Line Brush for barrier placement
• Environmental Storytelling: Mix of all brushes for detailed scenes

Objects Not Placing

• ✅ Check that Edit Mode is enabled
• ✅ Verify Parent Object is assigned
• ✅ Ensure prefabs are added to the list
• ✅ Check Ground Layer settings match your terrain
• ✅ Verify slope settings aren't too restrictive
• ✅ For Line/Curve brushes, check brush mode matches your needs

Auto Spacing Issues

• 🔧 If spacing seems too large/small, switch to Manual Point Spacing
• 🔧 Auto Spacing is based on largest selected prefab dimension
• 🔧 For mixed prefab sizes, consider using Manual Spacing

Performance Issues

• 🔧 Switch to Simple Preview mode
• 🔧 Reduce brush radius for complex scenes
• 🔧 Lower amount values for heavy prefabs
• 🔧 Use appropriate Min Distance values

Preview Not Showing

• 🔧 Make sure you're hovering over valid surfaces
• 🔧 Check that your ground layer is set correctly
• 🔧 Verify slope filtering isn't blocking placement
• 🔧 Ensure prefabs are properly assigned

Objects Appearing in Wrong Places

• 🔧 Check Top-Down Mode vs Surface-Aware Mode settings
• 🔧 Verify Normal Alignment settings
• 🔧 Adjust Height Offset if objects are floating/buried