# 【UE5】BlsquiSDK-Unrealの導入・セットアップ手順｜手数料0%のゲーム内決済＆Web3ウォレット連携

Unreal Engine 5（UE5）製のPCゲームにブロックチェーンアイテムやeスポーツ賞金配布、ゲーム内決済を組み込む際、複雑な暗号処理やプレイヤーに手間を強いるブラウザ拡張機能はもう必要ありません。

本記事では、公式リポジトリ `BlsquiSDK-Unreal`（[`https://github.com/blsqui/BlsquiSDK-Unreal`](https://github.com/blsqui/BlsquiSDK-Unreal)) をUE5プロジェクトにインポートし、初期セットアップを行う手順をわかりやすく解説します。

---

まず最初にUnreal Engine プロジェクトを開きます。

Mac: /Users/&lt;your account>/Documents/Unreal Projects/&lt;Your UE5 Project>

**Windows:** `C:\Users\<your account>\Documents\Unreal Projects\<Your Project UE5>`

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/31400a5c-ddc0-461e-bd3f-334acb6b768e.png align="center")

プロジェクトルートで以下のコマンドを実行します。

```shell
git clone https://github.com/blsqui/BlsquiSDK-Unreal.git Plugins/BlsquiSDK
```

---

Plugins フォルダにBlsquiSDKディレクトリが生成されます。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/87a6c3a4-97dc-49fa-b124-cbc9e6dabbc5.png align="center")

---

次にビルドします。

Mac:

```shell
"/Users/Shared/Epic Games/UE_5.5/Engine/Build/BatchFiles/Mac/Build.sh" \
  BlsquiTestProjectEditor Mac Development \
  -Project="/Users/<your account>/Documents/Unreal Projects/<Your UE5 Project>/<Your UE5 Project>.uproject"
```

Windows はあまりよく分からないですが以下のようにするようです。

```shell
"C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles\Build.bat" ^
  BlsquiTestProjectEditor Win64 Development ^
  -Project="C:\Users\<your account>\Documents\Unreal Projects\<Your UE5 Project>\<Your UE5 Project>.uproject"
```

---

コマンドを実行して以下のように出力されればビルドは成功しています。

```shell
---- Starting trace ----
UbaSessionServer - Disable remote execution (remote sessions will finish current processes)
------ Building 12 action(s) started ------
[1/12] Compile [Apple] BlsquiSDKModule.cpp
[2/12] Compile [Apple] BlsquiCurrentUser.cpp
[3/12] Compile [Apple] BlsquiTestProjectGameMode.cpp
[4/12] Compile [Apple] BlsquiTestProjectCharacter.gen.cpp
[5/12] Compile [Apple] BlsquiSDKComponent.cpp
[6/12] Compile [Apple] BlsquiTestProjectCharacter.cpp
[7/12] Compile [Apple] Module.BlsquiSDK.cpp
[8/12] Compile [Apple] BlsquiStageSlot.cpp
[9/12] Compile [Apple] BlsquiWebRTCPresence.cpp
[10/12] Link [Apple] UnrealEditor-BlsquiSDK.dylib (UBA disabled)
ld: warning: building for macOS-13.0, but linking with dylib '@rpath/libdatachannel.0.dylib' which was built for newer version 26.0
[11/12] Link [Apple] UnrealEditor-BlsquiTestProject.dylib (UBA disabled)
ld: warning: building for macOS-13.0, but linking with dylib '@rpath/libdatachannel.0.dylib' which was built for newer version 26.0
[12/12] WriteMetadata BlsquiTestProjectEditor.target (UBA disabled)
Trace file written to /Users/temtech/Documents/Library/Application Support/Epic/UnrealBuildTool/Log.uba with size 4.1kb
Total time in Unreal Build Accelerator local executor: 15.74 seconds
Deploying BlsquiTestProjectEditor Mac Development...
Deploying now!
Total execution time: 20.81 seconds
```

ここでSDKのコードの中身について紹介します。\
UE5開発者が普段通りのBlueprintやC++の感覚で組み込めるよう、SDKは以下の6つのモジュールに分けて設計しています。

