インスタンスフォルダーの構造

インスタンスフォルダーの場所

各 GDLauncher インスタンスは Runtime Path のサブフォルダーに置かれます:

<runtime_path>/
└── instances/
    └── <shortpath>/        ← インスタンスフォルダー

<shortpath> は表示名をサニタイズしたもの。GDLauncher 内でインスタンスを右クリック → Open Folder で直接開けます。

中身

インスタンスフォルダーはトップレベルに GDLauncher が追跡するいくつかの項目と、Minecraft の実際のゲームディレクトリとなる instance/ サブフォルダーに分かれます。常に存在するものもあれば、何かが書き込もうとした最初のときに作成されるものもあります。

<shortpath>/
├── instance.json          ← GDLauncher のインスタンスメタデータ (常に存在)
├── packinfo.json          ← Modpack ペアリング情報 (ペア済みパックのみ)
├── icon.png | icon.webp   ← カスタムアイコン (設定時のみ)
├── logs/                  ← GDLauncher のインスタンス別ランチャーログ
└── instance/              ← Minecraft のゲームディレクトリ
    ├── mods/              ← Mod JAR
    ├── config/            ← Mod 設定
    ├── shaderpacks/       ← シェーダーパック (インストール時)
    ├── options.txt        ← Minecraft クライアント設定 (初回起動後)
    ├── logs/              ← Minecraft セッションログ (latest.log など)
    ├── saves/             ← ワールド (ワールド生成時に作成)
    ├── screenshots/       ← F2 スクリーンショット (初回 F2 時に作成)
    ├── crash-reports/     ← クラッシュダンプ (クラッシュが起きたときのみ)
    ├── resourcepacks/     ← カスタムリソースパック (追加時)
    ├── datapacks/         ← グローバルデータパック (ワールド限定は saves/<world>/datapacks/)
    └── (パック固有)        ← kubejs/、defaultconfigs/、packmenu/ など、パックが同梱する場合のみ

新しいインスタンスでこれらの一部がないことを気にしないでください。ランチャーと Minecraft は必要なときに必要なものだけ作成します。一度もプレイしていないインスタンスには saves/、screenshots/、options.txt はありません。Vanilla インスタンスには mods/ も config/ もありません。

各項目の中身

トップレベルファイル

• instance.json: GDLauncher のメタデータ、名前、アイコンパス、Mod ローダーとバージョン、Minecraft バージョン、作成時刻、最終プレイ時刻、合計プレイ時間。常に存在。
• packinfo.json: Modpack から来たファイルのハッシュマニフェスト。パック管理 Mod と自分で追加したものをランチャーが区別できます。CurseForge / Modrinth Modpack とペアのインスタンスでのみ存在。
• icon.png または icon.webp: アップロードしたカスタムアイコン。デフォルトアイコンの場合は存在しません。

logs/ (トップレベル)

GDLauncher のインスタンス別ログ。右クリック → View Logs で開けるのはここの中身。ランチャー側 から見た起動 (Java 引数、アセットダウンロード、Mod ローダーインストール、終了コード) を記録。Minecraft 本体が自前のログを書く前にクラッシュしたときに役立ちます。

instance/mods/

Mod の JAR ファイル。Minecraft が起動時にここの全部を読み込み (Mod ローダーのルールに従う)。ランチャーはどの Mod がインスタンスに属するかを内部 DB で管理 (ファイル名とコンテンツハッシュをキーに), サイドカーファイルはありません。手動で置いた JAR も拾われますが、CurseForge / Modrinth メタデータはランチャー側にありません。

instance/config/

Mod ごとに 1 サブフォルダーまたは 1 ファイル。Mod 設定の永続化先。多くの Mod は config/<modid>.toml や config/<modid>/ を作ります。手編集は基本的に安全で、再起動時に反映されます。

instance/resourcepacks/, instance/shaderpacks/, instance/datapacks/

アセットパック。リソースパックはテクスチャと音、シェーダーパックは描画 (Iris/OptiFine などを Mod として導入していること前提)、データパックはレシピ・ルートテーブル・ファンクションを追加。ワールド限定のデータパックは saves/<world>/datapacks/ に入れます。これらのフォルダーは実際にコンテンツがあるときのみ作成されます。

instance/saves/

ワールドごとに 1 サブフォルダー。中の level.dat がマスターファイル、region/ にチャンクデータ、playerdata/ にプレイヤー別状態、datapacks/ にワールドスコープのデータパック。ワールドのバックアップは <world>/ フォルダーをまるごとコピー。saves/ 自体は初めてワールドを生成したときに作成されます。

instance/screenshots/

F2 で撮った PNG、タイムスタンプで命名。初回スクリーンショット時に作成されます。

instance/logs/ と instance/crash-reports/

Minecraft 自身の診断出力。logs/latest.log は常に最新の起動分 (次の起動時に logs/<date>-1.log.gz にロール)。crash-reports/ は完全なクラッシュダンプ、実際にクラッシュが発生したときにのみ作成されます。

instance/options.txt

Minecraft クライアント設定 (グラフィック、操作、サウンド)。プレーンテキスト、key=value。手編集可能。

パック固有のフォルダー

大型 Modpack は追加フォルダーを同梱します。よくあるもの:

• kubejs/: KubeJS スクリプト (server_scripts/、client_scripts/、startup_scripts/、data/、assets/)。パック作者がランタイム調整に使用。
• defaultconfigs/: 「デフォルトでの設定の見た目」のスナップショット。パックの起動スクリプトが各起動で config/ に欠落エントリをコピー。
• packmenu/: パックテーマのメインメニューアセット (カスタムボタン、背景、スプラッシュテキスト)。
• defaultsettings/: defaultconfigs/ と類似だが、options.txt とキーバインド用。

パックが同梱する場合のみ存在。Vanilla とほとんどのカスタムインスタンスにはありません。

削除して安全なもの

ロックされた Modpack インスタンスについて

インスタンスフォルダーはディスク上の普通のフォルダー。GDLauncher がかける Modpack ロックは UI レベルで強制されるもので、ファイルシステムでは強制されません。ロックされたインスタンスの instance/mods/ に直接 JAR を入れれば動きますが、Addons タブからは認識されません。削除はファイルシステムから行う必要があります。安全な運用のため、まずインスタンスを開いて Settings タブの Modpack セクションで Unlock を押すのを推奨。