Troubleshooting

The Object Launches Upward

Lower these values:

• Buoyancy Strength
• Max Point Force
• Point Radius

Also check that float points are not far below the hull.

The Object Does Not Float

Check:

• Surface is assigned on WaveBuoyancy.
• The object has a non-kinematic Rigidbody.
• Float Points is not empty.
• Float points are near or below the waterline.

Motion Feels Sharp

Try:

• Increase Height Smoothing for vertical motion.
• Increase Normal Smoothing for roll and pitch.
• Increase Water Angular Drag if rotation is too fast.

The Ship Does Not Tilt Enough

Try:

• Increase Surface Normal Influence.
• Lower Water Angular Drag.
• Lower Upright Stability.

The Setup Menu Creates Only Water

This is expected. Create Basic Demo Setup creates the water surface, profile, and material only.

Add boats and buoys manually, then attach WaveBuoyancy and WaveFloatPoint components.

Missing Reference Errors in the Inspector

If Unity reports a destroyed object while drawing the Inspector:

1. Click another object in the Hierarchy.
2. Clear the Console.
3. Make sure the Inspector is not locked.
4. Reopen the scene if the old selection remains cached.