Spine エディター - マニュアル

翻訳について

本ドキュメントはChatGPT-4によって翻訳されており、内容に不正確な部分が含まれる可能性があります。

ユーザーインターフェース

左側：操作バー

機能	説明
背景	■ 単色：単色背景 ■ 画像：カスタム画像背景 ■ 無効化：背景をオフにして、背景なしのモデルスナップショットを保存するため
ズーム	モデルをズーム
回転	モデルを回転
現在のサイズと位置を保存	現在のサイズと位置をJson設定オプションに書き込み、モデルの初期状態を設定
タッチ可能領域を表示	赤い枠で領域を表示
スキン	スキンを選択
ヒント	操作ヒント
情報	モデルmocファイル情報
ログ	モデルログ、モーションイベントを表示
レンダリングサイズ	現在のプレビューウィンドウの解像度
録画設定	動画とスナップショットの設定

中央：モデルプレビュー

アイコン	説明
	Json設定を編集
	モデルの境界を編集
	モデルスナップショットを保存
	動画を録画
	左パネルを表示/非表示
	右パネルを表示/非表示
	デスクトップでモデルをプレビュー

右側：タブページ

ファイルビューア

• モデルフォルダを表示

  アイコン	説明
  	Jsonファイルを開く
  	モデルフォルダを開く
  	フォルダを更新

• モデル関連ファイルを表示

• その他の操作

  操作	説明
  フォルダを開く	モデルフォルダを開く
  設定ファイルを作成	参考：Json設定ファイルを作成する

設定ファイル

• Json設定ファイルの内容を表示

• その他の操作

  操作	説明
  編集	Jsonファイルを編集

アニメーション

• モデルのすべてのモーションを表示

• その他の操作

  操作	説明
  ループ	モーションのループ再生をプレビュー
  速度	モーションの再生速度をプレビュー
  リセット	ユーザーが行ったモーションに対するすべての操作をリセット
  	ソートを解除
  	昇順ソート
  	降順ソート

ボーン

• モデルのすべてのボーンを表示

• その他の操作

  操作	説明
  スケルトンを表示	プレビュー インターフェイスにスケルトンを表示する
  リセット	ユーザーが行ったボーンに対するすべての操作をリセット
  ヒットエリアを作成	選択したリスト項目のヒットエリアを作成します
  	ソートを解除
  	昇順ソート
  	降順ソート

スケルトンを表示する

スケルトンの緑色の点をクリックして、ボーンを選択します。リストにはクリックしたボーンだけが表示され、選択されます。リストを復元するには、「リセット」ボタンをクリックします

スロット

• モデルのすべてのスロットの透明度を表示

• その他の操作

  操作	説明
  リセット	ユーザーが行ったスロットに対するすべての操作をリセット
  	ソートを解除
  	昇順ソート
  	降順ソート

---

Jsonエディター

【保存】および【閉じる】について

• 【保存】は現在の設定をファイルに書き込み、モデルを再読み込みします
• 【閉じる】はエディタウィンドウを閉じるだけで、モデルは再読み込みされません

共通アイコンボタン

アイコン	説明	アイコン	説明
	複数を追加		複製
	追加		削除
	上に移動		下に移動
	アイテム名を変更		アイテムを選択

テンプレート

アイコン	説明
	テンプレートを読み込み（アイテムリストに挿入）
	テンプレートを読み込み（アイテムリストを置き換え）
	テンプレートを保存

---

バージョン

モデルバージョン

---

テクスチャアトラス

モデルテクスチャアトラス

• 1つのモデルは複数のテクスチャアトラス（atlas）を持つことができます
• 1つのテクスチャアトラスは複数のテクスチャファイル（png）に対応します

---

ヒットエリア

モデルのヒットエリアで、マウス操作で動作イベントを発生させることができます

プロパティ	説明
名称	エリア名称
ID	モデルボーンID
ソート順	エリアが重なっている場合、最も高い番号のエリアのみがマウスイベントを受け取ることができます
クリック時のモーション	マウスクリック時にトリガー
押下時のモーション	マウスがエリア内で押下されたときにトリガー
リリース時のモーション	マウスボタンをリリースしたときにトリガー（エリア外でも可）
侵入時のモーション	マウスがエリアに侵入したときにトリガー
退出時のモーション	マウスがエリアを退出したときにトリガー
幅	エリアの幅
高さ	エリアの高さ
中心X	エリア中心のX位置
中心Y	エリア中心のY位置
有効化	エリアが有効かどうか

