🔧 PITMとは
PITM(Programmable Item Template Model) は、clusterで使用される3Dアイテムのデータフォーマットです。
アクセサリーやクラフトアイテムのモデル・挙動・スクリプトを統一形式で表現できます。
glTF形式の3Dモデルに加え、cluster独自のメタデータやClusterScriptを追加することで、非Unity環境でもインタラクティブアイテムが作成可能になります。
📁 PITMデータ構造
PITMは以下のような構成でデータを持ちます:
- 3Dモデル(.glb) - ベースとなるビジュアルデータ
- manifest.json - アイテムの種別や設定
- script.js - ClusterScriptで記述された動作スクリプト
これらをまとめて1つのZIP形式にパッケージングし、APIを通じてアップロードします。
🚀 アップロードAPI
PITMファイルは cluster サーバーへ POST リクエストでアップロード可能です。
認証やAPI仕様については以下のドキュメントを参照してください。
🧪 サンプルコード
以下のGitHubリポジトリでサンプルコードが公開されています:
- ClusterVR/PITMSample
- Pythonによるミニマル実装
- blenderアドオンや画像→アイテム変換ツールの実装例もあり
⚠️ 注意点と留意事項
- PITM仕様の公開は実験的な取り組みです
- 仕様は予告なく変更・非公開となる可能性があります
- 不具合(アップロードできない・動作しないなど)は Discord などで報告歓迎
安定版ではないことを理解した上で、拡張ツール開発や非公式エディタ等への応用が可能です。