setPersona

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

vrm.setPersona(persona) はキャラクターのペルソナ全体を置換します。

await character.setPersona({
  profile: "A cheerful virtual assistant who loves to help with coding.",
  personality: "Friendly, curious, and always enthusiastic about learning new things.",
  ocean: {
    openness: 0.9,
    conscientiousness: 0.7,
    extraversion: 0.8,
    agreeableness: 0.85,
    neuroticism: 0.2,
  },
  metadata: {
    favoriteColor: "blue",
    skills: ["typescript", "rust"],
  },
});

スポーン時のペルソナ設定

キャラクターをスポーンするときに初期ペルソナを設定することもできます：

const character = await Vrm.spawn("my-mod:character", {
  persona: {
    profile: "A quiet observer who watches the screen.",
    ocean: { extraversion: 0.2, neuroticism: 0.1 },
    metadata: {},
  },
});

変更のリッスン

イベントシステムを使用してペルソナの更新に反応します：

const eventSource = character.events();

eventSource.on("persona-change", (e) => {
  console.log("Persona updated:");
  console.log("  Profile:", e.persona.profile);
  console.log("  Openness:", e.persona.ocean.openness);
});

型定義については Persona と Ocean を参照してください。