Skip to content

Release Notes

Ryan Guy edited this page Dec 3, 2021 · 73 revisions
Clone this wiki locally

Stable Releases

  • version 1.2.1 (Dec 03 2021)
    • This version is a hotfix that mainly improves compatibility with older MacOS versions.
    • MacOS Compatibility: Improved support for older OS versions that are no longer receiving service updates from Apple.
      • This mainly affects MacOS 10.13 (High Sierra) and earlier that were experiencing an Unable to load fluid engine library error.
      • If you are continuing to experience this error, please contact us.
    • Bug Fix: Issue where the fluid surface mesh would be generated incorrectly if the Meshing Against Obstacles option was disabled (issue #567).
    • UI: Corrected attribute name listed in Generate Source Color Attributes option tooltip.
  • version 1.2.0 (Nov 25 2021)
    • Blender 3.0 Compatibility: FLIP Fluids version 1.2.0 adds official compatibility support for Blender 3.0.
      • Do not use older versions of the FLIP Fluids addon with Blender 3.0 as you may encounter severe compatibility issues.
      • Blend File Compatibility: .blend files created in Blender 2.93 using FLIP Fluids 1.1.0 should be compatible in Blender 3.0 using FLIP Fluids 1.2.0.
      • Forward compatibility support for Blender 3.0:
        • If a .blend file is saved in Blender 3.0 and then opened in an earlier version of Blender 2.8x or 2.9x, the addon will automatically update the .blend file so that FLIP Fluid objects are compatible and function correctly.
        • We still recommend keeping Blender 3.0 .blend files and earlier versions in separate saves. Blender will warn that you may still experience data loss in the .blend file in areas/features outside of the FLIP Fluids addon.
    • Blender 3.1 Compatibility: Not officially supported.
      • Added preliminary support for Blender 3.1 which is set to release on March 9, 2022.
      • Compatibility may break as Blender 3.1 is developed. Issues related to Blender 3.1 compatibility can be reported and tracked in this thread: issue #560.
    • MacOS Compatibility: Added potential fixes to a rare issue where the FLIP Fluids Engine was not supported on older MacOS versions. If you are experiencing any compatibility issues on any MacOS version 2014 or later, please let us know.
    • Added: Functionality to preserve any UV Map Layers or Vertex Color Layers on the fluid mesh data (issue #561).
      • Note: as the fluid meshes have dynamic topology, the values in the layers will not be transferred to the next frame. The layers will contain default data and should only be used procedurally.
    • Added: Alternate surface tension solving method:
      • Regular: Choose for general purpose surface tension effects. This option is the default and is the same method used in previous versions.
      • Smooth: Choose for improved stability, smoother results, and improved cohesion in small-scale effects. Good for thin streams/strands of liquid and for high surface tension effects. Not recommended for highly chaotic fluid motion or large volumes of liquid as this can result in volume increase issues.
    • Added: Report a Bug (GitHub) operator to the FLIP Fluid Preferences menu.
      • This operator will open the GitHub issue tracker and pre-fill the form with your system and version information.
      • Not all information may be found out depending on system and Blender version.
      • A GitHub account is required to post on the issue tracker.
      • This operator can also be found in the Blender > Help > FLIP Fluids menu.
    • Added: Copy System Information operator to the FLIP Fluid Preferences menu.
      • This operator will copy your system and version information to the clipboard.
      • Paste this info when sending us a message through the Blender Market, support[at]flipfluids.com, or elsewhere.
      • Not all information may be found out depending on system and Blender version.
      • This operator can also be found in the Blender > Help > FLIP Fluids menu.
    • Added: (Experimental Motion Blur Support) Added an example .blend file to the experimental builds package to demonstrate how to use a new Blender 3.0 feature to render true motion blur on the liquid surface (motion_blur_rendering_example.blend).
    • Added: Preset Scenes to the FLIP Fluids addon downloads. These are work-in-progress preset scenes for popular liquid types. More in development!
    • Example Scenes: Example scenes for Blender 2.8+ have had the UI reset for consistency in newer versions of Blender.
    • Example Scenes: surface_tension_pour.blend has been updated to use the new Smooth surface tension solver mode and to correct settings to more closely match the rendered example.
    • Bug Fix: Issue where attribute error would be generated on addon initialization if Cycles addon was not enabled (issue #552).
    • Bug Fix: Issue where IndexError would be generated if surface attributes were enabled, but not yet baked.
    • Bug Fix: Issue where unsupported object types could be set as a FLIP Fluid object (issue #556).
    • Bug Fix: Added workaround to issue where adding a Graph Editor Modifier to FLIP Fluids settings could bypass the property min/max values, generating an error during bake.
      • This manual fix has only been added to certain settings where a user is more likely to add a graph modifier. Settings in the FLIP Fluid World panel, and settings in the Obstacle properties.
      • A workaround for other settings can be to make sure the graph curve stays in the min/max range values.
    • Bug Fix: Issue where objects could be incorrectly simplified into a cuboid (issue #557).
    • Bug Fix: Issue where temporary stat cache files would not be processed and updated upon loading a .blend file (issue #558).
    • Bug Fix: Error message generated if cache directory location was invalid on .blend file load.
    • Bug Fix: Baking crash (Index Out Of Range or EXCEPTION_ACCESS_VIOLATION error) that could be possible when the Remove Mesh Near Domain option is enabled.
    • Bug Fix: Issue where Re-launch Bake After Crash command line bake feature could resume the simulation from an incorrect frame after an error is encountered.
    • Bug Fix: Re-launch Bake After Crash command line bake feature will no longer attempt to re-launch a simulation if a Out of device/disk space error is encountered.
    • Bug Fix: Issue where custom drawing of text in the grid visualization feature could display with inconsistent colors depending on Blender version.
    • Bug Fix: Issue where the option to enable surface tension could be grayed out and not selectable.
    • Bug Fix: Issue where building from source could display a cmake_minimum_required() deprecation warning.
    • Bug Fix: Issue where particles would not be jittered correctly if Jitter Surface Particles option was disabled (issue #564).
    • Bug Fix: UI Issue where color selector could be greyed out if the color attribute domain setting was enabled (issue #565).
    • Bug Fix: (Blender 3.0) Missing Documentation link in the preferences menu is now visible.
    • Bug Fix: (Blender 3.0) Issue where automatic toggling of Cycles visibility options upon FLIP Fluid object creation was not functioning correctly.
    • Bug Fix: (Blender 3.0) Issues related to automatically setting Cycles ray visibility for FLIP Fluid/Inflow/Outflow/Force/Domain objects.
    • Bug Fix: (Blender 3.0) Issues related to immediate baking crashes.
    • Bug Fix: (Blender 3.0) Issues related to immediate render crashes during initialization.
    • Bug Fix: (Blender 3.0) Issues related to incorrect addon and simulation mesh initialization.
    • Bug Fix: (Blender 3.0) Misc. errors during Blender startup.
    • UI: The Beginner Friendly Reminder and tooltip displayed in the Physics panel now adds a note that when this preference is enabled, some settings will be hidden.
    • UI: Various reported typos and formatting in property tooltips (Thanks for the reports!).
    • UI: Tooltips and documentation have been updated to use the term Voxel rather than Grid Cell for consistency.
    • UI: Re-arrangements to the FLIP Fluids Preferences menu.
    • Removed: Deprecated Check For Updates operator.
  • version 1.1.0 (Aug 20 2021)
    • Blender 3.0 Compatibility: Blender 3.0 is still in development and is set to release in October 2021. At the moment, there are no known issues when using Blender 3.0 or the Blender 3.0 Cycles-X branch with this version of the FLIP Fluids addon.
      • Compatibility may break as Blender 3.0 is developed. Issues related to Blender 3.0 compatibility can be reported and tracked in this thread: issue #535.
    • Added support for the Apple Silicon chip.
    • Added functionality to the Automatic Command Line Bake operator (Windows Only):
      • If a simulation error occurs that stops the simulation, the operator will now attempt to automatically re-launch and resume the simulation. Certain errors such as 'Out of Memory' errors can be solved by re-launching a simulation.
      • If Blender crashes, the command line bake will try to detect the crash and attempt to re-launch Blender and the baking process.
      • The max number of re-launch attempts can be set in the FLIP Fluid Preferences menu.
    • Added 'Remove Mesh Near Domain' feature support for the preview mesh.
    • Added operator to FLIP Fluid Cache panel to set the cache location to a directory based on the name of the .blend file.
    • Added +/- operators to the FLIP Fluid Cache panel to increment/decrement a number at the end of a cache directory, similar to the icons when saving a .blend file.
    • Added support for all render output image file types when using the Helper > Generate Batch File operator.
    • Added support for curves that use the Poly spline type when used as a Curve Guided Force Field.
    • Improved support for fracture simulations set as a FLIP Fluid Obstacle where the fracture simulation contains non-manifold geometry.
      • Instead of ignoring the entire mesh when non-manifold geometry is detected, the simulator will only ignore fractured pieces of the mesh that contain non-manifold geometry.
    • Bug Fix: Simulation will no longer stop if a frame statistics temporary file is found to be in use and unable to be deleted (issue #529).
    • Bug Fix: Issue where command line operators may not work if spaces are contained in the Blender executable path, specifically when located in C:/Program Files/.
    • Bug Fix: Fixed inconsistent UI issues (issue #533).
    • Bug Fix: Issue where non-mesh type objects could be selected as a custom whitewater particle object, leading to an error during render.
    • Bug Fix: Re-fixed preview rectangle artifacts issue that was introduced as a side effect by another bug fix (issue #491).
    • Bug Fix: Issue where the whitewater display percentage setting loaded an incorrect amount of whitewater after resuming a simulation. Notes:
      • This was caused by the addon saving incorrect information to the savestates cache.
      • Simulations will need to be re-baked for this fix to take effect.
    • Bug Fix: Fixed a FileNotFoundError when using the FLIP Fluids Helper > Generate Batch File if the render output location was set to a relative path.
    • Bug Fix: fixed issue where Helper > Generate Batch File operator did not support image file prefixes in the render output location.
    • Bug Fix: When baking from the command line and an error is encountered within the simulation, an error message will now be output correctly to the command line window.
    • Bug Fix: The cache directory can no longer be set to a location directly relative to the .blend file (ex: '//').
    • Bug Fix: Fixed issue where liquid could be spawned with triangle line artifacts for cuboid shaped Fluid objects in high resolution simulations.
    • Bug Fix: Crash that could be caused by using undo after activating the Create Domain operator on a selected object.
    • Bug Fix: Fixed incorrect render issue when 'Render > Persistent Data' option is enabled. Note: with this option enabled, rendering can be less stable. It is recommended to render through the command line if enabling this option.
    • Bug Fix: Fixed issue where a curve or empty type object could not be added as a force field object through the helper menu.
    • Bug Fix: (Blender 3.0) TypeError which prevents fluid surface object from being generated upon creation of a domain.
    • Bug Fix: (Blender 3.0) KeyError generated upon starting a simulation.
    • Bug Fix: (Blender 3.0) Immediate crash upon starting a render of a FLIP Fluids addon cache generated in Blender 2.93 or lower.
    • Blender Bug: Added a workaround for issue T87629 to return a 'fake' preferences with default values if the actual preferences cannot be accessed. This workaround is to support activating the FLIP Fluids addon through the command line.
    • Blender Bug: There is an issue that causes render crashes when rendering vertex attributes (T88811). The only known workaround is to render using the command line.
  • version 1.0.9b (Apr 06 2021)
    • FLIP Fluids version 1.0.9b adds many bug fixes, stability improvements, and by popular demand, a new solver feature using the APIC simulation method!
    • Added an APIC solver using the Affine Particle-In-Cell method.
      • The simulation method, FLIP or APIC, can be set in the FLIP Fluid Simulation panel or FLIP Fluid Advanced panel.
      • Choose FLIP for high energy, noisy, and chaotic simulations. Generally better for large scale simulations where noisy splashes are desirable.
      • Choose APIC for high vorticity, swirly, and stable simulations. Generally better for small scale simulations where reduced surface noise is desirable or for viscous simulations.
      • FLIP vs APIC documentation and comparisons
    • Added an Accuracy option to the viscosity solver to control the solver error tolerance.
      • Decrease to speed up baking at the cost of accuracy. Increase to improve accuracy at the cost of baking speed. High viscosity thick or stiff fluids benefit the most from increasing accuracy. Low viscosity thin fluids often work well at a lower accuracy. Setting above a value of 4 may have greatly diminishing returns on improvement.
      • The default value of 4 is the same amount of error tolerance used internally in previous versions.
    • Added an operator to the FLIP Fluid Helper sidebar menu to generate a Windows batch file (.bat) to command line render each frame of an animation one by one.
      • Operator will detect already rendered frames in the output directory and disregard these from the batch file.
      • Upon a render crash, the batch file will start up Blender again and begin rendering the next frame. In this way, you can minimize unrendered frames if your system is prone to render crashes.
      • Can be used outside of the FLIP Fluids addon to render a sequence of frames individually. There are some bugs in Blender which can cause an animation to be rendered incorrectly and a workaround to these issues is to render each frame one by one.
    • Added viewport visibility toggles to the fluid particle, force field, and obstacle debug tools.
    • Added a UI warning and tooltip if the Estimated Surface Tension Substeps info value exceeds the allowed Max Frame Substeps Value (Documentation).
    • Bug Fix: Fixed issue in Blender 2.91+ where rendering fluid meshes with motion blur enabled could result in longer Cycles render times.
      • Note: Motion Blur Rendering of fluid surfaces or whitewater particles is not currently supported (See: Motion Blur Support).
      • This fix will only apply to newly created scenes. To workaround this issue in an existing scene, select a fluid/whitewater object and disable the Object Properties > Motion Blur option (only applies if Cycles is the selected renderer).
    • Bug Fix: Fixed issue where low viscosity streams would have a velocity bias in the positive X/Y/Z direction (issue #455).
    • Bug Fix: Fixed an issue where many particles could become stuck to sharp obstacle edges which could lead to an unstable simulation (issue #508).
    • Bug Fix: Bug where using the inflow Constrain Inflow Velocity option could cause a bulge to form in the lower x/y/z corner of the domain.
    • Bug Fix: Fixed issue where disabling the whitewater feature and resuming a simulation would result in invalid whitewater cache files being generated in the cache directory.
    • Bug Fix: Issue where keyframing a min/max property could overwrite other min/max properties (issue #516).
    • Bug Fix: Issue where the bake operator status could hang on Calculating time remaining....
    • Bug Fix: UI issue where the Resume From Frame X label could be displayed in red text instead of the default white.
    • Bug Fix: UI issue where domain FLIP operator displayed the hide/show viewport/render icons in reverse order compared to regular Blender convention.
    • Bug Fix: UI issue where bake information would not be updated when using the Reset operator if the current cache directory did not exist.
    • Bug Fix: An error that would prevent a helpful error message from being displayed when loading the fluid engine library (Pull Request Here).
    • Bug Fix: Potential fix for render crashes when the Fluid Particle Debugging or Force Field Debugging tools are enabled (issue #521).
    • Bug Fix: Bug where using the FLIP Fluids Helper > Solid/Wireframe operator would deselect Fluid/Inflow/Outflow objects after execution.
    • Bug Fix: Removed deprecated cache operators (Copy/Move/Rename) from being searchable and executable in the F3 operator search menu.
    • Bug Fix: ValueError that could be triggered upon creating a domain if the .blend file was located on a different drive than the Blender installation.
    • Bug Fix: 'TypeError' that could be triggered in Blender 2.93 by pressing the F3 operator search key.
    • Bug Fix: Removed extraneous debugging code that would cause (harmless) error messages in Blender 2.79.
    • Bug Fix: Fixed error messages in Blender 2.79 due to difference in icon names in Blender 2.8+.
    • Example Scene Fix: Fixed volume_force_animated_character.blend example scene issue where the fluid objects would be emitted in the wrong direction. Corrected in the example scenes file as of March 25, 2021.
    • Changed: The FLIP Fluids Helper > Solid/Wireframe operators no longer change the render visibility of the objects. This functionality has been split into a separate row of Show/Hide Render operators that sets the render visibility of all selected objects.
    • Changed: Safety Factor (CFL Number) setting in the FLIP Fluid Advanced panel has moved from the Simulation Stability section to the Frame Substeps section. The Safety Factor option is more closely related to how the simulator calculates adaptive substeps.
    • Blender Support: Updated addon code to be compatible with Python 3.9 for future versions of Blender.
    • Blender Support: At the moment, there are no known compatibility issues between FLIP Fluids and Blender 2.93 Alpha. This may change as development of 2.93 progresses and bugs can be tracked in (issue #519).
    • Improved accuracy of viscosity solver setup.
    • Improved memory handling and storage of fluid particles and attributes.
    • Improved stability and performance.
  • version 1.0.9a (Feb 03 2021)
    • FLIP Fluids version 1.0.9a is a maintenance update to add small improvements and bug fixes reported since the last stable release.
    • MacOS Compatibility notes:
      • Due to a bug in Blender versions 2.80, 2.81, and 2.82, it will no longer be possible for us to support MacOS in these three versions. The FLIP Fluids addon on MacOS will still be supported in Blender 2.79, 2.83+, and 2.9+.
    • Blender 2.92 Alpha support: as of January 5th 2021, the daily Blender builds now support the FLIP Fluids addon. In earlier 2.92 builds, a Python feature that the addon uses was missing.
      • Support may break as Blender 2.92 develops and issues can be tracked here: Issue #507.
    • Added three new example scenes by popular request (Animation previews, Example Scene Descriptions).
    • Added a filesystem protection layer to enforce that all file removal operations are functioning correctly, reducing bugs related to human/development error (Documentation).
    • Added a workaround into the addon for a long-standing Blender bug (T71908) which causes keyframed render settings on the fluid meshes not to be evaluated during render. This workaround fixes:
      • Issues where keyframed settings in the FLIP Fluid Display Settings panel would not take effect during render.
      • Issues where the FLIP Fluids Helper > Override Frame Playback feature would not function during render.
      • Issues where an Ocean Modifier attached to the fluid meshes would not be animated during render.
    • Bug Fix: Addon will no longer allow the FLIP Fluid current cache directory to be set as blank and will be set as a reasonable default value.
    • Bug Fix: FLIP Fluids Helper menu command line tool operators displayed incorrectly on MacOS and Linux (issue #505).
    • Bug Fix: FLIP Fluids Helper menu command line tool Copy to Clipboard operators were not functioning on MacOS and Linux (issue #505).
    • Bug Fix: Fixed potential Out of Memory error that could be triggered if a force field object is located outside of the domain.
    • Bug Fix: Fixed potential issue where the FLIP Fluid surface or whitewater object could lose it's material after reseting a bake.
    • Bug Fix: Fixed issue where inflow particles could be seeded in an unnatural pattern (issue #509).
    • Bug Fix: Incorrect frame used in the simulation for the inflow/fluid object speed value if this value was keyframe animated.
    • Bug Fix: Potential crash if a curve guided force field had endcaps disabled while enabling a minimum distance for the force field.
    • Bug Fix: Issue where exporting an animated curve guided force field could trigger a 'Changing Topology Warning'. Note: it is okay for all current force fields to change topology.
    • Bug Fix: Issue where Remove Particles With Extreme Velocities could generate false-positives for a viscous fluid falling under regular gravity.
    • Bug Fix: Issue where keyframed quaternion or axis-angle rotation was not supported (issue #515).
    • Bug Fix: Issue where the baked debug tools (particle/obstacle/forcefield) would not be updated correctly if the simulation Time Scale value was set to 0.0.
    • Bug Fix: Potential error messages caused by the addon detecting Blender 2.9x versions incorrectly.
    • Bug Fix: Issue where a combination of high resolution and small world scaling could result in the surface preview mesh not generating.
    • New Documentation: Crash Protection Features.
    • New Documentation: Closing Blender while a simulation is running.
    • New Documentation: Addon Installation Troubleshooting.
      • How to verify your FLIP Fluids installation file.
      • How to locate your Blender addons directory.
      • How to verify your FLIP Fluids Blender installation.
      • How to clean up your Blender addons directory in the case of an incorrect installation.
      • How to manually install the FLIP Fluids addon.
  • version 1.0.9 (Nov 26 2020)
    • FLIP Fluids version 1.0.9 is our biggest update yet! This version includes a large new force field feature set as well as many other features, tweaks, and workflow improvements. Thank you to all of the testers who helped us develop this new version!
    • Compatibility notes on older .blend files:
      • FLIP Fluids 1.0.9 is fully compatible with .blend files and caches created in 1.0.8, however some settings have been replaced and updated. If opening an older .blend file, you may want to check the following settings and adjust if necessary:
    • Changes to default behavior:
      • Default value change: Update Settings on Resume in FLIP Fluid Simulation panel is now enabled by default.
      • Default value change: Surface Subdivision in FLIP Fluid Surface panel is now set to 1 by default. Tip: set to 0 (low quality) for quicker iteration when prototying a simulation.
    • Added 4 new force field modes (Documentation):
      • Point Force - A force field that attracts fluid towards a single point.
      • Surface Force - A force field that attracts fluid towards the surface of a mesh.
      • Volume Force - A force field that attracts fluid into the volume of a mesh.
        • Can be used similarly to Blender's older Fluid Control feature that was removed since Blender 2.82.
      • Curve Guide Force - A force field that attracts towards or along a curve, or to spin around a curve.
      • More force field modes are in development! Try our experimental versions here.
    • Added 7 new example scenes to showcase the FLIP Fluids force field feature set, including detailed notes about the simulation setup and settings (Blender 2.82+, 2.9+ only).
    • Added force field debug visualizer to FLIP Fluid Debug panel. See development update #13 for detailed information.
    • Added Force Field Resolution option to FLIP Fluid World panel.
    • Added a README.html file to the Blender Market product downloads that contains info and links for how to get started with the addon.
    • Added a Grid Info section to the FLIP Fluids Simulation panel to display info about the simulation grid including tooltips to help explain the simulation grid.
    • Added feature to upscale a simulation to an increased resolution on resuming the bake (Documentation).
    • Added functionality for Inflow/Fluid objects to emit fluid in the direction of the object's local axis.
    • Added functionality to Skip Re-Export of static and keyframed meshes in addition to skipping animated meshes.
    • Added a Force Re-Export On Next Bake feature for FLIP Fluid simulation objects.
    • Added expanded functionality for skipping/forcing mesh data to be exported in Settings and Mesh Export submenu in FLIP Fluid Simulation panel.
    • Added functionality to link exported geometry data from another cache directory in FLIP Fluid Cache panel (Documentation).
    • Added exponent precision editing for viscosity and surface tension values.
    • Added preferences option to rename the FLIP Fluids Helper menu panel name.
    • Added preferences option to display links to relevant documentation in the UI.
    • Added UI reminder that displays in the physics panel if the preferences Beginner Friendly Mode is activated.
    • Added functionality for Enable Stable Rendering operator to also undo this operation (Blender 2.8+ only).
    • Added prompt/warning to Domain UI to warn that the .blend file has not been saved. Includes operator to open the save file menu.
    • Added features to and organized the FLIP Fluids Helper Menu panels.
      • Added domain bake and cache operators to the FLIP Fluids Helper menu.
      • Added Create Domain operator to FLIP Fluids Helper Menu to generate a domain depending on the context of what type of objects are selected and in your scene.
      • Added operators to FLIP Fluids Helper Menu to select all simulation objects of a certain type (Obstacle/Fluid/Inflow/Outflow/ForceField).
      • Added operators to FLIP Fluids Helper Menu to help organize your simulation objects in the Blender Outliner.
      • Added Override Frame settings to FLIP Fluids Helper Menu that works similar to the setting of the same name in Blender's Alembic Cache modifier.
    • Updated for compatibility with latest version of OctaneRender.
    • Updated addon packaging, distribution, and testing processes to be automated to reduce issues related to human-error.
    • Updated Blender Market product downloads naming conventions to use a more consistent naming format that includes the date that the file was last updated (See FLIP Fluids Downloads).
    • Removed Rigid/Deformable mesh option for Inflow object. The simulator will now automatically detect whether the object is rigid or deformable.
    • Removed Preserve Foam options from FLIP Fluid Whitewater UI. These settings were not working as expected and are no longer needed.
    • Fixed: potential compatibility issues on MacOS systems.
    • Fixed: bug where command line tools would not be displayed for MacOS/Linux operating systems.
    • Fixed: issue where rectangle artifacts could appear in the fluid surface preview mesh (issue #491).
    • Fixed: bug in Blender versions 2.9+ where toggling a FLIP object's render visibility would not update the object visibility in the viewport rendered display.
    • Fixed: error during export that could be triggered by exporting an Empty type object as a fluid/inflow target.
    • Fixed: issue where Empty type objects could be exported to incorrect locations within the simulator.
    • Fixed: issue where the simulation mesh could be loaded into the viewport during animated object export, causing a very slow export process.
    • Fixed: bug that could cause a crash if viscosity feature was enabled while simulating small amounts of fluid.
    • Fixed: bug that could cause a crash if a object contained all vertices outside of the domain.
    • Fixed: issue where changing particle size in the FLIP Fluid Debug particle debugging tool would not affect the draw size.
    • Fixed: issue that was causing inflow object to require too much memory. More info in development update #14.
    • Fixed: issue where Strawberry Splash example scene was not compatible with newer versions of Blender.
    • Fixed: bug where a rare divide-by-zero error could cause the simulation to collapse in on itself.
    • Fixed: issue where a mesh containing a zero-area triangle could cause a crash.
    • Fixed: issue where an Attribute Error could be displayed when selecting the Domain object.
    • Fixed: possible FLIP Fluid Stats alignment issue when selecting a frame that was outside of the cache range.
    • Fixed: issue where FLIP Fluid Stats panel could display out-of-date info after a cache reset.
    • Fixed: issue where FLIP Fluid toolshelf menu was missing operator to select the whitewater dust object.
    • Fixed: Fixed potential crash issues that could be triggered when using Blender's Undo (Ctrl+Z) after creating a domain.
    • Fixed: bug where FLIP Fluid Simulation panel would not be drawn in the case that the user has run out of drive space during the previous simulation.
    • General performance improvement of 10% - 15% for medium to large simulations (Detailed notes in Development Update #33).
    • Improved speed and flexibility of geometry export system (Detailed notes in Development Update #28).
    • Improved accuracy of surface tension calculations to improve stability (prevent blow-ups).
    • Improved multithreaded performance of adding new fluid particles into simulation domain.
    • Improved performance in grid initialization.
    • Improved performance in handling FLIP Fluid Obstacle objects.
    • Miscellaneous UI tweaks, usability, stability, reliability improvements.
    • New Documentation: What is the domain simulation grid?.
    • New Documentation: FLIP Fluids Helper Menu.
    • New Documentation: FLIP Fluids Preferences Menu.
    • New Documentation: Current Status of the Preset System.
    • New Documentation: Updated installation instructions using Blender 2.8x screenshots.
    • New Documentation: Limitations of the FLIP Fluids addon.
    • New Documentation: Expanded CPU Usage Topic.
    • New Documentation: What is the difference between Blender's Mantaflow fluid simulator and the FLIP Fluids addon.
    • New Documentation: Does my obstacle object need to be completely contained by the domain?.
    • New Documentation: Tips for Creating Ship Simulations.
    • New Documentation: Scene Troubleshooting: Fluid behaviour changes when increasing resolution.
    • New Documentation: Whitewater Rendering Tips.
    • New Documentation: notes on potential feature of Motion Blur Support on Alembic Exports.
    • New Tutorial: Episode Eight: Layering Fluid to Make Delicious Sweets.
    • New Tutorial: Complete Guide Episode: Mastering Foam (part 3a).
    • New Tutorial: Complete Guide Episode: Mastering Bubbles, Spray, and Dust (part 3b).
  • version 1.0.8a (Mar 05 2020)
    • Hotfix to correct a major bug. Please download and update to this version if you had version 1.0.8 (Mar 02 2020) installed
    • Fixed: Bug that could cause materials to be removed from whitewater objects after render completes
  • version 1.0.8 (Mar 02 2020)
    • For detailed release notes of FLIP Fluids v1.0.8, see our development blog post.
    • Version 1.0.8 is fully supported in Blender 2.79, 2.81, and 2.82. Blender 2.80 is not fully supported due to severe bugs that affect the FLIP Fluids addon (See Blender 2.8 Support)
    • Updated world scaling system to include two scaling modes: Relative and Absolute (Documentation)
    • Options to set Start/End timing values in FLIP Fluid simulation panel have been removed (no longer useful)
    • Added operators for copying command line baking/rendering commands to clipboard (Windows Only)
    • Operator that automatically launches command line render no longer requires a FLIP Fluids Domain in the scene (Windows Only)
    • Removed unsafe cache operators (move/copy/rename) from UI. Use your filebrowser for these operations, which is safer.
    • Removed the Compute Chunks setting (automatic/manual) from the FLIP Fluids surface panel (no longer needed)
    • Particle Scale will be displayed in red if the value is set to less than 1.0
    • Gravity mode (Scene or Custom) in the FLIP Fluid World panel has been changed to a horizontal selector
    • Removed optimization and performance settings from FLIP Fluid Advanced panel (no longer needed)
    • Fixed: Issue where velocities could be ignored on deformable meshes (Issue #485)
    • Fixed: Issue where velocities of animated objects would be ignored if an inverse obstacle was present in the scene
    • Fixed: Issue that would cause mesh geometry not to export correctly if the Hide from Viewports object option (monitor icon in outliner) is used
    • Potential fix for 1st frame not rendering whitewater particles
    • Fixed: Issue where edge split modifiers would not be ignored during mesh export
    • Fixed: Incorrect default fluid_surface mesh type for OctaneRender
    • Fixed: Issue where the fluid_surface object could become unrecoverable if deleted within the viewport (Issue #483)
    • Fixed: Issue where OpenGL point size for particle debugging could not be set in Blender 2.8 (Issue #484)
    • Fixed: Issue where special filesystem characters could not be used in object name (Issue #462)
    • Fixed: Potential errors if simulation contained over 120 million particles (Issue #477)
    • Fixed: Issue where simulation data could become corrupted when running out of storage space
    • Fixed: Incorrect frame loading when playback offset set to -1 or 1 (Issue #488)
    • Fixed: Compositing uses the wrong cached frame during render (Issue #489)
    • Fixed: Potential crashes when rendering example scenes
    • Fixed: Issue that could trigger an error during command line baking
    • Fixed: Baking error message when switching a FLIP Fluids Domain to another simulation type
    • Fixed: Issue that could cause a baking crash if an obstacle object was located entirely outside of the domain
    • Fixed: issue where inline force field documentation links would not be consistently displayed when submenu was collapsed.
    • New Documentation: The Most Important Documentation Topics
    • New Documentation: Obstacle Inverse Workflow
    • New Documentation: The importance of scale
    • New Documentation: How to use Relative and Absolute world scaling in your workflow
    • New Documentation: Which meshing offset mode to use
    • New Documentation: Why is exporting animated objects taking so long!
    • New Documentation: Surface Tension: Estimated Substeps
    • New Documentation: Update Documentation: Alembic Support
  • version 1.0.7 (Nov 27 2019)
    • Version 1.0.7 is fully supported in Blender 2.79 and Blender 2.81. Blender 2.80 is not fully supported due to severe bugs that affect the FLIP Fluids addon (See Blender 2.8 Support).
    • Updated addon to use new Blender 2.81 features that improve rendering and baking stability
    • Added a new Dust particle type to the whitewater simulator. Dust particles are generated near obstacles that are marked as dust emitters. Dust particles are advected with the fluid velocity similar to bubble particles and sink towards the ground.
    • Added a 'Dust Emission Strength' parameter to the Obstacle properties section that controls how much whitewater dust the object will generate
    • Added 'Spray Emission Speed' parameter to the whitewater simulator that will scale the speed of emitted spray particles. Increase to generate larger and more exaggerated spray effects.
    • Added option to FLIP Fluid Advanced panel to disable changing topology warning for animated meshes that change topology between frames. Warning: vertex velocities will not be computed for topology changing meshes.
    • Added option to FLIP Fluid Simulation panel to automatically set domain preview resolution based on recommendation
    • Surface and whitewater mesh objects can now be renamed and are no longer required to be child objects of the Domain
    • Fixed misc compile errors and warnings for Linux/MacOS
    • Fixed bug that could cause baking crashes when using the whitewater simulator
    • Fixed bug that could prevent whitewater foam particles from transitioning into spray particles
    • Fixed bug that could cause whitewater particle objects not to be loaded in the viewport
    • Fixed bug that could cause incorrect particle geometry when switching between built-in and custom particle objects
    • Fixed bug that could leave behind stray objects in the scene when removing whitewater meshes
    • Fixed bug that could cause errors when re-loading addon scripts
    • Fixed bug where the 'More Bake Settings' subsection of the FLIP Fluid Simulation panel could not be set as default values
    • Fixed bug where rendering could be disrupted if the 'Auto Load Baked Frames' feature is enabled
    • Fixed bug that could cause grid debugging tools not to display
    • Fixed stray debugging print outs during simulation in the Blender System Console
    • Addon will now initialize the fluid_surface mesh object with smooth shading by default
    • Addon will now automatically toggle Cycles visibility settings on inflow/outflow/fluid objects according to the objects hide render property
    • Addon will now automatically lock the Blender interface (Blender > Render > Lock Interface) upon creation of the domain to prevent render crashes in Blender 2.8x
    • Addon can now visualize the domain bounds independently of the domain grid in the FLIP Fluid Debug panel
    • Removed smoothing operations from FLIP Fluid Surface panel. Amount of smoothing should be set in the fluid_surface object smooth modifier
    • Whitewater particle object can now be set as a built-in 6 sided cube in addition to a 20 sided icosphere or a custom object in the FLIP Fluid Display Settings panel
    • Whitewater display settings section in FLIP Fluid Display panel can now be collapsed in the UI
    • Misc tooltip improvements
    • Misc performance improvements
  • version 1.0.6 (Oct 10 2019)
    • Added support for Blender 2.81
    • Added reminder in the addon installation/preferences menu and Physics panel to complete installation by restarting Blender. See Installation Instructions.
    • Added warning about Blender 2.80 bugs to the addon installation/preferences menu and system console output. See Blender 2.80 known issues.
    • Added a reminder to prevent render crashes by locking interface in Blender 2.8x to addon installation/preferences menu and system console output
    • Added an operator to the FLIP Fluid Display Settings panel and toolshelf menu to automatically lock the interface (Blender 2.8x)
    • Added an operator to the FLIP Fluid Display Settings panel and toolshelf menu to automatically set the render display mode to Fullscreen (Blender 2.79)
    • Added operators to toolbox menu to automatically launch command line baking and rendering processes (Feature only supported on Windows)
    • Added monochromatic FLIP Fluids icon for Blender 2.8x
    • Fixed issue that could cause frequent Blender 2.8x crashes during render, Alembic export, and rigid/cloth simulation baking (issue #403)
    • Fixed bug where Inflow 'Substep Emissions' value could not be keyframed
    • Fixed TypeError that could be triggered at the end of simulation baking (issue #469)
    • Fixed bug where console output would still be displayed during mesh export when the 'Display Console Output' option was disabled
    • Reduced amount of particle meshing artifacts on boundary of domain
    • Addon no longer automatically deletes the FLIP Fluids cache when closing an unsaved .blend file
    • Addon now automatically adds a smooth modifier (set to 0 iterations) to the fluid mesh objects
    • Addon will now display an error if a user attempts to bake a simulation before completing installation
  • version 1.0.5 (Jun 04 2019)
    • Added support for Blender 2.80 (Experimental until official release. See known issues.)
    • Added a surface tension solver (issue #388)
    • Added sheeting effects feature (Documentation)
    • Added meshing options to remove parts of surface mesh near the domain boundary
    • Added meshing options to set offset for fluid-solid mesh interface
    • Added meshing feature to set a custom object as a meshing volume. Only fluid inside of this object will be meshed.
    • Added option to skip re-exporting animated meshes
    • Added settings and option to set a custom baking frame range instead of using the timeline start/end values
    • Added a savestates feature which gives the ability to rollback a simulation and resimulate from an earlier frame
    • Added a 'Beginner Friendly Mode' to preferences that limits UI to only show the most basic and commonly used parameters
    • Added a Basic/Advanced settings mode for Whitewater panel (issue #384)
    • Added feature to control amount of whitewater generated by Obstacle objects (issue #385)
    • Fixed bug where using world scaling would cause incorrect distribution of generated whitewater particles (issue #373)
    • Fixed 'ResourceWarning' error when disabling and re-enabled addon
    • Fixed bug that would cause bumpy mesh artifacts on edges of domain (issue #380)
    • Fixed bug where bake would continue to run after closing Blender (issue #361)
    • Fixed bug where Blender could crash while rendering in Cycles with the viewport open (issue #403)
    • Fixed bug where copper preset could be loaded as coffee preset
    • Fixed 'Value must be greater or equal to zero' error that could be triggered if domain bounding box is too thin (issue #397)
    • Fixed bug where deleted objects could be exported to the simulator (issue #405)
    • Fixed bug where particles could escape the domain and trigger an 'Out of Range' error (issue #415)
    • Fixed precision error what could cause fluid meshes to be scaled incorrectly (issue #414)
    • Fixed bug where the 'Reload Frame' operator could ignore reloading a frame (issue #419)
    • Fixed bug where the intersection between inversed obstacles would be computed as solid instead of empty
    • Fixed issue where Blender could crash during animated mesh export (issue #401)
    • Fixed Linux/MacOS bug where a simulation could stop in the middle of baking. Huge thanks to Christian Schwarz for helping us solve this issue!
    • Setting inflow 'Substep Emissions' to 0 will cause the inflow only emit fluid on the first substep of a frame (Documentation)
    • Misc material and preset library fixes
    • Improved collisions with thin obstacles
    • Improved forward/backward compatibility of .blend files between addon versions
    • Performance improvements
    • Simulation stability improvements
    • Mesh generation improvements
  • version 1.0.4a (Aug 24 2018)
    • Fixed bug that would cause holes (missing triangles) in the surface mesh (issue #372)
    • Fixed bug that would cause missing chunks near the boundary of the surface mesh (issue #376)
    • Fixed bug that would cause banding artifacts in the surface mesh (issue #377)
    • Fixed bug where using world scaling would cause incorrect distribution of generated whitewater particles (issue #373)
  • version 1.0.4 (Aug 09 2018)
    • Added support for baking from the command line (issue #329) - See Notes
    • Added debug functionality to visualize the true domain bounds (issue #299)
    • Added functionality to restrict viewport/render fluid display from the 'FLIP Fluid' physics button (issue #222)
    • Added Inflow option to constrain fluid inside of an inflow object to match the inflow emission velocity. Allows inflow to work when submerged (issue #322). Allows low velocity emission values to have the effect of slowing down inflow emission (issue #90) - See Notes
    • Added volumetric water shader 'Water (volumetric)' courtesy of Grant Wilk of Remington Graphics
    • Added optimization to skip frame calculations if time step is zero-length (issue #350)
    • Fixed bug that would require reloading a scene if an invalid cache directory was set before baking (issue #330)
    • Addon will now display popup error message when exporting a preset package to an invalid directory (issue #320)
    • Fixed incorrect surface motion blur rendering method that would result in a hard edge of the surface mesh instead of a fully blurred edge (issue #87)
    • Fixed bug that would trigger an error if a deformable inflow was located outside of the domain
    • Fixed UI issue to disable ability to insert keyframes into 'Hold Frame' option (issue #340)
    • Removed 'Invert Surface-Contact Normals' option in 'FLIP Fluid Surface' settings. This option does not work as intended and is not useful.
    • Fixed bug where whitewater particles would be killed when boundary behaviour was set to 'Ballistic' (issue #354)
    • Fixed bug where changes to whitewater particle scale would not be reloaded in the viewport (issue #339)
    • Fixed bug where renaming Inflow/Fluid target object in outliner would not rename object in Inflow/Fluid settings (issue #356)
    • Improved forward/backward compatibility of .blend files between addon versions
    • Improved performance of surface mesh generation
    • Improved compatibility with various Linux distributions
    • Removed GPU acceleration features. GPU methods have been entirely replaced with higher performance CPU methods.
    • Removed 'Enable Experimental Optimization Features' setting from Advanced panel. These features are no longer experimental and are now fully integrated into the fluid engine.
  • version 1.0.3 (Jun 01 2018)
    • Added operator to preferences menu to check for version updates (issue #314)
    • Added support for fluid surface motion blur rendering (issue #87) - See Notes
    • Fixed bug where editing a preset would display an error (issue #301)
    • Fixed bug that prevented viscous fluids from sticking to obstacles
    • Fixed bug that caused 'Out of Memory' error when an Inflow or Outflow was located outside of the domain (issue #316)
    • Fixed bug that would cause meshes to be misaligned if world scaling was enabled (issue #315)
    • Fixed bug that caused mesh artifacts when 'GPU Features' was disabled (issue #317)
  • version 1.0.2 (May 16 2018)
    • Added support for OS X and Linux - See Notes
    • Fixed bug where addon would crash if Inflow/Outflow was outside of Domain
  • version 1.0.1 (May 04 2018)
    • Added full preset library
    • Added full material library
    • Added functionality to invert fluid surface-obstacle interface normals
    • Fixed bug where stats could stop being processed (issue #280)
    • Improved fluid particle stability

Experimental Releases

Experimental releases will give you access to the latest updates and features, but these builds may contain bugs and lack documentation. Please let us know what you think of the experimental builds or notice any problems, we love to hear your feedback!

Experimental Versions 9.2.x

Release notes for experimental version 9.2.x, which correspond to the stable FLIP Fluids Version 1.2.0. These versions contain the latest features, fixes, and improvements. Please read our Experimental Builds documentation before testing these versions.

  • version 9.2.1 (Nov 25 2021)
    • This experimental release corresponds with the stable 1.2.0 release and contains minimal changes. Refer to the 1.2.0 release notes.

Experimental Versions 9.1.x

Release notes for experimental version 9.1.x, which correspond to the stable FLIP Fluids Version 1.1.0. These versions contain the latest features, fixes, and improvements. Please read our Experimental Builds documentation before testing these versions.

  • version 9.1.4 (Nov 17 2021)
    • This will likely be the last experimental version before the release of the next stable version, FLIP Fluids v1.2.0 to be released on 25-nov-2021.
      • At this point, it is unlikely that any changes in Blender 3.0 developments should break compatibility before the release on 03-dec-2021.
      • At the moment, there are no known issues between this version of the FLIP Fluids addon and Blender 3.0.
      • Issues related to Blender 3.0 compatibility can be reported and tracked in this thread: issue #535.
      • Experimental versions after the next stable release will continue in the 9.2.x series.
    • Added: Functionality to preserve any UV Map Layers or Vertex Color Layers on the fluid mesh data (issue #561).
      • Note: as the fluid meshes have dynamic topology, the values in the layers will not be transferred to the next frame. The layers will contain default data and should only be used procedurally.
    • Added: Alternate surface tension solving method:
      • Regular: Choose for general purpose surface tension effects. This option is the default and is the same method used in previous versions.
      • Smooth: Choose for improved stability, smoother results, and improved cohesion in small-scale effects. Good for thin streams/strands of liquid and for high surface tension effects. Not recommended for highly chaotic fluid motion or large volumes of liquid as this can result in volume increase issues.
    • Bug Fix: Issue where Re-launch Bake After Crash command line bake feature could resume the simulation from an incorrect frame after an error is encountered.
    • Bug Fix: Re-launch Bake After Crash command line bake feature will no longer attempt to re-launch a simulation if a Out of device/disk space error is encountered.
    • Bug Fix: Issue where custom drawing of text in the grid visualization feature could display with inconsistent colors depending on Blender version.
    • Bug Fix: Issue where building from source could display a cmake_minimum_required() deprecation warning.
    • Bug Fix: Issue where the option to enable surface tension could be greyed out and not selectable.
    • UI: Various reported typos and formatting in property tooltips (Thanks for the reports!).
    • UI: Tooltips and documentation have been updated to use the term Voxel rather than Grid Cell for consistency.
  • version 9.1.3 (Nov 03 2021)
    • This is a minor update that mainly updates compatibility for Blender 3.0 Beta.
    • Blender 3.0 Compatibility: This build is intended to be used with Blender 3.0 Beta builds dated November 3, 2021 or later.
    • Added: Forward compatibility support for Blender 3.0
      • If a .blend file is saved in Blender 3.0 and then opened in an earlier version of Blender 2.8x or 2.9x, the addon will automatically update the .blend file so that FLIP Fluid objects are compatible and function correctly.
      • We still recommend keeping Blender 3.0 .blend files and earlier versions in separate saves. Blender will warn that you may still experience data loss in the .blend file in areas/features outside of the FLIP Fluids addon.
    • Bug Fix: Issues related to automatically setting Cycles ray visibility for FLIP Fluid/Inflow/Outflow/Force/Domain objects in recent builds of Blender 3.0.
    • Bug Fix: Baking crash (Index Out Of Range or EXCEPTION_ACCESS_VIOLATION error) that could be possible when the Remove Mesh Near Domain option is enabled.
    • UI: The Beginner Friendly Reminder and tooltip displayed in the Physics panel now adds a note that when this preference is enabled, some settings will be hidden.
    • Added: updated example motion_blur_rendering_example.blend file in the experimental builds package. This example file now uses the updated geometry nodes 'fields' workflow and removes legacy nodes.
  • version 9.1.2 (Oct 18 2021)
    • This is a minor update that mainly updates compatibility for Blender 3.0 Alpha.
    • Blender 3.0 Compatibility Update:
      • Reminder that Blender 3.0 is still in early development and is set to release on December 3rd 2021. Please do not expect experimental versions of the FLIP Fluids addon with Blender 3.0 to be production-ready.
      • Recent changes in Blender 3.0 development caused compatibility to break with the FLIP Fluids addon, and in severe cases damaged .blend files. For this reason, we strongly recommend frequent backups of your .blend files.
      • It is strongly recommended to use this version of the FLIP Fluids addon with Blender 3.0 builds dated October 18 2021 or later.
      • At the moment there are no known issues with this version of the FLIP Fluids addon and Blender 3.0 Alpha, but compatibility may break as Blender develops.
      • Issues related to Blender 3.0 compatibility can be reported and tracked in this thread: issue #535.
    • Added: An example .blend file to the experimental builds package to demonstrate how to use a new Blender 3.0 feature to render true motion blur on the liquid surface (motion_blur_rendering_example.blend).
    • Bug Fix: Issue where objects could be incorrectly simplified into a cuboid (issue #557).
    • Bug Fix: Issue where temporary stat cache files would not be processed and updated upon loading a .blend file (issue #558).
    • Bug Fix: Error message generated if cache directory location was invalid on .blend file load.
    • Removed: Deprecated Check For Updates operator.
  • version 9.1.1 (Sep 17 2021)
    • This is the first experimental version since the latest stable version 1.1.0 which adds minor fixes.
    • Blender 3.0 Compatibility: Fixed issues related to recent changes in the Blender 3.0 API.
      • Missing Documentation link in the preferences menu is now visible.
      • Fixed issue where automatic toggling of Cycles visibility options upon FLIP Fluid object creation was not functioning correctly.
      • Issues related to Blender 3.0 compatibility can be reported and tracked in this thread: issue #535.
    • MacOS Compatibility: Added potential fixes to a rare issue where the FLIP Fluids Engine was not supported on older MacOS versions. If you are experiencing any compatibility issues on any MacOS version 2014 or later, please let us know.
    • Bug Fix: Issue where attribute error would be generated on addon initialization if Cycles addon was not enabled (issue #552).
    • Bug Fix: Issue where IndexError would be generated if surface attributes were enabled, but not yet baked.
    • Bug Fix: Issue where unsupported object types could be set as a FLIP Fluid object (issue #556).
    • Bug Fix: Added workaround to issue where adding a Graph Editor Modifier to FLIP Fluids settings could bypass the property min/max values, generating an error during bake.
      • This manual fix has only been added to certain settings where a user is more likely to add a graph modifier. Settings in the FLIP Fluid World panel, and settings in the Obstacle properties.
      • A workaround for other settings can be to make sure the graph curve stays in the min/max range values.
      • If there is a setting where you would like this fixed, please let us know.

Experimental Versions 9.0.9.x

Release notes for experimental version 9.0.9.x, which correspond to the stable FLIP Fluids Version 1.0.9 and subsequent (1.0.9a,b,c if needed). These versions contain the latest features, fixes, and improvements. Please read our Experimental Builds documentation before testing these versions.

  • version 9.0.9.24 (Aug 12 2021)
    • This version mainly adds bug fixes and small improvements. This will be the last experimental version release before the release of the next stable version (v1.1.0) next week.
    • Blender 3.0 Alpha Compatibility:
      • This version adds necessary changes to the FLIP Fluids addon to be compatible with recent developments in Blender 3.0 Alpha. Compatibility with Blender 3.0 may break as development continues.
      • Issues related to Blender 3.0 compatibility can be reported and tracked in this thread: issue #535
      • Added functionality to the Automatic Command Line Bake operator (Windows Only):
        • If a simulation error occurs that stops the simulation, the operator will now attempt to automatically re-launch and resume the simulation. Certain errors such as 'Out of Memory' errors can be solved by re-launching a simulation.
        • If Blender crashes, the command line bake will try to detect the crash and attempt to re-launch Blender and the baking process.
        • The max number of re-launch attempts can be set in the FLIP Fluid Preferences menu (default = 5).
      • Improved support for fracture simulations set as a FLIP Fluid Obstacle where the fracture simulation contains non-manifold geometry.
        • Instead of ignoring the entire mesh when non-manifold geometry is detected, the simulator will only ignore fractured pieces of the mesh that contain non-manifold geometry.
      • Bug Fix: When baking from the command line and an error is encountered within the simulation, an error message will now be output correctly to the command line window.
      • Bug Fix: (Blender 3.0) TypeError which prevents fluid surface object from being generated upon creation of a domain.
      • Bug Fix: (Blender 3.0) KeyError generated upon starting a simulation.
      • Bug Fix: (Blender 3.0) Immediate crash upon starting a render of a FLIP Fluids addon cache generated in Blender 2.93 or lower.
  • version 9.0.9.23 (Jun 30 2021)
    • This version mainly adds bug fixes and small improvements.
    • Vacation notice: Development of the FLIP Fluids addon as well as our untitled development project will be on hold during vacation until July 23rd. Until this time, fulfillment of support requests may be delayed. Thank you for your patience!
    • Blender Bug: Added a workaround for issue T87629 to return a 'fake' preferences with default values if the actual preferences cannot be accessed. This workaround is to support activating the FLIP Fluids addon through the command line.
    • Blender Bug: Reported an issue that causes render crashes when rendering vertex attributes (T88811).
    • Bug Fix: Crash that could be caused by using undo after activating the Create Domain operator on a selected object.
    • Bug Fix: Fixed incorrect render issue when 'Render > Persistent Data' option is enabled. Note: with this option enabled, rendering can be less stable. It is recommended to render through the command line if enabling this option.
    • Bug Fix: Fixed issue where a curve or empty type object could not be added as a force field object through the helper menu.
    • Bug Fix: Added missing Cache 'Match Filename' operator to helper menu.
    • Unfinished features: Color attribute features (and Source ID attributes) are not completely finished, but basic functionality can be accessed by enabling the 'Developer Tools' option in the FLIP Fluids Preferences menu.
  • version 9.0.9.22 (May 25 2021)
    • This version adds bug fixes and small features.
    • Reverted a bug fix in 9.0.9.20 (Issue where surface and whitewater materials would be removed when changing between scenes) that ended up causing large problems in material set up for the simulation mesh objects. A better fix without side-effects will need to be implemented.
    • Added operator to FLIP Fluid Cache panel to set the cache location to a directory based on the name of the .blend file.
    • Added +/- operators to the FLIP Fluid Cache panel to increment/decrement a number at the end of a cache directory, similar to the icons when saving a .blend file.
    • Added support for all render output image file types when using the Helper > Generate Batch File operator.
    • Bug Fix: fixed issue where Helper > Generate Batch File operator did not support image file prefixes in the render output location.
    • Bug Fix: The cache directory can no longer be set to a location directly relative to the .blend file (ex: '//').
    • Bug Fix: Fixed issue where liquid could be spawned with triangle line artifacts for cuboid shaped Fluid objects in high resolution simulations.
  • version 9.0.9.21 (May 13 2021)
    • This version adds preliminary support for the Blender 2.93.0 Beta MacOS Arm 64 bit version of Blender!
      • The MacOS ARM build of Blender is for native support on the Apple Silicon M1 processor.
      • This version of Blender can be downloaded here: https://builder.blender.org/download/
      • The way that we build and package the MacOS side of the addon has changed and we are looking for feedback:
        • Please let us know if you encounter any error messages.
        • If you have access to a MacOS M1 system, feedback on whether you can run a simulation using this addon version and Blender version would be greatly appreciated.
        • If you do not have access to an M1 system, we would also appreciate feedback on whether the simulator still runs on your MacOS Intel system.
        • A 'Yes, it runs' answer is just as valuable to us as a 'No, it does not run' answer.
        • Feel free to let us know on the Blender Market, on our GitHub thread, social media pages, or through support at flipfluids.com.
    • Bug Fix: Fixed a FileNotFoundError when using the FLIP Fluids Helper > Generate Batch File if the render output location was set to a relative path.
  • version 9.0.9.20 (May 05 2021)
    • This version mostly adds fixes for reported issues.
    • Blender 3.0 Compatibility: Blender 3.0 is in early development and is set to release on August 25, 2021. At the moment, there are no known issues when using Blender 3.0 with the FLIP Fluids addon version 1.0.9b or the latest experimental version. The Blender 3.0 Cycles-X branch also seems to work after some brief testing.
      • Issues related to Blender 3.0 compatibility can be reported and tracked in this thread: issue #535
    • Added 'Remove Mesh Near Domain' feature support for the preview mesh.
    • Added an option to the FLIP Fluids Preferences menu to hide the experimental build warning displayed in the physics panel.
    • Bug Fix: Simulation will no longer stop if a frame statistics temporary file is found to be in use and unable to be deleted (issue #529).
    • Bug Fix: Issue where surface and whitewater materials would be removed when changing between scenes.
      • This involved many changes for how the addon sets up the viewport and render. Please let us know about any odd behavior in how the simulation is displayed.
    • Bug Fix: Issue where command line operators may not work if spaces are contained in the Blender executable path, specifically when located in C:/Program Files/.
    • Bug Fix: Fixed inconsistent UI issues (issue #533).
    • Bug Fix: Issue where non-mesh type objects could be selected as a custom whitewater particle object, leading to an error.
    • Bug Fix: Re-fixed preview rectangle artifacts issue that was introduced as a side effect by another bug fix (issue #491).
    • Bug Fix: Issue where the whitewater display percentage setting loaded an incorrect amount of whitewater after resuming a simulation. Notes:
      • This was caused by the addon saving incorrect information to the savestates cache.
      • Simulations will need to be re-baked for this fix to take effect.
    • Bug Fix: Issues where (harmless) error messages could be displayed when using Blender 3.0.
    • Known Issue: The Age and Source ID attributes are not yet supported when using the particle sheeting feature. A fix is in progress!
  • version 9.0.9.19 (April 21 2021)
    • This version is the first experimental build since the release of FLIP Fluids 1.0.9b (06-APR-2021).
    • Added geometry attribute features for the liquid surface mesh that can be enabled in the FLIP Fluid Surface panel. See Development Notes #55 on these features.
      • Added a velocity attribute. After baking, the velocity vectors (in m/s) can be accessed in a Cycles Attribute Node with the name 'flip_velocity' from the Vector output. If the velocity direction is not needed, use Generate Speed Attributes instead.
      • Added a speed attribute. After baking, the speed (in m/s) can be accessed in a Cycles Attribute Node with the name 'flip_speed' from the Fac output.
      • Added an age attribute. After baking, the age (in seconds) can be accessed in a Cycles Attribute Node with the name 'flip_age' from the Fac output.
      • Only supported in Blender 2.93.
      • Only supported using the Cycles renderer. According to the Blender developers, EEVEE support will come at a later date.
      • Due to a bug in Blender, these new attribute features will cause render crashes or incorrect renders. Until this is fixed, rendering from the command line will be required to prevent render crashes when using these attribute features.
      • Compatibility with older .blend files: If you had tested our prototype build for velocity-based shading, you may need to fix your .blend file when using this version. To fix your file, delete all shape keys attached to the fluid_surface object.
  • version 9.0.9.18 (March 31 2021)
    • This version is a minor release containing only stable bug fixes and contains almost every change that will be included in the next stable release, FLIP Fluids 1.0.9b (April 6 2021).
    • Bug Fix: 'TypeError' that could be triggered in Blender 2.93 by pressing the F3 operator search key.
    • Bug Fix: Removed deprecated cache operators (Copy/Move/Rename) from being searchable and executable in the F3 operator search menu.
    • Bug Fix: Fixed UI issue where bake information would not be updated when using the Reset operator if the current cache directory did not exist.
    • Bug Fix: Fixed missing icon errors in Blender 2.79 due to icon renaming in Blender 2.8+.
    • Example Scene Fix: Fixed volume_force_animated_character.blend example scene issue where the fluid objects would be emitted in the wrong direction. Corrected in the example scenes file as of March 25, 2021.
  • version 9.0.9.17 (March 17 2021)
    • This version is a minor release containing only stable bug fixes and improvements as we get ready for the next stable release, version 1.0.9b, set during the week of April 5th. Thanks for all of your testing and reports!
    • Blender 2.93 Alpha support: As of the March 11th daily build, there are no know compatibility issues between the FLIP Fluids addon and Blender 2.93. Issues related to Blender 2.93 compatibility can be reported and tracked in issue #519.
    • Bug Fix: Error message when using command line batch baking operator if render output directory does not exist on the filesystem.
    • Bug Fix: UI issue where domain FLIP operator displayed the hide/show viewport/render icons in reverse order compared to regular Blender convention.
    • Bug Fix: Bug where using the inflow Constrain Inflow Velocity option could cause a bulge to form in the lower x/y/z corner of the domain.
    • Bug Fix: ValueError that could be triggered upon creating a domain if the .blend file was located on a different drive than the Blender installation.
    • Bug Fix: Potential issue where instanced particle objects could have Motion Blur enabled, causing longer render times in Blender 2.91+ (related to similar fix in v9.0.9.16).
    • Fixed: Bug where using the FLIP Fluids Helper > Solid/Wireframe operator would deselect Fluid/Inflow/Outflow objects after execution.
    • Changed: The FLIP Fluids Helper > Solid/Wireframe operators no longer change the render visibility of the objects. This functionality has been split into a separate row of Show/Hide Render operators that sets the render visibility of all selected objects.
  • version 9.0.9.16 (March 10 2021)
    • This version adds a few bug fixes and improvements.
    • Bug Fix: Fixed an issue where many particles could become stuck to sharp obstacle edges which could lead to an unstable simulation (issue #508).
    • Bug Fix: Potential fix for render crashes when the Fluid Particle Debugging or Force Field Debugging tools are enabled (issue #521).
    • Bug Fix: Fixed error messages in Blender 2.79 due to difference in icon names in Blender 2.8+.
    • Bug Fix: Fixed issue in Blender 2.91+ where rendering fluid meshes with motion blur enabled could result in longer Cycles render times.
      • Note: Motion Blur Rendering of fluid surfaces or whitewater particles is not currently supported (See: Motion Blur Support).
      • This fix will only apply to newly created scenes. To workaround this issue in an existing scene, select a fluid/whitewater object and disable the Object Properties > Motion Blur option (only applies if Cycles is the selected renderer).
    • Added a UI warning and tooltip if the Estimated Surface Tension Substeps info value exceeds the allowed Max Frame Substeps Value (Documentation).
    • Added viewport visibility toggles to the fluid particle, force field, and obstacle debug tools.
  • version 9.0.9.15 (March 03 2021)
    • Similar to the last experimental release, this version contains large structural changes in how the simulator functions which may be a potential source of bugs. Please let us know if you are experiencing any of the following issues:
      • Crashes or error messages during baking.
      • Out of Memory errors or simulations using an unusually large amount of memory.
      • Inability to pause, resume, or upscale a simulation.
      • Error messages when using a cache created by an older addon version.
    • Safety Factor (CFL Number) setting in the FLIP Fluid Advanced panel has moved from the Simulation Stability section to the Frame Substeps section. The Safety Factor option is more closely related to how the simulator calculates adaptive substeps.
    • Added an operator to the FLIP Fluid Helper sidebar menu to generate a Windows batch file (.bat) to command line render each frame of an animation one by one.
      • Operator will detect already rendered frames in the output directory and disregard these from the batch file.
      • Upon a render crash, the batch file will start up Blender again and begin rendering the next frame. In this way, you can minimize unrendered frames if your system is prone to render crashes.
      • Can be used outside of the FLIP Fluids addon to render a sequence of frames individually. There are some bugs in Blender which can cause an animation to be rendered incorrectly and a workaround to these issues is to render each frame one by one.
    • Viscosity Solver Improvements
      • Large structural changes to the viscosity solver code and memory layout. Please let us know about any baking crashes, error messages, or incorrect behaviour.
      • Bug Fix: Fixed issue where low viscosity streams would have a velocity bias in the positive X/Y/Z direction (issue #455).
      • Improved accuracy of viscosity solver setup.
      • Added an Accuracy option to the viscosity solver to control the solver error tolerance.
        • Decrease to speed up baking at the cost of accuracy. Increase to improve accuracy at the cost of baking speed. High viscosity thick or stiff fluids benefit the most from increasing accuracy. Low viscosity thin fluids often work well at the lowest accuracy. Setting above a value of 4 may have greatly diminishing returns on improvement.
        • The default value of 4 is the same amount of error tolerance used internally in previous versions.
    • Bug Fix: Fixed issue where disabling the whitewater feature and resuming a simulation would result in invalid whitewater cache files being generated in the cache directory.
    • Bug Fix: Fixed typo in code that would cause an error that would prevent a helpful error message from being displayed (Pull Request Here).
    • Bug Fix: Fixed UI issue where the Resume From Frame X label could be displayed in red text instead of the default white.
  • version 9.0.9.14 (February 18 2021)
    • This is the first experimental version since release of FLIP Fluids Stable 1.0.9a (03-FEB-2021).
    • New system for storing and managing particles in the simulation engine (More info in development notes #47). This is a large structural change for how the simulator functions and may be a potential source of bugs. Please let us know if you are experiencing any of the following issues:
      • Crashes or error messages during baking.
      • Out of Memory errors or simulations using an unusually large amount of memory.
      • Inability to pause, resume, or upscale a simulation.
    • Bug Fix: Issue where keyframing a min/max property could overwrite other min/max properties (issue #516).
    • Bug Fix: Updated addon code to be compatible with Python 3.9. Some Linux distributions package Blender with Python 3.9 rather than the officially supported Python 3.7.
    • Bug Fix: Removed extraneous debugging code that would cause (harmless) error messages in Blender 2.79.
    • Bug Fix: Issue where the bake operator status could hang on Calculating time remaining....
  • version 9.0.9.13 (January 27 2021)
    • This is a minor update that only includes small and stable changes. Assuming no large problems are found, this version will become a maintenance patch, FLIP Fluids 1.0.9a, that will contain most changes since the release of 1.0.9. Expected release of February 3, 2021.
    • Bug Fix: Potential crash if a curve guided force field had endcaps disabled while enabling a minimum distance for the force field.
    • Bug Fix: Issue where exporting an animated curve guided force field could trigger a 'Changing Topology Warning'. Note: it is okay for all current force fields to change topology.
    • Bug Fix: Issue where Remove Particles With Extreme Velocities could generate false-positives for a viscous fluid falling under regular gravity.
    • Bug Fix: Issue where keyframed quaternion or axis-angle rotation was not supported (issue #515).
    • Bug Fix: Issue where the baked debug tools (particle/obstacle/forcefield) would not be updated correctly if the simulation Time Scale value was set to 0.0.
    • Bug Fix: Potential error messages caused by the addon detecting Blender 2.9x versions incorrectly.
  • version 9.0.9.12 (January 13 2021)
    • This is the first experimental version since development has resumed after our winter holiday break! This update mainly involves adding minor bug fixes.
    • Blender 2.92 Alpha support: as of January 5th, 2021, the daily Blender builds now support the FLIP Fluids addon. In earlier 2.92 builds, a Python feature that the addon uses was missing.
      • The stable FLIP Fluids 1.0.9 is also now supported in Blender 2.92 Alpha.
      • Support may break as Blender 2.92 develops and issues can be tracked here: Issue #507.
    • Fixed bug where an incorrect frame was used in the simulation for the inflow/fluid object speed value if this value was keyframe animated.
    • Integrated a workaround into the addon for a long-standing Blender bug T71908 which causes keyframed render settings on the fluid meshes not to be evaluated during render. This workaround fixes:
      • Issues where keyframed settings in the FLIP Fluid Display Settings panel would not take effect during render.
      • Issues where the FLIP Fluids Helper > Override Frame Playback feature would not function during render.
      • Issues where an Ocean Modifier attached to the fluid meshes would not be animated during render.
    • Added three new example scenes by popular request (Animation previews, Example Scene Descriptions).
      • These scenes are also supported in the stable FLIP Fluids version 1.0.9.
    • New Documentation: Addon Installation Troubleshooting.
      • How to verify your FLIP Fluids installation file.
      • How to locate your Blender addons directory.
      • How to verify your FLIP Fluids Blender installation.
      • How to clean up your Blender addons directory in the case of an incorrect installation.
      • How to manually install the FLIP Fluids addon.
  • version 9.0.9.11 (December 16 2020)
    • This is the first experimental version since the stable version release of FLIP Fluids 1.0.9. Update mainly involves adding minor bug fixes reported after the stable release.
    • Notice: Development of the FLIP Fluids addon will be on winter break during December 17th, 2020 - January 3rd, 2021. Have a happy holidays and a wonderful new year!
    • Compatibility notes:
      • Due to a bug in Blender versions 2.80, 2.81, and 2.82, it will no longer be possible for us to support MacOS in these three versions. The FLIP Fluids addon on MacOS will still be supported in Blender 2.79, 2.83+, and 2.9+.
      • Blender 2.92 is not yet supported. This version of Blender is still in early development and we will need to wait until this becomes more stable in order to add support (track issue here).
    • Added a filesystem protection layer to enforce that all file removal operations are functioning correctly.
      • All file removal operations must pass through this layer which detects bugs related to human/development error.
      • Enforces that files can only be deleted within the current cache directory or the FLIP Fluids addon scripts directory.
      • Enforces that directories cannot be deleted recursively (ex: files within subdirectories of a subdirectory cannot be deleted).
      • Enforces that files can only be deleted if they contain an extension contained in a whitelist of extensions used by the FLIP Fluids addon.
        • Extension whitelist: .backup, .bbox, .bobj, .data, .ffd, .fpd, .info, .md, .png, .preset, .sim, .sqlite3, .state, .txt, .wwp
    • Bug Fix: Addon will no longer allow the FLIP Fluid current cache directory to be set as blank and will be set as a reasonable default value.
    • Bug Fix: FLIP Fluids Helper menu command line tool operators displayed incorrectly on MacOS and Linux (issue #505).
    • Bug Fix: FLIP Fluids Helper menu command line tool Copy to Clipboard operators were not functioning on MacOS and Linux (issue #505).
    • Bug Fix: Fixed potential Out of Memory error that could be triggered if a force field object is located outside of the domain.
    • Bug Fix: Fixed potential issue where the FLIP Fluid surface or whitewater object could lose it's material after reseting a bake.
    • Bug Fix: Fixed issue where inflow particles could be seeded in an unnatural pattern (issue #509).
  • version 9.0.9.10 (November 23 2020)
    • Update mainly involves testing and polishing. All features in this experimental version will be moved in the next stable 1.0.9 version release (November 26th 2020).
      • New experimental features will continue in the next experimental version 9.0.9.11.
      • More force field features will be added to the stable versions (ex: 1.0.9a or 1.1.0) as they are tested and are considered stable.
    • Added missing Add Force object in the FLIP Fluids Helper Menu.
    • When the addon creates a new domain object using the Create Domain operator, the origin will now be set at the object's center.
    • Added a UI notification to the FLIP Fluid Simulation panel to notify user in the case that the simulation will be upscaled (increasing resolution on resume).
    • Rearranged settings in the FLIP Fluid Simulation panel to group settings related to setting the simulation grid in one place.
      • Added a Grid Info section to display info about the simulation grid including tooltips to help explain the simulation grid.
        • 3D voxel dimensions
        • 3D physical dimensions
        • Voxel size
        • Voxel count
      • Copied option to display grid visualization in the Grid Info section.
      • Copied option to set World Scale in the FLIP Fluid Simulation panel.
    • Force Field Resolution option is now set to Ultra by default. This is the recommended value for force fields that are static.
    • The FLIP Fluid Preset panel and features are now hidden by default as this feature has been deprecated for more than a year. These features can still be enabled in the FLIP Fluid Preferences menu. Read More Here.
    • FLIP Fluid Preferences options are now greyed out instead of hidden in the case that the user has just installed the addon but has not restarted Blender. This is to show that there are preferences that exist in this menu.
    • Viewport/Render display options (final/preview/none) in the FLIP Fluid Display Settings panel are now displayed in a full list rather than a drop down menu.
    • FLIP Fluid Helper Menu now contains an option to set the viewport display (final/preview/none) for both the fluid surface and whitewater meshes separately.
    • Bug Fix: Fixed major crash issue on MacOS that could be triggered by updating simulation settings on resuming a bake.
    • Bug Fix: Fixed potential Index out of range crash when using a point force field in combination with a small world scale.
    • Bug Fix: Fixed bug where FLIP Fluid Simulation panel would not be drawn in the case that the user has run out of drive space during the previous simulation.
    • Bug Fix: Fixed issue where using the Organize Outliner operator could leave FLIP Fluid objects in the incorrect collection if the object had changed the simulation type.
    • New Documentation: notes on potential feature of Motion Blur Support on Alembic Exports.
  • version 9.0.9.09 (November 04 2020)
    • Update mainly consists of bug fixes and a feature to upscale simulation resolution on resume.
    • Added functionality to upscale a simulation to an increased resolution on resuming the bake. Notes:
      • If resuming a bake at a higher resolution, the simulator will automatically upscale the simulation data to the new resolution.
      • Useful if you have a simulation that takes some time to generate motion before you want to render the animation. For example, the initial motion and fill of a river could be simulated at a low resolution quickly, and then upscaled and continued at a higher final resolution.
      • Functionality to downscale a simulation to a lower resolution will be added at a later date.
    • Material UI dropdown lists have been copied from the FLIP Fluid Material panel into the FLIP Fluid Display Settings panel.
    • Bug Fix: Fixed issue where the simulation mesh could be loaded into the viewport during animated object export, causing a very slow export process.
    • Bug Fix: Fixed issue where Empty type objects could be exported to incorrect locations within the simulator.
    • Bug Fix: Fixed issue where implementation and functionality of the Disable Changing Topology Warning was missing.
    • Bug Fix: Fixed issue where rectangle artifacts could appear in the fluid surface preview mesh (issue #491).
  • version 9.0.9.08 (October 22 2020)
    • Update mainly consists of changes to the UI including bug fixes, organization, and small workflow features.
    • Blender Market product downloads have been renamed to use more consistent naming format that includes the date that the file was last updated (See FLIP Fluids Downloads).
    • Added a README.html file to the Blender Market product downloads that contains info and links for how to get started with the addon.
    • Added Force Re-Export On Next Bake feature for FLIP Fluid/Obstacle/Inflow/Outflow/ForceField objects. Notes:
      • When enabled, this option will force the addon to re-export the object's mesh data the next time that the user bakes or resumes the simulation.
      • This option overrides the Skip Re-Export option.
      • After the object has been re-exported, the force export option will be automatically disabled.
      • This option is only applicable if the _Skip Re-Export option is enabled.
      • Useful for if you have a complex animation or object with a lot of geometry with the Skip Re-Export option enabled to save time during export. Use this option if you make an update to your mesh and want to easily mark the object to update the next time you bake/resume the simulation.
    • FLIP Fluids Helper Menu organization and cleanup - many changes based on user feedback, thanks!
      • Submenus can now be collapsed/expanded.
      • Renamed submenus and rearranged operators within submenus.
      • Check For Updates operator has been removed from the Helper Menu and is now only available in the FLIP Fluids Preferences Menu.
      • Bake Simulation submenu now includes the current cache directory.
      • Added prompt/warning to Bake Simulation submenu to warn that the .blend file has not been saved. Includes operator to open the save file menu.
        • Note: it is not required to save the .blend file in order to run a simulation, but some addon features were designed to work better if the file is saved.
    • FLIP Fluid Simulation > Settings and Mesh Export submenu organization and cleanup.
      • Submenu can now be expanded/collapsed.
      • Object list can now be filtered to display objects by motion type: Static, Keyframed, Animated, or all objects.
      • Added the new Force Re-Export On Next Bake option to be displayed in the list.
      • Added operators to Enabled or Disable Skip Re-Export or Force Re-Export On Next Bake_ options for all objects in list.
    • The Enable Stable Rendering operator now toggles to Disable Stable Rendering if enabled, as a quick way to undo the operator (Blender 2.8+ only).
    • Obstacle Friction list in FLIP Fluid World panel can now be expanded/collapsed.
    • Default name of the domain object has been renamed to FLIP Domain when using the Create Domain operator.
    • Whitewater Wavecrest/Turbulence/Dust Emission Rate settings have been renamed to Max Wavecrest/Turbulence/Dust Emission Rate as better descriptions for the settings.
    • Bug Fix: Fixed error that could be triggered if the Organize Outliner operators were used without a Domain object in the the scene.
    • Bug Fix: Fixed bug where stray FLIP Fluid objects could remain behind after using the FLIP Objects to Collections operator.
    • Bug Fix: Fixed bug where toggling render visibility for a FLIP Force Field object would not also toggle Cycles ray visibility.
    • Bug Fix: Fixed bug in Blender versions 2.9+ where toggling a FLIP object's render visibility would not update the object visibility in the viewport rendered mode.
    • Bug Fix: Fixed bug where command line tools would not be displayed for MacOS/Linix operating systems.
    • Bug Fix: Fixed bug in versions of Blender 2.9+ where newly created Domain objects would not be highlighted after using the Create Domain operator.
  • version 9.0.9.07 (October 14 2020)
    • A minor update that mainly consists of an Override Frame feature similar to Blender's Alembic Mesh Cache setting and some bug fixes.
    • Added Override Frame settings to FLIP Fluids Helper Menu that works similar to the setting of the same name in Blender's Alembic Cache modifier.
      • TIP: Keyframing the override frame number can allow for complex control over simulation playback (ex: start/stop freeze frames, reverse animation)
      • The addition of this feature caused some settings to be re-arranged in the Helper Menu and some settings have moved into a separate Simulation Playback submenu (Documentation).
    • The FLIP Meshes to Collections operator in the Helper Menu now groups all of the whitewater meshes into a single WHITEWATER collection instead of separating them each into separate collections.
    • Bug Fix: Fixed error that could be triggered when using the FLIP Objects to Collections operator in the Helper Menu.
    • Bug Fix: Fixed potential crash issues that could be triggered when using Blender's Undo (Ctrl+Z) after using the Create Domain operator in the Helper Menu.
  • version 9.0.9.06 (October 7 2020)
    • This version mainly consists of requested features to help with your simulation workflow.
    • Added functionality to link exported geometry data from another cache directory in FLIP Fluid Cache panel (Documentation).
      • Use if you want to re-use exported geometry data that is located in another cache directory.
      • Useful if you have a lot of animated geometry data in your scene that you do not want to re-export.
      • Useful for if you have multiple caches from the same scene for testing different simulation settings.
    • Added 'Create Domain' operator to FLIP Fluids Helper Menu to generate a domain depending on the context of what type of objects are selected and in your scene (Documentation).
    • Added operators to FLIP Fluids Helper Menu to help organize your simulation objects in the Blender Outliner (Documentation).
      • Separate your FLIP Fluid objects into collections by type
      • Separate the generated simulation methods into collections (useful for creating view layers)
    • Added operators to FLIP Fluids Helper Menu to select all simulation objects of a certain type (Obstacle/Fluid/Inflow/Outflow/ForceField) (Documentation).
    • New Documentation: Whitewater Rendering Tips.
  • version 9.0.9.05 (September 30 2020)
    • Added optimizations that can speed up simulation baking for medium to large simulations by 10% - 15%
    • Addon now includes two versions of the fluid simulation engine that can be switched in the addon preferences menu. Notes:
      • Engine Debug Mode enabled: uses a debugging version of the simulation that can generate error messages after a simulation crash, but runs slightly slower
        • This is the version of the simulation engine used in versions older than v9.0.9.05
      • Engine Debug Mode disabled: includes performance optimizations, but is unable to generate error messages after a simulation crash
        • If you are experiencing a persistent simulation crash, switch to the debugging engine and resume/re-run simulation to check for error messages
      • Running the debug engine or normal engine will not affect the results of the simulation
    • Addon can now be built/compiled using a Python script (build.py) rather than running CMake and GNU Make directly. The new Python script automates building both versions of the fluid simulation engine.
    • Addon packaging and distribution for Windows/MacOS/Linux is now automated to reduce issues related to human-error
    • Fixed potential crash that can be triggered when using Surface, Volume, or Curve Guided force fields
    • Default value change: FLIP Fluid Simulation -> Update Settings on Resume is now enabled by default
    • Default value change: FLIP Fluid Surface -> Subdivisions is now set to 1 by default
      • Note: this produces a more desireble mesh with less artifacts and issues, but takes some extra time to compute. If you want to maximize baking speed during testing, set this value to 0
    • New Documentation: FLIP Fluids Helper Menu
    • New Documentation: FLIP Fluids Preferences Menu
    • New Documentation: Current Status of the Preset System
  • version 9.0.9.04 (September 16 2020)
    • Added curve guided force field mode See documentation.
    • Added options to Fluid/Inflow object to emit fluid from the object's negative local axis (in addition to the existing positive axis options).
    • Fixed export error that could be triggered by exporting an Empty type object as a force field.
    • Added UI warnings if the type of Blender object is not suitable for the selected force field mode (Ex: using an Empty type object as a Surface Force).
    • Added note to Inflow Enabled tooltip that this option can be disabled to stop fluid emission.
    • Performance improvements in handling FLIP Fluid Obstacle objects.
    • Performance improvements in grid initialization.
  • version 9.0.9.03 (September 2 2020)
    • Mesh data export system has been rewritten and exported scene mesh data types are now stored in an SQLite3 database rather than directly on the filesystem (Detailed notes in Development Update #28)
      • This will be a likely source of bugs as a major portion of code had been rewritten. The following is a list of some things to test:
      • Are your mesh objects appearing in the correct place during simulation?
        • For static objects (not moving)?
        • For keyframed objects (animated with simple rotation/location/scale or f-curves)?
          • For all of Blender's rotation modes (Euler, Axis Angle, Quaternion)?
        • For animated objects (complex animation such as parenting, armatures, deformation)?
      • Are you able to start your simulation without error messages?
      • Are you able to stop and resume your simulation?
        • Is the 'Update Settings on Resume' feature still functioning correctly?
      • Are you able to reset or delete your cache without errors?
      • Are Inflow/Fluid objects with target objects emitting in the correct direction?
        • When the target is an Empty type object?
        • When the target is a Mesh type object?
      • Is the Skip Re-Export feature still functioning correctly?
      • Is the FLIP Fluid Surface 'Meshing Volume' feature still functioning correctly?
      • Is command line baking still functioning correctly?
      • Are your older .blend files (v1.0.8a and higher) and caches still running and loading correctly?
      • If you notice any undesireable changed behaviour or bugs between versions, please let us know!
      • If you are interested in viewing/debugging the database contents, the SQLite3 database file can be found in cache_directory/export/export_data.sqlite3. A graphical SQLite3 viewer such as DB Browser for SQLite can be used.
    • Added functionality to Skip Re-Export of static and keyframed meshes in addition to skipping animated meshes.
    • Added functionality for Inflow/Fluid objects to emit fluid in the direction of the object's local axis.
    • Fixed issue where inline force field documentation links would not be consistently displayed when submenu was collapsed.
    • New Complete Guide Episode: Mastering FOAM (part 3a)
  • version 9.0.9.02 (August 5 2020)
    • Latest development update covering this development week: #27
      • Notice: Ryan is back from vacation! Daily support and experimental updates have resumed!
    • Added Domain bake operators to the FLIP Fluid toolshelf menu.
    • Fixed error where some fixes mentioned in previous experimental release notes were not actually distributed in the releases.
    • Fixed compatibility issues on MacOS systems
    • Fixed bug that could cause a crash if viscosity feature was enabled while simulating small amounts of fluid.
    • Removed Preserve Foam options from FLIP Fluid Whitewater UI. These settings were not working as expected and are no longer needed.
    • Updated Documentation: Scene Troubleshooting: Fluid behaviour changes when increasing resolution.
    • New Tutorial: Episode Eight: Layering Fluid to Make Delicious Sweets.
  • version 9.0.9.01 (July 6 2020)
    • Latest development update covering this development week: #26
      • Notice: Ryan will be on vacation starting July 6th. There will be reduced customer support during this time, but you should receive a response within a few days. Regular development and daily support will resume on July 27th. Thank you for your patience!
    • Replaced model dragon model in point_force_dragon.blend example scene with a rhino statue. Unbeknownst to us, the dragon model is a cultural symbol and deforming it with fluid simulation can be seen as disrespectful. We apologize for this mistake and will be more careful int he future.
    • Fixed incorrect setting in volume_force_animated_character.blend example scene where the fluid would drop down immediately instead of following the character (gravity was set to -9.81 instead of 0.0)
    • Tuned internal settings for the Volume Force Object for improved UX
    • Added missing force field documentation links to UI (option to display documentation links in UI can be found in addon preferences menu)
    • Fixed a bug that could cause a crash if a surface/volume force contained all vertices outside of the domain
    • Fixed error where source code was not distributed with experimental build
    • Edited force field documentation topics for changes to new build
  • version 9.0.9.00 (Jun 30 2020)
    • Added force field mode: Point Force, a force that directs fluid towards a single point.
    • Added force field mode: Surface Force, a force that directs fluid towards an object's surface. See development update #13, #18, #19, and #20 for detailed information.
    • Added force field mode: Volume Force, a force that directs fluid towards an the interior of an object's volume. See development update #21 and #22 for detailed information.
    • Added force field grid resolution to FLIP Fluid World panel. See development update #22 for detailed information.
    • Added 'Enable Adaptive Time Stepping for Force Field' option to FLIP Fluid Advanced panel (similar to it's Obstacle counterpart).
    • Added force field debug visualizer to FLIP Fluid Debug panel. See development update #13 for detailed information.
    • Added new example scenes for force field features.
    • Added exponent precision editing for viscosity value.
    • Added exponent precision editing for surface tension value.
    • Added preferences option to rename the FLIP Fluids toolshelf panel name.
    • Added preferences option to display links to relevant documentation in the UI.
    • Added UI reminder to display if the preferences 'Beginner Friendly Mode' is activated.
    • Subsections of the UI panel can now be collapsed (Whitewater/World/Debug panels).
    • Duplicated whitewater particle size option from FLIP Fluid Display Settings panel to FLIP Fluid Whitewater panel.
    • Updated for compatibility with latest version of OctaneRender.
    • Updated whitewater tooltips.
    • Removed Rigid/Deformable mesh option for Inflow object. The simulator will now automatically detect whether the object is rigid or deformable.
    • Fixed issue where changing particle size in the FLIP Fluid Debug particle debugging tool would not affect the draw size.
    • Fixed issue that was causing inflow object to require too much memory. More info in development update #14.
    • Fixed issue where Strawberry Splash example scene was not compatible with newer versions of Blender.
    • Fixed bug where a rare divide-by-zero error could cause the simulation to collapse in on itself.
    • Fixed issue where a mesh containing a zero-area triangle could cause a crash.
    • Fixed issue where an Attribute Error could be displayed when selecting the Domain object.
    • Fixed possible FLIP Fluid Stats alignment issue when selecting a frame that was outside of the cache range.
    • Fixed issue where FLIP Fluid Stats panel could display out-of-date info after a cache reset.
    • Fixed issue where FLIP Fluid toolshelf menu was missing operator to select the whitewater dust object.
    • Improved accuracy of surface tension calculations to improve stability (prevent blow-ups).
    • Improved multithreaded performance of adding new fluid particles into simulation domain.
    • Documentation: Updated installation instructions using Blender 2.8x screenshots.
    • Documentation: Limitations of the FLIP Fluids addon.
    • Documentation: Expanded CPU Usage Topic.
    • Documentation: What is the difference between Blender's Mantaflow fluid simulator and the FLIP Fluids addon.
    • Documentation: Does my obstacle object need to be completely contained by the domain?
    • Documentation: Tips for Creating Ship Simulations.
    • New Tutorial Series: FLIP Fluids addon: The Complete Guide.

Experimental Versions 9.0.6.x

Release notes for experimental versions 9.0.6.x, which correspond to the stable FLIP Fluids 1.0.6

  • version 9.0.6.1 (Sep 27 2019)

    • Added support for Blender 2.81
    • Added reminder in the addon installation/preferences menu to complete installation by restarting Blender. See Installation Instructions.
    • Added warning about Blender 2.80 bugs to the addon installation/preferences menu and system console output. See Blender 2.80 known issues.
    • Added a reminder to prevent render crashes by locking interface in Blender 2.8x to addon installation/preferences menu and system console output
    • Added monochromatic FLIP Fluids icon for Blender 2.8x
    • Fixed issue that could cause frequent Blender 2.8x crashes during render, Alembic export, and rigid/cloth simulation baking (issue #403)
    • Fixed bug where Inflow 'Substep Emissions' value could not be keyframed
    • Fixed TypeError that could be triggered at the end of simulation baking (issue #469)
    • Fixed bug where console output would still be displayed during mesh export when the 'Display Console Output' option was disabled
    • Reduced amount of particle meshing artifacts on boundary of domain
    • Addon no longer automatically deletes the FLIP Fluids cache when closing an unsaved .blend file
    • Addon now automatically adds a smooth modifier (set to 0 iterations) to the fluid mesh objects
    • Addon will now display an error if a user attempts to bake a simulation before completing installation
  • version 9.0.6.0 (Jun 05 2019)

    • This is the initial version of the 9.0.6 experimental branch. This branch will eventually be merged into the next stable 1.0.6 version.
    • Added operators to toolbox menu to automatically launch command line baking and rendering processes (Feature only supported on Windows)
  • version 9.0.5.5 (May 17 2019)

    • Try it out! This version is considered stable and 'production ready' as long as you are using Blender 2.79. See Blender 2.80 known issues.
    • Fixed addon errors in Blender 2.80 due to recent API change (issue #448)
  • version 9.0.5.4 (May 09 2019)

    • Try it out! This version is considered stable and 'production ready' as long as you are using Blender 2.79. See Blender 2.80 known issues.
    • This versions is NOT compatible with older FLIP Fluids cache directories. Please use a newly create cache directory when testing this version.
    • Added meshing options to remove parts of surface mesh near the domain boundary
    • Added meshing options to set offset for fluid-solid mesh interface
    • Added meshing feature to set a custom object as a meshing volume. Only fluid inside of this object will be meshed.
    • Added advanced option to enable particle jittering for surface particles (issue #435)
    • Added option to skip re-exporting animated meshes
    • Added settings and option to set a custom baking frame range instead of using the timeline start/end values
    • Added a savestates feature which gives the ability to rollback a simulation and resimulate from an earlier frame
    • Added functionality to set a sheeting effect strength multiplier against individual obstacles
    • Added a 'Beginner Friendly Mode' to preferences that limits UI to only show the most basic and commonly used parameters
    • Fixed bug where custom particle drawing would not be reset after a cache reset (issue #422)
    • Fixed bug that could cause a sudden Blender crash when using 'Enable Sheeting Effects' (issue #425)
    • Fixed bug where custom logo icon would not be loaded (issue #427)
    • Fixed bug where the intersection between inversed obstacles would be computed as solid instead of empty
    • Fixed issue where Blender could crash during animated mesh export (issue #401)
    • Fixed bug where surface tension simulations could 'explode' (issue #420)
    • Fixed Linux/MacOS bug where a simulation could stop in the middle of baking. Huge thanks to Christian Schwarz for helping us solve this issue!
    • Improved support and compatibility for loading .blend files created in older FLIP Fluids versions
    • Improved speed and stability of animated mesh export (issue #401)
    • Performance improvements
    • Simulation stability improvements
  • version 9.0.5.3 (Feb 01 2019)

    • Added support for missing features in Blender 2.80 (issue #404)
    • Added sheeting effects feature to World panel (Documentation)
    • Added 'Surface Tension Stability' parameter to World panel (Documentation)
    • Misc material and preset library fixes
    • Fixed bug where particles could escape the domain and trigger an 'Out of Range' error (issue #415)
    • Fixed precision error what could cause fluid meshes to be scaled incorrectly (issue #414)
    • Fixed bug where debug information would be drawn when domain object is hidden or not on selected layer (issue #416)
    • Fixed bug where estimated surface tension substeps could have a negative value (issue #417)
    • Fixed bug where the 'Reload Frame' operator could ignore reloading a frame (issue #419)
    • Fixed bug where simulation could crash when resuming a bake
    • Setting inflow 'Substep Emissions' to 0 will cause the inflow only emit fluid on the first substep of a frame (Documentation)
    • Updated surface tension parameter to a more appropriate/stable default value
    • Moved 'Surface Tension Safety Factor' to World panel as 'Surface Tension Accuracy' (Documentation
    • Obstacle 'Expand' setting now has small soft min/max value restrictions to guide users towards smaller values (Documentation
    • Improved collisions with animated obstacles
  • version 9.0.5.2 (Dec 24 2018)

    • Fixed addon install error in Blender 2.80 due to API change (issue #408)
    • Fixed 'Value must be greater or equal to zero' error that could be triggered if domain bounding box is too thin (issue #397)
    • Fixed bug where deleted objects could be exported to the simulator (issue #405)
    • Improved simulation handling of thin obstacles to prevent leaking
    • 'Check for Updates' operator now displays release notes for experimental versions
    • Performance improvements
  • version 9.0.5.1 (Dec 13 2018)

    • Added support for Blender 2.80 (issue #404)
    • Fixed bug where Blender could crash while rendering in Cycles with the viewport open (issue #403)
    • Fixed bug where copper preset could be loaded as coffee preset
    • Added checkbox to Presets Panel to allow auto assigning presets
    • Updated default whitewater spray drag coefficient to add more drag to spray particles
    • Rolled back some stability improvements that were causing volume increase (issue #326)
    • Meshing improvements
    • Performance improvements
  • version 9.0.5.0 (Nov 19 2018)

    • Added feature to control amount of whitewater generated by Obstacle objects (issue #385)
    • Added a surface tension solver (issue #388)
    • Added new surface tension example scenes (Documentation)
    • Updated Whitewater panel UI with Basic/Advanced settings modes (issue #384)
    • Fixed 'ResourceWarning' error when disabling and re-enabled addon
    • Fixed bug that would cause bumpy mesh artifacts on edges of domain (issue #380)
    • Fixed bug where bake would continue to run after closing Blender (issue #361)
    • Performance improvements
    • Simulation stability improvements

Related Topics