The PopcornFX plugin provides Editor and Runtime settings. Settings can be changed by selecting the PopcornFX menu in the top toolbar of UE4 Editor.
Note: settings might change between PopcornFX UE4 plugin versions
Editor settings are only used within UE4 Editor, they are ignored in cooked builds.
Source PopcornFX Project path: Path to the folder containing PopcornProject.pkproj. This path can be absolute or relative (to the UE4 project’s root folder). It is best practice to keep the path relative, so everyone in a team can benefit from auto-reimport features when editing source effects, properly reimport effects, …
In this example, a PopcornFX project is contained at the root of the UE4 project, in an Assets/UE4ContentExamples directory. It is possible to use shortcuts if the source project is contained elsewhere.
Other properties like IsValid are read-only, and only help determine if the path is correct (the checkbox is left unchecked if the project wasn’t found).
Add Source Pack to Monitored Directories: If enabled, enables auto-reimport (hot reload) of effects when they are saved in outside UE4 (i.e. PopcornFX Editor). It is required to have a valid Source PopcornFX Project path. Auto-reimport behavior can be tweaked in
UE4 Editor Preferences > Loading & Saving > Auto Reimport.
Asset Dependencies Auto Import: enum describing how effect dependencies (Textures, Meshes, ..) should be imported when an effect is imported. By default, importing an effect will automatically import all associated resources, following the same folder hierarchy as in the source PopcornFX project.
Debug Baked Effects: Advanced, helps debugging baked effects during cook.
Auto Insert Scene Actor: if true, whenever an effect is drag & dropped from UE4 content browser into a level, if there is no PopcornFXSceneActor present in the level, a new one will be created. This can be disabled in some configurations where the PopcornFXSceneActor is contained in a master level, while effects are currently being imported in a sub-level, and not having a scene actor is expected.
Always Render Attribute Sampler Shapes: when enabled, will always draw PopcornFX attribute sampler shape components in UE4 viewport.
Runtime settings are both used within UE4 Editor and in cooked builds.
Pack Mount Point: root of all PopcornFX assets within the UE4 project (the default is /Game/, UE4’s Content/ folder). If all PopcornFX assets should be nested in a sub folder of Content/, Pack Mount Point needs to be changed accordingly. It is not allowed for an effect to load external resources (i.e. Meshes, Textures used for sampling) outside of this mount point.
Global Scale: legacy from PopcornFX v1 and should not be used, it represents how PopcornFX unit-related properties should be scaled (PopcornFX has units in meters).
PopcornFX C++ SDK and UE4 plugin extensively use asserts in Debug configurations (although some asserts can appear in release) to report coding errors, unexpected behaviors, which are displayed using a window. If Enable Asserts is disabled, all asserts will be ignored and just printed out in the Output Log window.
Those are the default values for the plugin’s simulation settings, and can be overridden per PopcornFXSceneActor.
Enable Physical Materials: legacy from PopcornFX v1 and hasn’t been ported to v2 yet. This options controlled whether or not to fetch UE4’s Physical Material properties (ie. Friction) affecting PopcornFX particle collisions behavior.
Localized Pages Mode: advanced, controls the pages localization behavior in PopcornFX runtime.
Scene Update Tick Group: advanced, controls when in the frame PopcornFXSceneActor should be ticked. Modifying this can heavily affect performance as it modifies CPU frames layout.
Those are the default values for the plugin’s rendering settings, and can be overridden per PopcornFXSceneActor.
Draw Call Sort Method: advanced, controls how PopcornFX draw calls are emitted.
Billboarding Location: advanced, controls how PopcornFX draw calls are built.
Enable Early Frame Release: advanced, controls the policy for PopcornFX collected frames.
Disable Stateless Collecting: advanced, controls how PopcornFX render batches are held.
Force Lights Lit Translucent: if true, all PopcornFX light particles will light translucent geometry.
List of default base UE4 materials used for imported effects. When an effect is imported, all renderers will be assigned a material instance, created from those default materials. Materials are selected based on the rendering features activated on the renderer in the source effect. This list can be modified if the production needs different default materials, materials can also be overriden per effect.
These budgets are for now only used by the viewport profiler, and helps color effect stats based on predefined budgets. If an effect stat is out of budget, its color will tend towards red.
Debug Bounds Lines Thickness: Lines thickness for drawn bboxes when a PopcornFXSceneActor’s HeavyDebugMode is Page or Medium BBox.
Debug Particle Point Size: Point size for drawn points when a PopcornFXSceneActor’s HeavyDebugMode is “Particle Points”.
Effects Profiler Sort Mode: Sort method for profiler display (sort by sim cost, particle count, ..).
HUD Display Screen Ratio: Screen ratio for profiler display.
HUD Hide Nodes Below Percent: All effects with “CPU%” below this value will not be displayed. This helps identifying out of budget effects easily.
HUD Update Time Frame Count: Number of frames used for averaging timings.