Skip to content

arcaneenergy/godot-multimesh-scatter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 

Repository files navigation

MultiMesh Scatter

A simple tool to randomly place meshes.


ko-fi


Note: This plugin was created for Godot v4. If you are using Godot 3.5 (or older), you can find the corresponding plugin in the 3.5 branch.


random_rotation

video_01.mp4
video_02.mp4
video_03.mp4

A simple tool to randomly place meshes.

🧩 Features

  • Scatter objects in the scene. Instances automatically rotate to the normal of the terrain.
  • Adjust the scatter type, size and collision layer and randomize the size and rotation.
  • Clustering: Place instances in tight groups together.
  • Apply advanced constraint options to scatter according to:
    • Terrain angle
    • Vertex color
  • Chunks: Split the MultiMeshScatter node into chunks.

🚀 Install & Use

  1. Download this repository or download the addon from the asset library inside Godot.
    • Import the addons folder into your project (if it already isn't present).
  2. Activate the MultiMesh Scatter addon under Project > Project Settings > Plugins. If an error dialog appears, restart the engine and try activating it again.
  3. Add a MultiMeshScatter node to the scene.

⚠️ Notes

  • The sphere placement type takes placement_size.x for the radius. The y and z values are not used.
  • The sphere placement type behaves more like a capsule shape. This means that only the horizontal radius is taken into account when scattering meshes.
  • Scattering occurs automatically in the editor whenever you change a parameter or move the MultiMeshScatter node. In game mode, the scatter occurs once at the beginning of the game.

🏠 Links

🗒️ License

MIT License