表データをUnrealEngineで扱いやすくするためのプラグインです。
- エディタでPlay中に表データ(DataTable)を書き換えてゲームの動作に反映すること
- データエントリに一意のキー(GameplayTag)でアクセスすること
- データエントリにインデックスでアクセスすること
インストールしたいProjectのPluginsフォルダ内に、このリポジトリのPlugins内のファイルをすべて配置してください。
- 設定した特定の接頭辞(デフォルトは
DT_
)をもつCSVファイルをドラッグアンドドロップしてDataTableをインポートする(RowNameがそのままGameplayTagになる点に注意) - 自動的に
ChartDataAsset
とGameplayTagDataTable
が生成される - 任意のBPで
GetChartDataAssetRow
関数を用いて取得したいエントリのキーを指定する
以上です。
GetChartDataAssetRow
の他にインデックスを指定して取得できるGetChartDataAssetRowByIndex
もあります。
そのほか、キーを全取得するGetRowTags
や最後のインデックスを取得するGetLastRowIndex
もあります。
応用的な使い方として、自動再インポートと合わせることで
- CSVを変更すると同時にDataTableが変更される
- DataTableの変更と同時にChartDataAssetが変更される
- 即座にエディタでプレイ中のゲームに反映される
を実現することができます。
自動再インポートの公式ドキュメント: https://docs.unrealengine.com/4.26/ja/Basics/AssetsAndPackages/AutoReImport/
DataTable
からChartDataAsset
とGameplayTagDataTable
を生成します。
ChartDataAsset
には元となったDataTable
とほぼ同等のデータが格納されており、そのキーはGameplayTag
です。
キーであるGameplayTag
はGameplayTagDataTable
によって自動的に登録されます。
したがって元となるDataTableの内容を直接編集した場合(インポートを経由しない場合)はBuildFromDataTable
ボタンを押す必要があります。
ProjectSettings-Plugins-StudioThursdayChart
内にあります。
例えば生成元となるDataTableの接頭辞の設定はSourceDataTablePrefixです。
ProjectSettings-Project-GameplayTags
内にあります。
UnrealEngine 5.1.1-23901901+++UE5+Release-5.1
当リポジトリのIssuesへお願いいたします。