Search Unity

  1. Check out the Unite LA keynote for updates on the Visual Effect Editor, the FPS Sample, ECS, Unity for Film and more! Watch it now!
    Dismiss Notice
  2. The Unity Pro & Visual Studio Professional Bundle gives you the tools you need to develop faster & collaborate more efficiently. Learn more.
    Dismiss Notice
  3. Improved Prefab workflow (includes Nested Prefabs!), 2D isometric Tilemap and more! Get the 2018.3 Beta now.
    Dismiss Notice
  4. Improve your Unity skills with a certified instructor in a private, interactive classroom. Watch the overview now.
    Dismiss Notice
  5. Want to see the most recent patch releases? Take a peek at the patch release page.
    Dismiss Notice

[Release] Legacy Particle System Updater

Discussion in 'Particle System Previews' started by richardkettlewell, Jan 2, 2018.

Thread Status:
Not open for further replies.
  1. richardkettlewell


    Unity Technologies

    Sep 9, 2015
    We are releasing a tool that can be used to convert Legacy Particle Systems into new Particle System Components.

    GameObjects using ParticleEmitter, ParticleAnimator, and ParticleRenderer, can use this tool to convert to using ParticleSystem and ParticleSystemRenderer Components.

    Unfortunately, scripts cannot be updated automatically.

    This tool is being offered because the Legacy Particle System is scheduled to be removed from Unity in the 2018 release cycle. 2018.1 begins this removal by removing all script API functionality.

    To use the conversion script, simply download it and place it in your project folder inside of a folder called Editor. Next, launch the Editor, open your project, and select Assets/Upgrade Legacy Particles from the Menu. From there, you are presented with some simple options about how to proceed with the conversion.

    The tool is currently a prototype - your feedback and improvements are encouraged and welcomed, in order to make it more robust. You are welcome to make modifications/fixes yourselves, and submit them to be included in the final version. We have very few example Legacy Particle Systems, and most of what we do have are contrived examples, not real world content, meaning that the tool has only had limited testing up to this point. Please use the feedback thread to let us know about any issues.

    Important version Info

    Due to the ongoing removal of Legacy Particles throughout recent Unity versions, the tool is not usable in all recent versions:

    2017.4 and earlier: will work fully
    2018.1: if your project has any scripts using Legacy Particles, they will fail to compile and the tool will be unusable.
    2018.2: is the same at 2018.1
    2018.3: wont work at all - Legacy Particles have been removed from this version.

    Therefore, use the tool with Unity 2017.4 or older, unless you have no scripts using Legacy Particles, in which case 2018.1 and 2018.2 cannot use the tool.

    Alternatively, manually fix the scripts first, and then 2018.1 and 2018.2 may use the tool.


    • Initial release
    • Fixed incorrect billboard mode
    • Added Undo support
    • Fixed emission using Min and Max state when Min and Max values were the same.
    • Fixed emission when using one shot, should be Burst.
    • Added support for sizeGrow.
    • Fixed incorrect shape when Ellipsoid emitter is (0,0,0).
    • Fixed emitterVelocityScale being used incorrectly. It should be inherit velocity.
    • Fixed velocity dampening. We need to apply this to the velocity curve.
    • Set duration to be max lifetime.
    • Fixed particles using transform scale. Legacy did not support this.
    • Fixed size grow. grow is not linear, we also did not handle min and max times.
    • Fixed compilation issues on 2017.1
    • Warning added for Unity version 2018.3 and newer. Legacy particles will be removed in 2018.3.
    • Fixed incorrect version detection and information in help message

    Attached Files:

    Last edited: Aug 20, 2018
    dyupa, AntonioModer, drawcode and 9 others like this.
Thread Status:
Not open for further replies.