Table of Contents

PIDI : XFur Mobile™

XFur Mobile™ is the most complete fur solution for mobile projects made with Unity 3D. With all the power and flexibility of XFur Studio carefully optimized, scaled and ported to mobile devices, XFur Mobile has all the features you need to achieve high quality and detailed fur simulations in your games.

While a wide selection of parameters, settings and shaders is offered to ensure that XFur can be used on lower end devices with an acceptable quality, the system itself and most of its features are targeted to higher end devices with full OpenGLES 3.0 support and a powerful GPU / CPU combination.



Quick Start Guide


In this quick guide we will go through the whole process of using XFur Mobile, from installing the software into your project, preparing a model, adding fur, customizing its parameters and having it ready to use.

As a first step, please ensure that your project fully meets the requirements below :

If your project meets these requirements, then we are ready to move on towards the first steps of this small guide.



Installation & Initial setup

To add XFur to a project there is little to no setup required. If this is a first time installation you just need to head to the Asset Store and find this asset either under the section “My Assets” or by a normal search in the store itself.



If you have bought the asset, a Download / Import / Update button will show, depending on if you have never downloaded the asset before, you have downloaded it and it is in cache already or there is a new version available for download, respectively.



Once the import dialog appears, just import all the contents of the asset as usual. To verify that the asset was imported without any errors try to open one of the demo scenes. If they work without issues, the package has been imported correctly. If you see any graphical errors you must re-import the asset. If the issues persist even with a brand new and empty project, please contact us at our support email



Basic & Full Shader variants

XFur Mobile offers two variants of shaders designed for different levels of hardware and with support for different features, graphical fidelity levels and general performance. These two branches of shaders are the Basic and Full fur shaders.

The Basic shaders are designed for lower end devices with OpenGLES2 capabilities and similar. While they will work on most devices, they are still demanding and will perform better on mid-range phones and tablets.

The Full shaders are designed for higher end devices and require a full, advanced OpenGLES3 capability present only on modern devices (usually released on 2016-17 and newer). They are a mostly direct port of the Desktop version shaders and their features.

Below you can find a full feature comparison between the Full and Basic shaders included with XFur Mobile.

Feature Basic Shader Full Shader
Control fur properties (length, thickness, occlusion, etc) through sliders
Control fur properties (length, thickness, occlusion, etc) through texture
Fur grooming and fur direction control X
LOD module support and dynamic quality changes
Physics module and real-time dynamics X
FX module support for snow and other effects X
Randomization module
Support for wind effects Limited
Mix-colored fur strands Limited
Texture-colored fur strands

We encourage you to test thoroughly which branch of shaders adapts better to the target devices of your project.



Preparing your 3D models

XFur Mobile is compatible with both regular and skinned meshes (meshes for animated characters, with a rig). Most models will work with XFur Mobile without requiring any changes nor modifications, there are a few requirements that is recommended that your model meets in order to take full advantage of XFur Mobile.

For the examples of this Quick Start guide we will be using a very high quality model developed by Malbers Animations, the Realistic Raccoon model on its LOD3 variant, from the Realistic Raccoons and Red Panda package that you can get in the Unity Asset Store. We want to thank Malbers Animations for sharing this model with us for the purpose of testing XFur and for this small tutorial.



For this particular model, to ensure it will work with XFur Mobile without any issues, we set the rotation of the mesh (called Racoon Body LOD3) to be 0,0,0 instead of its original value of -90,0,0. We also set the Root Bone in the Skinned Mesh Renderer component to be the Raccoon Realistic root object instead of the Pelvis transform that it has assigned originally. This does not affect the animations in any way, but allows us to recalculate the normals in a more accurate way internally, which is necessary for XFur Mobile to use the more advanced features such as snow coverage.

Finally, we re-adjust the bounds by hand to make sure that they are bigger than the mesh itself, otherwise our model will stop rendering while it is still in frame due to the bounds not being correctly placed.

Following these requirements will ensure that your models take full advantage of XFur Mobile, have the best performance possible and that all features and effects work without errors.



Adding fur to a model

Adding fur to this model is a straightforward task. We will first create a core XFur material for our entire project. For this tutorial, we will call this material XFur Tutorial mat. Once created, we will assign the twelve samples shader from the Full branch to our material.



Once the shader is assigned, the material will display the custom shader inspector for XFur Mobile. Since most of the features of the material are controlled by each XFur instance (and this is actually the intended behavior) we will not touch most of them. We will only assign the XFur_FurLayers1 map to the FUR GEN MAP slot and set the FUR CUTOFF value to 0.03



