pdx (Playdate Executable [実行ファイル])
1. “.pdx” とは何か？
pdx は、Playdate上で動作する「ゲームプログラム本体」です。
一見すると一つのファイルのよう（macOSではパッケージとして表示される）に見えますが、その実体は特定の構造を持った「フォルダ（ディレクトリ）」です。
このフォルダの中に、実行コード、画像、音声、設定ファイルなどがすべて格納されています。
2. pdxファイルの中身（構造）
| ファイル名 / 拡張子 |
内容・役割 |
| pdxinfo |
ゲームのタイトル、開発者名、バージョン、一意のIDなどを記述したテキストファイル。ランチャーでの表示に不可欠です |
| main.pdz |
Luaで開発された場合の、コンパイル済みLuaバイトコード |
| pdex.bin |
C言語で開発された場合の、Playdate実機用バイナリ |
| pdex.so / .dll |
Playdate Simulator（PC）で動作させるための共有ライブラリ |
| .pdi |
Playdate用に最適化された画像ファイル（Playdate Image） |
| .pda |
Playdate用に最適化された音声ファイル（Playdate Audio） |
3. どうやって作られるのか？
- 1. ソースフォルダの準備
- main.lua や画像素材を一つのフォルダにまとめる。
- 2. コンパイル
- ターミナルで
pdc source_folder output.pdx
- を実行。
- 3. 最適化
- pdc は単にファイルをまとめるだけでなく、画像を1ビット（白黒）の独自形式に変換したり、Luaをバイトコード化したりして、実機で高速に動くように処理します。
4. 実行と配布
Playdateは非常にオープンな設計になっており、自作した .pdx ファイルを動かすのはとても簡単です。
- Playdate Simulatorでの実行
- PC上のPlaydate Simulatorに .pdx フォルダをドラッグ＆ドロップするだけで即座に起動します。
- 実機への転送（Sideloading）
- USB経由で直接マウントして Games フォルダにコピーする
- Playdate公式サイトのユーザーアカウントページから .pdx をアップロードし、Wi-Fi経由で実機に「無線転送」する
- 公式ストア (Catalog)
- Panic社が運営するストアで販売・配布される際も、ベースはこの .pdx 形式です。
5. 開発者向けの注意点
- 大文字・小文字の区別
- Playdateの実機OS（Playdate OS）はファイル名の大文字・小文字を厳密に区別します。
- WindowsやmacOS（標準設定）では区別されないため、Simulatorで動いても実機でエラーが出る原因の多くはこれです。
- pdxinfo の重要性
- bundleID が重複していると、既存のゲームを上書きしてしまう可能性があります。
- 豆知識
- .pdx は単なるフォルダなので、中身を覗きたいときは右クリック（macOSなら「パッケージの内容を表示」）したり、ターミナルで中に入ったりするだけで、どんなアセットが使われているか簡単に確認できます。
関連ページ
最終更新：2026年04月26日 19:15
