7f7e043a88
Server-authoritative, data-driven item/inventory/interaction/carry/equipment/ world-slot/placement/crafting framework. 8 modules, compiles against UE 5.7. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
85 lines
2.5 KiB
C++
85 lines
2.5 KiB
C++
// Copyright ExByte Studios. Item Interaction Ecosystem.
|
|
|
|
#pragma once
|
|
|
|
#include "CoreMinimal.h"
|
|
#include "UObject/Interface.h"
|
|
#include "ItemInstanceData.h"
|
|
#include "ItemInteractionInterfaces.generated.h"
|
|
|
|
/**
|
|
* Implemented by world actors that represent a concrete item (e.g. APickupItemActor).
|
|
* Lets the interaction layer read/take the item without ItemInteraction depending on
|
|
* ItemWorld - the dependency only flows World -> Interaction.
|
|
*/
|
|
UINTERFACE(MinimalAPI, BlueprintType)
|
|
class UWorldItemProvider : public UInterface
|
|
{
|
|
GENERATED_BODY()
|
|
};
|
|
|
|
class ITEMINTERACTION_API IWorldItemProvider
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
/** Returns the item this actor carries. */
|
|
virtual bool GetProvidedItem(FItemInstanceData& OutItem) const = 0;
|
|
|
|
/** True if the provider is currently locked/claimed by another interaction. */
|
|
virtual bool IsItemAvailable() const { return true; }
|
|
|
|
/** Server: the item was taken into an inventory/hands - tear down the world actor. */
|
|
virtual void NotifyItemTaken(AActor* Taker) {}
|
|
|
|
/** Server: only part of the stack was taken; write back the remaining item. */
|
|
virtual void UpdateProvidedItem(const FItemInstanceData& RemainingItem) {}
|
|
|
|
/** Server: mark this world item as being physically carried by Holder (or released). */
|
|
virtual void SetCarried(AActor* Holder, bool bCarried) {}
|
|
};
|
|
|
|
/**
|
|
* Implemented by whatever tracks the pawn's currently held/carried item
|
|
* (the character or its UHeldItemComponent). The resolver queries it to build
|
|
* "held + target" interactions without depending on ItemWorld.
|
|
*/
|
|
UINTERFACE(MinimalAPI, BlueprintType)
|
|
class UHeldItemInterface : public UInterface
|
|
{
|
|
GENERATED_BODY()
|
|
};
|
|
|
|
class ITEMINTERACTION_API IHeldItemInterface
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
virtual bool GetHeldItem(FItemInstanceData& OutItem) const = 0;
|
|
virtual bool HasHeldItem() const = 0;
|
|
};
|
|
|
|
/**
|
|
* Implemented by world objects that react to a held item being used on them
|
|
* (section 15): pour fuel into a generator, barricade a door, place bait, etc.
|
|
* Found on the target actor or any of its components.
|
|
*/
|
|
UINTERFACE(MinimalAPI, BlueprintType)
|
|
class UItemUseTarget : public UInterface
|
|
{
|
|
GENERATED_BODY()
|
|
};
|
|
|
|
class ITEMINTERACTION_API IItemUseTarget
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
/**
|
|
* Server: apply the held item to this target for the given result verb (e.g.
|
|
* "TransferFuel"). May mutate HeldItem (reduce fuel/charge). Returns true if it
|
|
* did something - the caller then writes HeldItem back to the held component.
|
|
*/
|
|
virtual bool ReceiveHeldUse(FName ResultVerb, FItemInstanceData& HeldItem, AActor* Instigator) = 0;
|
|
};
|