Skip to content

Data Assets

UDRW_WaveDataAsset

Purpose: Configures ocean wave physics: spectrum type, wind, damping, amplitude, and WPO.

Used by: GridManager (WaveDataAsset property).

PropertyTypeDefaultRangeDescription
DisplayNameFText::Human-readable name.
DescriptionFText::Description text.
bEnableFFTbooltrue:Enable FFT simulation.
SpectrumTypeenumPhillips:Phillips, Pierson-Moskowitz, or JONSWAP.
WindSpeedfloat25.01–80Wind speed (m/s).
WindDirectionFVector2D(1, 1)-1 to 1Wind direction.
WaveAmplitudeFVector4(4 ×4)0–64Wave strength per cascade.
SmallWaveDampingFVector4(4, 2, 1, 0)0–64Short wave damping per cascade.
LargeWaveDampingFVector4(0.25, 2, 4, 6)0–64Long wave damping per cascade.
WindInfluenceFVector4(1 ×4)0–16Wind alignment.
OpposingWaveFactorFVector4(0.125, 0.25, 0.5, 1)0–128Counter-wind wave reduction.
PatchLengthFVector4(6400 ×4)0–16384Cascade patch size.
DomainSizeFVector4(6, 7, 8, 6)0–16384Domain size.
WPOStrengthFVector4(1 ×4)0–10World position offset per cascade.
WPODirectionFVector(1, 1, 1)-1 to 1WPO direction.
NormalStrengthfloat40.01–128Surface normal intensity.
DetailNormalStrengthfloat0.250–128Detail normal layer.
DetailNormalTilingfloat32.00–512Detail normal UV tiling.
JONSWAP only
GammaFVector4(3.3 ×4)1–10Peak enhancement factor.
AlphaFVector4(0.076, 0.114, 0.152, 0.228)0.001–1Energy scaling.
PeakOmegaFVector4(0.7, 1.1, 1.6, 2.5)0.1–10Peak frequency.
SigmaLow / SigmaHighFVector40.07 / 0.090.01–0.5Spectral width.
Pierson-Moskowitz only
PMAlphaFVector4(0.048, 0.048, 0.064, 0.096)0.001–1PM energy scaling.
PMPeakOmegaFVector4(1, 1.5, 2, 4)0.1–10PM peak frequency.

UDRW_VisualDataAsset

Purpose: Configures ocean visual appearance: lighting, color, foam, caustics, depth, underwater effects, and color correction.

Used by: GridManager (VisualDataAsset property).

PropertyTypeDefaultRangeDescription
Lighting
Roughnessfloat0.20–1Surface roughness.
Specularfloat1.00–1Specular intensity.
Anisotropyfloat0.20–1Reflection stretching.
SurfaceSpecularfloat4.00–16Glancing angle specular.
Phase / Phase2float0.8 / -0.2-1 to 1Scattering phase.
Refractionfloat1.0331–5Refraction index.
Color
AbsorptionColorFLinearColor(0.193, 0.092, 0.090):Absorption color.
Absorptionfloat0.0650.001–1Absorption rate.
ScatteringColorStrengthfloat3.00–4Scattering color.
BaseColorStrengthfloat2.00–4Base color influence.
HueShiftfloat-60.0-180 to 180Hue rotation.
GeneralStrengthfloat64.00–64Ambient / backside.
Foam
FoamAlphaContrastfloat-0.1-1 to 1Foam mask contrast.
FoamStrengthfloat1.50–16Foam intensity.
FoamColorFLinearColor(0.727, 0.816, 1.0):Foam tint.
Caustics
CausticsStrengthfloat1.00–10Caustics intensity.
CausticsChromaticfloat0.30–1Chromatic aberration.
Underwater
BlurIntensityfloat1.00–10Underwater blur.
DepthIntensityfloat2000.00–100000Depth fog distance.
DistanceIntensityfloat20000.00–100000Distance fog.
VignetteIntensityfloat1.30–10Vignette strength.
Color correction
Offset / Gain / Brightness / Contrast / SaturationFLinearColoridentity:Post-process color grading.