---

モーション

• モーションは複数のモーショングループで構成されており、各モーショングループは複数のモーションイベントを持つことができます
• 異なるレイヤーのモーショングループを同時に再生することが可能で、レイヤーは【#レイヤー番号】で表されます

サンプル	説明
start	事前定義されたモーショングループ
tap_Head	事前定義されたモーショングループ【tap_エリア名】、【Head】はトリガーエリアの名称
MyGroup	カスタムモーショングループ名
MyGroup#3	カスタムモーショングループ名、モーショングループが存在するレイヤー番号は【3】

複数モーションを同時再生する場合について

• モーション再生にはレイヤー（Layer）の概念があり、異なるレイヤーのモーションを同時に再生することが可能です。高いレイヤーで再生されるモーションは、低いレイヤーの同じパラメーターを持つモーションを上書きします。
• モーションはデフォルトでレイヤー0で再生されます。他のレイヤーで再生したい場合は、【モーショングループ#レイヤー】の命名形式を使用します（例：【idle#1】はレイヤー1で再生）。レイヤー0で再生する場合は【モーショングループ#0】を使用せず、【モーショングループ】を直接使用してください。
• 事前定義されたモーショングループのうち【idle】以外はレイヤーをサポートしていません。事前定義モーション内で【start_mtn】を使用して他のレイヤーのモーションを実行してください。
• 応用例については 複数モーショングループを同時再生 を参照してください。

事前定義モーショングループ

イベント	説明	備考
idle	待機
tap	マウスクリック	HitAreas（ヒットエリア）が存在する場合、優先的に tap_エリア名 をトリガーします
tap_エリア名	マウスエリアクリック	HitAreas を設定する必要があります。設定されていない場合は tap イベントを使用してください
start	モデル読み込み時にトリガー
shake	デバイスを振ったときにトリガー	重力センサー機能をサポートするデバイスのみ
tick	毎分トリガー
tick_x	X分ごとにトリガー	Xには1〜60の数字を記入します 条件を満たすイベントが複数ある場合（例：2分目のTick1とTick2）、ランダムで1つのイベントをトリガーします
leave_x_y_z	放置（待機以外のイベントがトリガーされない場合）	Xは開始時間、Yは最小トリガー間隔、Zは最大トリガー間隔（単位：秒） 例：leave_30_10_20 は、放置後30秒でこのイベントを開始し、10〜20秒の間隔でトリガーします

モーションイベントプロパティ

基本プロパティ	説明	オプション	備考
名称	モーション名		モーションは名前を設定することで他の参照者から正しく認識されます。名前がない場合、モーショングループとしてのみ認識されます
言語	モーションに対応する言語	■ en：英語 ■ zhs：中国語簡体字 ■ zht：中国語繁体字 ■ ja：日本語 ■ ru：ロシア語	プログラムで設定された言語と一致する場合にのみトリガーされます
ファイル	モーションファイル（motion3.json）
再生終了時の動作	モーション再生が終了したときの処理
テキスト	モーション実行時に表示するテキスト
テキスト表示時間	テキストの表示時間をカスタマイズ		設定しない場合はシステムで自動判断されます
テキスト遅延	モーション再生後、テキストの表示を開始するまでの遅延時間を設定
表情	モーション再生中の表情名
音声	モーション再生中の音声
音声チャンネル	音声を再生するチャンネルを設定		全3チャンネル（0, 1, 2）が選択可能。デフォルトは0
音量	音声の音量
音声遅延	モーション再生後、音声が再生されるまでの遅延時間を設定
音声ループ	音声のループ再生		主にBGM再生に使用されます
ブレンドモード	異なるレイヤー間のモーションブレンド	■ 上書き ■ 加算	Spine 3.7以降のみ対応
ブレンドウェイト	現在のモーションと他のモーションをブレンドする際のウェイト		Spine 3.5以降のみ対応
フェードイン	モーションのフェードイン
ループ時にフェードイン	現在のモーションが前のモーションと同じ場合のフェードイン値		デフォルト値は0
フェードアウト	モーションのフェードアウト
優先度	モーション実行の優先度		■ 設定可能な範囲は2〜9。値が大きいほど優先度が高くなります ■ デフォルトは2で、9に設定すると前のイベントを強制的に上書きします
モーション時間	モーションイベントの持続時間をカスタマイズ		設定すると、このイベントはモーションや音声の長さに影響されません
ウェイト	モーショントリガーの確率		範囲は1〜999。値が大きいほどトリガー確率が高くなります。デフォルトは1
速度	モーション再生速度		SDK 2では使用不可。デフォルトは1

