SwitchablePawn

SwitchablePawn は、Play 中に FirstPerson / ThirdPerson / VR の Pawn を切り替えるための Unreal Engine Runtime Plugin です。

Author

• Author: Hironori Sugino
• Website: https://sugi.cc
• Original Repository: https://github.com/sugi-cho/UE_SwitchablePawn

対象

• Unreal Engine 5.7
• C++ プロジェクト推奨
• Enhanced Input 使用
• VR は OpenXR 使用

UE プロジェクトへの導入

1. UE プロジェクト直下に Plugins フォルダを作成します。
2. この SwitchablePawn フォルダを Plugins/SwitchablePawn に配置します。
3. .uproject に Plugin を追加します。

{
  "Name": "SwitchablePawn",
  "Enabled": true
}

4. 必要に応じて依存 Plugin も有効化します。

{
  "Name": "EnhancedInput",
  "Enabled": true
},
{
  "Name": "OpenXR",
  "Enabled": true
}

5. .uproject を右クリックして Generate Visual Studio project files を実行します。
6. Editor target をビルドします。

& "C:\Program Files\Epic Games\UE_5.7\Engine\Build\BatchFiles\Build.bat" YourProjectEditor Win64 Development -Project="C:\Path\To\YourProject\YourProject.uproject" -WaitMutex -NoHotReloadFromIDE

基本設定

GameMode または World Settings で PlayerController を次に設定します。

• ASwitchablePlayerController

Default Pawn は未設定、または Plugin 側の Pawn を指定します。

• ASwitchableFirstPersonCharacter
• ASwitchableThirdPersonCharacter
• ASwitchableVRCharacter

ASwitchablePlayerController は開始時に DefaultMode の Pawn を生成して Possess します。 NavMesh 制限は ASwitchablePlayerController::bConstrainMovementToNavMesh で全モード共通に切り替えます。 NavMesh 制限時に NavLinkProxy で飛ばしたい場合は、ASwitchableBaseCharacter::NavLinkProxies にレベル上の NavLinkProxy を設定します。空ならワールド内を自動探索します。

Level 設定

Level に ASwitchablePawnTeleportPoint を配置します。

主な設定:

• bSetAsDefaultStart: 起動時の位置として使う
• TeleportPointName: Outliner の Actor 名を反映した読み取り用の名前

Blueprint から Spawn する場合は USwitchablePawnBlueprintLibrary::SpawnTeleportPoint() を使うと、Spawn 時に名前を渡せます。

• ActorName: TeleportToPointByName() で検索する名前。Level 上で自動的に一意になる

Blueprint / C++ から次の API で移動できます。

TeleportToStartPoint();
TeleportToPointByName("Lobby");
TeleportToPointByIndex(0);

入力

既定では PlayerController が Runtime fallback の Enhanced Input Mapping を作成します。

既定キー:

• 1: FirstPerson
• 2: ThirdPerson
• 3: VR
• WASD: 移動
• Mouse: Look
• Space: Jump
• RightMouseButton: VR teleport aim / confirm
• Gamepad_RightTrigger: VR teleport confirm

BP_SwitchablePlayerController では次を変更できます。

• bEnableModeSwitchKeys: 1/2/3 のモード切替キーをまとめて無効化
• SwitchFirstPersonKey
• SwitchThirdPersonKey
• SwitchVRKey
• OnModeWillChange / OnModeChanged: モード変更前後の独自処理

VR へ切り替える時は HMD / stereo を有効化し、VR から FirstPerson / ThirdPerson に戻る時は Windowed に戻します。

プロジェクト側で独自の InputMappingContext / InputAction を指定することもできます。

モデル

ThirdPerson の body mesh、VR の hand mesh は Plugin 内にコピーしません。
この Plugin の BP は、UE テンプレート側のアセットを参照する前提です。

そのため、BP の設定をそのまま使うなら次のテンプレートが必要です。

• Third Person Template
• First Person Template
• VR Template

差し替え用 property / component 設定:

• ASwitchableThirdPersonCharacter::BodyMesh
• ASwitchableVRCharacter::HandSkeletalMesh
• CharacterMesh0 / FirstPersonMesh / LeftHandMesh / RightHandMesh の Animation Mode
• 各 Mesh の Anim Class
• CameraDistance

目安:

• ThirdPerson の見た目を変える: BodyMesh
• VR の手モデルを変える: HandSkeletalMesh
• 動かすアニメを変える: 各 Mesh の Anim Class
• カメラ距離を変える: CameraDistance

補足:

• Animation Mode が Use Animation Blueprint でないと、Mesh は出ても動きません。
• テンプレートを使わずに運用する場合は、BP 側で参照先を自前アセットへ差し替えてください。

最終的な Plugin は、テンプレート依存を BP の参照に閉じる方針です。
つまり、Plugin 本体の C++ はテンプレートアセットを複製せず、BP 側の参照だけがテンプレート依存になります。

実装済み機能

• FirstPerson / ThirdPerson / VR の Pawn 切り替え
• 切り替え時の Transform / Velocity / ControlRotation 引き継ぎ
• FirstPerson / ThirdPerson の移動と Jump
• ASwitchablePlayerController の bConstrainMovementToNavMesh による全モード移動の NavMesh 制限
• ASwitchableVRCharacter の teleport ray は既定で赤/緑のデバッグ表示
• TeleportPreviewMesh / TeleportPreviewMaterial / TeleportPreviewValidMaterial は任意の見た目変更用
• TeleportNavMeshSnapDistance で、Collider hit から NavMesh 最近傍へ寄せる許容距離を調整可能
• VR の HMD Camera / MotionController / Hand mesh slot
• VR line trace teleport
• NavMesh projection による teleport destination 判定
• ASwitchablePawnTeleportPoint による default start と teleport point

検証

この Plugin の変更後は、最低限 Editor target の C++ build を確認します。

& "C:\Program Files\Epic Games\UE_5.7\Engine\Build\BatchFiles\Build.bat" UE_SwitchablePawnEditor Win64 Development -Project="C:\Users\git\source\sugi-cho\UE_SwitchablePawn\UE_SwitchablePawn.uproject" -WaitMutex -NoHotReloadFromIDE

Shader や Editor load の確認が必要な場合は UnrealEditor-Cmd.exe で別途ログ確認します。

注意

• Git ルートはこの SwitchablePawn フォルダです。
• UE プロジェクト直下の Source / Content / Config はこの Plugin repo の管理対象ではありません。
• Binaries / Intermediate / Saved は Git 管理しません。