Beyond the headline tables above, VisualDataAsset exposes finer-grained tuning categories: sensible defaults are baked in, edit only when you need control:

  • Color extras: AmbientStrength, BacksideStrength, PeakWaveHeight, PeakWaveStrength, BaseColorStrength.
  • Foam extras: FoamNormalStrength.
  • Caustics extras: CausticsInteractionStrength.
  • Depth extras: DepthNormalStrength, DepthFoamStrength.
  • Smoothing: NormalSmoothing, RoughnessSmoothing, SpecularSmoothing (soften LOD-transition popping).
  • LOD Transition: six fields biasing the colour blend across cascade layers.
  • Underwater extras: CausticsDepthIntensity, CausticHueShiftIntensity, CausticsStrengthIntensity, ColorIntensity, ColorHueShiftIntensity, RefractionIntensity.

These categories don’t exist on WBVisualDataAsset (water bodies have a smaller surface: no LOD cascades).


UDRW_WBVisualDataAsset

Purpose: Visual appearance for discrete water bodies (pools, lakes). A flat, calm-water variant of VisualDataAsset.

Used by: WaterBody base class (VisualData property).

Shared with VisualDataAsset (same defaults): Lighting category (Roughness, Specular, Anisotropy, SurfaceSpecular, Phase, Phase2, Refraction); core Color category (AbsorptionColor, Absorption, ScatteringColorStrength, BaseColorStrength, HueShift, GeneralStrength, AmbientStrength, BacksideStrength); core Foam (FoamAlphaContrast, FoamStrength, FoamNormalStrength, FoamColor); core Caustics (bEnableCaustics, CausticsStrength, CausticsChromatic); Color Correction (Offset, Gain, Brightness, Contrast, Saturation); full Underwater set (BlurIntensity, CausticsDepthIntensity, CausticHueShiftIntensity, CausticsStrengthIntensity, ColorIntensity, ColorHueShiftIntensity, DepthIntensity, DistanceIntensity, RefractionIntensity, VignetteIntensity).

Different from VisualDataAsset:

PropertyTypeDefaultRangeDescription
NormalStrengthfloat8.00–16Surface normal (much lower than ocean’s 40: water bodies are calmer).
DetailNormalStrengthfloat1.00–16Detail normal layer.
DetailNormalTilingfloat1.00.01–100Detail tiling.

Not present on WBVisualDataAsset (these are ocean-only): the wave-driven Color extras (PeakWaveHeight, PeakWaveStrength), CausticsInteractionStrength, the Depth category (DepthNormalStrength, DepthFoamStrength, etc.), the Smoothing category, the LOD Transition category. Pools and lakes don’t have wave cascades, depth-driven shoreline shaping, or LOD transitions, so these tunables don’t apply.


UDRW_InteractionDataAsset

Purpose: Configures water interaction effects: ripple, wake, splash parameters, decay, and output limits.

Used by: GridManager, WaterBody, InteractionSubsystem.

PropertyTypeDefaultRangeDescription
General
OverallIntensityfloat1.00.01–10Master multiplier.
DisplacementStrengthfloat1.00–5Height displacement.
FoamGenerationMultiplierfloat1.00–10Foam across all types.
Ripple
RippleHeightScalefloat0.030.001–1Ripple height impulse.
RippleVelocityScalefloat0.060.001–1Ripple velocity impulse.
MaxRippleRadiusfloat200.050–1000Max ripple radius (cm).
RippleStampDurationfloat0.150.01–1Impulse duration (seconds).
RippleLargeObjectReductionfloat0.70–1Intensity reduction for large objects.
Wake
KelvinWakeAnglefloat19.475–45Wake half-angle (degrees). Physical default: 19.47.
WakePatternStrengthfloat0.80–2V-pattern displacement.
BowWaveStrengthfloat0.50–2Bow wave displacement.
WakeEdgeFoamStrengthfloat0.80–2Hull edge foam.
WakeFoamMultiplierfloat1.00–5Wake foam output.
Splash
SplashHeightScalefloat0.040.001–1Impact height impulse.
SplashVelocityScalefloat0.080.001–1Impact velocity impulse.
SplashImpulseDurationfloat0.20.01–1How long an impact splash impulse keeps emitting (seconds).
SplashFoamMultiplierfloat4.00–20Impact foam.
SplashFoamDecayRatefloat1.20.1–5Foam fade rate for splash patches.
ImpactSplashDurationfloat3.00.5–10Total active duration of an impact splash (seconds).
Decay
DecayRatefloat0.20.01–5Effect fade rate.
AdvectionStrengthfloat0.50–1Outward propagation.
DiffusionStrengthfloat0.50–1Spread / dispersion.
WaveEquationSpeedfloat0.40.01–2Ripple propagation speed (c²).
WaveEquationDampingfloat0.020.001–0.5Viscous damping.
Thresholds
MinSpeedForRipplefloat15.01–100Min speed for ripples (cm/s).
MinSpeedForWakefloat200.050–500Min speed for wakes (cm/s).
MinRadiusForWakefloat100.010–500Min radius for wakes (cm).
MinVerticalSpeedForSplashfloat30.010–200Min vertical speed (cm/s) to trigger an impact splash.
Output
MaxDisplacementHeightfloat2.00.5–10Max height clamp.
MaxFlowStrengthfloat2.00.5–10Max flow clamp.
MaxFoamfloat1.00.1–5Max foam clamp.
Wake extras
WakeIntensityMultiplierfloat1.00–5Extra master multiplier on wake outputs.

