UE5 で TargetPoint を取得する方法｜GetAllActorsOfClass

編集

この記事の要点

TargetPoint は位置情報のマーカーとなる軽量アクター。AI 移動目標 / スポーン位置 / カメラ移動目標などに使う
C++: UGameplayStatics::GetAllActorsOfClass(World, ATargetPoint::StaticClass(), OutActors) で全 TargetPoint を取得
Blueprint: Get All Actors Of Class ノードに TargetPoint を指定
特定の TargetPoint だけ欲しい場合は Actor Tag でフィルタする（ActorHasTag("SpawnPoint")）
GetAllActorsOfClass はレベル内の全アクターを走査するため毎フレーム呼ばない。BeginPlay でキャッシュ

1TargetPoint とは

TargetPoint は Unreal Engine 5 (UE5) に標準で含まれる軽量アクターで、レベル内に「位置と回転」を持つマーカーを置くために使います。実体的な描画やコリジョンを持たず、ゲームロジックから「ここに何かを移動・配置せよ」と参照するための目印として機能します。

用途	具体例
AI 移動目標	パトロール経路の中継点、追跡先
スポーン位置	プレイヤー / 敵 / 拾得アイテムの出現点
カメラ移動目標	カットシーンのカメラ経路
イベント発生位置	ステージ進行で重要な座標の記録

2C++ で取得する

1. ヘッダーをインクルード

#include "Engine/TargetPoint.h"
#include "Kismet/GameplayStatics.h"

2. レベル内の全 TargetPoint を取得

TArray<AActor*> TargetPoints;
UGameplayStatics::GetAllActorsOfClass(
    GetWorld(),
    ATargetPoint::StaticClass(),
    TargetPoints
);

UE_LOG(LogTemp, Log, TEXT("TargetPoint count: %d"), TargetPoints.Num());

3. タグで特定の TargetPoint だけ抽出

ATargetPoint* SelectedTarget = nullptr;

for (AActor* Target : TargetPoints)
{
    if (Target->ActorHasTag(FName("SpawnPoint")))
    {
        SelectedTarget = Cast<ATargetPoint>(Target);
        break;
    }
}

if (SelectedTarget)
{
    FVector Loc = SelectedTarget->GetActorLocation();
    UE_LOG(LogTemp, Log, TEXT("Spawn at: %s"), *Loc.ToString());
}

4. タグ別にまとめて取り出す

// GetAllActorsWithTag は AActor 配列、種別チェックは Cast で
TArray<AActor*> SpawnPoints;
UGameplayStatics::GetAllActorsWithTag(
    GetWorld(), FName("SpawnPoint"), SpawnPoints);

3Blueprint で取得する

Blueprint グラフを開く
Get All Actors Of Class ノードを追加
Actor Class に TargetPoint を指定
出力 Out Actors を ForEachLoop に接続
各要素を Get Actor Location や Actor Has Tag で処理

タグだけで絞りたい場合は Get All Actors With Tag ノードを使うと走査が一度で済みます。

4パフォーマンスのコツ

状況	推奨
BeginPlay で一度だけ	`GetAllActorsOfClass` でキャッシュし、メンバ変数に保持
毎フレーム / Tick	キャッシュした配列を参照、再走査しない
大量にある	派生クラスを作って `UPROPERTY(EditAnywhere)` で個別参照
動的生成	SpawnActor 時に登録、配列管理

5派生クラスで設計する（推奨）

用途別に ATargetPoint を継承したクラスを作ると、エディタ上で識別しやすく、誤って取得することも減ります。

// SpawnTargetPoint.h
#pragma once
#include "Engine/TargetPoint.h"
#include "SpawnTargetPoint.generated.h"

UCLASS()
class MYGAME_API ASpawnTargetPoint : public ATargetPoint
{
    GENERATED_BODY()
public:
    UPROPERTY(EditAnywhere, Category="Spawn")
    int32 Priority = 0;
};

6まとめ

レベル内の TargetPoint は GetAllActorsOfClass でまとめて取得
個別識別は Actor Tag または派生クラスで行う
取得はBeginPlay で一度だけ、結果はキャッシュ
Blueprint でも同等のノードが用意されている

編集

子ページ

子ページはありません

同階層のページ

2026-10-03 03:32:11 atom 266

最近更新/作成されたページ

Oracle 19cのSAVEPOINT｜部分ロールバック・COMMIT・DDLの境界 2026-10-26 15:51:40
Oracle 19cのUPDATE文｜更新件数・NULL・相関サブクエリ・MERGE 2026-10-26 15:51:40
Oracle 19cのHAVING句｜WHEREとの違い・NULL・集計条件 2026-10-26 15:51:40
Oracleの制約｜NOT NULL・UNIQUE・主キー・外部キー・CHECK 2026-10-26 15:51:38
Oracle SQL関数まとめ｜集計・文字列・日時・NULL・分析関数 2026-10-26 15:51:38
Oracle 19cのROLLBACK｜SAVEPOINT・DDLの暗黙COMMITと製品別の違い 2026-10-26 14:28:53
Oracle 19cのDDLとは｜CREATE・ALTER・DROPと暗黙COMMITの注意点 2026-10-26 14:28:53
Unityで処理を一定時間待つ｜WaitForSeconds・実時間待機と停止条件 2026-10-26 12:51:07
Unityのビルドに時間がかかる場合の対処法｜ログ・照明・シェーダーの確認 2026-10-26 12:51:07
Blenderのモード変更｜Object・Edit・Sculptと操作対象の違い 2026-10-26 11:58:16
Blenderの頂点・辺・面の選択｜旧画像・X-Ray・選択数の読取り 2026-10-26 11:58:16
Blenderのカメラ移動｜視点・配置・Fly/Walkと追従の違い 2026-10-26 11:58:16
Blenderショートカットキー一覧｜モード・テンキー・設定の違い 2026-10-26 11:58:16
Metasequoiaでオブジェクトを結合する方法｜旧画面と合成前後の確認 2026-10-26 11:17:22
Metasequoiaとは｜無償・EXの機能差と操作の入口 2026-10-26 11:17:22

ページ一覧

その他