楽天ブラックフライデー開催中!セール会場へ

Spineの書き出し|JSON・アトラスと版の確認

Spine で作ったアニメーションをゲームで動かすには、データ(JSON かバイナリ)と、画像をまとめたテクスチャアトラスを書き出します。

  • データは JSON かバイナリ。バイナリのほうがかなり小さい
  • 「Pack」にチェックを入れると、データと一緒にテクスチャアトラスも作られる
  • 書き出したエディタの版(4.3 など)と、ゲーム側のランタイムの版はそろえる
  • GIF・PNG・動画(AVI・MOV)でも書き出せる

書き出しの画面は、メインメニューの Export(エクスポート)か、Ctrl+E(Mac は Cmd+E)で開きます。

前回と同じ書き出しを繰り返すときは、Ctrl+Shift+E(Mac は Cmd+Shift+E)です。

設定名は英語の画面表記で書き、公式の日本語ガイドの訳を( )で添えます。

内容は2026年11月20日に公式の日本語ガイド(エクスポート・テクスチャパッキング・バージョン設定)で確かめたもので、Spine と Unity の実機で書き出した結果ではありません。

書き出しとテクスチャパックは Essential にも含まれますが、体験版では使えません。

Photoshop のレイヤーを Spine に取り込む向きの書き出しは、Photoshop 側のスクリプトで行います(PhotoshopToSpine の解説)。

目次

エディタとランタイムの版を合わせる

書き出したエディタの版の、最初の2つの数字(4.3 など)は、ランタイムの版と一致させる必要があります。

違っていると、ランタイムはデータを読めません。

安定版では先頭2数字が同じ範囲のパッチ更新に互換性があります。

エディタとランタイムのパッチ番号は別々の番号なので、3つ目まで一致させる必要はありません。

ベータ版は対応状況を別に確認します。

エディタの版は、起動したときのランチャーか設定の画面で選べます。

スポンサーリンク

書き出せる形式

種類主な形式の例
データJSON・バイナリ
画像GIF・PNG・APNG・PSD・JPEG・WEBP
動画AVI・MOV・WEBM など。使用版とエンコード設定を確認
Spine ユーザーガイド「エクスポート」と変更履歴(WEBP・WEBM は 4.1 で追加)をもとに作成

JSONとバイナリ

バイナリは JSON よりファイルがかなり小さく、読み込みも速い形式です。

JSON は文字のファイルなので、中身を読んだり、Spine に読み戻したりできます。

公式ガイドは、アプリでは小さくて速いバイナリを使い、データを調べたり加工したりするときに JSON を使う、という使い分けを勧めています。

どちらも、プロジェクトのスケルトンごとに1つのファイルが作られます。

スケルトンの一部や、1つのアニメーションだけを書き出すことはできません。

JSON の設定働き
Output folder(出力フォルダ)スケルトンごとの JSON をここに書く。ファイル名はスケルトン名
Extension(拡張子)書き出すファイルの拡張子
Format(形式)標準のJSON、JavaScript(必要な名前だけ引用符で囲む)、Minimal(多くの名前や値の引用符を省く)
Pretty print(整形表示)人が読みやすいように整える。ファイルは少し大きくなる
Version(バージョン)古い版のデータとして書く(JSON だけ)
Nonessential data(非必須データ)実行には要らない追加の情報も入れる(Spine に読み戻すとき用)
Animation clean up(アニメーションクリーンアップ)書き出すデータだけ、不要なキーを整理する(プロジェクトは変えない)
Export all(全てをエクスポート)「エクスポート」のチェックを外した項目も書き出す
Pack(パック)書き出しと同時にテクスチャアトラスを作る
Spine ユーザーガイド「エクスポート」(日本語版)をもとに作成

Version で古い版を選ぶのは、公式ガイドでは、新しい版でうっかり保存してしまったときの最後の手段とされています。

バイナリの設定には、Format・Pretty print・Version がありません。

JSON ファイルの中身

公式のJSON出力形式によると、JSON は次の項目でできています。

  • skeleton:データのハッシュと、書き出した Spine の版
  • bones・slots:ボーンとスロットのセットアップポーズ
  • ik・transform・path:コンストレイント
  • skins:スキンごとのアタッチメント(画像の名前・メッシュの頂点など)
  • events:イベントの名前と初期値
  • animations:アニメーションごとのキー

「非必須」と書かれた項目(fps や画像のパスなど)は、Nonessential data にチェックしたときだけ入ります。

ゲーム側でデータを読み込むコードは各ランタイムが持っているので、自分で JSON を読むコードを書く必要はふつうありません。

公式のページの例は 3.8.24 で書き出したものなので、4.3 の項目を調べるときは自分の書き出したファイルと見比べてください。

