In-Game-Shop: Auslagen, Angebote und Preise

Was der Spieler sieht

• Auslagen als Tabs. Der erste Bereich einer Auslage ist ein Karussell, die übrigen sind Kartenraster.
• Ein tägliches Gratisgeschenk, das leuchtet, bis es abgeholt wird.
• Timer auf den Karten: „neu in“, „öffnet in“, „ausverkauft“.
• Ein Fenster zur Kaufbestätigung (auf Handys ein Bottom Sheet).
• Die Animation „Erhalten“: Belohnungen fliegen zu den Guthabenzählern.
• Ein Abzeichen am Shop-Tab, wenn ein Gratisangebot wartet.

Wie der Shop aufgebaut ist

Der Shop ist ein Baum: Auslage → Bereiche → Slots → Angebot.

• Angebot: was verkauft wird. Preis, Belohnungen, Limits, Banner („bester Wert“, „x2“). Angebote liegen in einem Katalog.
• Slot: ein Platz im Regal der Auslage. Ein Angebot lässt sich nur über einen Slot kaufen: Ein Angebot in keinem Slot wird gar nicht verkauft.
• Rotation: Ein Slot kann ein Angebot aus einem Pool zeigen und es nach Zeitplan wechseln, wie ein Tages-Shop. Die Rotation berechnet der Server, sodass ein Spieler auf jedem Gerät denselben Shop sieht.

Preise

Du kannst einen durchgestrichenen „alten“ Preis zeigen, den Rabatt in Prozent berechnet der Server. Ein Angebot kann mehrere Preisoptionen haben, zum Beispiel Münzen oder Edelsteine.

Kauflimits

• Insgesamt: zum Beispiel ein Starterpaket einmal.
• Pro Tag: wird um Mitternacht UTC zurückgesetzt.
• Abklingzeit: der nächste Kauf erst nach einer festgelegten Zeit.
• Pro Rotationsfenster: das Limit des Slots, solange dieses Angebot im Regal steht.

Die Abzeichen „erster Kauf“ und „ausverkauft“ sowie die Timer berechnet der Server für jeden Spieler.

Für Entwickler

Der Shop arbeitet über client.store in @idosgames/core. Zeichne den Bildschirm aus getStorefront(): die bereits für diesen Spieler berechnete Auslage (Rotation, Limits, Timer). getDefinitions() ist nur die Konfiguration, für alle gleich.

const res = await client.store.getStorefront()
if (!res.ok) return showError(res.error)

for (const store of res.data.Stores ?? [])
  for (const section of store.Sections ?? [])
    for (const slot of section.Slots ?? []) {
      // Ein leerer Slot kommt mit Offer === null: Zeichne einen leeren Rahmen, damit das Regal nicht springt.
      if (!slot.Offer) continue
      drawCard(slot.Offer, slot.RefreshesAtUtc)
    }

const buy = await client.store.purchase(offer.OfferID, 1, {
  selectedOptionID: option.OptionID,
  slot: { storeID: store.StoreID, sectionID: section.SectionID, slotID: slot.SlotID },
})

• Gibt ein Kauf OFFER_NOT_IN_ROTATION zurück, hat sich die Auslage geändert: Lade sie neu, ohne einen Fehler zu zeigen.
• Deaktiviere den Knopf „Kaufen“, solange die Anfrage läuft: Jeder Aufruf von purchase ist ein eigener Kauf.
• Zähle Timer von ServerTimeUtc in der Antwort herunter, nicht von der Geräteuhr.
• null in einem Restlimit heißt „kein Limit“, 0 heißt „ausverkauft“.

Jedes Feld ist im Skill store-system beschrieben, den der MCP-Server des SDK bereitstellt.