よくある質問
一般
どのバージョンのBlenderがサポートされていますか？
Blender 2.93以降です。アドオンは新しいマニフェストシステムを持つBlender 4.2以降にも対応しています。
Asepriteのインストールは必須ですか？
はい、アドオンはAsepriteのコマンドラインインターフェースを使用して.asepriteファイルをPNG形式にエクスポートしてからBlenderにインポートします。
.aseファイルはインポートできますか？
はい、.aseは.asepriteと同じ形式です。ただし、現在のファイルフィルターは.asepriteのみ表示します。.aseファイルは手動で選択できます。
Asepriteのアニメーションに対応していますか？
現在、アドオンは現在のフレームのみをインポートします。アニメーション対応は将来のバージョンで追加される可能性があります。
インストールと設定
Aseprite実行ファイルはどこにありますか？
Windows:
- Steam:
C:\Program Files (x86)\Steam\steamapps\common\Aseprite\Aseprite.exe - スタンドアロン:
C:\Program Files\Aseprite\Aseprite.exe
macOS:
/Applications/Aseprite.app/Contents/MacOS/aseprite
Linux:
/usr/bin/aseprite~/.steam/steam/steamapps/common/Aseprite/aseprite
"Aseprite not found"エラーが出ます
- Asepriteがインストールされているか確認
編集 > プリファレンス > アドオン > Aseprite Importerでパスを確認- パスが実行ファイル（フォルダではない）を指しているか確認
- macOSでは、
.appバンドル内のパスを使用
インポートメニューにアドオンが表示されません
- プリファレンスでアドオンを有効化（チェックボックス）したか確認
- Blenderを再起動
- システムコンソール（ウィンドウ > システムコンソールの切り替え）でエラーを確認
使用方法
メッシュが小さすぎる/大きすぎます
メッシュは1ピクセル = 1Blenderユニットを使用します。32x32ピクセルのスプライトは32x32ユニットのメッシュになります。スケールツール（Sキー）で調整してください。
テクスチャがぼやけています
アドオンはピクセルパーフェクトレンダリングのため、デフォルトでテクスチャ補間を"Closest"に設定します。ぼやけている場合：
- シェーダーエディターでImage Textureノードを確認
- Interpolationが"Closest"に設定されているか確認
Solidifyモディファイアを無効にできますか？
はい、ファイルをインポートする際にインポートダイアログのオプションで"Solidifyモディファイアを追加"のチェックを外してください。
テクスチャプレフィックス設定は何ですか？
アドオンはAsepriteファイルをプレフィックス付き（デフォルト: tex_）でPNGとしてエクスポートします。これによりBlenderの一時ディレクトリで一時テクスチャファイルを識別しやすくなります。
テクスチャはどこに保存されますか？
テクスチャはBlenderの一時ディレクトリに保存されます。.blendファイルを保存すると、テクスチャはファイルにパックされます。元の.asepriteファイルは変更されません。
技術的な質問
Blender 4.2の新しい拡張システムで動作しますか？
はい、アドオンはBlender 4.2以降の互換性のためにblender_manifest.tomlを含んでいます。
このアドオンは商用利用できますか？
はい、アドオンはMITライセンスで、商用利用が可能です。
バグを報告するにはどうすればいいですか？
GitHub Issuesページでバグを報告してください。
プロジェクトに貢献できますか？
はい！プルリクエストを歓迎します。貢献ガイドラインについてはGitHubリポジトリを参照してください。
トラブルシューティング
エラーメッセージなしでインポートが失敗します
- Blenderのシステムコンソールで詳細なエラーを確認
- Asepriteを手動で実行して動作するか確認
.asepriteファイルが破損していないか確認
"PNG export failed"エラー
- Asepriteが一時ディレクトリへの書き込み権限を持っているか確認
.asepriteファイルがAsepriteで開けるか確認- シンプルなテストファイル（単一レイヤー、複雑な機能なし）で試す
メッシュに欠けている面があります
これは仕様です - 透明ピクセルはメッシュ面に変換されません。アルファ > 0のピクセルのみが含まれます。
UVマッピングがおかしいです
アドオンは各ピクセルの中心にUV座標を配置します。インポート後にメッシュを変更した場合、手動でUVを調整する必要があるかもしれません。