【Godot】仮想パス「res://」と「user://」の意味と使い分け

この記事では、Godot における res:// と user:// の違いと、用途ごとの使い分けについて整理します。

res:// と user:// の基本的な意味

res:// と user:// は、Godotで使用できる仮想パス表記です。以下に、それぞれの意味についてまとめます。

res:// … プロジェクト内リソース用パス

• プロジェクトのルートフォルダ（project.godot がある場所）を基準とした仮想パスです。
• ゲーム内の シーン、テクスチャ、スクリプト など「プロジェクト側で用意した資源」を参照する際に使います。
• エディタで実行しているときは読み書き可能ですが、エクスポート後は基本的に読み取り専用になります。

var enemy_scene = preload("res://scenes/Enemy.tscn")

user:// … ユーザーが書き込むデータ用パス

• ゲームがユーザー環境で動作しているときに 確実に書き込み可能 なフォルダを指す仮想パスです。
• セーブデータ、設定ファイル、スクリーンショット、ダウンロードされたコンテンツなど、ユーザー固有の永続データに使います。
• エクスポート後でも書き込み可能で、OSごとに以下のパスで保存されます
  • Windows ：%APPDATA%／Godot／[プロジェクト名]
  • macOS　： ~/Library/Application Support/Godot/app_userdata/[プロジェクト名]

var save_file_path = "user://save/game1.save"

上記の保存先フォルダは、Godotエディタのメニューバー＞プロジェクト＞ユーザーデータフォルダーを開く　から開くことができます。（テスト時に便利なアクセスです）

どう使い分けるべきか

それぞれをどう使い分けるかを簡単にまとめると以下のようになります。
要は、読み取り専用でパッケージに含めるのが res:// で、ビルド後のゲームで読み書きがあるものはuser://に配置します。

参考リンク

以下は res:// と user:// の挙動や定義を説明している公式ドキュメントです：