Documentation & FAQ

📖 Installation

1. Open Blender Blender
2. Go to Edit → Preferences → Add-ons
3. Click Install
4. Select the P2O Converter ZIP file
5. Enable the add-on checkbox

The add-on will appear in the Particles Properties Tab.

🚀 Quick Start Guide

Step 1 — Select Particle Object

Select the object that contains your particle system.

Step 2 — Select Instance Object

Select the object used as the particle instance.

⚠️ Important:
The particle system object must remain the active object.

Step 3 — Configure Settings

Choose:

• Frame range
• Particle amount percentage
• Keyframing options
• Visibility behavior
• Collection name

Step 4 — Convert

Press:

Convert Particles to Objects

The add-on will automatically generate animated objects with keyframes.

⚙️ Settings Explained

Particle Amount

Controls how many particles will be converted.

Example:

• 100% = all particles
• 50% = half the particles
• 10% = lightweight preview

Useful for testing large simulations quickly.

Keyframe Location

Adds position keyframes for all generated objects.

Keyframe Rotation

Adds rotation animation matching particle movement.

Keyframe Scale

Adds scale animation from particle size.

Keyframe Visibility

Creates visibility keyframes using Blender visibility settings.

Use Scale for Visibility

Instead of hiding objects, scales them close to zero when particles die.

Benefits:

• Better compatibility with FBX exports
• Better compatibility with game engines
• Cleaner animation playback

Recommended for most workflows.

Make Single User

Creates unique object data before applying transforms.

Useful when:

• Using linked meshes
• Preparing assets for export
• Avoiding shared mesh issues

📦 FBX Export Workflow

Recommended Export Process

1. Convert particles
2. Select generated objects
3. Click Export FBX
4. Use Blender FBX export settings
5. Import into external software

Works well with:

• Unreal Engine
• Unity
• Autodesk Maya
• Houdini