logo liquifeel

Blender 4.1+

Get up to speed

We strive to make Liquifeel is easy to use. Watch the video to get started quickly. Should you need more info, check the Complete Guide below.

Full Documentation

Learn how to…

Install Liquifeel 1.0

Video Guide

  1. Download the Add-on.

    Obtain the Liquifeel_v1.0.zip file from BlenderMarket or GumRoad.

  2. Add Liquifeel to Blender!

    Blender 4.0 or later is required to run the add-on correctly.

    Launch Blender and navigate to Edit > Preferences in the menu. In the Preferences window, switch to the Add-ons tab.
    Click the Install… button and navigate to the location where you downloaded the Liquifeel_v1.0.zip file.
    Select the file and click Install Add-on.

  3. Activate add-on:

    Use the search bar in the Add-ons tab to find “Liquifeel.”
    Check the box next to the Liquifeel add-on to activate it.
    Click Save Preferences to apply the changes.

  4. Accessing Liquifeel:

    Once installed and activated, Liquifeel can be accessed in the N-menu Panel.

Use Liquifeel's UI

Video Guide

    1. Understanding the UI.
The Liquifeel Add-on has 3 main tabs: Geometry tab: for controlling the liquid. Shading tab: for customizing materials. Recipients tab: to choose a preset liquid container.
    1. Recipients Tab:
  Go to the Recipients tab. Choose a preset liquid container from the available options. After selecting the asset, add it to the 3D Cursor in Blender.
    1. Geometry Tab:
In the Geometry tab, locate the “Fill Active” option. Click on “Fill Active” to apply the liquid to the selected object.
    1. Shading Tab:
In the Shading tab, you can choose to shade both the container and the content inside it. Select between the options: “To recipient” and “To liquid“. Choose from the Material Library or add your Own Materials to customize the shading.
Add Liquid inside a recipient

Video Guide

  1. Adding Liquid to straight-opening recipients
    To add liquid geometry to a recipient mesh that has a horizontally straight opening (mouth), select the mesh and click  Fill Active button
    By default, the Opening Shape is set to StraightOpening Shape Dropdown

    Mesh Geometry requirements for operator to work correctly:
    a. Mesh must be Single island (the recipient’s topology is represented by a single contiguous set of faces that are connected by edges and vertices)
    b. Recipient mesh must have thickness.

    c. Recipient mesh must be concave and the opening (or mouth) should be pointing upwards.
    d. Recipient must have realistic scale
    e. Object should not be an instance and should have applied scale and rotation.
  2. Liquid Amount
    Control how much of the recipient is filled by adjusting the Liquid Amount sliderFoam Amount slider
    By default, the Liquid Amount is set to 50. This represents a percentage of how much of the recipient’s volume is filled, from the bottom to the opening (where liquid would overflow).
  3. Adding Liquid to irregular-opening recipients
    If the object respects the requirements above, yet when clicking Fill Active nothing happens, the recipient might have an opening that is not horizontally straight and needs a different algorithm. For example, if it’s a carafe, it might have a draining beak.
    In that case, Irregular opening has to be selected from the Opening Shape dropdown and the Lip Threshold amount has to be increased until the liquid geometry appears.Opening Shape Irregular dropdown
    In this case the carafe was filled only when the Lip Threshold was adjusted to 2.3. Increase the Lip Threshold progressively until the liquid geometry appears, if the object appears to have an irregular opening.
  4. Liquid Behaviour
    Once liquid geometry has been added, the algorithm simulates how liquids behave in reality when the recipient is inclined (rotated).
  5. Seal Container
    If checked, the Seal Container option disables the liquid draining at the opening. Therefore, the liquid now appears to have an invisible lid blocking it from flowing out. Useful for instances where you want the liquid to stay inside even after rotating the recipient, like for example when you want to place a capped bottle on its side.
Add Shaders to objects

