Baltor Get started

Gallery / Godot components

Probe buoyancy and water drag for RigidBody3D

In your harnessGodot componentMIT

Float a RigidBody3D on water from probe points: depth-proportional upward force per probe, travelling sine waves for the surface height, water drag and signals for entering and leaving the water.

Files, names only

  • ATTRIBUTION.md
  • LICENSE
  • README.md
  • baltor_test.gd
  • buoyancy_probes_3d.gd
  • component.json
  • inspect_gdscript.py
  • run_tests.gd
  • test_package.py
  • tests/test_buoyancy_probes_3d.gd
  • verification/native.json

Full files in your harness.

What it takes and gives

Class
BaltorBuoyancy3D, extends Node
Methods
wave_height_at(point: Vector2, time: float, base_height: float, wave_list: PackedVector4Array) -> float; surface_height(world_position: Vector3) -> float; probe_force(depth: float, mass_share: float) -> float; get_submerged_ratio() -> float; get_time() -> float; apply_forces(body: RigidBody3D, delta: float) -> void
Signals
entered_water, left_water
Exports
water_height, waves, probes, probe_depth, buoyancy, gravity, water_drag, water_angular_drag
Placement
res://baltor/godot_components/buoyancy_probes_3d/

Limits. Not a fluid simulation: probes ignore hull shape and displaced volume, and waves are sums of sines without Gerstner sideways motion. Light default drag lets bodies bob for a while. The surface function must match any water shader you pair it with. Verified with Godot 4.7.2 headless; written against the Godot 4.3 API.

Details

Kind
Godot component
Engine
Godot 4.3 or later
Files
11 files, 77.4 KB
Licence
MIT
Declared effects
reads files, runs commands
Checked with
Godot 4.7.2, headless
Checks
godot parse check only, godot gdscript tests, godot tests reject gutted component, godot editor import, godot contract reflection, godot readme usage compiles
Techniques
probe-based buoyancy, sum of travelling sine waves, linear and angular water drag
Tags
buoyancy, water, boat, physics, rigidbody3d, waves, floating
Identity
library.supply.creative_originals.0621f0a7a1e8b06a281823dd.4b05f4596316d962
Version
4b05f4596316d962203af3e9422c41cef5febe1d8a480c995534765fd3d9c875

The version is the SHA-256 of the item your harness downloads; every file in it names its own checksum.

Something wrong with this item, its rights or its safety? Report it on the support page, or from your harness after a download.