上級プロパティ	説明	オプション	備考
前置コマンド	モーション再生前に実行		利用可能なコマンドリスト
後置コマンド	モーション再生終了後に実行		利用可能なコマンドリスト
前のモーション	前のモーションイベントを指定		前のモーションが指定されたモーションである場合のみ、現在のモーションを実行
次のモーション	次に実行するモーションを指定		モーション終了後に実行される次のモーション
フェイストラッキングパラメータの上書き	チェックすると、モーションはフェイストラッキングの影響を受けません
有効化	このモーションイベントが実行可能であるか
中断可能	モーションが中断可能かどうか		■ チェックすると、このモーションイベントは同じ優先度のモーションで中断されることができます ■ この設定は優先度9のイベントには無効
無視可能	モーションが無視可能かどうか		■ 条件を満たし、【時間制限】の設定がある他のモーションイベントが存在する場合、このイベントを実行可能にするかどうか ■ 【時間制限】を設定すると、このパラメータは無効になります
時間制限	時間条件を満たした場合にのみ実行可能	■ 時/分/月/日 ■ 持続時間（分） ■ 誕生日：プログラム設定で指定された誕生日
好感度	好感度条件を満たした場合にのみ実行可能	■ 最小値：イベントをトリガーするための最小親密度 ■ 最大値：イベントをトリガーするための最大親密度 ■ 等しい：好感度がこの値のときにトリガー ■ リワード：成功したイベントトリガー時に増加する親密度値

特殊プロパティ	説明	オプション	備考
選択肢	テキストボックスで選択肢を表示し、モーションイベントを実行	■ Text：テキスト ■ NextMtn：次のモーション
浮動小数点変数	浮動小数点変数を使用してモーションの実行を制御	条件判断（Condition） ■ greater：より大きい ■ greater_equal：以上 ■ lower：より小さい ■ lower_equal：以下 ■ equal：等しい ■ not_equal：等しくない 値操作（Operation） ■ assign：代入 ■ add：加算 ■ subtract：減算 ■ multiply：乗算 ■ divide：除算 ■ init：初期化 ■ round：四捨五入。小数点以下を何桁残すかを指定してください。例：0 は整数に丸めることを意味し、1 は小数点以下1桁を残すことを意味します	■ 条件判断は、モーションイベントがトリガー可能かどうかを判断します ■ 値操作は、イベントトリガー後に値を操作します ■ 2つの変数で条件判断や操作を行うことができ、例：greater $var2（$+変数名） ■ 変数名はモデルパラメータ名にすることができ、パラメータ名の前に@を付けます（例：@ParamAngleX） ■ ランダム数関数：rand(min,max) と randf(min,max)。randは整数ランダム、randfは浮動小数点ランダム。minとmaxはランダム数の最小値と最大値 ■ 変数は保存可能 ■ init操作は、その変数が保存されていない（未初期化）場合にのみ有効

浮動小数点変数

• 浮動小数点変数は以下の2種類に分けられます：【条件判断】と【値操作】
• 条件判断：浮動小数点変数が条件を満たした場合にのみモーションイベントが実行可能
• 値操作：モーションイベント実行後、浮動小数点変数の値を操作

モーションの参照について

• モーション参照形式は【モーショングループ:モーション名】（例：Tap:MotionA）
• 【モーショングループ】のみ記載した場合（例：Tap）、そのモーショングループ内で条件を満たす任意のモーションがランダムで実行されます
• 【モーショングループ:モーション名】を完全に記載した場合（例：Tap:MotionA）、そのモーショングループ内の指定されたモーション名のモーションが実行されます