Video Guide

  1. Shading an asset without filling

    To apply a shader from the Liquifeel material library to the selected object, click Shade Active button in the Shading Tab

  2. Selecting the library

    Liquifeel comes with two libraries of shaders: Liquids and Solids. You can switch between them by accessing the Library dropdown. Libraries dropdown
    Additionally, you can select “Scene Materials” which gives quick access to all the materials already in the scene. Scene materials dropdown
    This is important, because once an asset is shaded using Liquifeel, the material in the material slot should not be manually changed in Blender’s standard interface. Scene materials are also made available through Liquifeel’s interface and should be added through this functionality

  3. Selecting the Shader

    To select a shader from the library, click on the large thumbnail.Liquid Thumbnail
    A dropdown will appear to give you access to the various shader presets in each library.Liquid Shader Library dropdown
    Beneath the thumbnail, you will see the name of the currently selected shader preset.

  4. Shading a filled object

    To apply a shader from the Liquifeel material library to the selected filled object, click Shade Active button
    Two extra buttons (selectors) will be available for objects that have been previously filled, which determine to which mesh the shader is applied.

    If the “toRecipient” selector is active, the shader is applied to the surface of the original mesh.toRecipient button If the “toLiquid” selector is active, the shader is applied to the generated geometry inside the original mesh.toLiquid button

  5. Modifying Presets

    Shader presets come with a variety of settings that can be altered. Beer Settings
    The number and type of settings are different between different shader presets.

    Some common settings for shaders in the Liquids library are:

    Sets the main color of the shaderColor for liquids

    Foam Amount
    Determines how much of the liquid height is represented by foam. Increasing the amount will convert more of the liquid to foam, starting from the top and expanding downwards.Foam Amount slider
    The foam amount is relative to object size and total liquid level, therefore it is necessary sometimes to increase the amount until it becomes visible.
    Foam Amount Example image

    Determines whether the liquid contains carbonation bubbles. If checked, two more controls become available – Amount and Size.
    Carbonation example image

    Other settings can include turbidity, color intensity, etc. Some are specific to a single shader preset.

Use Uber Materials

Video Guide – Uber Glass

Video Guide – Uber Liquid

Text Guide – Uber Glass

  1. Understanding Uber Glass Material:

  2. The Uber Glass material consists of 2 customizable sections:

  3. Customizing Glass Section:

  4. In the Uber Glass material, locate the Glass section.
    Adjust parameters such as glass color, index of refraction, rim darkness, dispersion, and glass roughness to achieve the desired appearance for the glass material.

  5. Customizing Pattern Section:

  6. Utilize this section to add a pattern to the glass.
    Choose between using a preset texture or your own texture, you can switch between the two different approaches based on your preference.
    Adjust the texture resolution to control the quality of the applied pattern.
    Determine the texture extrusion to define how much the pattern protrudes from the surface of the glass.
    Customize the pattern size and its limits to control the scale and distribution of the pattern on the glass surface.

Text Guide – Uber Liquid

  1. Understanding the UI.

  2. The Uber Liquid material consists of 5 customizable sections:


  3. Customizing Liquid Section:

  4. In the Uber Liquid material, locate the Liquid section.
    Adjust parameters such as liquid color, transmission, intensity, turbidity, subsurface, and particles opacity to achieve the desired appearance for the liquid.

  5. Customizing Foam Section:

  6. Configure parameters to adjust the bubbles of the foam and its color.

  7. Secondary Foam:

  8. Utilize the Secondary Foam section to make changes to the general appearance of the foam when mixing with the primary foam.

  9. Smoothie Transformation:

  10. Explore the Smoothie section to transform the liquid into a smoothie texture, with control over the pulp visibility.

  11. Carbonated Liquids:

  12. When carbonated liquids, navigate to the Carbonation section. Customize parameters to adjust the appearance of bubbles in the carbonated liquid.
Add Recipients from the Library

Video Guide

Adding Recipients from the Library

  1. To add a Recipient asset from the Liquifeel library, go to Recipients Tab
  2. Then to access the library click on the large thumbnail that signifies the currently selected asset
  3. This will open a dropdown window containing the thumbnails of all the other assets. Click on any one of them to select the corresponding asset.

  1. To add the selected asset to the scene, click Add asset to 3d cursor button

There are various situations when the add-on might not work as you expect. We have compiled a list of common issues, but it may not be exhaustive.

  1. No liquid is added when Fill Active is clicked

    a. Check if the object conforms to the requirements: it should be oriented upwards, have thickness and consist of a single mesh island. 
    b. Check if the opening is Straight or Irregular: press Num3 or Num1 to go to a side view and make sure the opening is horizontally straight. If it’s not, switch to Opening Shape Irregular dropdown and increase the value for Lip Threshold until liquid becomes visible.
    c. If liquid was added before, then undo was triggered – press Clear before trying to use Fill Active again.

    If none of these work, contact support via the Discord Channel. We’re happy to help, if we can.

  2.  The upper liquid surface has uneven surface or shading artifacts
    a. If the Recipient is rotated, lower the Liquid Amount a little until the surface becomes smooth.
    b. Press apply and manually correct the geometry, if a. doesn’t work.

Our Mission is to push Blender forward and aid its amazing community by providing tools and know-how that we have obtained in the 20+ years of combined experience. Blender has played a pivotal role in each of the creatives in the team that made Liquifeel and we feel grateful for that. 

Looking to the future, we would love to be a part of Blender’s progression and craft tools for our creative brethren that we ourselves enjoy. We hope you enjoy Liquifeel and everything that will hopefully come in the future. 

Contact Us: