【Godot】カスタムリソース（Custom Resource）の作成と活用 - Godot Engineで実現するデータ駆動設計

なぜカスタムリソースが重要なのか：データ駆動設計への第一歩

Godot Engineでゲーム開発を進める際、ゲーム内のデータ管理は避けて通れない課題です。キャラクターのステータス、アイテムの定義、敵のAI設定など、多くのデータがゲームの挙動を決定します。これらのデータをノードやシーンに直接記述してしまうと、データの再利用が難しくなり、プロジェクトの規模が大きくなるにつれて管理が複雑化し、変更が困難になります。

ここで カスタムリソース（Custom Resource） の出番です。カスタムリソースは、Godotの強力な リソース（Resource） システムを拡張し、独自のデータ型を作成・保存するための仕組みです。UnityにおけるScriptableObjectに近い概念であり、ゲームロジックからデータを分離し、データ駆動設計（Data-Driven Design） を実現するための鍵となります。

データ駆動設計とは、ゲームの挙動をコードではなくデータによって制御する設計思想です。これにより、プログラマーでなくてもデータを編集してゲームバランスを調整できるようになり、開発の柔軟性とイテレーション速度が大幅に向上します。

カスタムリソースの基本概念

Godotにおけるリソースとは、ディスクに保存できるデータコンテナです。シーン、スクリプト、テクスチャ、オーディオなど、プロジェクト内のほとんどの非ノードデータはリソースとして扱われます。カスタムリソースは、このResourceクラスを継承したスクリプトを作成することで定義されます。

1. カスタムリソースの定義

カスタムリソースは、Resourceクラスを継承したGDScriptファイルとして作成します。このスクリプト内で、保存したいデータに対応するプロパティを@exportアノテーションを付けて定義します。

# res://resources/character_data.gd
# Resourceクラスを継承し、カスタムリソースとして機能させる
class_name CharacterData extends Resource

# @exportアノテーションを付けることで、インスペクタで編集可能になり、リソースファイルに保存される
@export var character_name: String = "New Character"
@export var max_health: int = 100
@export var attack_power: float = 15.0
@export var skills: Array[String] = []

# データにアクセスするためのメソッドを定義することも可能
func get_description() -> String:
    return "Name: %s, HP: %d, ATK: %.1f" % [character_name, max_health, attack_power]

2. リソースファイルの作成と編集

上記のスクリプトを保存した後、Godotエディタ内で「新規リソースの作成」から、定義したCharacterData型を選択し、.tres（Text Resource）または.res（Binary Resource）ファイルとして保存します。

保存されたリソースファイル（例: res://data/player_stats.tres）をインスペクタで開くと、@exportで定義したプロパティがGUIで編集可能になります。これにより、コードを一切変更することなく、キャラクターのステータスデータを調整できます。

実践的な活用例：アイテムデータベースの構築

カスタムリソースの最も強力な活用法の一つは、ゲーム内のアイテムやエンティティのデータベース構築です。

3. アイテムリソースの定義

まず、すべてのアイテムの基盤となるカスタムリソースを定義します。

# res://resources/item_data.gd
class_name ItemData extends Resource

@export var item_id: int = 0
@export var item_name: String = "Unknown Item"
@export_multiline var description: String = "A mysterious item."
@export var icon_texture: Texture2D # アイコン用のテクスチャもリソースとして保存可能
@export var stackable: bool = true
@export var max_stack: int = 99

4. 派生リソースの作成

特定の種類のアイテム（例: 武器、ポーション）には、さらに固有のプロパティが必要になる場合があります。その場合、ItemDataを継承したカスタムリソースを作成します。

# res://resources/weapon_data.gd
class_name WeaponData extends ItemData

@export var attack_bonus: float = 5.0
@export var weapon_type: String = "Sword"
@export var two_handed: bool = false

5. ゲーム内での利用

ゲーム内のインベントリシステムやショップシステムでは、これらのリソースファイルをロードして利用します。リソースは一度ロードされると、複数の場所で共有されるため、メモリ効率も優れています。

# インベントリを管理するノードのスクリプト
extends Node

# 武器リソースを直接エクスポートしてインスペクタから設定
@export var equipped_weapon: WeaponData

func _ready():
    if equipped_weapon:
        print("装備中の武器: %s" % equipped_weapon.item_name)
        print("攻撃力ボーナス: %s" % equipped_weapon.attack_bonus)
        # データを参照してゲームロジックを実行
        if equipped_weapon.two_handed:
            print("両手持ち武器です。")

# 外部ファイルからリソースをロードする例
func load_item_data(path: String) -> ItemData:
    # ResourceLoader.load()でリソースファイルをロード
    var item_resource = ResourceLoader.load(path)
    if item_resource is ItemData:
        return item_resource
    return null

カスタムリソースのメリットとデータ駆動設計

カスタムリソースを活用することで、以下のような大きなメリットが得られます。

メリット	説明	データ駆動設計との関連
データの分離	ゲームロジック（GDScript）とデータ（.tresファイル）が完全に分離されるため、コードの可読性と保守性が向上します。	データがコードから独立し、変更が容易になる。
再利用性	一度作成したリソースファイルは、複数のシーンやノードで共有・再利用できます。これにより、データの重複を防ぎ、一貫性を保てます。	データの定義が一箇所に集約される（Single Source of Truth）。
エディタ統合	@exportプロパティはGodotのインスペクタに表示され、プログラミング知識がなくてもデザイナーやプランナーがデータを直感的に編集できます。	開発チーム全体がデータにアクセスしやすくなる。
インスタンス化	リソースはノードとは異なり、シーンツリーに属しません。Resource.duplicate()メソッドを使えば、簡単にデータのコピー（インスタンス）を作成できます。	実行時にデータを動的に生成・変更する基盤となる。

まとめ：カスタムリソースでプロジェクトをスケーラブルに

Godot Engineのカスタムリソースは、単なるデータ保存の仕組みではなく、プロジェクトの設計思想を データ駆動型 へと進化させるための強力なツールです。

初心者の方は、まずキャラクターの基本ステータスやシンプルなアイテム定義からカスタムリソースの導入を試みてください。これにより、ゲームのデータ管理が劇的に改善され、より大規模で複雑なプロジェクトにも対応できるスケーラブルな設計基盤を築くことができます。

カスタムリソースを使いこなすことは、Godot Engineでの開発を次のレベルへと引き上げるための重要なステップとなるでしょう。