Program Listing for File ZagalaSpecExamplesHoverboardActor.h#

↰ Return to documentation for file (ZagalaSpecExamples/Public/Hoverboard/Sut/ZagalaSpecExamplesHoverboardActor.h)

// Copyright (c) 2026, Zagala Game Solutions. All rights reserved.

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Components/StaticMeshComponent.h"
#include "Components/BoxComponent.h"
#include "Components/SceneComponent.h"
#include "ZagalaSpecExamplesHoverboardActor.generated.h"


UCLASS(Blueprintable, meta = (DisplayName = "ZagalaSpec Examples Hoverboard Actor"))
class ZAGALASPECEXAMPLES_API AZagalaSpecExamplesHoverboardActor : public AActor
{
    GENERATED_BODY()

public:
    AZagalaSpecExamplesHoverboardActor(const FObjectInitializer& ObjectInitializer = FObjectInitializer::Get());

    virtual void BeginPlay() override;
    virtual void Tick(float DeltaSeconds) override;


    UFUNCTION(BlueprintCallable, Category = "Hoverboard|Input")
    void SetThrottle(float InThrottle);

    UFUNCTION(BlueprintCallable, Category = "Hoverboard|Input")
    void SetSteering(float InSteering);


    UFUNCTION(BlueprintCallable, Category = "Hoverboard|Query")
    float GetHeightAboveGround() const;

    UFUNCTION(BlueprintPure, Category = "Hoverboard|Query")
    float GetYawDegrees() const;

    UFUNCTION(BlueprintPure, Category = "Hoverboard|Query")
    float GetThrottle() const { return Throttle; }

    UFUNCTION(BlueprintPure, Category = "Hoverboard|Query")
    float GetSteering() const { return Steering; }

    static float ComputeHoverForceZ(float Mass, float GravityZ, float CurrentHeight, float VerticalVelocity, float TargetHeight, float TimeToRecover, float DeltaSeconds);


    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Hoverboard|Components")
    TObjectPtr<UBoxComponent> HoverBox;


    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float HoverHeight = 150.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics", meta = (ClampMin = "0.01"))
    float TimeToRecover = 0.5f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics", meta = (ClampMin = "0.0"))
    float MaxHoverTraceDistance = 10000.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float MaxThrottleForce = 500.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float MaxSteerForce = 450.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    TEnumAsByte<ECollisionChannel> RayCastChannel = ECC_Visibility;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float MassKg = 20.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float LinearDamping = 2.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float AngularDamping = 4.f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hoverboard|Physics")
    float HalfExtent = 100.f;

private:
    float Throttle = 0.f;
    float Steering = 0.f;

    void ApplyHoverForce(float DeltaSeconds);
    void ApplyThrottleForce();
    void ApplySteerForces();
    bool TraceGroundHeight(const FVector& From, float& OutHeight) const;
};