Godot粒子系统高级优化：GPU加速、子发射器、着色器与性能优化脚本

切勿使用 amount_ratio 来动态优化性能 —— 它不会节省 GPU 内存或改善处理；完整的 amount 仍然会被分配。请直接更改 amount 属性。
切勿在桌面平台上对性能关键的特效使用 CPUParticles2D —— 除非目标是无 GPU 支持的低端移动设备，否则请使用 GPUParticles。但是，如果你在 2D 中需要物理插值来实现运动物体上的平滑轨迹，请使用 CPUParticles2D。
切勿将 preprocess 设置为极高的值 —— 高值（例如 60 秒）会强制 GPU 在单个渲染帧中模拟数千帧，可能导致 GPU 立即崩溃。
切勿对大型系统不配置 visibility_aabb —— 错误的 AABB 会导致视锥体剔除错误（粒子突然消失）并破坏 LOD 计算。请使用编辑器工具栏生成 AABB。
切勿在移动端/Web 端未经测试就启用湍流 —— 每个粒子进行 3D 噪声评估的计算量极大。在低端平台上通过功能标签禁用它。
切勿忘记对一次性粒子使用 queue_free() —— 使用 finished 信号而不是任意的 Timer 来进行安全的生命周期管理。
切勿对轨迹使用 local_coords = true —— 抛射物留下的烟雾或火焰必须使用全局空间（local_coords = false），否则轨迹会像一根僵硬的棍子一样跟随抛射物。
切勿期望 GPUParticles2D 在 Godot 4.3 中能正确插值 —— 当父级为物理体时，它们会卡顿。对于高速 2D 运动，请使用 fract_delta = true 的 CPUParticles2D。
切勿在 finished 信号后立即触发 emitting = true —— 异步 GPU 状态延迟可能导致重启失败。请改用 restart() 方法。
切勿尝试使用子发射器进行递归 —— 粒子系统不能作为自己的子发射器；这会静默失败。
切勿忘记颜色渐变中的 alpha 值 —— 在生命周期结束时立即消失的粒子看起来很生硬；始终在 1.0 处添加一个 alpha 为 0.0 的渐变点，以实现平滑退出。
切勿对体积爆炸使用 EMISSION_SHAPE_POINT —— 在单个点生成所有粒子看起来很扁平。使用球体或盒子形状来实现自然的 3D 扩散。
切勿忘记为一次性视觉特效初始设置 emitting = false —— 这可以防止在你通过脚本定位节点之前，在场景原点处产生不需要的发射。

# 添加 GPUParticles2D 节点
# 设置数量: 32
# 设置生命周期: 1.0
# 设置一次性: true (用于爆炸)

# 创建 ParticleProcessMaterial
var material := ParticleProcessMaterial.new()

# 发射形状
material.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_SPHERE
material.emission_sphere_radius = 10.0

# 重力
material.gravity = Vector3(0, 98, 0)

# 速度
material.initial_velocity_min = 50.0
material.initial_velocity_max = 100.0

# 颜色
material.color = Color.ORANGE_RED

# 应用到 godot-particles
$GPUParticles2D.process_material = material

extends GPUParticles2D

func _ready() -> void:
    one_shot = true
    amount = 64
    lifetime = 0.8
    explosiveness = 0.9
    
    var mat := ParticleProcessMaterial.new()
    mat.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_SPHERE
    mat.emission_sphere_radius = 5.0
    mat.initial_velocity_min = 100.0
    mat.initial_velocity_max = 200.0
    mat.gravity = Vector3(0, 200, 0)
    mat.scale_min = 0.5
    mat.scale_max = 1.5
    
    process_material = mat
    emitting = true

extends GPUParticles2D

func _ready() -> void:
    amount = 16
    lifetime = 2.0
    
    var mat := ParticleProcessMaterial.new()
    mat.direction = Vector3(0, -1, 0)
    mat.initial_velocity_min = 20.0
    mat.initial_velocity_max = 40.0
    mat.scale_min = 0.5
    mat.scale_max = 1.0
    mat.color = Color(0.5, 0.5, 0.5, 0.5)
    
    process_material = mat

var mat := ParticleProcessMaterial.new()
mat.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_BOX
mat.emission_box_extents = Vector3(100, 100, 0)
mat.gravity = Vector3.ZERO
mat.angular_velocity_min = -180
mat.angular_velocity_max = 180
mat.scale_min = 0.1
mat.scale_max = 0.5

# 使用星星纹理
$GPUParticles2D.texture = load("res://textures/star.png")
$GPUParticles2D.process_material = mat

# player.gd
const EXPLOSION_EFFECT := preload("res://effects/explosion.tscn")

func die() -> void:
    var explosion := EXPLOSION_EFFECT.instantiate()
    get_parent().add_child(explosion)
    explosion.global_position = global_position
    explosion.emitting = true
    queue_free()

extends GPUParticles3D

