Spielsysteme

Konto-Avatar: ein Aussehen in jeder App

Wie der iDos Games Konto-Avatar in deiner App funktioniert: das Voxel-Aussehen des Spielers von idosgames.com, welche Slots angezeigt werden, Größengrenzen und das Zeichnen mit dem SDK.

Der Konto-Avatar ist die iDos Games Figur des Spielers: ein Aussehen für alle Apps, bearbeitet auf idosgames.com. Deine App entscheidet, ob sie ihn nutzt und was sie davon zeigt; ohne ihn zeichnet die App eigene Figuren.

Was der Spieler sieht

  • Den eigenen Avatar im Profil und in deiner App, wenn die App ihn nutzt.
  • Die Avatare anderer Spieler in Räumen, Chats und Bestenlisten, auf die gleiche Weise gezeichnet.
  • Avatar ändern im Profil öffnet den Editor auf idosgames.com.

So funktioniert es

  • Das Aussehen liegt im Konto des Spielers, nicht in deiner App: eine Änderung erreicht sofort jede App.
  • Der Server schickt jedes Aussehen schon nach deinen Regeln: ausgeblendete Slots abgenommen, die Größe in deine Grenzen gebracht.
  • Aussehen werden nach Revision gelesen: ein unverändertes Aussehen kommt ohne Daten zurück.

Schritt 01Zum Projekt hinzufügen

Nichts zu installieren: Das Profil jedes neuen Projekts zeigt den Avatar, wenn er eingeschaltet ist. Für die eigenen Figuren deines Spiels nutze das SDK unten.

Schritt 02Im Dashboard einrichten

Öffne das Dashboard, wähle dein Projekt und gehe zu Live Operations → v2 → Avatar.

  • Konto-Avatar verwenden: standardmäßig aus.
  • Was die App zeigt: Abgewählte Slots werden allen Spielern in dieser App abgenommen.
  • Größe: Grenzen von 0.9 bis 1.1 auf der Skala des Standards.

Die Schaltfläche KI auf der Seite öffnet einen Assistenten: Beschreibe, was du brauchst, er schlägt Änderungen vor, und du prüfst sie und drückst Speichern.

Schritt 03Testen und veröffentlichen

Prüfe den Avatar in der Testversion deiner App. Einstellungen gehen in einem eigenen Schritt in die Live-App: siehe Veröffentlichung und Links.

In Vorlagen

  • Spielbaukasten: In 3D-Genres wird der Held des Spielers als sein Avatar gezeigt, mit Laufen, Springen, Angriffen und Siegestanz. 2D-Genres behalten ihre eigenen Figuren.
  • Brettspiel: Die Spielfigur des Spielers wird zu seinem Avatar. Im Modus „Mit Freunden“ sehen sich Freunde gegenseitig als Avatare auf einem Brett.
  • Gäste und Spieler ohne Look bekommen den eigenen Helden oder die Figur des Spiels.

Avatar-Shop

  • Die Startgegenstände sind für alle kostenlos; neuere Gegenstände sind kostenpflichtig und werden von der Plattform für Aspis verkauft.
  • Ein gekaufter Gegenstand gehört dem Spieler für immer, in jeder App. Angelegt wird er im Editor auf idosgames.com.
  • Das Profil zeigt den Shop unter dem Avatar. Kauft ein Spieler einen Gegenstand in deiner App, erhältst du einen Anteil am Preis; Gegenstände ausgeblendeter Slots werden in deiner App nicht verkauft.
  • Im Profil stehen die neuesten Gegenstände, „Alle Gegenstände“ öffnet den ganzen Shop: Suche nach Namen, „Meine“, Verkäufer und Reihenfolge (neueste, beliebt, nach Preis). Weitere Gegenstände laden beim Scrollen nach.
  • Jeder Kauf braucht die Bestätigung des Spielers auf idosgames.com. In der Testversion deiner App wird nichts abgebucht und kein Gegenstand vergeben.

Gegenstände von Creators

  • Wenn die Plattform Gegenstände von Creators öffnet, kann jeder mit Konto auf idosgames.com einen Gegenstand erstellen (Avatar, dann „Eigenen Gegenstand erstellen“): wählen, wo er getragen wird, mit einer Form beginnen, Name, Farben und Bild ändern und einen Preis in Aspis festlegen.
  • Im Editor liegen die Gegenstände von Creators in denselben Bereichen wie die offiziellen: Suche nach Namen, „Meine“, Herkunft und Reihenfolge (neueste, beliebt, nach Preis). Weitere Gegenstände laden beim Scrollen nach.
  • Der Gegenstand wird nach denselben Regeln wie jeder offizielle geprüft, eine genaue Kopie eines vorhandenen Gegenstands wird abgelehnt. Das Aussehen lässt sich nach dem Veröffentlichen nicht ändern.
  • Der Gegenstand gehört sofort dem Creator, und an jedem Verkauf bekommt der Creator einen Anteil. Spieler melden schlechte Gegenstände: Ein Gegenstand mit vielen offenen Meldungen wird von selbst ausgeblendet, bis die Moderation entscheidet.
  • Gegenstände von Creators erscheinen automatisch im Avatar-Shop deiner App neben den Gegenständen der Plattform. Ein ausgeblendeter Gegenstand wird allen Spielern abgenommen.

Für Entwickler

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 })

// Einen Gegenstand für Aspis kaufen (der Spieler bestätigt auf 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))
  • Gäste und Spieler ohne Aussehen kommen mit hasAvatar: false: Zeichne für sie DEFAULT_AVATAR oder randomAvatar.
  • Zeichne beim Ereignis avatar:changed neu; erhaltene Aussehen liest du mit client.avatar.peek(userID).
  • getShop() liefert das Angebot, den Besitz des Spielers und die Rezepte der Gegenstände; übergib immer den Preis, den der Spieler gesehen hat: hat er sich geändert, wird nichts abgebucht.
  • browseShop() liest den Shop seitenweise für Tausende Gegenstände: Slot, Suche, ownedOnly, Verkäufer und Reihenfolge; übergib next der Antwort als cursor für die nächste Seite.

Jedes Feld ist im SDK beschrieben, bereitgestellt vom MCP-Server des SDK.

Häufige Fragen

Kann der Spieler den Avatar in meiner App ändern?

Nein: Der Spieler bearbeitet ihn auf idosgames.com, und jede App, die ihn nutzt, erhält das neue Aussehen.

Was bekommt ein Gast?

Keinen Avatar: Zeichne für Gäste und Spieler ohne Aussehen ein Standard-Aussehen.

Siehe auch

Erstelle dein eigenes Spiel

Beschreibe die Idee in einem Satz: Der KI-Coder baut das Spiel, und es geht unter eigenem Link online.