保存して制作を再開する

編集内容は自動保存され、次回はプロジェクト一覧から開けます。XRiftで公開するには、保存後に公開の操作が必要です。

iPadではブラウザに保存されます。手元にファイルを残すには、「プロジェクトを書き出す」で.xriftstudioファイルを保存してください。パソコンへ渡す方法は、iPadの案内を参照してください。以下はデスクトップ版の操作です。

自動保存を確認する

ビジュアルエディターのシーン、Script、GLSLと、コードエディターのテキストは、編集すると自動保存されます。通常は保存ボタンやショートカットを押す必要はありません。

プロジェクト名の近くに「保存待ち」「保存中」「保存済み」と表示されます。アプリを終了する前に、「保存済み」を確認してください。「保存エラー」が出た場合は、編集画面を閉じずにエラーの内容を確かめます。

Ctrl + S、Macでは⌘ + Sを押すと、その時点の変更をすぐに保存できます。

次回開く

エディターの「プロジェクト一覧」を押すと、残っている変更が保存されてから一覧に戻ります。作品のカードを選ぶと、続きを編集できます。

名前やサムネイルを設定すると、作品が増えても見分けやすくなります。公開用の日本語タイトルと、フォルダー名に使うプロジェクト名は、それぞれ設定できます。

コードエディターのxrift.json設定は、「保存」か保存のショートカットで保存します。別のファイルやJSON表示へ切り替えるとき、プロジェクト一覧へ戻るとき、Play・チェック・公開を始めるときにも、変更を先に保存します。保存に失敗した場合は、下書きを残したまま現在の画面に留まります。

バックアップする

大きく作り替える前は、作品のカードから「複製」するか、「.xriftstudioファイルに書き出す」でバックアップしてください。

別のパソコンでは、「ファイルから取り込む」で.xriftstudioファイルを開けます。従来の.zipファイルも取り込めます。複製や取り込みで作られたプロジェクトは、元の作品とは別の未公開プロジェクトになります。

VRM 0.xやVRM 1.0のファイルと、Inspectorで編集したMToonの色、輪郭線、テクスチャも保存されます。取り込み先でモデルのMaterialsを開き、設定と見た目を確認してください。操作はVRMの案内を参照してください。

Ctrl + Zで取り消せる範囲は限られます。変更前の状態を確実に残すには、ファイルに書き出しておいてください。

コードエディターへ書き出す

デスクトップ版の上部にある「コードエディターへ書き出す」から、シーンと素材を既存のコードプロジェクトに追加できます。MToonの設定とVRMモデルも書き出されます。

「コードプロジェクトを選ぶ」で書き出し先を選びます。ワールドはワールド、アイテムはアイテムのコードプロジェクトを指定してください。
「Componentとして追加」を選ぶと、既存の起動ファイルが保たれます。書き出し後に「組み込み用コードをコピー」を使い、既存のWorld.tsxかItem.tsxに追加してください。
書き出したシーンから起動する場合は、「起動するシーンを切り替える」を選びます。起動ファイルのバックアップと置き換えを確認してください。
「必要なパッケージ」の案内を読んで、「コードエディターへ書き出す」を押します。
完了画面の「フォルダーを開く」か「VS Codeで開く」から、生成内容を確認できます。パッケージのインストールが必要な場合は、表示された手順を実行してからシーンを開いてください。

元のビジュアルプロジェクトも引き続き編集できます。ただし、書き出したコードの変更はビジュアルエディターに自動では戻りません。バックアップや別端末でのビジュアル編集には、.xriftstudioファイルを使ってください。

VS Codeやターミナルが開かない

「VS Codeで開く」を使うには、VS Codeのインストールとcodeコマンドの設定が必要です。macOSでは、VS CodeのコマンドパレットでShell Command: Install 'code' command in PATHを実行し、XRift Studioを再起動してください。各OSでの設定は、VS Codeの公式案内を参照してください。

「ターミナルを開く」では、プロジェクトのフォルダーを作業場所として起動します。WindowsではWindows Terminalを探し、見つからなければコマンドプロンプトを開きます。macOSではTerminalを使います。Linuxでは、GNOME Terminal、Konsole、Xfce Terminal、システムのターミナル、xtermの順に探します。対応するターミナルがない場合は、画面の案内に従ってインストールしてください。

保存したのに見つからない

プロジェクト一覧の検索と絞り込みを解除してください。似た名前の複製や、別の保存先を開いていないかも確認します。

保存エラーが出ていた場合は、保存が完了していない可能性があります。編集画面を閉じずに、エラーの内容と保存先を確認してください。

データを消さずに復旧する

パネルの位置や大きさの問題は、「パネル配置を初期化」で戻せます。プロジェクトのデータは削除されません。

「完全リセット」では、保存済みプロジェクトやログイン情報も削除され、元に戻せません。不具合が出たら、先に復旧と問い合わせの手順を確認してください。

一部だけ別のワールド・アイテムへ渡す

Hierarchyで選んだEntityを、子Entityと必要な素材も含めて.xriftstudioファイルに書き出せます。追加先では「.xriftstudioからHierarchyへ追加」を使ってください。プロジェクト全体を開き直さず、必要な部分を取り込めます。詳しくはEntityを別のワールド・アイテムへ渡すを参照してください。