主にGM / 素材制作者
カードZIPインポートFAQ
独自カードセットをZIPで追加するための形式、上限、サンプル、よくあるエラーです。
最終更新: 2026年7月13日
できること
GMは独自カード画像をZIPにまとめて読み込み、部屋内のカードセットとして追加できます。追加したカードセットは、その部屋の中だけで使えます。
読み込み後はカードセットを選び、デッキを作成します。卓上の山札を右クリックするとカードを引けます。
引いたカード盤面上のピースとして移動、回転、表向き、裏向き、自分だけ見る、山札へ戻す、戻して混ぜる操作ができます。デッキシャッフル、捨て札込みシャッフル、カード表示倍率、正位置/逆位置のランダムドロー設定を使えます。操作できる人カードZIPの読み込み、デッキ作成、シャッフル、デッキ削除はGMだけが行えます。
ZIPの基本形
推奨構成は、ZIPのルートに manifest.json を置き、カード画像を cards/ などのフォルダにまとめる形です。
my-card-set.zip
manifest.json
cards/
back.webp
card-001.webp
card-002.webpmanifest.json は省略できますが、カード名、表示名、縦横比、ライセンス表示を正しく持たせたい場合は入れてください。
manifest.json
{
"name": "サンプルカードセット",
"kind": "custom",
"width": 180,
"height": 252,
"defaultBack": "cards/back.webp",
"cards": [
{
"id": "card-001",
"name": "Card 001",
"label": "カード001",
"front": "cards/card-001.webp",
"tags": ["sample"]
}
]
}nameカードセット一覧に表示される名前。未指定時はZIPファイル名が使われます。kind種別を表す任意文字列です。例: custom, tarot, playing-cards。width / heightカード画像の基準サイズです。20から1000まで。未指定または範囲外なら 180 x 252 になります。defaultBack共通の裏面画像です。back でも指定できます。cardsカード定義配列です。1枚以上必要です。license表示用のライセンス情報です。label, url, attribution などを入れられます。
カード定義
id任意のカードIDです。英数字、_、- 推奨。未指定時は画像ファイル名から作られます。name内部名です。未指定時は label または画像ファイル名が使われます。label卓上や管理表示で使う短い表示名です。未指定時は name または画像ファイル名が使われます。front表面画像です。image でも指定できます。backこのカード専用の裏面画像です。未指定時は defaultBack が使われます。tags検索・分類用の文字列配列です。最大20個まで保持されます。
manifestなし
画像だけのZIPでもカードセットを推測できます。
裏面画像back, cardback, card-back, cover, ura, 裏 に一致する画像を裏面として使います。カード画像裏面以外の画像を、ファイル名順でカードにします。カード名カード名と表示名は画像ファイル名から作られます。基準サイズwidth: 180, height: 252 になります。
画像と上限
対応形式.png, .jpg, .jpeg, .webp, .gif, .bmp, .avif。SVGは読み込めません。アップロードZIP20MBまで。ZIP内ファイル数200件まで。ZIP展開後合計30MBまで。manifest.json256KBまで。カード枚数128枚まで。画像ファイル数160枚まで。共通裏面やカード専用裏面も含みます。画像1枚512KBまで。画像合計20MBまで。部屋内デッキ数8個まで。
正位置と逆位置
デッキ作成後、デッキ一覧の 正逆 を ランダム にすると、カードを引くたびに正位置または逆位置がランダムに決まります。
kind が tarot や tarot-major など tarot で始まるカードセットは、デッキ作成時の初期設定がランダムになります。
読み込み手順
- 部屋にGMとして入ります。
- カード/デッキ ツールを開きます。
- zipインポート からカードセットZIPを選びます。
- 追加されたカードセットを選びます。
- デッキ作成 を押します。
- 卓上の山札を右クリックしてカードを引きます。
よくあるエラー
エラーコードが表示された場合は、原因を直してから同じZIPを選び直します。読み込みに失敗したZIPから部屋へカードセットは追加されません。
zip_requiredファイルが未選択です。zip拡張子のファイルを選び直します。zip_too_largeZIPまたは展開後の合計が上限超過です。不要ファイルを除き、画像を圧縮します。invalid_zipZIPとして展開できません。ファイルを再圧縮し、破損していないか確認します。too_many_zip_entriesZIP内が200件を超えています。不要ファイルや余分なフォルダを除きます。manifest_too_large / invalid_card_manifestmanifest.jsonが256KB超過、またはJSONとして不正です。JSONの括弧、カンマ、文字コードを確認します。card_images_not_found / cards_required対応画像またはカード定義がありません。表面画像を追加し、manifestのcardsを確認します。default_back_not_found共通裏面が見つかりません。defaultBackのパスとZIP内ファイル名を一致させます。front_not_found / back_not_foundmanifestの画像パスとZIP内の場所・大文字小文字が一致しているか確認します。unsupported_card_image / svg_rejected非対応形式またはSVGです。PNG、JPEG、WebPなどの対応形式へ変換します。too_many_cards / too_many_card_imagesカード128枚または画像160枚の上限を超えています。カードセットを分割します。card_images_too_large1枚512KBまたは画像合計20MBを超えています。解像度や画質を下げて圧縮します。invalid_zip_pathZIP内に絶対パス、ドライブ名、または .. を含む危険なパスがあります。通常の相対フォルダ構成で圧縮し直します。