func _ready() -> void:
    amount = 100
    lifetime = 3.0
    
    var mat := ParticleProcessMaterial.new()
    mat.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_BOX
    mat.emission_box_extents = Vector3(10, 0.1, 10)
    mat.direction = Vector3.UP
    mat.initial_velocity_min = 2.0
    mat.initial_velocity_max = 5.0
    mat.gravity = Vector3(0, -9.8, 0)
    
    process_material = mat

var mat := ParticleProcessMaterial.new()

# 创建渐变
var gradient := Gradient.new()
gradient.add_point(0.0, Color.YELLOW)
gradient.add_point(0.5, Color.ORANGE)
gradient.add_point(1.0, Color(0.5, 0.0, 0.0, 0.0))  # 淡出到透明红色

var gradient_texture := GradientTexture1D.new()
gradient_texture.gradient = gradient

mat.color_ramp = gradient_texture

# 生成 godot-particles 的粒子（烟花）
$ParentParticles.sub_emitter = $ChildParticles.get_path()
$ParentParticles.sub_emitter_mode = GPUParticles2D.SUB_EMITTER_AT_END

1. 使用纹理作为形状

# 为 godot-particles 添加纹理
$GPUParticles2D.texture = load("res://textures/particle.png")

2. 生命周期管理

# 自动删除一次性 godot-particles
if one_shot:
    await get_tree().create_timer(lifetime).timeout
    queue_free()

# 为移动端减少数量
if OS.get_name() == "Android":
    amount = amount / 2

主技能：godot-master

2026 年 2 月 10 日

🇺🇸English

Particle Systems

GPU-accelerated rendering, material-based configuration, and sub-emitters define performant VFX.

Available Scripts

vfx_shader_manager.gd

Expert custom shader integration for advanced particle VFX.

particle_burst_emitter.gd

One-shot particle bursts with auto-cleanup - essential for VFX systems.

custom_particle_logic.gdshader

Expert procedural particle movement logic. Demonstrates persistent CUSTOM data and USERDATA injection for dynamic wind/orbit effects.

sub_emitter_impact.gdshader

High-performance collision handling. Triggers sub-emitters (splashes/debris) using emit_subparticle() and COLLISION_NORMAL.

particle_attractor_opt.gd

Optimization pattern using cull_mask to isolate particle-attractor interactions, preventing global performance bottlenecks.

massive_swarm_multimesh.gd

Bypassing GPUParticles for millions of entities (fish, insects). Uses set_buffer_interpolated() for jitter-free high-count movement.

dynamic_userdata_modulation.gd

Clean architectual pattern for passing runtime variables to particle shaders via USERDATA to preserve GPU batching.

local_vs_global_coords.gd

Expert logic for switching between localized (Auras) and global (Trails) space. Includes correct restart() handling for teleports.

smart_oneshot_recycler.gd

Robust lifecycle management using the finished signal and restart() to avoid async emission failures.

screenspace_weather_heightfield.gd

Optimizing global weather (Rain/Snow) using Camera-snapped GPUParticlesCollisionHeightField3D.

particle_lod_manager.gd

Hierarchical LOD for environmental VFX. Uses visibility_range and margins to cull distant torches or fires completely.

2d_physics_interpolation_fix.gd

Expert workaround for 2D particle stuttering. Switches to CPUParticles2D with fract_delta for smooth physics-parented movement.

NEVER Do in Particle Systems

NEVER useamount_ratio to optimize performance dynamically — It does not save GPU memory or improve processing; the full amount is still allocated. Change the amount property directly instead.
NEVER use CPUParticles2D for performance-critical effects on Desktop — Use GPUParticles unless targeting low-end mobile with no GPU support. However, use CPUParticles2D if you need Physics Interpolation for smooth trails on moving bodies in 2D.
NEVER setpreprocess to extremely high values — High values (e.g., 60s) will force the GPU to simulate thousands of frames in a single render tick, potentially causing an immediate GPU crash.
NEVER leavevisibility_aabb unconfigured for large systems — Incorrect AABBs cause frustum culling errors (particles popping out) and break LOD calculations. Generate AABBs using the editor toolbar.
NEVER enable turbulence on Mobile/Web without testing — 3D noise evaluation per particle is extremely heavy. Disable via Feature Tags on lower-end platforms.
NEVER forget toqueue_free() one-shot particles — Use the signal instead of an arbitrary Timer for safe lifecycle management.

Basic Setup

# Add GPUParticles2D node
# Set Amount: 32
# Set Lifetime: 1.0
# Set One Shot: true (for explosions)

Particle Material

# Create ParticleProcessMaterial
var material := ParticleProcessMaterial.new()

# Emission shape
material.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_SPHERE
material.emission_sphere_radius = 10.0

# Gravity
material.gravity = Vector3(0, 98, 0)

# Velocity
material.initial_velocity_min = 50.0
material.initial_velocity_max = 100.0

# Color
material.color = Color.ORANGE_RED

# Apply to godot-particles
$GPUParticles2D.process_material = material

Common Effects

Explosion

extends GPUParticles2D