UDRW_VesselDataAsset

Purpose: Master vessel configuration that aggregates all sub-assets for a complete vessel definition.

Used by: Vessel, VesselPawn (VesselData property).

PropertyTypeDescription
Identity
DisplayNameFTextHuman-readable name.
DescriptionFTextDescription text.
IconTexture2D (soft)Optional thumbnail.
TagsArray<FName>Free-form tags for categorisation.
Configuration
HullHullDataAssetHull configuration. Required for IsValid() to return true.
HydrodynamicsHydrodynamicsDataAssetResistance profile (optional: sensible defaults when null).
StabilityStabilityDataAssetStability profile (optional: sensible defaults when null).
PropulsionSourcesArray<PropulsionDataAsset>Engines, sails, jets, etc. Empty array is valid but the vessel won’t move.
ControlSurfacesArray<ControlSurfaceDataAsset>Rudders, trim tabs, foils, etc. Empty array is valid but the vessel won’t steer.
FunctionReturnsDescription
IsValid()boolTrue when at least the Hull is assigned.
HasEngine()boolTrue if any propulsion source has Type=Engine.
HasSail()boolTrue if any propulsion source has Type=Sail.
GetTotalPowerKW()floatSum of MaxPowerKW across all engine propulsion sources.
GetTotalSailArea()floatSum of SailArea across all sail propulsion sources (m²).

UDRW_HullDataAsset

Purpose: Hull geometry and hydrodynamic form coefficients.

Used by: VesselDataAsset (Hull property).

PropertyTypeDefaultRangeDescription
HullTypeenumDisplacement:Displacement, SemiDisplacement, Planing, Hydrofoil, Multihull.
WaterlineLengthfloat500.010+Length at waterline (cm).
WaterlineBeamfloat150.010+Beam at waterline (cm).
Draftfloat50.01+Hull draft (cm).
Freeboardfloat100.01+Height above waterline (cm).
BlockCoefficientfloat0.50.2–0.95Volume ratio (Cb).
MidshipCoefficientfloat0.850.6–1.0Midship fullness (Cm).
PrismaticCoefficientfloat0.650.5–1.0Volume distribution (Cp).
WaterplaneCoefficientfloat0.750.5–1.0Waterplane area (Cwp).
DeadriseAnglefloat15.00–30Transom deadrise (degrees).

These derive useful values from the hull’s geometry: handy for HUD speedometers, debug overlays, AI decisions.

FunctionReturnsDescription
GetDisplacementVolume()floatApproximate underwater volume from form coefficients (m³).
GetWettedSurfaceArea()floatApproximate wetted surface area (m²).
GetHullSpeed()floatTheoretical “hull speed”: the displacement-mode efficiency limit (cm/s).
GetFroudeNumber(SpeedCmS)floatFroude number for a given speed (dimensionless).

UDRW_HydrodynamicsDataAsset

Purpose: Resistance model, added mass coefficients, and planing parameters.

Used by: VesselDataAsset (Hydrodynamics property).