テクスチャアトラスを作る

テクスチャアトラスは、パーツの画像を1枚(または数枚)の大きな画像にまとめたものです。

書き出しの画面で「Pack」にチェックを入れると、データと一緒に作られます。

アトラスは、拡張子 .atlas のテキストファイルと、1枚以上の「ページ画像」(PNG など)の組です。

.atlas ファイルには、パーツの画像(領域)がページ画像のどこにあるかが、名前つきで書かれています。

Pack の下では、詰める画像の探し方と、アトラスの分け方を選びます。

  • Attachments(アタッチメント):アタッチメントで使っている画像だけを詰める
  • Image folders(画像フォルダ):各スケルトンの画像パスのフォルダーを詰める(pack.json で設定できる)
  • Atlas per skeleton(各スケルトンごとのアトラス):スケルトンごとに1つ。名前はデータファイルと同じ
  • Single atlas(単一のアトラス):全スケルトンで1つ。名前はプロジェクトファイルの名前

メインメニューの Texture Packer(テクスチャ・パッカー)から、画像フォルダーだけを詰めることもできます。

Texture Packer の主な設定

設定働き
Strip whitespace X/Y(空白X/Y削除)画像の周りの透明な余白を削る
Rotation(回転)詰めるときに画像を90度回転させる
Max width / height(最大幅/高さ)1ページの最大寸法。収まらない場合は複数ページに分かれる
Power of two(2のべき乗)大きさを2の累乗にする
Padding X/Y(パディングX/Y)画像間の余白。公式の推奨値2pxを起点に、縮小表示やフィルターに応じて確認する
Bleed(ブリード)透明ピクセルのRGBを近くの不透明ピクセルの色で埋める。透明度は維持する
Premultiply alpha(乗算済みアルファ)色に透明度をかけた形(PMA)で書く
Packing(パッキング)Grid・Rectangles・Polygons から選ぶ。Polygons はメッシュの外周で密に詰める
Filter min / mag(フィルター縮小/拡大)縮小・拡大時のフィルター情報。取り込み側が適用するかも確認する
Atlas extension(アトラス拡張子)アトラスのファイルの拡張子(初期値 .atlas)
Legacy output(レガシー出力)4.0より前のランタイムで読める形式でアトラスを書く
Spine ユーザーガイド「テクスチャパッキング」(日本語版)をもとに作成

spine-unity 4.3以降の標準手順では、Premultiply alphaをオフ、Bleedをオンにしてストレートアルファで書き出します。

Unity側のテクスチャ設定とマテリアルも同じ方式にそろえます。

4.2以前の標準だったPMAを使う既存データでは、出力だけを切り替えないでください。

公式ではPMA方式はGamma色空間での利用に限定しています。

Unityで使うときの拡張子

spine-unity は拡張子 .skel を読めないので、バイナリは .skel.bytes、アトラスは .atlas.txt にします。

Unity での読み込みは、Spineのデータをspine-unityで動かす方法で紹介しています。

画像や動画で書き出す

画像や動画の書き出しでは、FPS、書き出すアニメーションやスキン、範囲(Range)、背景色などを決めます。

GIF では、最大の色数とディザ(色の少なさを点で補う)も設定できます。

コマンドラインでまとめて書き出す

書き出しは、コマンドラインインターフェース(CLI)からも実行できます。

書き出しの画面の下にある Save(保存)で設定を JSON に保存しておくと、同じ設定で何度でも書き出せます。

公式ガイドに載っている例は次のとおりです。

Spine -i /path/to/project.spine -o /path/to/output/ -e /path/to/export.json
Spine -i /path/to/project.spine -o /path/to/output/ -e binary+pack

-e に設定ファイルの代わりに json・binary・json+pack・binary+pack を書くと、初期設定で書き出します。

使う Spine の版は -u(--update)で指定でき、4.3.xx と書くと 4.3 の最新のパッチ版になります。

たくさんのプロジェクトを一度に書き出すなら、公式の書き出し用スクリプト(Windows は spine-export.bat、Mac・Linux は spine-export.sh)が使えます。

4.3で増えたこと

  • スキンごとにアトラスを書き出す機能(変更履歴では 4.3.40-beta で追加)
  • PNG を小さくする「brute force」設定(4.3.56-beta で追加)。4.3.82-beta で既定がオフに変わったので、常に有効とは限らない

練習用の書き出しと読み込み確認

元の.spineプロジェクトと画像フォルダーを残し、複製で書き出します。

既存の出力を上書きせず、practice-exportのような別フォルダーを指定します。

SpineのメインメニューでExportを選びます。

ショートカットはWindowsではCtrl+E、MacではCmd+Eです。

