계정 아바타는 플레이어의 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로 가격을 정합니다.
- 에디터에서 크리에이터 아이템은 공식 아이템과 같은 섹션에 있습니다: 이름 검색, 내 것, 출처, 정렬(최신순, 인기순, 가격순). 스크롤하면 아이템이 더 불러와집니다.
- 아이템은 공식 아이템과 같은 규칙으로 검사되며, 기존 아이템과 똑같은 복사본은 거절됩니다. 게시 후에는 아이템 모양을 바꿀 수 없습니다.
- 아이템은 바로 크리에이터의 것이 되고, 판매될 때마다 크리에이터가 몫을 받습니다. 플레이어는 나쁜 아이템을 신고할 수 있으며, 열린 신고가 많은 아이템은 운영진이 결정할 때까지 자동으로 숨겨집니다.
- 크리에이터 아이템은 앱의 아바타 상점에 플랫폼 아이템과 함께 자동으로 나타납니다. 숨겨진 아이템은 모든 플레이어에게서 벗겨집니다.
개발자용
// 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에서 편집하고, 이를 사용하는 모든 앱이 새 모습을 받습니다.
게스트는 무엇을 받나요?
아바타가 없습니다: 게스트와 모습이 없는 플레이어에게는 기본 모습을 그려 주세요.
함께 보기
- 플레이어 프로필: 이름, 설정, 언어iDos Games의 준비된 플레이어 프로필이 작동하는 방식: 서버 규칙을 따르는 이름, ID, 소리, 볼륨, 애니메이션 줄이기, 게임 언어, 로그아웃. 모든 새 프로젝트에 들어 있습니다.
- 영웅과 캐릭터: 능력치, 등급, 장비iDos Games의 준비된 영웅 시스템이 작동하는 방식: 영웅 명단, 능력치 강화, 등급, 서버가 계산하는 전투력, 장비 슬롯, 스킨, 그리고 대시보드에서 설정하는 방법.
- TypeScript SDK와 프로젝트 구조iDos Games 프로젝트의 구성: @idosgames npm 패키지, 로그인과 로비가 있는 호스트 셸, 시스템과 게임을 위한 기능 모듈, 디자인을 위한 설정 파일 하나.
나만의 게임을 만드세요
아이디어를 한 문장으로 설명하면 AI 코더가 만들어 주고, 게임은 고유 링크로 바로 공개됩니다.