---

コントローラー

注意

• コントローラー内で「パラメータ」と表示されたものは、Spineでは「アニメーション」を指します
• SpineコントローラーとLive2Dコントローラーの違い：Live2Dコントローラーはパラメータ値を制御しますが、Spineコントローラーはアニメーションを制御します。アニメーション速度を0に設定してコードでアニメーション時間を制御します。使用時に注意してください。

マウストラッキング

モデルをマウスに追従するように一定の動きをさせます

プロパティは 共通プロパティA を参照

プロパティ	説明
スムーズ時間	スムーズ時間が長いほど、モデルがマウスに追従する速度が遅くなり、動きが滑らかになります

---

リップシンク

音声の音量によってモデルの口の開閉パラメータを制御します

プロパティは 共通プロパティA を参照

プロパティ	説明
ゲイン	ゲインが大きいほど、音量の影響で口の開閉がより敏感になります
スムーズ時間	スムーズ時間が長いほど、口の開閉の変化が遅くなり、動きが滑らかになります

---

パラメータドラッグ

マウス操作を使用してモデルのパラメータを制御します

注意

指定されたアニメーションが再生中でない場合、このコントローラーは無効になります

プロパティ	説明
名称	プロパティ名
ヒットエリア	ドラッグをトリガーするエリア
ID	パラメータID
最小値	パラメータの最小値。未設定の場合はデフォルト値を使用
最大値	パラメータの最大値。未設定の場合はデフォルト値を使用
タイプ	■ ドラッグ：マウス左ボタンを押しながらドラッグ ■ なでる：マウス左ボタンを押しながら前後に動かす ■ 長押し：マウス左ボタンを長押し
座標軸	マウスのXY軸
ファクター	乗算係数 ■ ドラッグ/なでる：マウスが1ピクセル移動するごとのパラメータ変化値 ■ 長押し：1秒間押し続けるごとのパラメータ変化値
パラメータロック	マウスを離した後もパラメータが元に戻らない
ウェイト	パラメータ値がモデルに与える影響度。実際の影響値 = パラメータ値 × ウェイト
最小値モーション	パラメータ値が最小に達したときにトリガー
最大値モーション	パラメータ値が最大に達したときにトリガー
開始モーション	マウス左ボタンを押したときにトリガー
終了モーション	マウスを離したときにトリガー（パラメータが最大値に達していない場合）
有効化	プロパティが有効かどうか

---

パラメータループ

パラメータを時間に応じてループ再生します

注意

コントローラーは高レイヤーでアニメーションを再生して制御を行います

プロパティ	説明
名称	プロパティ名
IDグループ	パラメータIDグループ
タイプ	パラメータ値の変化方法
ブレンドモード	パラメータとモデルアニメーションのブレンドモード
持続時間	ループ時間（ミリ秒）
最小値	パラメータの最小値
最大値	パラメータの最大値
最小間隔	2回のループ間の最小間隔
最大間隔	2回のループ間の最大間隔
ウェイト	パラメータ値がモデルに与える影響度。実際の影響値 = パラメータ値 × ウェイト
時間同期	現在のシステム時間に基づいてパラメータ値を設定
有効化	プロパティが有効かどうか

---

スロットの透明度

事前定義されたアートメッシュの透明度をユーザーが制御できるようにします

プロパティは 共通プロパティB を参照

---

スロットの色

事前定義されたアートメッシュの色をユーザーが制御できるようにします

プロパティは 共通プロパティB を参照

---

アクセラレーター

スマートフォンのハードウェアアクセラレーターを使用してモデルパラメータを制御します

プロパティは 共通プロパティA を参照

---

キートリガー

プロパティ	説明
押下時モーション	キーが押されたときにトリガー
リリース時モーション	キーが離されたときにトリガー

ヒント

キーを有効にするには、【コントロールパネル】【設定】で【ホットキー】を有効にする必要があります

注意

• マウスの左右ボタンを使用する場合、対応するトリガーモーションを【クリックイベント】とは異なるレイヤーに設定してください。そうしないと、マウス左右ボタンのイベントがトリガーされた後に【クリックイベント】がトリガーされなくなります。
• 【デスクトップでモデルをプレビュー】またはデスクトップ/壁紙ソフトウェアでモデルを直接ロードして効果を確認してください。