最初のUnity向け確認ではJSONを選び、Texture AtlasのPackをオンにします。

公式の初心者向け手順では、Nonessential dataとPretty printも有効にします。

Animation cleanupは無効にしてください。

有効にするとセットアップポーズと同じキーが書き出されず、確認したいキーが省かれるためです。

Pack SettingsでAtlas extensionを.atlas.txtにします。

4.3以降では前述のストレートアルファ設定を確認し、OKで戻ります。

別の出力フォルダーを指定し、Exportを押して、次のファイル一式を確認します。

本番用にバイナリへ切り替える場合は、Binaryを選び、Extensionを.skel.bytesにします。

データ・アトラス・画像ページを1組として比較します。

出力Unity用の例確認する内容
JSON形式practice.jsonスケルトン名と版の先頭2数字を確認
バイナリ形式practice.skel.bytes書き出したエディタ版とランタイム版をそろえる
アトラスpractice.atlas.txt記載された画像ページ名と実ファイルを照合
画像ページpractice.png等複数ページの場合はすべて同じ組に含める

JSON・JavaScript・Minimalは同じ内容の表記違いですが、読込み側が各形式に対応しているとは限りません。

一般的なJSONパーサーへ渡す場合は標準JSONを選びます。

Unityの複製プロジェクトで_SkeletonDataの生成、プレビューとアニメーション名、実際の画像の表示まで確認します。

ファイルが存在するだけでは成功と判断しません。

書き出したデータが読めないときの対処と戻し方

症状最初の確認復旧方法
版不一致エディタとランタイムの先頭2数字対応版で開ける元.spineまたは旧版バックアップから再書き出し
白い・画像が欠けるatlasのページ名とPNGの組出力を別フォルダーで作り直し一組で取り込む
輪郭が黒い・色が違うPMA/ストレート、色空間、マテリアル一条件ずつそろえて比較
データを戻したいNonessential dataと元プロジェクト元.spineと元画像から再開

新しいEditorで保存した.spineは、それより古いEditorでは開けません。

spine-unity のダウンロードページは、ランタイムは自分の版と違うバイナリを読み込めないと注意しています。

JSON のほうが新しい版でも読める見込みは高いものの、それでも壊れることがあると書かれています。

版を戻す場合は、先に旧版で保存したバックアップを探してください。

Runtimesを新しい版へ更新できる場合は、Editorも合わせて元プロジェクトから再出力します。

古いVersionへの書き出しは完全な変換を保証せず、失われるデータと警告を確認する最終手段です。

JSONのVersionで旧版向けに出力した後は、旧Editorへ読み戻し、警告とアニメーションを確認します。

バイナリをJSONのように編集したり、拡張子の変更だけで版を変換したりしません。

練習ファイルと確認済みの範囲

Spine関連の練習入力とC#コードをダウンロード。

2本のC#例は参照・名前・待ち時間の異常系をローカルのテストダブルで検査し、4.3のAPI宣言を一次資料で照合しました。

実際のSpine/Unityコンパイル・描画・スキン・書き出し・変形は未検証です。

コードは4.3用です。

練習の完了は、それぞれ本文の表示・再生・復元を実環境で確認して判断します。

スポンサーリンク

まとめ

  • ゲーム用は JSON かバイナリ。バイナリのほうが小さい
  • 「Pack」でアトラスも作り、画像間の余白と実際の縮小表示を確認する
  • エディタとランタイムの版(4.3 など)はそろえる
  • Unity 用は .skel.bytes と .atlas.txt

次にやること:書き出したファイルを Unity で動かすなら、Spine Unityの使い方に進みます。

メッシュを使うデータを作るときは、Spineのメッシュの作り方も見てください。

参考:Esoteric Software の公式ガイド(日本語版)エクスポート、テクスチャパッキング、バージョン設定、JSON出力形式、コマンドラインインターフェース、spine-unity アセット、変更履歴(2026年11月20日確認)。

Spine と Unity での書き出し・読み込み・描画は実行していません。

次に学ぶ・作業環境を選ぶ

学習を続けたい方や、作業環境を整えたい方は、目的に合うガイドをご覧ください。

3DCGのおすすめ書籍

3DCG用PCの選び方

周辺機器の優先度

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

須澤 元貴のアバター 須澤 元貴 代表社員

MOTOKI合同会社 代表社員。
アニメ・映像業界とゲーム業界で、2D・UI・3D・アニメーション制作、映像編集、ツール制作に携わってきました。
現在はWordPressを中心にWebサイトの制作とカスタマイズを手がけています。
著書に『Unity デザイナーズ・バイブル』『Unityゲーム プログラミング・バイブル 2nd Generation』(ボーンデジタル)。
岡山県出身、埼玉県在住。

目次