We then assign our material to the Racoon Body LOD03 mesh. The mesh will appear to explode, which is perfectly normal since most of the data XFur needs is not yet present.



Now, we will assign the XFurMobile_System component to the mesh. After loading it, the component will inform us that we do not have a database asset assigned to it. We will solve this now, before proceeding.



Inside the XFur Studio Mobile folder, in the Database Module subfolder you can find a Database Asset pre-packaged with our tool. However, since this database gets overwritten with every update we release, you should not use it directly for your project. Instead, we will simply select it, press Ctrl+D to duplicate it, and store it somewhere else in our project.



Once we have our database ready to be used, we will assign it to the XFUR DATABASE ASSET slot in the UI of the XFur Mobile System component. The Unity Editor will freeze for a few seconds as the mesh of the raccoon character is being automatically copied, patched with the needed data, and stored safely in the database. This allows you to keep your original mesh untouched while providing XFur with everything it needs. Once the patching process is over the XFur Mobile UI will show all the available options.



We will open now the XFUR - MAIN SETTINGS TAB and set up some first parameters that will allow us to control the fur carefully. We will first set the FUR SAMPLES value to twelve (more samples = higher quality strands = lower performance), the QUALITY MODE to full and both the BASE SKIN MODE and the FUR SETTINGS MODE to be FROM INSTANCE rather than FROM MATERIAL. These last two options will allow us to override the material parameters on each object, which can let you share a single material across every single fur covered character in your game.



A BASE SKIN block of settings followed by a FUR SETTINGS block will appear in the UI. In the BASE SKIN block, we will assign the corresponding texture of the Raccoon to our MAIN TEXTURE slot, set the MAIN COLOR to a dark gray (to simulate the shadow from the fur) and adjust any other values we wish.



On the FUR SETTINGS block, we will set the FUR COLOR A and FUR COLOR B to a light gray color (you can play with these values until you get the result you want) and assign the same Albedo texture from the Raccoon to the FUR COLOR MAP slot.

We will also play with the RIM COLOR and RIM POWER values (which adjust the backlight effect on the fur) as well as with the FUR LENGTH and FUR THICKNESS. For the best results, you can try to copy the values in the following picture into your own object. Remember that Fur length values are most of the time very small to produce accurate, good looking results



For now, since we will not paint any additional data nor groom our character yet, we will also set the GROOMING ALGORITHM to ACCURATE and the FUR DIRECTION value to 0,0,0. Following the steps detailed above and copying all the parameters shown in the pictures will give us a great baseline to start working with our character and, in some cases, it will be everything we need to do, depending on the results you want.



However, if your character needs additional details or more refined control over the appearance of the fur, its length, direction, etc. then you should continue reading this guide and move on to the XFur Painter section, where we will cover the basics of XFur Painter, the included tool to work over all the small details of your character's fur within the Unity Editor and through the use of easy, simple brushes and strokes.





XFur Painter

First, let's save our work. Create a prefab of the Raccoon model (or any model you are using) with all the XFur settings and parameters we have set up to this moment.

IMPORTANT : XFur Painter is NOT compatible with the Basic variants of the Fur shaders. You need to set your character to use the Full variants in order to use XFur Painter. Once you finish, you can switch back to the Basic variants

Then, open the XFur_Painter scene included with this asset. Once opened, disable the demo model of the dog from the root game object. XFur Painter will automatically detect the active object in the scene and leaving the German Shepherd in there will interfere with the Raccoon we want to paint. Once the German Shepherd is disabled, place the prefab we just made in the center of the scene, at location 0,0,0 and with a rotation of 0,0,0.

If your character has places that you believe will be difficult to reach (such as the inside of the mouth, under the arms, etc) you should modify its pose by hand to one that is easier to manage. In our case, we will open the mouth of the raccoon and disable all the unnecessary meshes such as the upper and bottom teeth, and the whiskers.



Once the model is ready, you just need to hit play and XFur Painter will start. To see a detailed timelapse of how to use XFur Painter, please watch the video below.



The brushes available in XFur Painter are divided in Appearance Tools and Grooming tools. The appearance tools are, from left to right, Fur Shaving, Fur Length, Fur Shadowing and Fur Thickness. You can switch between the addition and subtraction modes of each tool with the left and right buttons of your mouse. You can use the middle mouse to rotate around the character or pan if you keep Left Shift pressed as you drag your mouse with the middle button.



Once you are happy with the results you achieve in XFur Painter, you must click on the Export Fur Data button and save the resulting fur data maps somewhere in your project. Once this process finishes, you can stop the application. Your character will seem to have lost all fur data, but if you assign the Fur Data maps you exported to the corresponding slots of the XFur UI (the length map goes on Fur Data 0 while the grooming map goes on Fur Data 1) that information will be restored.

