Phaserでアトラスのフレームが反転・ずれる時
Phaserでアトラスのフレームが反転したり、回ったり、欠けたりするなら、たいていアトラスの回転が原因です。私たちのエンジン実行では、Phaser 3.90と4.2のどちらも回転したTexturePackerのフレームを元の向きに戻さず、正しく描けませんでした（ある実行では左右反転、別の実行では横倒しで欠け）。Phaser 3.90だけでずれるなら、トリム済みのStarling/Sparrow XMLが原因で、3.90のXMLパーサーが2つのサイズを取り違えて読みます。
Phaserでアトラスの一部のフレームがおかしいときは、コードより先にデータファイルを見てください。"rotated": trueの項目：検証の実行でPhaser 3.90と4.2はこうしたフレームを戻して描けなかったので、回転なしでパックし直します。Phaser 3.90でトリムしたStarling/Sparrow XML（frameXがある）：XMLパーサーがトリム後と元の大きさを逆の順で渡すため、JSONアトラス、トリムなし、またはPhaser 4.2を使います。それ以外は、フレーム名とファイルをローダーの呼び出しと照らし合わせます。Nerulioは既存のアトラスを修正せず、Phaserが読める設定でフレームをパックし直します。
- Phaser 3 / 4検証済み· Phaser 3.90 + 4.2
- Starling / Sparrow XML検証済み· Phaser 4.2
- Godot 4検証済み· Godot 4.7.2
- Unity 6検証済み· Unity 6000.5.3f1
- PixiJS 8検証済み· PixiJS 8.21
- Aseprite JSON検証済み· Phaser load.aseprite · PixiJS 8.21
- .aseprite検証済み· Aseprite 1.3.18
- Spine / libGDX検証済み· spine-canvas 4.2
- LÖVE検証済み· LÖVE 11.5
- Defoldビルド確認· Defold bob.jar 1.13.1
- GameMaker未検証
- CSS sprites検証済み· Chromium
- GIF / APNGデコード確認· Pillow
3つの原因と、見るべき3つの場所
回転。パッカーは面積を節約するためにフレームを90度回して保存し、rotatedと印を付けることがあります。PhaserのJSONパーサーはそのフレームに印を付けてテクスチャ座標を変えますが、Phaser 3.90と4.2での検証では、まさに回転したフレームだけが崩れ、同じアトラスの正立したフレームは正しく描かれました。TexturePacker自身の回転ありの書き出しで一致したのは、弓兵10フレーム中6、サムライ60フレーム中40、トゥーン45フレーム中9でした。
XMLのトリム。Sparrow形式はトリムをframeX、frameY、frameWidth、frameHeightで保存します。Phaser 3.90のAtlasXMLはsetTrim(width, height, frameX, frameY, frameWidth, frameHeight)を呼びますが、setTrimは元の大きさを先に、トリム後の大きさを最後に受け取ります。JSONパーサーはsourceSizeを先に渡すので、JSONアトラスは影響を受けません。
データの不一致。アトラスにないフレーム名、PNGとは別の書き出しのJSON、パック後に大きさを変えたPNGは、エンジンのバグがなくてもフレームを狂わせます。this.textures.get(key)で、違う矩形や存在しない名前として現れます。
- rotated
- ページ上に90度回して保存されたフレームの印。
- setTrim
- トリムした断片を元の大きさの枠に置く、PhaserのFrameのメソッド。
- frameX, frameY
- Sparrow XMLで、保存ピクセルから見たフレーム全体の負のオフセット。
回転かトリムか？項目を読む
回転したJSONの項目（TexturePacker形式）：
"run_0": { "frame": {"x":17,"y":23,"w":18,"h":15}, "rotated": true, … }
→ ページには15 × 18で保存。Phaser 3.90と4.2はこうしたフレームを崩して描いた → 回転なしでパックし直す
トリムしたSparrow XML：
SubTexture name="run_0" x="0" y="34" width="18" height="15" frameX="-10" frameY="-10" frameWidth="40" frameHeight="29"
Phaser 3.90の呼び出し setTrim(18, 15, 10, 10, 40, 29)
setTrimが期待する値 setTrim(40, 29, 10, 10, 18, 15) → 大きさとオフセットが狂う
Phaser 4.2：正常。 3.90での対処：JSONアトラス、またはトリムなしのXML
トリムしたJSON（バグではない）：sourceSize + spriteSourceSizeから setTrim(40, 29, 10, 10, 18, 15)ファイルにどちらの印もないのにフレームがおかしいなら、原因はほぼ必ずデータです。古いJSON、名前の変わったフレーム、大きさの変わったPNG。
できること
- Phaser 3 / 4プリセットは回転を使わず、別の書き出し先で回転をオンにしていても、この書き出しは回転を拒否。変わる設定は押す前に書き出しボタンの横に表示されます。
- JSONアトラスはトリムを維持。PhaserはspriteSourceSizeとsourceSizeを正しく読むので、どちらのバージョンでもトリムしたフレームが元の位置に来ます。
- XMLのプリセットは2つ。Starling / Sparrow XMLはトリムを保ちPhaser 4.2で正常、Sparrow XML (Phaser 3)はトリムを切ってPhaser 3.90でも全フレームが元の位置に。
- 根拠：実在のCC0素材で実エンジンを49回実行し47回合格。不合格の2回はまさにPhaser 3.90のトリム済みXMLで、不具合を示すためにレポートに残しています。
- 作成済みのアトラス（PNGとTexturePacker JSONかStarling XML）も読み込めますが、回転したフレームは回転したままで、その書き出しは未検証です。元のフレームがあればそちらでパックし直してください。
使い方
- 元のフレーム、.aseprite、またはシート（適用まで）を入れる。
- パック＆書き出しでPhaser 3 / 4を選ぶ（回転オフ、トリムオン）。
- Phaser 3.90でXMLを使うならSparrow XML (Phaser 3)、4.2ならどちらのXMLプリセットでも可。
- 書き出してthis.load.atlasかthis.load.atlasXMLで読み込み、いくつかのフレームをフローティングプレビュー（F7）と見比べる。
結果の確認
- 全フレームを静止画としてグリッドに描き（名前ごとに
this.add.image(x, y, key, name)）、元のフレームと並べて比べます。 - できればPhaserの別のメジャーバージョンでも試します。3.90のXMLでだけ起きるならトリムの順番、両方で回転したフレームに起きるなら回転です。
- パックし直した後のデータファイルに
"rotated": trueがなく、Phaser 3.90用のXMLにはframeX属性がないこと。
Phaser 3.90と4.2でのアトラス設定ごとの結果
| アトラスの設定 | Phaser 3.90 | Phaser 4.2 | Studioのプリセット |
|---|---|---|---|
| JSONハッシュ、トリムあり | 正常 | 正常 | Phaser 3 / 4（トリムオン） |
| JSONハッシュ、回転フレーム | 正しく描けない（向きが戻らない） | 正しく描けない（向きが戻らない） | Phaser向けは回転を拒否 |
| Starling/Sparrow XML、トリムあり | トリムしたフレームが崩れる（setTrimにサイズが逆順で渡る） | 正常 | Starling / Sparrow XML、4.2向け |
| Sparrow XML、トリムなし | 正常 | 正常 | Sparrow XML (Phaser 3) |
| load.aseprite用のAseprite JSON | 正常 | 正常 | Aseprite JSON：1ページ、回転なし |
トラブルシューティング
| 症状 | 考えられる原因 | 確認方法 | 対処 |
|---|---|---|---|
| 一部のフレームだけ反転・回転・欠ける | そのフレームが回転して保存されている | まさにその項目に"rotated": true | 回転なしでパックし直す。NerulioのPhaserプリセットは回転を拒否し、TexturePackerならAllow rotationをオフに |
| Phaser 3.90で、XMLのときだけトリムしたフレームがずれる・欠ける | AtlasXMLのsetTrimの順番 | そのフレームのXMLにframeXがあり、同じファイルがPhaser 4.2では正常 | 「Sparrow XML (Phaser 3)」プリセット（トリムなし）、JSONアトラス、またはPhaser 4 |
| 全フレームが同じだけずれる | JSONにpivotがあるとPhaserはそれをスプライトの原点にし、なければ原点は中央 | sprite.originX、sprite.originY | ピボットが原点（0.5, 1 = 足元）だと考えて配置するか、中央基準で置くならJSONからpivotを外す |
| フレームに別のフレームの絵が出る | JSONとPNGが別々の書き出しのもの、またはフレーム名が変わった | meta.imageとmeta.sizeをPNGと比べ、this.textures.get(key).getFrameNames()を確認 | 両方のファイルを一緒に書き出し直す |
| 動くとフレームがぼやける・継ぎ目が出る | アトラスのデータではなく、線形フィルターとピクセルの間の位置が原因 | ゲーム設定 | pixelArt: true、アトラスの間隔は2pxを保つ |
ほかの方法
| 方法 | こんなときに向いています |
|---|---|
this.load.asepriteで読むAsepriteのJSON | 検証の実行ではPhaser 3.90と4.2の両方で正しく描かれました。1ページ、回転なし。AsepriteからPhaserへを参照。 |
| 元のフレームからパックし直す | 元のフレームがあるならこれが一番です。Phaser 3 / 4プリセットはトリムを保ち、決して回転しません。Phaserのテクスチャアトラスを参照。既存のアトラスからフレームを読み戻すと、回転したフレームは回ったままです。 |
エンジン別の書き出しと検証方法
「検証済み」は、実際のCC0アセットから書き出したファイルを本物のエンジン・ツールで読み込み、元データと比較したという意味です。読み込んでいない形式はそのように表示します。
| 書き出し先 | ファイル | 検証 |
|---|---|---|
| Godot 4 | .tres SpriteFrames · .tscn AnimatedSprite2D · .png.import | 検証済み Godot 4.7.2Godotで読み込み、全アニメーションフレームを描画して元ファイルと比較。シーンはNearestフィルターで、回転は使いません。 |
| Unity 6 | .unity.json · Editor/NerulioSpriteImporter.cs · AnimationClip | 検証済み Unity 6000.5.3f1バッチモードでスプライト範囲・ピボット・ピクセル・クリップのキーと長さを確認。 |
| Phaser 3 / 4 | atlas JSON (multiatlas) · .anims.json | 検証済み Phaser 3.90 + 4.2両バージョンでフレームとアニメーションを描画。 |
| PixiJS 8 | spritesheet JSON · animations · anchor · meta.scale | 検証済み PixiJS 8.21回転・複数ページのアトラスも確認。 |
| Aseprite JSON | hash / array · frameTags · slices | 検証済み Phaser load.aseprite · PixiJS 8.21タグの方向と繰り返し回数を保持。 |
| .aseprite | layers · tags · durations · slices | 検証済み Aseprite 1.3.18Asepriteのコマンドラインで開いて描画。 |
| Spine / libGDX | .atlas | 検証済み spine-canvas 4.2Spineランタイムで回転・トリム領域をすべて描画。libGDX本体は未実行。 |
| Starling / Sparrow XML | XML per page | 検証済み Phaser 4.2Phaser 3.90はトリムされたXMLフレームを誤って描画します（Phaser側の不具合）。「Sparrow XML (Phaser 3)」プリセットはトリムを切り、3.90・4.2とも合格。 |
| LÖVE | Lua quads · nerulio_atlas.lua · main.lua | 検証済み LÖVE 11.5同梱ヘルパーで全フレームを描画し、全アニメーションを再生。 |
| Defold | .atlas · .tilesource | ビルド確認 Defold bob.jar 1.13.1Defoldのコマンドラインビルダーでビルドし、生成テクスチャのUVを読み戻して確認。 |
| GameMaker | spr_<name>_stripN.png · gamemaker.json | 未検証GameMakerでは読み込んでいません（ヘッドレス実行不可）。ストリップはGameMakerの取り込み方式どおりに切ります。 |
| CSS sprites | .css · preview .html | 検証済み Chromium同梱スタイルシートで全クラスを描画。 |
| GIF / APNG | one file per animation | デコード確認 Pillow書き出し後に全フレームと遅延を再デコード。APNGは完全一致。 |
検証の根拠
書き出し：実在のCC0アセットで実際のエンジンを49回実行し47回合格。失敗2回はPhaser 3.90のトリムXMLの不具合で、Phaser 3プリセットで回避。実在の5フレームセットでパッカー比較（CodeAndWeb無料Webパッカー、GAPTools、free-tex-packer）：回転ありで5つすべて最小、回転なしで5つ中4つ。全フレームがピクセル単位で復元できます。
制限
- ポリゴン（メッシュ）パッキングはありません。検証したエンジンのどれも、書き出しデータからメッシュアトラスを描画しないためです。
- GameMakerのストリップはGameMaker本体では未検証です。
- 拡大縮小バリエーション（@0.5x〜@4x）はニアレストネイバーのみです。
- トリムしたStarling XMLはPhaser 3.90で正しく描画されないため、「Sparrow XML (Phaser 3)」プリセットを使ってください。
バージョンと出典
2026-09-23のNerulioのエンジン検証では、Studioの書き出し49件を実際のエンジンに読み込み、47件が合格し、失敗の2件はPhaser 3.90でのトリムしたStarling XMLでした。回転したTexturePackerのフレームは、TexturePacker 8.3.0が回転ありで書き出したもの（2026-09-25）も含めて、Phaser 3.90.0と4.2.1の両方で失敗しました。setTrimの順番はPhaser 3.90のソースから引用しています。
参照した公式ドキュメント
よくある質問
Phaserで回転をオンのままにできる？
このバージョンではできません。私たちの実行では、Phaser 3.90と4.2は回転したTexturePackerのフレームを元の向きに戻さなかったため、Phaserプリセットは回転を使いません。PixiJS 8.21とSpineランタイムは回転したフレームを正しく描いたので、そちらのプリセットは回転を使えます。
Phaser 4にもXMLのトリム問題はある？
ありません。同じ実行でPhaser 4.2はトリム済みのStarling/Sparrow XMLを正しく描きました。両バージョン共通の問題は回転だけです。
トリムを切るとどれくらい損？
各フレームが透明な縁ごとキャンバス全体を持つので、ページが大きくなります。XMLの代わりにJSONアトラスを使えるなら、そちらはトリムを入れたままにしてください。
手元のアトラスファイルを直せる？
パックし直す方法だけです。Studioは既存のアトラスを部分修正せず、Phaserが正しく読める設定でフレームを詰め直します。
無料ですか？アカウントは必要ですか？
このページの機能はすべて無料で、アカウントなしで使えます。透かしや制限された書き出しはありません。
スプライトはアップロードされますか？
いいえ。Studioはこのブラウザのタブ内でデコード・パック・書き出しを行います。プロジェクトはブラウザ（IndexedDB）に自動保存され、.nerulioファイルとして保存できます。
Asepriteやエンジンのプラグインは必要ですか？
いいえ。.asepriteファイルはブラウザで読み書きします。エンジン別のバンドルには必要なものが入っています（Godotはインポート設定とシーン、UnityとGodotのタイルセットは小さなエディタースクリプト）。