Plan : Free Credits : 0
Gravity Scatter Tool - Documentation
Unreal Engine Plugin

Gravity Scatter Tool

Physics-Based Scatter for Unreal Engine 5

A powerful physics-based scatter plugin that uses real-time Chaos physics simulation to drop, spray, shoot, rain, or explode objects onto your scene. Objects bounce, roll, and settle naturally before being converted to optimized Hierarchical Instanced Static Meshes (HISM) for maximum performance.

⚡ Version 1.1 • UE 5.3 - 5.7

Key Features

🎯

Physics-Based Placement

Objects interact with your scene geometry using Unreal's Chaos physics system. They bounce, roll, and settle naturally on any surface with automatic rest detection.

Performance Optimized

Automatic conversion to HISM on confirmation with configurable Cull Distance. Achieve minimal draw calls for thousands of instances.

🖌️

Intuitive Brush System

Visual brush preview with mode-specific visualization. Adjustable brush size with Shift+Scroll and falloff control for natural density distribution.

📚

Mesh Library

Drag & drop meshes directly from Content Browser. Per-mesh spawn weight, enable/disable toggles, and random scale/rotation per mesh type.

5 Unique Spawn Modes

⬇️

Drop Mode

Drop objects from a configurable height and watch them fall with gravity. Perfect for scattering debris, leaves, or rocks on terrain.

🔫

Gun Mode

Shoot objects like projectiles toward your target point. Great for placing objects on vertical surfaces or hard-to-reach areas.

💨

Spray Mode

Spray objects upward from the surface with adjustable force and angle. Ideal for creating splatter effects or upward debris.

🌧️

Rain Mode

Rain objects continuously over large rectangular areas (up to 65,000 units). Perfect for covering large terrain areas quickly.

💥

Explosion Mode

Spawn multiple objects with radial explosion force. Create destruction debris or dramatic scatter effects instantly.

Keyboard Shortcuts

Shortcut Action
Left Click Paint / Spawn objects
Shift + Left Click Erase objects in brush radius
Shift + Scroll Adjust brush size
Enter Confirm and convert to HISM
Escape Cancel and remove scattered objects

Cull Distance (NEW)

Control the visibility of scattered instances based on camera distance. Essential for performance optimization when scattering thousands of objects.

Enable Cull Distance Toggle distance-based culling on/off for HISM instances.
Start Cull Distance Distance at which instances begin to fade out (default: 5000 cm / 50m).
End Cull Distance Distance at which instances are fully invisible (default: 15000 cm / 150m).

Brush Settings

Brush Radius Size of the scatter area (50 - 65,536 units).
Brush Falloff Density distribution (0 = uniform, 1 = concentrated at center).
Spawn Rate Number of objects spawned per batch (1-100).
Spawn Interval Time between spawns in seconds (0 = every frame).

Physics Settings

Gravity Scale Multiplier for gravity force (1 = normal, 2 = double gravity, 0.5 = half gravity).
Initial Velocity Scale Affects launch speed for Projectile, Spray, and Explosion modes.
Linear Damping How quickly objects slow down (higher = faster stop).
Angular Damping How quickly rotation slows down.

Mesh Library

Drag and drop meshes directly from the Content Browser. Each mesh entry supports:

Enable/Disable Toggle individual meshes on/off without removing them.
Spawn Density Weight for spawn probability (higher = spawns more often).
Override Scale Set custom min/max scale range per mesh.
Random Yaw Only Rotate only on Z axis (useful for vegetation).

Perfect For

🍂

Debris & Clutter

Scatter fallen leaves, trash, papers, and environmental clutter with natural physics-based placement.

🪨

Rocks & Terrain

Place rocks, pebbles, and stones naturally on terrain. They roll and settle into realistic positions.

💥

Destruction Effects

Create explosion debris, destruction aftermath, and dramatic scatter effects with the Explosion mode.

🌿

Ground Cover

Distribute ground vegetation, mushrooms, and small props across large areas with Rain mode.

Installation

1

Download

Get the plugin from Fab or extract manually

2

Copy to Plugins

Place in YourProject/Plugins/ folder

3

Compile

Restart UE and let it compile the plugin

4

Enable

Activate in Edit → Plugins

Requirements

  • Unreal Engine 5.3, 5.4, 5.5, 5.6, or 5.7
  • C++ project or ability to compile plugins
  • Blueprint-only projects need to convert to C++ first

Need Help?

Join our Discord community for support, bug reports, and feature requests.

Join Discord Server