- `BlsquiCurrentUser`**（セッション＆インベントリ管理）**`UGameInstanceSubsystem` を継承しているため、レベル遷移を跨いでもプレイヤーのログイン状態やウォレットアドレスが維持されます。ダッシュボードの起動（`OpenDashboard`）や、ゲーム側からのアイテム使用トリガー（`RequestUseItem`）、さらには外部Webダッシュボードからの装備変更・アイテム使用イベントの受信までを一手に担います。
- `BlsquiSDKComponent`**（トランザクション実行＆ステータス監視）** PlayerControllerやキャラクターにアタッチできる `UActorComponent` です。`RequestTransaction` を呼ぶだけで、改ざん防止用の署名付きセッショントークンの発行からブラウザゲートウェイの起動、ブロック確定（`SEALED`）までの非同期ポーリングを自動で行い、完了時にデリゲート（`OnTransactionCompleted`）で通知します。
- `BlsquiWebRTCPresence`**（ゼロラグP2P通信ブリッジ）** ゲームクライアントとWebウォレット（ダッシュボード）をWebRTC DataChannel（`libdatachannel`）で直接つなぐ通信エンジンです。Webダッシュボード側で武器スロットを付け替えたりアイテム使用ボタンを押したりした瞬間に、ミリ秒単位の低遅延でゲーム画面へリアルタイム同期されます。
- `BlsquiStageSlot` **&** `BlsquiTypes`**（Blueprintフレンドリーなデータ構造）** 装備スロットの状態（`FStageSlotItem`）やアイテム使用リクエスト（`FItemUseRequestPayload`）、トランザクション結果（`FTxResult`）などを `USTRUCT(BlueprintType)` として定義しています。C++を書かなくても、Blueprintのノード上でピンを繋ぐだけでそのままUI（UMG）やゲームロジックへ値を渡せます。
- `BlsquiSDKModule`**（プラットフォーム別ネイティブライブラリ制御）** プラグイン起動時にOS環境（Windows / macOS）を判別し、`libdatachannel` などのサードパーティ製ネイティブバイナリを安全にロード・解放するモジュール初期化クラスです。

---

### 次にプロジェクトにBlsquiSDKを組み込んでいきます。

\`Source/&lt;Your UE5 Project>/&lt;Your UE5 Project>.Build.cs\`を開きます。

```cpp
// Copyright Epic Games, Inc. All Rights Reserved.

using UnrealBuildTool;

public class BlsquiTestProject : ModuleRules
{
	public BlsquiTestProject(ReadOnlyTargetRules Target) : base(Target)
	{
		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;

		PublicDependencyModuleNames.AddRange(new string[] {
			"Core", "CoreUObject", "Engine", "InputCore", "EnhancedInput", "BlsquiSDK"
		});
	}
}
```

このように PublicDependencyModuleNames.AddRange に "BlsquiSDK" を追加します。

この状態で一度あなたのUE5プロジェクトを起動してみます。

まずプロジェクトをビルドします。

```shell
"/Users/Shared/Epic Games/UE_5.5/Engine/Build/BatchFiles/Mac/Build.sh" \
  <Your Project UE5>Editor Mac Development \
  -Project="/Users/<your account>/Documents/Unreal Projects/<Your Project UE5>/<Your Project UE5>.uproject"
```

### WebRTCの設定

SDKはWebRTCに `libdatachannel` のライブラリを使用しています。

以下のコマンドを実行してください。

```shell
SRC_DYLIB="/Users/<your account>/Documents/Unreal Projects/<Your UE5 Project>/Plugins/BlsquiSDK/Source/BlsquiSDK/ThirdParty/libdatachannel/lib/Mac/libdatachannel.dylib"
PLUGIN_BIN="/Users/<your account>/Documents/Unreal Projects/<Your UE5 Project>/Plugins/BlsquiSDK/Binaries/Mac"
PROJECT_BIN="/Users/<your account>/Documents/Unreal Projects/<Your UE5 Project>/Binaries/Mac"

