ZEPETOキャラクターにオブジェクトを取り付ける
8 分
ZEPETOキャラクターにオブジェクトを取り付けて、キャラクターが動くときにオブジェクトも一緒に動くようにします。

ステップ 1 : オブジェクトプレハブの準備
まず、オブジェクトをプレハブに変換する必要があります。 オブジェクトを作成し、それをアセットフォルダーにドラッグしてプレハブにします。

オブジェクトプレハブの例
ステップ 2 : オブジェクトをキャラクターの特定の部分に取り付けるスクリプト
- シーンにZEPETOキャラクター作成コードをデフォルトとして実装します。
📘 以下のガイドを参照してください。 [ZEPETOキャラクターを作成]
ステップ 2-1 : スクリプトを書く
1) 階層を作成 > 空のオブジェクトを作成し、AttachObjectに名前を変更します。
2) プロジェクトを作成 > 作成 > ZEPETO > TypeScriptを選択し、AttachObjectに名前を変更します。
3) 以下のようなサンプルスクリプトを書きます。
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { Transform, Animator, GameObject, HumanBodyBones, Object } from 'UnityEngine';
export default class AttachObject extends ZepetoScriptBehaviour {
// 体に取り付けるオブジェクトのプレハブ。
public prefItem: GameObject;
// オブジェクトを取り付ける骨。
public bodyBone: HumanBodyBones;
private _localCharacter: ZepetoCharacter;
Start() {
ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
// ローカルプレイヤーを見つけて、_localCharacterに設定します。
this._localCharacter = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character;
// _localCharacterのアニメーターコンポーネントを取得します。
const animator: Animator = this._localCharacter.ZepetoAnimator;
// オブジェクトを取り付ける骨の位置を取得します。
const bone: Transform = animator.GetBoneTransform(this.bodyBone);
// オブジェクトのプレハブを作成します。
Object.Instantiate(this.prefItem, bone) as GameObject;
});
}
}
- スクリプトの流れは次のとおりです:
- Start()
- ZepetoPlayers.instance.OnAddedLocalPlayerイベントリスナーを登録します。これはローカルプレイヤーが追加されたときに発火します。
- ローカルプレイヤーを_localCharacter変数に設定します。
- _localCharacterのアニメーターコンポーネントを取得し、bodyBoneで指定された位置を取得し、prefItemで指定されたプレハブをその位置に作成します。
ステップ 2-2 : インスペクターでの取り付け位置の設定
1) スクリプトの作成が完了したら、スクリプトをAttachObjectオブジェクトに追加します。
2) インスペクターで、Pref Item、Body Boneを割り当てます。
- Pref Itemはオブジェクトのプレハブです。
- Body Boneはオブジェクトが作成される場所です。
- 左手を選択して、オブジェクトを手に持っているように見せます。

スクリプト設定画面の例
3) 再生ボタンを押して実行すると、ZEPETOキャラクターが左手にオブジェクトを持っているのが見えます。
ステップ 3 : 適用
同じ方法で、Body Boneの希望する位置に任意のオブジェクトを取り付けることができます。
📘 Unity HumanBodyBones https://docs.unity3d.com/ScriptReference/HumanBodyBones.html
以下は、BuildItからのネックピローオブジェクトをキャラクターの首に取り付けて、ZEPETOキャラクターがネックピローを着用しているように見せる例です。

- オブジェクトの位置と回転を適切に調整して、望ましい外観を得ることができます。

オブジェクトプレハブ設定の例
- インスペクターで、ネックピローオブジェクトをプレファブアイテムに割り当て、ボディボーンとしてネックを選択します。

スクリプト設定画面の例