Physics including buoyancy and drag.
Related: Floating Objects
Properties¶
Rigid Body |
The rigid body to affect. It will automatically get the sibling rigid body if not set. |
Model |
The model to use for buoyancy. Align Normal is simple and only uses a few queries whilst Probes is more advanced and uses a few queries per probe. Cannot be changed at runtime after Start. |
Align Normal |
A simple model which aligns the object with the wave normal. |
Probes |
A more advanced model which samples water at the probes positions. |
Layer |
Which water collision layer to target. |
Everything |
Include all displacement. |
After Animated Waves |
Only include Animated Waves. |
After Dynamic Waves |
Include Animated Waves and Dynamic Waves. |
Buoyancy¶
Force Strength |
Strength of buoyancy force. For probes, roughly a mass to force ratio of 100 to 1 to keep the center of mass near the surface. For Align Normal, default value is for a default sphere with a default rigidbody. |
Torque Strength |
Strength of torque applied to match boat orientation to water normal. |
Maximum Force |
Clamps the buoyancy force to this value. Useful for handling fully submerged objects. |
Height Offset |
Height offset from transform center to bottom of boat (if any). Default value is for a default sphere. Having this value be an accurate measurement from center to bottom is not necessary. |
Accelerate Downhill |
Approximate hydrodynamics of ‘surfing’ down waves. |
Probes |
Query points for buoyancy. Only applicable to Probes model. |
Drag¶
Drag |
Drag when in water. Additive to the drag declared on the rigid body. |
Angular Drag |
Angular drag when in water. Additive to the angular drag declared on the rigid body. |
Force Height Offset |
Vertical offset for where drag force should be applied. |
Wave Response¶
Object Width |
Width of object for physics purposes. The larger this value, the more filtered/smooth the wave response will be. If larger wavelengths cannot be filtered, increase the LOD Levels |
Use Object Length |
Computes a separate normal based on boat length to get more accurate orientations. Requires the cost of an extra collision sample. |
Object Length |
Length dimension of boat. Only used if Use Boat Length is enabled. |