Skip to content
Qwinkle's Particles 2

FAQ & Troubleshooting

The walkthrough and Particiliary explain how each part of the plugin works. The Hidden Depths chapters cover the patterns that combine those parts into elaborate effects. The From Script chapters cover the runtime API. This section is for the moments where something isn’t working as expected, or where a question keeps coming up that doesn’t fit cleanly into any of the per-feature chapters.

Each chapter here is organised around a question, not a feature. Read them when you have the question; ignore them when you don’t.

Available chapters

Section titled “Available chapters”
  • Emitter not emitting — a checklist for when an emitter isn’t producing particles. The most common causes, in rough order of frequency: forgotten Enabled toggle, missing PrimaryPart for Model, missing Attachment0 / Attachment1 for Beam, empty Render Template for Attachment, bare :Enable while Enabled is false, forgotten :Activate() in script-driven projects.
  • Performance — when the plugin is causing frame-rate problems, what to check. Particle count budgets, the cost of Model subtree cloning per emit, the per-frame :ScaleTo() cost on big Models, the GraphBlender per-frame allocation, the PointLight 8–16 limit, mesh particles vs Block particles cost, and how to scale effects for low-end vs high-end devices.
  • Type differences — same-name-different-shape (polymorphism) gotchas. Brightness is a graph on Part/Beam/PointLight but a single number on Trail and native ParticleEmitter. Speed is a graph on transformed types but a range on native PE. Lifetime is a range on Part/Beam/PointLight but a single number on Trail. Quick lookup table.

What’s not here

Section titled “What’s not here”

A few things this section deliberately doesn’t cover, because they live elsewhere:

  • How a specific property works — that’s the type’s chapter in the Particiliary, not the FAQ.
  • How to author a specific effect — that’s the Hidden Depths chapters and the per-type Particiliary chapters.
  • API reference for Particle:Emit() etc. — that’s the From Script section.
  • What the bulk-edit tools do — that’s the Toolbench section.

The FAQ is for the cross-cutting questions that don’t have a natural home in the per-feature chapters.

What’s next

Section titled “What’s next”

Emitter not emitting is the most-frequently-needed troubleshooting page. It walks through the diagnostic checklist for the “I clicked Enabled and nothing happened” case.