Skip to main content

lookAtTarget

import { Vrm } from "@hmcs/sdk";

vrm.lookAtTarget(entity) makes the character look at a specific entity by its ID. This is useful for making characters look at each other or at specific objects in the scene.

const character = await Vrm.findByName("MyAvatar");
const other = await Vrm.findByName("OtherCharacter");

// Make MyAvatar look at OtherCharacter's head
const headEntity = await other.findBoneEntity("head");
await character.lookAtTarget(headEntity);

You can also use the entity ID of any Bevy ECS entity, not just VRM bones:

// Look at another VRM's root entity
await character.lookAtTarget(other.entity);

Example: Characters Looking at Each Other​

const alice = await Vrm.findByName("Alice");
const bob = await Vrm.findByName("Bob");

const aliceHead = await alice.findBoneEntity("head");
const bobHead = await bob.findBoneEntity("head");

await alice.lookAtTarget(bobHead);
await bob.lookAtTarget(aliceHead);

Use unlook to disable look-at behavior, or lookAtCursor to follow the mouse cursor instead.