UPROPERTY

Что такое BlueprintReadOnly

BlueprintReadOnly — спецификатор UPROPERTY, который открывает свойство только для чтения в Blueprints. Значение можно получить через Get-ноду, но нельзя изменить через Set.

Этот спецификатор используется, когда значение должно быть видно в Blueprint, но изменять его должен только C++ код.

Когда использовать BlueprintReadOnly

• значение должно быть видно в Blueprint, но изменять его должен только C++ код
• состояние объекта, которое можно читать, но нельзя перезаписывать из Blueprint
• внутренние расчётные данные, которые нужно показывать для отладки

Пример кода

UCLASS()
class MYGAME_API AMyActor : public AActor
{
    GENERATED_BODY()

public:

    UPROPERTY(BlueprintReadOnly)
    float CurrentSpeed = 0.0f;

    UPROPERTY(BlueprintReadOnly)
    bool bIsAlive = true;

    virtual void Tick(float DeltaTime) override;
};

Разница между BlueprintReadOnly и BlueprintReadWrite

Официальный список спецификаторов UPROPERTY, включая BlueprintReadOnly, можно посмотреть в документации Epic Games.

Что такое BlueprintReadWrite

BlueprintReadWrite — спецификатор UPROPERTY, который открывает свойство для чтения и записи в Blueprints (Event Graph, Construction Script, Function Calls).

Без этого спецификатора свойство недоступно из Blueprint-нод вообще.

С BlueprintReadWrite ты можешь:

• читать значение переменной из любой Blueprint-ноды (Get)
• записывать новое значение (Set)
• использовать свойство в Break / Make нодах для структур

Когда использовать BlueprintReadWrite

• свойство должно быть доступно в Blueprint как для чтения, так и для изменения
• ты хочешь дать разработчику возможность настраивать логику в Event Graph
• параметр или конфигурация, которую нужно менять во время игры из Blueprint

Пример кода

UCLASS()
class MYGAME_API AMyActor : public AActor
{
    GENERATED_BODY()

public:

    UPROPERTY(BlueprintReadWrite)
    float Health = 100.0f;

    UPROPERTY(BlueprintReadWrite)
    FString CharacterName = TEXT("Hero");
};

Как это выглядит в редакторе

В Blueprint Editor для BlueprintReadWrite автоматически создаются ноды Get и Set:

Get — читает текущее значение. Set — записывает новое значение. Работает с любым типом переменной.

Сравнение с BlueprintReadOnly

Официальный список спецификаторов UPROPERTY, включая BlueprintReadWrite, можно посмотреть в документации Epic Games.

Что такое EditAnywhere

EditAnywhere - самый универсальный спецификатор UPROPERTY.
Он позволяет редактировать переменную везде, где появляется панель Details:

• в Class Defaults (настройки класса по умолчанию)
• в каждом отдельном экземпляре актора на уровне
• в компонентах, структурах, вложенных объектах

Это означает, что одно и то же свойство можно настраивать как глобально (для всех объектов), так и индивидуально (для каждого объекта в сцене)..

Когда использовать EditAnywhere

• когда хочешь настраивать значения для каждого объекта на сцене
• нужна гибкость и на уровне класса, и на уровне экземпляра

Пример кода

UCLASS()
class MYGAME_API AMyClass : public AActor
{
    GENERATED_BODY()

public:

    UPROPERTY(EditAnywhere)
    FString Property = "";

    UPROPERTY(EditDefaultsOnly)
    FString DefaultOnlyProperty = "";

};

UCLASS()
class MYGAME_API AMyClass : public AActor
{
    GENERATED_BODY()

public:

    UPROPERTY(EditAnywhere)
    FString Property = "";

    UPROPERTY(EditDefaultsOnly)
    FString DefaultOnlyProperty = "";

};

Как это выглядит в редакторе

В Class Defaults меняешь → влияет на все новые экземпляры.
В размещённом акторе меняешь → переопределяется только этот экземпляр.

Сравнение с EditDefaultsOnly и EditInstanceOnly

Официальный список спецификаторов UPROPERTY, включая EditDefaultsOnly, можно посмотреть в документации Epic Games.