PropertyTypeDefaultRangeDescription
Resistance
FrictionalMultiplierfloat1.00.1–3Viscous resistance. 1.0 = clean hull.
WaveMakingMultiplierfloat1.00.1–3Wave-making resistance.
AppendageFactorfloat1.11–1.5Appendage drag (rudders, shafts).
FormFactorfloat1.151–23D flow effects (1+k).
LateralDragCoefficientfloat1.50.5–5Sideways resistance.
Added mass
AddedMassLongitudinalfloat0.050–0.5Surge (fore / aft).
AddedMassLateralfloat0.80–1.5Sway (sideways).
AddedMassVerticalfloat0.30–1Heave (vertical).
AddedInertiaRollfloat0.250–1Roll added inertia.
AddedInertiaPitchfloat0.30–1Pitch added inertia.
AddedInertiaYawfloat1.00–2Yaw added inertia.
Planing
bEnablePlaningboolfalse:Enable planing physics.
PlaningThresholdSpeedfloat500.0100+Planing onset speed (cm/s).
PlaningLiftCoefficientfloat0.30–1Dynamic lift when planing.
PlaningWettedAreaRatiofloat0.40.2–1Wetted area ratio vs at rest.
DragCurveCurveFloat (soft)::Custom drag: Froude → multiplier.

UDRW_PropulsionDataAsset

Purpose: Configures a single propulsion source: engine, sail, paddle, oar, or jet.

Used by: VesselDataAsset (PropulsionSources array).

PropertyTypeDefaultRangeDescription
TypeenumEngine:Engine, Sail, Paddle, Oar, Jet.
LocalPositionFVector(-200, 0, -30):Mount position (cm).
bCanSteerboolfalse:Steerable (outboard, sterndrive).
MaxSteeringAnglefloat30.00–90Max steering angle (degrees).
MaxPowerKWfloat150.01+Max power (kW = HP × 0.7457).
MaxRPMfloat6000.0100+Max RPM.
IdleRPMfloat800.0100+Idle RPM.
ThrottleResponsefloat2.00.1–10Throttle response rate.
bCanReversebooltrue:Reverse capability.
ReverseEfficiencyfloat0.60.3–1Reverse thrust ratio.
PropDiameterfloat40.010+Propeller diameter (cm).
PropPitchfloat50.010+Propeller pitch (cm/rev).
PropEfficiencyfloat0.550.3–0.8Propeller efficiency (η).
PropertyTypeDefaultDescription
SailTypeenumBermudaBermuda, Gaff, Junk, Spinnaker, Headsail.
SailRoleenumMainMain, Jib, or Spinnaker. Determines which input action drives this sail. A “main + jib” rig needs one PropulsionDataAsset per role.
SailAreafloat30.0Sail area (m²).
MastHeightfloat12.0Centre of effort height above the deck (m).
SailLiftCurveCurveFloat (soft):Optional: lift coefficient vs apparent-wind angle. Sensible default applied if unset.
SailDragCurveCurveFloat (soft):Optional: drag coefficient vs apparent-wind angle.
PropertyTypeDefaultDescription
MaxHumanPowerfloat150.0Sustainable power output of a human paddler (W). Range: 50–500.
BladeAreafloat800.0Paddle / oar blade area (cm²).
BladeEfficiencyfloat0.65Fraction of stroke energy converted to thrust. Range: 0.3–0.9.

Use one PropulsionDataAsset per oar / paddle. The driving input action is determined automatically by the propulsion Type.

PropertyTypeDefaultDescription
JetMaxThrustfloat5000.0Max thrust (Newtons).
JetNozzleDiameterfloat15.0Nozzle diameter (cm). Range: 5–50.
JetReverseBucketEfficiencyfloat0.65Reverse deflection efficiency. Range: 0.3–0.9.
JetEfficiencyCurveCurveFloat (soft):Optional: efficiency vs intake speed.

Engines support optional curves on the same data asset that override the default torque / thrust models:

PropertyDescription
TorqueCurveEngine output torque vs RPM.
ThrustCurvePropeller thrust vs vessel speed.
TorqueCurvePropPropeller load curve vs RPM.

UDRW_ControlSurfaceDataAsset

Purpose: Configures a single control surface: rudder, trim tab, hydrofoil, centerboard, keel, or thruster.

Used by: VesselDataAsset (ControlSurfaces array).