---

好感度システム

プロパティ	説明
初期値	初回モデル読み込み時に割り当てられる初期値。この値は最小値と最大値の間で設定する必要があります
最小値	好感度の下限
最大値	好感度の上限
アクティブ時の報酬	モデルが読み込まれている間、毎分増加する報酬値。通常は正の値を設定します
非アクティブ時の報酬	モデルが読み込まれていない間、毎分減少する報酬値。通常は負の値を設定します
デイリーボーナス上限	毎日の報酬の上限
バインドパラメータID	モデルパラメータにバインドします。このパラメータ値は好感度によって制御され、主に現在の好感度値を表示する用途で使用されます

ヒント

【モーションイベント】の【好感度】プロパティを使用して好感度値を変更することができます

---

#付録：共通プロパティA

注意

コントローラーは高レイヤーでアニメーションを再生して制御を行います

プロパティ	説明	マウストラッキング	リップシンク	アクセラレーター
名前	アイテム名	●
有効	アイテムが有効かどうか	●
パラメータ	パラメータID	●	●	●
座標軸	マウスのXY軸	●		●
反転	パラメータ値を反転する	●	●	●
最小値	パラメータの最小値	●	●	●
最大値	パラメータの最大値	●	●	●
デフォルト値	パラメータのデフォルト値	●		●
ブレンドモード	パラメータとモデルアニメーションのブレンドモード	●	●	●
ウェイト	パラメータ値がモデルに与える影響度【実際の影響値 = パラメータ値 × ウェイト】	●	●	●
入力	マウスの移動や左右ボタンに直接バインド	●

最大値、最小値、デフォルト値について

• パラメータ自体に最大値、最小値、デフォルト値が設定されていますが、選択すると自動入力されます
• これらの値をカスタマイズすることも可能で、カスタマイズされた値はパラメータのデフォルト値を上書きします
• カスタマイズする値は、パラメータの最大値と最小値の範囲内である必要があります

#付録：共通プロパティB

プロパティ	説明
名称	プロパティ名
テキスト	表示するテキスト。未設定の場合はプロパティ名が表示されます
値	初期値
ユーザーに非表示	編集パネルで非表示にします
IDグループ	関連付けられたパラメータIDグループ
キー値	■ 【スロットカラー】コントローラーでのみ使用 ■ キー値が存在する場合、UIは左右の矢印形式で表示され、存在しない場合はスライダーバー形式で表示されます

ユーザーに非表示

通常、ユーザーは編集パネルを通じてプロパティ値を変更できますが、プロパティ値が固定またはユーザーに変更されたくない場合は【ユーザーに非表示】を選択してください

#付録：使用可能なコマンド

• コマンドはスペースで各パラメータを区切ります。IDやパスなどにスペースが含まれる場合は、スペースの前にバックスラッシュを追加してください。例えば my model を my\ model と記述。
• 複数のコマンドはセミコロン（;）で区切ります

コマンド	説明	例
open_url	ブラウザでリンクを開く	open_url https://www.baidu.com
change_model	モデルを変更	change_model cos02.model.json
add_submodel	サブモデルを追加	add_submodel cos02.model.json 1 (1は位置を表し、範囲は-3～3の整数。親モデルは位置0で、0より大きい値は前面表示、0より小さい値は背面表示)
remove_submodel	サブモデルを削除	remove_submodel cos02.model.json
start_mtn	指定したモデルのモーションを強制実行（優先順位を9に設定）	start_mtn model_id group:motion （model_id 省略時は現在のモデルを指します）
stop_mtn	指定されたレイヤーのモーションを停止	stop_mtn 1 （1はレイヤー番号）、デフォルトレイヤーは0と記述してください
stop_sound	音声を停止	stop_sound 0 （0はチャンネル識別子）
stop_all_sounds	すべての音声を停止
mute_sound	音声をミュート	mute_sound 0 （0はチャンネル識別子）
unmute_sound	ミュートを解除
hide_text	テキスト表示を非表示にする
set_skins	複数のスキンを設定
add_skins	スキンを追加
remove_skins	スキンを削除
reset_pose	ポーズをリセット

