主に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.webp

manifest.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個まで。

正位置と逆位置

デッキ作成後、デッキ一覧の 正逆ランダム にすると、カードを引くたびに正位置または逆位置がランダムに決まります。

kindtarottarot-major など tarot で始まるカードセットは、デッキ作成時の初期設定がランダムになります。

読み込み手順

  1. 部屋にGMとして入ります。
  2. カード/デッキ ツールを開きます。
  3. zipインポート からカードセットZIPを選びます。
  4. 追加されたカードセットを選びます。
  5. デッキ作成 を押します。
  6. 卓上の山札を右クリックしてカードを引きます。

よくあるエラー

エラーコードが表示された場合は、原因を直してから同じ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内に絶対パス、ドライブ名、または .. を含む危険なパスがあります。通常の相対フォルダ構成で圧縮し直します。