ゲームシステム

アカウントアバター:すべてのアプリで同じ見た目

iDos Games のアカウントアバターがアプリでどう動くか:idosgames.com のプレイヤーのボクセルの見た目、表示するスロット、身長の範囲、SDK での描画。

アカウントアバターはプレイヤーの iDos Games キャラクターです:すべてのアプリで共通の見た目で、idosgames.com で編集します。 使うかどうか、何を表示するかはアプリが決めます。使わない場合、アプリは独自のキャラクターを描きます。

プレイヤーに見えるもの

  • 自分のアバター:プロフィールと、アバターを使うアプリの中で。
  • 他のプレイヤーのアバター:ルーム、チャット、リーダーボードで同じように描かれます。
  • プロフィールの アバターを変更 は idosgames.com のエディターを開きます。

仕組み

  • 見た目はアプリではなくプレイヤーのアカウントにあります:一度の編集がすぐにすべてのアプリに届きます。
  • サーバーはルールに合わせた見た目を送ります:非表示のスロットは外され、身長は範囲内に合わせられます。
  • 見た目はリビジョンで読み取ります:変わっていない見た目はデータなしで返ります。

ステップ 01プロジェクトに追加

インストールは不要です:新しいプロジェクトのプロフィールは、オンのときアバターを表示します。ゲーム独自のキャラクターには下の SDK を使ってください。

ステップ 02ダッシュボードで設定

ダッシュボードを開き、プロジェクトを選んで Live Operations → v2 → Avatar に進みます。

  • アカウントアバターを使う:既定はオフです。
  • アプリに表示するもの:チェックを外すと、そのアイテムがこのアプリの全プレイヤーから外されます。
  • 身長:標準スケールで 0.9 から 1.1 の範囲です。

ページの AI ボタンはアシスタントを開きます:必要なことを説明すると変更を提案するので、確認して 保存 を押します。

ステップ 03テストとリリース

アプリのテスト版でアバターを確認してください。設定は別の操作で本番アプリに反映されます:公開とリンクを参照してください。

テンプレートでは

  • ゲームコンストラクター:3D ジャンルではプレイヤーのヒーローがそのアバターで描かれ、走る、跳ぶ、攻撃、勝利のダンスも動きます。2D ジャンルは独自のキャラクターのままです。
  • ボードゲーム:プレイヤーのコマがアバターになります。「フレンドと」モードでは、フレンド同士が同じボードでお互いのアバターを見られます。
  • ゲストや見た目のないプレイヤーには、ゲーム独自のヒーローやコマが表示されます。

アバターショップ

  • スターターアイテムは全員無料です。新しいアイテムは有料で、プラットフォームが Aspis で販売します。
  • 購入したアイテムはずっとプレイヤーのもので、すべてのアプリで使えます。身につけるのは idosgames.com のエディターです。
  • プロフィールのアバターの下にショップが表示されます。プレイヤーがあなたのアプリ内でアイテムを買うと、価格の一部があなたに入ります。非表示にしたスロットのアイテムはあなたのアプリでは販売されません。
  • プロフィールには新着アイテムが表示され、「すべてのアイテム」でショップ全体が開きます。名前で検索、「自分の」、販売者、並び順(新着、人気、価格)。スクロールすると続きが読み込まれます。
  • 購入には必ず idosgames.com でのプレイヤーの確認が必要です。アプリのテスト版では何も引き落とされず、アイテムも付与されません。

クリエイターのアイテム

  • プラットフォームがクリエイターのアイテムを受け付けると、アカウントがあれば誰でも idosgames.com でアイテムを作れます(アバター、次に「自分のアイテムを作る」)。着ける場所を選び、形から始めて、名前、色、画像を変え、Aspisで価格を決めます。
  • エディターでは、クリエイターのアイテムは公式アイテムと同じセクションにあります。名前で検索、「自分の」、出どころ、並び順(新着、人気、価格)。スクロールすると続きが読み込まれます。
  • アイテムは公式アイテムと同じルールで確認され、既存のアイテムとまったく同じコピーは受け付けられません。公開後は見た目を変えられません。
  • アイテムはすぐにクリエイターのものになり、売れるたびにクリエイターが取り分を受け取ります。プレイヤーは問題のあるアイテムを報告でき、未解決の報告が多いアイテムはモデレーターが判断するまで自動で非表示になります。
  • クリエイターのアイテムは、アプリのアバターショップにプラットフォームのアイテムと並んで自動で表示されます。非表示になったアイテムはすべてのプレイヤーから外されます。

開発者向け

TypeScript
// The player's own look (null: the app does not use the account avatar)
const mine = await client.avatar.getMine()

// Looks of other players of this app: a room, a leaderboard page
const res = await client.avatar.get(userIDs)

// Draw it with @idosgames/characters
import { AvatarActor, avatarFromServer, DEFAULT_AVATAR, renderAvatarCanvas } from '@idosgames/characters/voxel'
const look = avatarFromServer(mine.ok ? mine.data : null)
const actor = new AvatarActor(look?.spec ?? DEFAULT_AVATAR, look?.items ?? {})
const sprite = look && renderAvatarCanvas(look.spec, look.items, { frame: 'full', size: 128 })

// Aspis でアイテムを買う(プレイヤーは idosgames.com で確認)
const shop = await client.avatar.getShop()
const page = await client.avatar.browseShop({ slot: 'hat', query: 'crown', sort: 'price_asc' })
const r = await client.credits.pay((id) => client.avatar.buyItem('hat.crown', 250, id))
  • ゲストや見た目のないプレイヤーは hasAvatar: false で届きます:DEFAULT_AVATAR または randomAvatar を描いてください。
  • avatar:changed イベントで描き直し、受け取った見た目は client.avatar.peek(userID) で読みます。
  • getShop() は販売中のアイテム、プレイヤーの所持品、アイテムのレシピを返します。プレイヤーが見た価格を必ず渡してください。価格が変わっていれば何も引き落とされません。
  • browseShop() は数千のアイテムに対応してショップをページごとに読みます。スロット、検索、ownedOnly、販売者、並び順。次のページには応答の next を cursor として渡します。

すべてのフィールドは SDK に記載されており、SDK MCP サーバーが提供します。

よくある質問

プレイヤーは私のアプリ内でアバターを変えられますか?

いいえ:プレイヤーは idosgames.com で編集し、それを使うすべてのアプリに新しい見た目が届きます。

ゲストには何が届きますか?

アバターはありません:ゲストや見た目のないプレイヤーには既定の見た目を描いてください。

関連ページ

自分のゲームを作ろう

アイデアを一文で書くだけで AI コーダーが作り、ゲームは専用リンクで公開されます。