Documentation

SKAVA Collision Mesh Generator Pro - Documentation

Table of Contents

1. Installation

2. Quick Start Guide

3. Interface Overview

4. Collision Types

5. AI Assistant

6. Quality Presets

7. Advanced Settings

8. Batch Processing

9. Export Options

10. Troubleshooting

11. API Reference

Installation {#installation}

1. Download the skava_collision_mesh_generator_pro.zip file

2. Open Blender and go to Edit → Preferences → Add-ons

3. Click "Install" and select the downloaded ZIP file

4. Enable "Mesh: SKAVA Collision Mesh Generator Pro"

5. The addon panel will appear in the 3D Viewport sidebar (N key)

Quick Start Guide {#quick-start}

Basic Collision Generation

1. Select your mesh object in the 3D viewport

2. Open the SKAVA panel in the sidebar (N → SKAVA tab)

3. Choose your target engine (Unity/Unreal/Both)

4. Click "Generate Collision"

Using AI Recommendations

1. Select your mesh

2. Enable "AI Optimization"

3. Click "Analyze Selected"

4. Review AI suggestions

5. Click "Generate Collision"

Interface Overview {#interface}

Main Panel

• Target Engine: Select Unity, Unreal, or Both

• Collision Type: Choose collision shape or use Auto (AI)

• Quality Preset: Mobile, Standard, High, or Ultra

• Generate Collision: Main generation button

AI Assistant

• Enable AI Optimization: Activates intelligent analysis

• Analyze Selected: Get AI recommendations

Batch Operations

• Process Selected Objects: Generate for multiple objects

Collision Types {#collision-types}

Box Collision

• Fastest performance

• Perfect for rectangular objects

• Uses oriented bounding box (OBB)

Sphere Collision

• Ideal for round objects

• Uses Ritter's bounding sphere algorithm

• Minimal memory footprint

Capsule Collision

• Perfect for characters and cylindrical objects

• Automatically oriented along principal axis

• Optimized radius calculation

Convex Collision

• Single convex hull

• Customizable vertex count (4-1024)

• Best for simple convex shapes

Compound Collision

• Multiple convex hulls

• Handles complex concave shapes

• Adjustable hull count (1-64)

Mesh Collision (Optimized)

• Decimated version of original mesh

• Adjustable optimization level

• Best for terrain and complex static objects

AI Assistant {#ai-assistant}

The AI analyzes your mesh considering:

• Vertex and polygon count

• Shape complexity

• Symmetry detection

• Convexity analysis

• Aspect ratio

• Volume distribution

AI Confidence Levels

• 90-100%: Highly confident recommendation

• 70-89%: Good recommendation

• 50-69%: Moderate confidence

• Below 50%: Manual review recommended

Quality Presets {#quality-presets}

Mobile (5% vertices)

• Max 64 vertices per hull

• Max 4 convex hulls

• Aggressive optimization

Standard (10% vertices)

• Max 128 vertices per hull

• Max 8 convex hulls

• Balanced performance

High (20% vertices)

• Max 255 vertices per hull

• Max 16 convex hulls

• Detailed collision

Ultra (50% vertices)

• Max 512 vertices per hull

• Max 32 convex hulls

• Maximum accuracy

Advanced Settings {#advanced-settings}

Convex Decomposition

• Max Hulls: Maximum number of convex pieces (1-64)

• Max Vertices: Vertices per hull (4-1024)

• Voxel Resolution: Accuracy of decomposition (10K-10M)

• Concavity: Maximum allowed concavity (0.0-1.0)

Optimization

• Level: None, Basic, Standard, Aggressive, Extreme

• Merge Threshold: Distance for vertex merging

• Simplify Ratio: Mesh simplification amount

Performance

• GPU Acceleration: Enable CUDA/OpenCL

• Max Threads: CPU threads to use

• Batch Size: Objects per batch

Batch Processing {#batch-processing}

1. Select multiple objects

2. Configure settings

3. Click "Process Selected Objects"

4. Monitor progress in the console

Best Practices

• Group similar objects

• Use consistent quality settings

• Process in batches of 50-100

• Enable GPU acceleration

Export Options {#export}

Unity Export

• Automatic UCX_ prefix

• Correct axis orientation

• FBX format with metadata

• Manifest file included

Unreal Export

• Standard UCX_ naming

• Unreal axis system

• Optimized FBX settings

• Collision groups preserved

Export Settings

• Selected Only: Export selection

• Visible Only: Skip hidden objects

• Include Original: Export source mesh

Troubleshooting {#troubleshooting}

Common Issues

"No mesh objects selected"

• Ensure you've selected a mesh object

• Convert curves/text to mesh first

"Mesh has too few vertices"

• Minimum 4 vertices required

• Check for corrupted geometry

"Non-manifold edges detected"

• Warning only, generation continues

• Use Mesh → Clean Up → Merge by Distance

Generation seems slow

• Enable GPU acceleration

• Reduce voxel resolution

• Use lower quality preset

Performance Tips

1. Close unnecessary applications

2. Enable GPU acceleration

3. Use appropriate quality presets

4. Process large batches overnight

API Reference {#api}

Python API

python

import bpy

# Access SKAVA settings

settings = bpy.context.scene.skava_collision_settings

# Set parameters

settings.collision_type = 'CONVEX'

settings.max_hulls = 16

settings.quality_preset = 'HIGH'

# Generate collision

bpy.ops.skava.generate_collision()

# Batch process

bpy.ops.skava.batch_generate()

Custom Integration

python

# Get AI recommendations

bpy.ops.skava.analyze_mesh()

# Export for Unity

settings.target_engine = 'UNITY'