mkdir -p "$PLUGIN_BIN" "$PROJECT_BIN"
cp "$SRC_DYLIB" "$PLUGIN_BIN/libdatachannel.0.dylib"
cp "$SRC_DYLIB" "$PROJECT_BIN/libdatachannel.0.dylib"

install_name_tool -change "@rpath/libdatachannel.0.dylib" "@loader_path/libdatachannel.0.dylib" "$PLUGIN_BIN/UnrealEditor-BlsquiSDK.dylib"

codesign --force --sign - "$PLUGIN_BIN/libdatachannel.0.dylib"
codesign --force --sign - "$PROJECT_BIN/libdatachannel.0.dylib"
codesign --force --sign - "$PLUGIN_BIN/UnrealEditor-BlsquiSDK.dylib"
codesign --force --sign - "$PROJECT_BIN/UnrealEditor-<Your UE5 Project>.dylib"
```

UE5 Editorを起動します。

```shell
open "/Users/<your account>/Documents/Unreal Projects/<Your UE5 Project>/<Your UE5 Project>.uproject"
```

以下のようにUE5 Editorが立ち上がります。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/924f4dd3-d880-4ced-8905-88cd6ed640bb.png align="center")

> これは私のUE5プロジェクトの場合であって見える画面は全然違います。

---

**特定のブロックチェーンアカウントの装備スロットの状態（**`FStageSlotItem`**）を取得する**

エディターのGraphで以下のように設定します。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/905b06c4-c5a2-48ed-8a16-c35bbc6013b2.png align="center")

スロットはPublisherのアプリ別に設定されます。そのため特定のブロックチェーンアドレスに加えてPublisher のアドレス(`Management Console`でログインしたアドレス)とアプリIDをセットします。

---

**ダッシュボードを開く。ダッシュボードに表示されるスロットの情報を取得する。**

エディターのGraphで以下のように設定します。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/3c06de93-b4a6-4a68-9c7b-85c1767837f4.png align="center")

見にくいのは重々承知ですが、GeminiなどのAIにこの画像をアップロードするとどうすべきかを教えてくれます。（<https://github.com/blsqui/BlsquiSDK-Unreal> のURLと一緒にお願いします）

---

**アイテム購入**

エディターのGraphで以下のように設定します。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/1c56b67b-336f-4bb5-97ff-5780befd8da8.png align="center")

---

**ブロックチェーンアイテムの使用を促す**

エディターのGraphで以下のように設定します。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/07a4c8b6-9bc8-4fd6-a8a1-9e5fbfc65ce6.png align="center")

左上でボタン押下時にアイテムIDをセットした状態でダッシュボードにアイテム使用を促すメッセージを送っています。

それ以外はユーザーがダッシュボードでアイテム使用意思を表した時に実行する場所です。Publisher ID, App ID, Item ID, Serial Numberを渡すことで一意のアイテムの使用をRequestTransactionに送信しています。コールバックはアイテム使用のものと全く同じものが呼ばれます。（On Transaction Completed）

### Try it out!

1. モニターを２つ並べてゲームからダッシュボードを呼び出します。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/cc0c387c-0c27-4b36-9b7b-98e79f2f95af.png align="center")

2. アイテムを使用して欲しい時にアイテムの使用を促します。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/546fec20-f27b-4a56-91f9-4e6aae7e94ec.png align="center")

事前にダッシュボードを開いていると、このように指定したアイテムが光ります。一定時間以内にボタンを押すとゲームに通知されます。

3. アイテム使用のトランザクションが実行されます。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/f28582f4-c984-43b5-8663-93c8cd19b69f.png align="center")

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/adda22da-4a0b-41ac-b869-f2952b1a5374.png align="center")

4. ゲーム側でトランザクション結果を受け取ります。

![](https://cdn.hashnode.com/uploads/covers/6a54b7c15c0c654db32e149a/bcfd1898-d296-40c0-8ead-771883e67a59.png align="center")