サブモデルの制限について

• サブモデルは親モデルからのコマンドでのみ追加・削除可能で、サブモデル自身にさらにサブモデルを追加することはできません。親モデルが削除されると、サブモデルも一緒に削除されます。
• サブモデルを追加する際、表示の前後位置を選択できます。範囲は-3～3の整数で、親モデルは位置0です。0より大きい値は前面表示、0より小さい値は背面表示を意味します。各位置に複数のモデルを配置可能ですが、重なった場合は表示異常が起こることがあります。
• ユーザーはサブモデルの位置やサイズを調整できず、Json設定で初期位置とサイズを設定するのみです。サブモデルは親モデルに従って移動・拡縮します。
• サブモデルには専用の編集パネルがないため、表情の切り替えやアートメッシュの透明度設定などはコマンドで変更する必要があります。
• サブモデルは親モデルのテキストボックスを使用してテキストを表示するため、複数のモデルが同時にテキストを表示するとテキストボックスの競合が発生することがあります。
• ワークショップアイテムやWPKファイルを使用する場合、サブモデルは親モデルのセーブデータを共有するため、浮動小数点変数や好感度の変更は親モデルとサブモデルの両方に影響します。LPKやJsonファイルを使用する場合、サブモデルのセーブデータは親モデルと別に保存され、互いに影響しません。
• サブモデルと親モデルは異なる種類でも構いません。例えば、親モデルがLive2DでサブモデルがSpineでも可能です。
• パフォーマンスや悪用防止の観点から、サブモデルは最大6つまで追加可能です。同じ設定ファイル名のモデルは同時に1つしか追加できません。複数追加する場合は、設定ファイルをコピーして名前を変更してください。

プロパティ	コマンド	説明	例
animations	lock unlock set	ロック 解除 設定	■ animations lock 1 0.5 500 （1はモーションレイヤー、0.5はアニメーション進行度、500はフェードイン時間で、記載しない場合はデフォルトで300msになります） * ロックは持続的に効果を与えるのに対し、設定は一度のみ値を割り当てる点が異なります
slot_opacities slot_colors	lock unlock set	ロック ロック解除 設定	■ slot_opacities lock SLOT_A 1 （1はロック値） ■ slot_opacities unlock SLOT_A ■ slot_opacities unlock（全ロック解除） ■ slot_opacities set SLOT_A 1 * ロックと設定の違いは、ロックは継続的で、設定は一度だけ値を割り当てます
motions	enable disable	有効化 無効化	■ motions enable group:motion ■ motions disable group:motion
hit_areas param_loop mouse_tracking	enable disable	有効化 無効化	■ hit_areas enable name（nameは名称を指します） ■ hit_areas disable name
param_hit	enable disable lock unlock begin end	有効化 無効化 パラメーターをロック ロック解除 ドラッグ開始 ドラッグ終了	■ param_hit enable name（nameは名称を指します） ■ param_hit disable name ■ param_hit lock name ■ param_hit unlock name ■ param_hit begin name PARAM_NAME ■ param_hit end name

---

オプション

プロパティ	説明
ID	モデルID。他のモデルとの相互作用に使用されます
名称	表示名。この名称はテキストボックスなど、さまざまな場所でモデル名として表示されます
スケールファクター	モデルのデフォルトスケール比率
位置X	モデルのデフォルトの左右位置
位置Y	モデルのデフォルトの上下位置
異方性フィルタリングレベル	異方性フィルタリングを使用すると、特定の条件下でテクスチャの見栄えが良くなりますが、グラフィックハードウェアの性能に負荷がかかります。この値が1を超える場合、アプリケーション内のテクスチャ異方性フィルタリング設定値を上書きします
エッジ塗りつぶし	モデルの黒いエッジが表示される問題を解決します
ユーザーによるカスタマイズの許可	チェックすると、ユーザーがモデルをカスタマイズできるようになります
背面カリング	デフォルトは両面レンダリングで、チェックすると正面のみレンダリングされます
シェーダー	デフォルトのシェーダーでモデル表示に問題がある場合、シェーダーを変更することで問題が解決する場合があります