IMPORTANT : The Basic branch of Fur shaders does not work directly with the fur data maps exported by XFur painter. The fur length, specifically, does not work immediately since it cannot be read on Shader Model 2.0 level shaders (such as the Basic shaders). In order to make the fur data maps painted in XFur Painter with the Basic shaders you have to assign the map in the corresponding slot and then click the Rebuild Data button. This will bake additional information into the mesh, allowing the data to be read by the shader.



While XFur Painter is versatile enough to provide high quality results in most meshes, there are a few situations in which XFur Painter will not be able to reach certain areas or in which the groom will not work properly (for example, in cases where the character is mirrored). We suggest you to experiment and see which feature, applied in which way fit better. Since the Fur Data maps are plain textures it is easy to add even more detail in programs such as Adobe Photoshop, GIMP, etc.



Further Learning



There are many more things you can do with XFur Mobile, from switching different Fur Layer / Fur Noise maps to achieve different styles of fur to using physics, advanced LOD, randomization to generate dozens of instances with different fur variations, snow and blood effects and much much more. Please read carefully the next sections of this online documentation to learn in detail everything you can do with XFur Mobile.



With XFur Mobile, the possibilities for your fur covered characters are limitless, to bring your mobile projects to the next level.




XFur Mobile - Reference Manual


This online documentation is regularly updated as new features are added to XFur Mobile. It contains detailed descriptions of every component, feature and setting of XFur Mobile. Many of the topics covered here are quite advanced so we recommend to read thoroughly through all the sections before using these features in your projects.


XFur Mobile - Components


Fur rendering in XFur Studio and XFur Mobile depends on a wide array of components and data to ensure the best balance between quality and performance. Thanks to its unique design and the careful tuning done over more than a year through every section of the system, XFur can achieve the best fur rendering for Unity available.

These main components that control fur rendering in XFur Mobile are :

XFur Mobile comes with all the assets, shaders and noise maps you will need to start adding fur to your characters, to ensure that everything works as “out of the box” as possibly.


XFur Mobile - System Modules


XFur mobile has different Modules that add new, advanced features to the fur simulation. From LOD management and dynamic performance adjustments to full randomization and physics, these modules offer a whole new array of possibilities for the fur simulation that XFur Mobile provides.


LOD Module

The LOD Module is fairly simple to use. It controls the quality of the fur in samples as the object gets closer or further away from the camera.



The LOD MODE setting controls whether the LOD Module will have a bias towards higher quality fur, switching to higher sample counts at a greater distance or towards performance, keeping the sample counts low unless the camera gets very close to the object.

The MAX DISTANCE slider controls after which distance the fur will switch to the lowest sample count. This is useful to control performance and ensure that the objects far away in the distance do not consume as many resources. While you can combine this with the Standard LOD Module included with Unity, you may need to add a XFur component to every LOD level of your model and it may introduce some conflicts with the way XFur works, since it directly interacts with the render in the middle of the XFur normal processes. Please keep in mind this when designing how your LOD system will work.


Randomization Module



The randomization module allows you to assign different fur profiles or even completely random parameters to the fur of your characters at runtime easily. These changes are applied on startup, but they can also be called at will from code at runtime.

For each Fur enabled material that your model has, you can assign any number of fur profiles with information about fur length, thickness, occlusion, color, textures etc. These profiles are created by setting up any configuration you want in your characters and then pressing the EXPORT PROFILE button.



IMPORTANT : You can also use these profiles to switch fast and easily between different fur configurations as if they were templates by just dropping them into the LOAD FUR PROFILE slot in the XFUR - MAIN SETTINGS tab.

Once you have exported a few profiles, you can assign them in the list for your material, adding or removing as many slots as you need.

If you enable the RANDOMIZED PARAMETERS feature, the randomization module will take two of the profiles you assigned and iterate over every single parameter, getting a random value for each one of them that is contained between the original values of both profiles. This way, for example, you could have a clear colored profile with short fur and a dark colored one with long fur and enabling the RANDOMIZED PARAMETERS feature would give you random fur variations that take the clear and dark profiles as its min. and max. variation points.


Physics Module

The physics module is a quite demanding one, since it has to perform expensive computations to simulate physics over the fur strands. These operations have been heavily simplified in XFur Mobile to ensure a stable performance, with the compromise that they are not as accurate as a real physics simulation would be.

Despite this, in most cases (especially in creatures with long fur) it can produce a more believable result by adding subtle movements and reactions in the fur as the character performs its animations.



