<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p data-line="1" class="code-line">Unreal Engineを学び始めるとき、<strong>どこから手を付けよう...</strong> となった感覚はありませんか？<br>
「<code>GameMode</code>・<code>PlayerController</code>・<code>GameInstance</code>… 似たような管理クラスが多くて、どこに何を書くのが正解なのか分からない...」</p>
<p data-line="4" class="code-line">そんな問題を解決するために <strong>「データの寿命」</strong> をポイントにUEのフレームワークを整理していった備忘録です。</p>
<h2 id="ue%E3%81%AE%E3%83%A1%E3%82%A4%E3%83%B3%E3%83%AB%E3%83%BC%E3%83%97%E3%81%A3%E3%81%A6%E3%81%A9%E3%81%93%EF%BC%9F" data-line="6" class="code-line">
<a class="header-anchor-link" href="#ue%E3%81%AE%E3%83%A1%E3%82%A4%E3%83%B3%E3%83%AB%E3%83%BC%E3%83%97%E3%81%A3%E3%81%A6%E3%81%A9%E3%81%93%EF%BC%9F" aria-hidden="true"></a> UEのメインループってどこ？</h2>
<p data-line="7" class="code-line">DirectXやC++で0から作っていた方は、<code>main()</code>関数などを使ってメインループを回していたと思いますが、UEにおいてはこれを <strong>開発者が直接書くことはありません。</strong></p>
<p data-line="9" class="code-line">UEの処理は大まかに以下の階層で駆動しているようです。</p>
<ol data-line="10" class="code-line">
<li data-line="10" class="code-line">Engine Loop : エンジンがハードウェア入力や時間を計算</li>
<li data-line="11" class="code-line">World Tick : 現在のレベル<code>(UWorld)</code>に更新を命令</li>
<li data-line="12" class="code-line">Actor Tick : レベルが、配置されているすべての<code>Actor</code>・<code>Component</code>の<code>Tick</code>を呼ぶ</li>
</ol>
<p data-line="14" class="code-line">つまり、ループそのものを作る必要はなく、<strong>エンジンから呼び出される<code>Tick</code>に処理を書き込む</strong> のがUEのスタイルということです。</p>
<h2 id="%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%BD%B9%E5%89%B2%E3%81%A8%E3%83%A9%E3%82%A4%E3%83%95%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB" data-line="16" class="code-line">
<a class="header-anchor-link" href="#%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%BD%B9%E5%89%B2%E3%81%A8%E3%83%A9%E3%82%A4%E3%83%95%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB" aria-hidden="true"></a> クラスの役割とライフサイクル</h2>
<p data-line="17" class="code-line">「どこに何を書けばいいのか」という疑問を解決するために、まず <strong>「クラスのライフサイクル」</strong> を知る必要があります。<br>
ゲームモードで設定できるクラスを寿命の長い順にすると、役割が分かりやすくなるでしょう。</p>
<h4 id="%E3%80%90%E5%AF%BF%E5%91%BD%EF%BC%9A%E9%95%B7%E3%81%84%E3%80%91%E3%82%B2%E3%83%BC%E3%83%A0%E8%B5%B7%E5%8B%95%E4%B8%AD%E3%80%81%E5%B8%B8%E3%81%AB%E7%94%9F%E5%AD%98(%E6%B0%B8%E7%B6%9A)" data-line="20" class="code-line">
<a class="header-anchor-link" href="#%E3%80%90%E5%AF%BF%E5%91%BD%EF%BC%9A%E9%95%B7%E3%81%84%E3%80%91%E3%82%B2%E3%83%BC%E3%83%A0%E8%B5%B7%E5%8B%95%E4%B8%AD%E3%80%81%E5%B8%B8%E3%81%AB%E7%94%9F%E5%AD%98(%E6%B0%B8%E7%B6%9A)" aria-hidden="true"></a> 【寿命：長い】ゲーム起動中、常に生存(永続)</h4>
<p data-line="21" class="code-line">このクラスは常に生存します。削除されることはありません。</p>
<table data-line="22" class="code-line">
<thead data-line="22" class="code-line">
<tr data-line="22" class="code-line">
<th>クラス名</th>
<th>役割</th>
</tr>
</thead>
<tbody data-line="24" class="code-line">
<tr data-line="24" class="code-line">
<td>GameInstance</td>
<td>ゲーム全体で保持するデータを管理</td>
</tr>
</tbody>
</table>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="27" class="code-line">変数を詰め込んでしまうと巨大なクラスになってしまうことが想定されます。<br>
これを解決するために、<strong>SubSystem</strong> に処理を委譲するのが一般的です。</p>
<p data-line="30" class="code-line">【SubSystemってなに？】<br>
<a href="https://zenn.dev/ponderingu/articles/c024f589c45ecd" target="_blank">https://zenn.dev/ponderingu/articles/c024f589c45ecd</a></p>
</div></aside>
<hr data-line="34" class="code-line">
<h4 id="%E3%80%90%E5%AF%BF%E5%91%BD%EF%BC%9A%E6%99%AE%E9%80%9A%E3%80%91%E3%83%AC%E3%83%99%E3%83%AB%E5%86%85%E3%81%A7%E7%94%9F%E5%AD%98" data-line="35" class="code-line">
<a class="header-anchor-link" href="#%E3%80%90%E5%AF%BF%E5%91%BD%EF%BC%9A%E6%99%AE%E9%80%9A%E3%80%91%E3%83%AC%E3%83%99%E3%83%AB%E5%86%85%E3%81%A7%E7%94%9F%E5%AD%98" aria-hidden="true"></a> 【寿命：普通】レベル内で生存</h4>
<p data-line="36" class="code-line">対象のレベルがロードされていると生存しています。<br>
他のレベルに移動すると削除され、新しいインスタンスが生成されます。</p>
<table data-line="38" class="code-line">
<thead data-line="38" class="code-line">
<tr data-line="38" class="code-line">
<th>クラス名</th>
<th>役割</th>
<th>主な使用例</th>
</tr>
</thead>
<tbody data-line="40" class="code-line">
<tr data-line="40" class="code-line">
<td>GameMode</td>
<td>レベルのルール設定</td>
<td>勝利条件の判定・プレイヤーのスポーン地点設定 ※ マルチプレイ時は、サーバー上のみ存在する</td>
</tr>
<tr data-line="41" class="code-line">
<td>GameState</td>
<td>ゲームの盤面</td>
<td>現在のスコア・チームの点数(UIに表示したいデータ) ※ マルチプレイ時は、全プレイヤーに同期</td>
</tr>
<tr data-line="42" class="code-line">
<td>PlayerController</td>
<td>プレイヤー操作</td>
<td>入力の受信・HUD(キャラが消えてもHUDは消えないので)・カメラ操作</td>
</tr>
</tbody>
</table>
<hr data-line="44" class="code-line">
<h4 id="%E3%80%90%E5%AF%BF%E5%91%BD%EF%BC%9A%E7%9F%AD%E3%81%84%E3%80%91%E7%89%A9%E4%BD%93(actor)%E3%81%AE%E7%94%9F%E5%AD%98%E3%81%AB%E4%BE%9D%E5%AD%98" data-line="45" class="code-line">
<a class="header-anchor-link" href="#%E3%80%90%E5%AF%BF%E5%91%BD%EF%BC%9A%E7%9F%AD%E3%81%84%E3%80%91%E7%89%A9%E4%BD%93(actor)%E3%81%AE%E7%94%9F%E5%AD%98%E3%81%AB%E4%BE%9D%E5%AD%98" aria-hidden="true"></a> 【寿命：短い】物体(Actor)の生存に依存</h4>
<p data-line="46" class="code-line">Actorが存在しているときに生存しています。<br>
倒されたなどして、Actorが消えると共に削除されます。</p>
<table data-line="48" class="code-line">
<thead data-line="48" class="code-line">
<tr data-line="48" class="code-line">
<th>クラス名</th>
<th>役割</th>
<th>主な使用例</th>
</tr>
</thead>
<tbody data-line="50" class="code-line">
<tr data-line="50" class="code-line">
<td>Pawn / Character</td>
<td>PlayerControllerに動かされる物体</td>
<td>HP・攻撃力・エモート</td>
</tr>
</tbody>
</table>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="53" class="code-line">「所持金」や「ミッション達成数」などを持たせてはいけません！<br>
Actorは場面転換や暗転時に頻繁に削除することが想定されるため、データが消えることに注意です。</p>
</div></aside>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="56" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p data-line="57" class="code-line">ここまで理解すれば、「どこに何を書けばいいか分からない...」ことはなくなったと思います！<br>
まずは流れを知ることから！</p>
<p data-line="60" class="code-line">SubSystemについては別記事にまとめようとしているので、気になる方はお待ちいただければと思います。</p>
<h2 id="%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99" data-line="62" class="code-line">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99" aria-hidden="true"></a> 参考資料</h2>
<p data-line="63" class="code-line"><a href="https://someiyoshino.info/entry/20160830/1472569969" target="_blank" rel="nofollow noopener noreferrer">https://dev.epicgames.com/documentation/ja-jp/unreal-engine/world-settings-in-unreal-engine</a><br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__2b017d81767c1" src="https://embed.zenn.studio/card#zenn-embedded__2b017d81767c1" data-content="https%3A%2F%2Fdev.epicgames.com%2Fdocumentation%2Fja-jp%2Funreal-engine%2Fgameplay-framework-in-unreal-engine" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://dev.epicgames.com/documentation/ja-jp/unreal-engine/gameplay-framework-in-unreal-engine" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://dev.epicgames.com/documentation/ja-jp/unreal-engine/gameplay-framework-in-unreal-engine</a></p>


【UE5】「PlayerController」ってなに？ 主要なゲームプレイクラス入門

クラスの役割とライフサイクル

【UE5】「PlayerController」ってなに？主要なゲームプレイクラス入門

Discussion