# Particle Effects - Dubai Metaverse

## Overview

This document catalogs all particle effects for the Dubai Metaverse project.

## Particle Systems

### P_Dust

**Purpose**: Ambient dust particles in the air

#### Properties

- **Type**: GPU Particles
- **Spawn Rate**: Low to medium
- **Lifetime**: Long (10-30 seconds)
- **Size**: Small (0.1-0.5 units)
- **Color**: Beige/brown (dust color)
- **Movement**: Slow drift, wind-affected

#### Implementation

1. **Emitter Setup**:
   - Spawn rate: 5-10 particles/second
   - Lifetime: 15-25 seconds
   - Initial velocity: Low, random

2. **Visual**:
   - Texture: Dust particle texture
   - Size: Small, random variation
   - Color: Beige/brown, slight variation
   - Opacity: Low (0.3-0.5)

3. **Behavior**:
   - Wind-affected
   - Gravity: Slight downward
   - Collision: None (or ground collision)

#### Placement

- **Areas**: Open areas, roads, construction sites
- **Density**: Low to medium
- **Distance**: Visible at medium distance

---

### P_HeatDistortion

**Purpose**: Heat distortion effect above hot surfaces

#### Properties

- **Type**: Post-process or material effect
- **Intensity**: Subtle
- **Distance**: Above hot surfaces (roads, buildings)
- **Falloff**: Distance-based

#### Implementation

1. **Material Function**:
   - Create material function
   - Use distortion node
   - Apply to surfaces or post-process

2. **Settings**:
   - Distortion intensity: 0.1-0.3
   - Distance falloff: Exponential
   - Affected by time of day (stronger during day)

#### Placement

- **Surfaces**: Roads, building roofs, hot surfaces
- **Time**: Stronger during day, weaker at night

---

### P_SandBlowing

**Purpose**: Sand particles blowing in wind

#### Properties

- **Type**: GPU Particles
- **Spawn Rate**: Medium
- **Lifetime**: Short (3-10 seconds)
- **Size**: Small to medium (0.2-1.0 units)
- **Color**: Sand color (beige/tan)
- **Movement**: Fast, wind-affected

#### Implementation

1. **Emitter Setup**:
   - Spawn rate: 10-20 particles/second
   - Lifetime: 5-8 seconds
   - Initial velocity: High, wind direction

2. **Visual**:
   - Texture: Sand particle texture
   - Size: Small to medium
   - Color: Sand color
   - Opacity: Medium (0.5-0.7)

3. **Behavior**:
   - Strong wind effect
   - Gravity: Downward
   - Collision: Ground collision

#### Placement

- **Areas**: Desert areas, open spaces, windy areas
- **Conditions**: Windy conditions, sandstorms (optional)

---

### P_Fountain

**Purpose**: Water fountain particle effects

#### Properties

- **Type**: GPU Particles
- **Spawn Rate**: High
- **Lifetime**: Short (1-3 seconds)
- **Size**: Small to medium (0.1-0.8 units)
- **Color**: Water color (white/blue)
- **Movement**: Upward spray, gravity-affected

#### Implementation

1. **Emitter Setup**:
   - Spawn rate: 50-100 particles/second
   - Lifetime: 1-2 seconds
   - Initial velocity: Upward, high

2. **Visual**:
   - Texture: Water droplet texture
   - Size: Small, random variation
   - Color: White/light blue
   - Opacity: High (0.7-1.0)

3. **Behavior**:
   - Gravity: Strong downward
   - Collision: Ground/water collision
   - Splash: Splash effect on impact

#### Placement

- **Locations**: Fountains, water features
- **Density**: High near fountain, lower at distance

---

## Particle System Organization

### Folder Structure

```
Content/Assets/FX/
├── P_Dust.uasset
├── P_HeatDistortion.uasset
├── P_SandBlowing.uasset
├── P_Fountain.uasset
└── Textures/
    ├── T_Dust_Particle
    ├── T_Sand_Particle
    └── T_Water_Droplet
```

### Naming Convention

- **Format**: `P_EffectName_Type`
- **Examples**: 
  - `P_Dust_Ambient`
  - `P_Fountain_Water`

---

## Performance Optimization

### Particle Optimization

1. **Spawn Rate**: Optimize spawn rates
2. **Lifetime**: Optimize particle lifetime
3. **LODs**: Use LODs for particles
4. **Culling**: Cull particles outside view

### GPU Particles

- **Use GPU Particles**: For better performance
- **Limit Count**: Limit particle count
- **Optimize Shaders**: Optimize particle shaders

---

## Integration

### With Lighting

- **Lighting**: Particles respond to lighting
- **Shadows**: Particles cast/receive shadows (optional)
- **Time of Day**: Particle appearance changes with time

### With Weather

- **Wind**: Particles affected by wind
- **Weather Conditions**: Particle intensity varies with weather

### With Audio

- **Audio Cues**: Trigger audio with particles (optional)
- **Synchronization**: Sync particles with audio

---

## Testing

### Visual Testing

1. **Appearance**: Verify particles look correct
2. **Behavior**: Verify particle behavior is realistic
3. **Performance**: Test performance with particles

### Performance Testing

1. **Frame Rate**: Test frame rate impact
2. **Memory**: Test memory usage
3. **Optimization**: Test optimization settings

---

## Troubleshooting

### Common Issues

**Issue**: Particles not spawning
- **Solution**: Check spawn rate settings
- **Solution**: Verify emitter is active

**Issue**: Particles too bright/dark
- **Solution**: Adjust color and opacity
- **Solution**: Check lighting settings

**Issue**: Performance issues
- **Solution**: Reduce spawn rate
- **Solution**: Use LODs
- **Solution**: Optimize particle shaders

---

## Best Practices

### Particle Design

1. **Subtlety**: Keep effects subtle and realistic
2. **Performance**: Balance quality and performance
3. **Variation**: Add variation for natural look
4. **Integration**: Integrate with other systems

### Workflow

1. **Prototype**: Prototype effects quickly
2. **Iterate**: Iterate based on feedback
3. **Optimize**: Optimize for performance
4. **Document**: Document particle settings

---

**Version**: 1.0
**Last Updated**: [Current Date]