PropertyTypeDefaultRangeDescription
TypeenumRudder:Rudder, TrimTab, Hydrofoil, Centerboard, Keel, BowThruster, SternThruster.
LocalPositionFVector(-250, 0, -40):Mount position (cm).
RudderAreafloat2000.0100+Blade area (cm²).
MaxDeflectionfloat35.05–45Max angle (degrees).
AspectRatiofloat2.00.5–5Height / chord ratio.
DeflectionRatefloat45.05+Turn rate (deg/s).
MinEffectiveSpeedfloat50.0:Min speed for effectiveness (cm/s).
StallAnglefloat18.010–25Stall angle (degrees).
PropertyTypeDefaultDescription
TrimTabAreafloat500.0Tab planform area (cm²).
TrimMaxDeflectionfloat20.0Max deflection angle (degrees).
TrimActivationSpeedfloat300.0Speed at which trim tabs become effective (cm/s).
PropertyTypeDefaultDescription
FoilAreafloat3000.0Foil planform area (cm²).
FoilSpanfloat150.0Foil span (cm).
FoilTakeoffSpeedfloat800.0Speed at which the foil generates enough lift to fly (cm/s).
TargetFlyingHeightfloat50.0Target hull-above-water height when fully foiling (cm).
FoilLiftCurveCurveFloat (soft):Optional lift coefficient vs angle of attack.

Centerboards and keels share the same lateral-fin model: different Type values, same fields.

PropertyTypeDefaultDescription
LateralAreafloat8000.0Lateral plan area (cm²): controls anti-leeway resistance. Min 1000.
MaxDepthfloat120.0(Centerboard only) Max retract depth below the hull (cm).
BallastWeightfloat500.0(Keel only) Ballast mass (kg). Lowers the centre of gravity, raising stability.

Centerboards are driven by the Centerboard input action: 0 retracted, 1 extended. Keels are static: they contribute lateral resistance and ballast continuously.

PropertyTypeDefaultDescription
ThrusterForcefloat2000.0Max lateral thrust (Newtons).
ThrusterMaxSpeedfloat200.0Speed above which the thruster loses authority (cm/s).

Bow and stern thrusters are driven by their respective input actions.


UDRW_StabilityDataAsset

Purpose: Hull stability, roll damping, and auto-leveling.

Used by: VesselDataAsset (Stability property).

PropertyTypeDefaultRangeDescription
MetacentricHeightfloat100.01+GM in cm. Higher = stiffer.
VerticalCenterOfGravityfloat0.0-500 to 500VCG relative to waterline (cm).
MaxRightingAnglefloat60.030–180Angle of vanishing stability (degrees).
RightingArmCurveCurveFloat::GZ curve: heel → righting arm.
NaturalRollPeriodfloat4.01–20Natural roll period (seconds).
RollDampingfloat0.50–5Roll damping coefficient.
PitchDampingfloat0.30–5Pitch damping coefficient.
YawDampingfloat0.20–5Yaw damping coefficient.
BilgeKeelFactorfloat0.00–2Bilge keel effectiveness.
bEnableAutoLevelboolfalse:Auto-leveling assist.
AutoLevelStrengthfloat0.10–1Auto-level correction strength.
AutoLevelMaxAnglefloat15.01–45Engage angle (degrees).

UDRW_VesselInputConfig

Purpose: Pre-configured input action bindings for vessels.

Used by: VesselInputComponent (when InputSource = CustomConfig).

PropertyTypeDescription
MappingContextInputMappingContextUE Enhanced Input mapping context.
MappingPriorityint32Context priority (default: 0).
Primary actions
ThrottleInputAction-1 (reverse) to 1 (forward).
SteeringInputAction-1 (port) to 1 (starboard).
Camera actions
CameraLookInputAction2D axis (yaw, pitch).
CameraZoomInputAction1D axis.
CameraCycleModeInputActionBool.
CameraFirstPersonInputActionBool.
CameraResetInputActionBool.
Trim actions
TrimLeft / TrimRightInputAction0 to 1 each.
Sailing actions
MainSheet / JibSheet / SpinnakerInputAction0 (eased) to 1 (tight).
CenterboardInputAction0 (up) to 1 (down).
Thruster actions
BowThruster / SternThrusterInputAction-1 (port) to 1 (starboard).
Paddle / oar actions
LeftPaddle / RightPaddleInputAction0 to 1.
RowingPowerInputAction0 to 1 (paired oars).
Foil action
FoilAngleInputAction-1 to 1.