The BASIC MODE limits the physics simulation to a fairly simple approximation based on bones movement. The ANGULAR FORCES setting allows the rotation of both the object and the bones to affect the fur's movement.

PHYSICS ITERATIONS refers to the number of calculations that can be performed, at max, on a single second. These are also dependent on the amount of vertices of the character so in a very complex character the max amount of iterations may not be reached if it is set to a high number, since in these cases performance is prioritized.

PHYSICS SENSITIVITY refers to the amount of movement that the bones have to perform before they are tracked by the physics simulation, while PHYSICS STRENGTH controls the amount of influence the bones and object's movement will have over the fur

Finally, the GRAVITY STRENGTH is the amount of force that will be applied downwards to the whole fur and INERTIA STRENGTH controls the way that the forces applied to the fur will slow down with some slight inertia after the bones/object have stopped moving.


FX Module

The last module available is the FX Module. The FX Module controls the special effects applied to the fur, particularly the weather effects (wind, snow, water) and the blood effects. These effects can be applied either through the global weather system, through a global direction to specify wind, snow and rain or through collisions with other objects and particles, using the FX_Collision, FX_Volume and FX_Particle components.

The AUTO NORMAL UPDATE setting lets the component update the normals direction as the character is being animated ensuring that some effects, such as the snow coverage, always fall on the faces that point upwards regardless of the pose of the character. This way, even if the character is laying down for example, the snow will fall accurately on top of it.

The MAX ITERATIONS and the VERTICES BUFFER values work similarly to those in the Physics Module. The LOCAL WIND STRENGTH is a modifier to control how much does the wind affect the fur. This allows you to control the intensity of the wind on a per instance basis on top of the global control that the XFur_WeatherSystem allows.

For each effect, you can control the way it will be applied to the fur, either GLOBALLY (through the Weather System) or ON DEMAND (with the Collision / Volume / Particle components or through code ). You can also control the color, specularity and smoothness of every effect, their falloff (to control how much they spread), penetration on the fur strands and even how long they take to fade out

IMPORTANT : For better results, please assign a FX Noise texture to your fur material on the ADDITIONAL SETTINGS tab, in the FX PARAM NOISE slot. These textures contain special channels that give a better appearance to snow and blood when applied over the fur



The FX_Collision module will apply boold, snow or water effects over the fur in the points where it detects a collision with the character. The FX_Volume will do the same but for any section of the model that enters the volume. Finally, the FX_Particles component will make the particles of a particle system apply fx over the fur upon colliding with it.



The XFur_WeatherSystem component is quite self-explanatory, offering you easy to understand controls over wind, snow and rain effects.



Using these components and the FX Module amazing results can be achieved in the Full variant of shaders. These results are not only available for mobile devices however, and have been successfully used on Desktop and even VR projects.



XFur Mobile API


XFur Mobile is intended to be used through the different UIs and tools to make the whole workflow as easy as possible. However, for advanced users and very specific situations you have some functions and interfaces available that grant you access to different parts of the system.

All XFur classes are contained within the XFurStudio namespace. To call any function from the XFur system or any of its components, you must write using XFurStudioMobile at the top of your C# script.

The main entry point for any function is the XFur System Component. Usually, in your scripts, you would access it like this :



Where gameObject is the target object from which you want to access the XFur_System component.

To access the fur properties of any of the materials, you use the FurProfiles interface and the index of the fur material you want to edit. After this, if you have auto-complete enabled on your coding IDE, you should see all the available methods and variables with a small explanation of what they do :



Any function that does not have a description should not be called by your scripts, as they are most surely intended for internal use only. Do not call nor use any internal function unless you are sure of what you are doing.

The main functions that you can call from other scripts and that you may need at some point in the development of your project are the following :

On XFurMobile_System.cs :



This function lets you assign a fur profile (profile) to the XFur system manually, to the specified fur material (material Index). This is useful if, for example, you are allowing your players to customize their characters and need to let them choose among a series of fur patterns. Simply assign the profile that corresponds to the choice of the player, and load it with this function to make the system load all the fur properties.



Forces all materials (or the specific material with index equals to profileIndex) to update and apply any changes that you have made.

WARNING : Once an XFur System component is added to an object, it will override and take control over the Materials array of said object's renderer. If you want to swap the materials of the object at runtime through code you need to override both the original material from the corresponding XFur material profile (this step is optional on Unity 2018.3+) and the material itself on the sharedMaterials array of the renderer :



Do not swap a XFur material for another XFur material. Use Fur Profile Assets instead.