ゲーム制作雑記録 - Unreal Engine - ブループリントとC++を使う～ブループリント形式のプロジェクトにC++を追加

いざUnreal EngineでC++も使ってみようと思って公式のWebドキュメントや解説サイトや参考書を見ても、「え…全部コーディング？ビューポートは？あばばばばｗｗｗ」。そして、仕方なくブループリントのみでやろうとするも、「ところで汎用関数ってどうやって作るの？」「もっと構造体みたいに使いたいんやが…」とかになったりする人もいると思います。
で、結局はC++をUnreal Engineで使おうと調べなおして、ようやく触りの部分を学べた成果を簡潔に紹介します。

今回ここでやること

まず記事のタイトルにあるように、変わらずブループリントをメインで使っていく内容です。以下、こまごまとした前提を書きますので一読を。

Unreal Engineのプロジェクトの形式

ブループリント形式で新規作成したプロジェクトで開始して、後からC++形式を追加することになります。もちろん、そのままUnrealエディタにてプループリントを使ってゲーム制作を続けることが可能です。

プログラミングについて

ここではプログラミングの解説はしませんので、ある程度の知識が必要です。ただ、全く知らなくこれから勉強したいと思っている人でも問題ありません。こちらが先でも後から本格的にC++を学ぼうとする時に、こういうことだったのかとわかると思いますので(´▽｀

制作環境

Visual Studioが導入されていることが必要です。Unreal Engine必須のライブラリを導入する過程でVisual Studioを入れている人がほとんどだと思いますが、無い人はインストールして下さい。

目標

C++で関数を作りグラフ上で右クリックして文字入力して候補表示させて使用👍

作業の流れ

①プループリント形式にC++を追加(C++の新規クラスを作ろうとすると自動で行われます。)
②手動でC++をリビルド
③C++で関数作成
④Unreal Engineでコンパイル
⑤ブループリントで使用

留意事項

私はエディタを英語で使用しているので、日本語の表記が多少異なる場合があります。(途中で確認するのが面倒に…)

手順

新規C++クラス作成

Unrealエディタのメニューバー「ツール」→「新規 C++ クラス」
「よく使うクラス」から「ブループリント関数ライブラリ(Blueprint Function Library)」を選択して「次へ」

クラス名やらパスの変更は任意で「クラスを作成」

押すしかないので「OK」ボタンを押下。

「はい」ボタンを押してIDEを起動

C++をリビルド

コンテンツ・ドロワー右上の歯車マークの「設定」をクリックして「C++クラスを表示」にチェック

Unrealエディタを閉じる

Unrealプロジェクト名のモジュールを右クリック
メニューから「リビルド」を左クリック

Unrealプロジェクトのファイル(～.uproject)をダブル・クリックして起動

C++で関数作成

ヘッダ・ファイル編集

「MyBlueprintFunctionLibrary.h」には既に数行コードが書かれていますが、以下を参考に入力してください。IDEなのである程度文字を入力すると候補一覧が表示されるので、カーソル・キーで選択し、Tabキーで入力を確定できます。

下三行が追加部分

class BPFUNCLIB_API UMyBlueprintFunctionLibrary : public UBlueprintFunctionLibrary
{
	GENERATED_BODY()
	
public:
	UFUNCTION(BlueprintPure, Category = "MyFunction")
	static int factorial(int number);
};

「UFUNCTION」はUnreal Engine用のマクロ定義です。固有のもので、Unreal Engineでコーディングする際のお作法的なものです。「BlueprintPure」はブループリントのグラフ上で、ノード同士を白い線で結ぶ必要がない関数に指定するものです。大抵緑色のやつですね。
最後のfactorial(階乗)の記載があるところが関数の宣言です。なお、ブループリントで使うという性質上、引数(入力)や戻り値(出力)の型に制限があります。整数型では「int」と「int64」で、「unsigned」は使えません。どうやら「static」は無くても動くようですが…、ブループリントの段階でオブジェクト(インスタンス)化してるから？

CPPファイルへ定義追加

先ほどのヘッダ・ファイルの関数宣言の部分からCPPファイルに定義を記載する部分を追加する機能があるので、そこから追加します。
ヘッダ・ファイルの「static int factorial(int number);」行に入力カーソルを移動させると、行の左側に(スクリュー)ドライバーのアイコンが表示されるのでクリックすると、「～.cppに'factorial'の定義を作成」旨のメニューが表示されるのでそれをクリック。

CPPファイル編集

「MyBlueprintFunctionLibrary.cpp」に実際の関数の中身を書いていきます。
再起呼び出しを使用しても問題ありません。というかやったことないけどブループリントの関数でもできるのかな？

int UMyBlueprintFunctionLibrary::factorial(int number)
{
	if (number > 0) {
		return number * factorial(number - 1);
	}
	return 1;
}

編集が終わったら、上部ツールバーの💾が2重になっているアイコンをクリックして全てセーブします。

Unreal Engineでコンパイル

Unrealエディタの右下のブロックのようなアイコンをクリックし、リコンパイル。
なお、レベルマップの画面を表示させないと表示されません。
(上部メニューには無いし、ちっちゃいアイコンだし、なんでこんなに目立たないようにしてるんや)

少し時間がかかるので完了するまで待機。

ブループリントで使用

作成した関数がブループリントのグラフ上でいつものように使えます。実際にやってみましょう。
↓ちゃんとコードに記載したカテゴリ「My Function」内に今回作成した関数が出てきてます。

テンプレートのキャラクターにでも追加して…

5の階乗の結果が表示できました。

→「ゲーム制作雑記録」トップ・ページへ

このブログを検索

Wish Spread

ゲーム制作雑記録 - Unreal Engine - ブループリントとC++を使う～ブループリント形式のプロジェクトにC++を追加