func _ready() -> void:
    one_shot = true
    amount = 64
    lifetime = 0.8
    explosiveness = 0.9
    
    var mat := ParticleProcessMaterial.new()
    mat.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_SPHERE
    mat.emission_sphere_radius = 5.0
    mat.initial_velocity_min = 100.0
    mat.initial_velocity_max = 200.0
    mat.gravity = Vector3(0, 200, 0)
    mat.scale_min = 0.5
    mat.scale_max = 1.5
    
    process_material = mat
    emitting = true

Smoke Trail

extends GPUParticles2D

func _ready() -> void:
    amount = 16
    lifetime = 2.0
    
    var mat := ParticleProcessMaterial.new()
    mat.direction = Vector3(0, -1, 0)
    mat.initial_velocity_min = 20.0
    mat.initial_velocity_max = 40.0
    mat.scale_min = 0.5
    mat.scale_max = 1.0
    mat.color = Color(0.5, 0.5, 0.5, 0.5)
    
    process_material = mat

Sparkles/Stars

var mat := ParticleProcessMaterial.new()
mat.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_BOX
mat.emission_box_extents = Vector3(100, 100, 0)
mat.gravity = Vector3.ZERO
mat.angular_velocity_min = -180
mat.angular_velocity_max = 180
mat.scale_min = 0.1
mat.scale_max = 0.5

# Use star texture
$GPUParticles2D.texture = load("res://textures/star.png")
$GPUParticles2D.process_material = mat

Spawn Particles on Demand

# player.gd
const EXPLOSION_EFFECT := preload("res://effects/explosion.tscn")

func die() -> void:
    var explosion := EXPLOSION_EFFECT.instantiate()
    get_parent().add_child(explosion)
    explosion.global_position = global_position
    explosion.emitting = true
    queue_free()

3D Particles

extends GPUParticles3D

func _ready() -> void:
    amount = 100
    lifetime = 3.0
    
    var mat := ParticleProcessMaterial.new()
    mat.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_BOX
    mat.emission_box_extents = Vector3(10, 0.1, 10)
    mat.direction = Vector3.UP
    mat.initial_velocity_min = 2.0
    mat.initial_velocity_max = 5.0
    mat.gravity = Vector3(0, -9.8, 0)
    
    process_material = mat

Color Gradients

var mat := ParticleProcessMaterial.new()

# Create gradient
var gradient := Gradient.new()
gradient.add_point(0.0, Color.YELLOW)
gradient.add_point(0.5, Color.ORANGE)
gradient.add_point(1.0, Color(0.5, 0.0, 0.0, 0.0))  # Fade to transparent red

var gradient_texture := GradientTexture1D.new()
gradient_texture.gradient = gradient

mat.color_ramp = gradient_texture

Sub-Emitters

# Particles that spawn godot-particles (fireworks)
$ParentParticles.sub_emitter = $ChildParticles.get_path()
$ParentParticles.sub_emitter_mode = GPUParticles2D.SUB_EMITTER_AT_END

Best Practices

1. Use Texture for Shapes

# Add texture to godot-particles
$GPUParticles2D.texture = load("res://textures/particle.png")

2. Lifetime Management

# Auto-delete one-shot godot-particles
if one_shot:
    await get_tree().create_timer(lifetime).timeout
    queue_free()

3. Performance

# Reduce amount for mobile
if OS.get_name() == "Android":
    amount = amount / 2

Reference

Godot Docs: Particles

Master Skill: godot-master

Weekly Installs

105

Repository

thedivergentai/…c-skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli104

opencode103

codex103

github-copilot100

kimi-cli99

amp99

ESLint迁移到Oxlint完整指南：JavaScript/TypeScript项目性能优化工具

1,600 周安装

NEVER uselocal_coords = true for trails — Smoke or fire left behind by a projectile MUST use global space (local_coords = false) or the trail will follow the projectile like a stiff stick.

NEVER expect GPUParticles2D to interpolate correctly in Godot 4.3 — They stutter when parented to physics bodies. Use CPUParticles2D with fract_delta = true for high-speed 2D movement.

NEVER triggeremitting = true immediately after a finished signal — Async GPU state delays can cause the restart to fail. Use the restart() method instead.

NEVER attempt recursion with sub-emitters — A particle system cannot be its own sub-emitter; it will silently fail.

NEVER forget alpha in color gradients — Particles that disappear instantly at the end of their lifetime look harsh; always add a gradient point at 1.0 with 0.0 alpha for a smooth exit.

NEVER useEMISSION_SHAPE_POINT for volumentric explosions — Spawning all particles at a single point looks flat. Use a Sphere or Box shape for natural 3D spread.

NEVER forget to setemitting = false initially for one-shot VFX — This prevents unwanted emission at the scene origin before you've had a chance to position the node via script.

Godot粒子系统高级优化：GPU加速、子发射器、着色器与性能优化脚本

🇨🇳中文介绍

粒子系统

可用脚本

相关 Skills

粒子系统中切勿做的事项

基本设置

粒子材质

常见特效

爆炸

烟雾轨迹

闪光/星星

按需生成粒子

3D 粒子

颜色渐变

子发射器

最佳实践