← Zurück zu Relay
AgentRelay

Skill · Version 1.0.0

Dauerhafte Colyseus-Belohnungen

Überführt bestätigte Matchergebnisse aus flüchtigem Raumspeicher in dauerhafte Ablage. Unterscheidet erfolgreiche, offene und unklare Schreibvorgänge, damit Wiederholungen Belohnungen weder verdoppeln noch verlieren.

colyseus-persistence-rewards

Entdecke, wie der Skill hilft

Wann ist der Skill hilfreich?

Nutze ihn, wenn Inventar oder Belohnungen Raumfreigabe und unterbrochene Datenbankbestätigungen überleben müssen.

Wobei hilft er dir?

  • Vergibt stabile Kennungen für serverbestätigte Spielergebnisse.
  • Trennt ausstehende, bestätigte und unklare Speicherergebnisse.
  • Klärt unterbrochene Schreibvorgänge vor Wiederholung oder Raumfreigabe.

Das könntest du fragen

Vergib nach unserem Koop-Raid je eine Belohnung mit der Ergebniskennung an berechtigte Teilnehmer. Simuliere erfolgreiches Speichern mit verlorener Bestätigung, wiederhole und schließe den Raum. Gleiche den ursprünglichen Vorgang ab und zeige genau eine gespeicherte Belohnung pro Spieler.

Ausführliche Dokumentation

Hier findest du die ursprüngliche Anleitung, Beispiele und Prüfschritte des Skills in ihrer Originalsprache.

Details…Weniger anzeigen

Colyseus — persistence rewards

Use when persisting Colyseus match results, inventory or rewards outside room memory.

Version and project gate

Inspect Server, client SDK and @colyseus/schema versions, TypeScript/decorator configuration, room registrations, auth hooks, patch/simulation rates, transport, deployment topology and persistence adapters. The 0.17 reconnection lifecycle must not be assumed for older versions. Never turn a task into an engine upgrade without the user’s intent. Read the version-matching official reference when an API decision depends on it.

Work

Assign a stable match/outcome identifier and separate pending, committed and unknown outcomes. Validate results from authoritative state and make durable writes idempotent. Reconcile an interrupted write before retrying; keep room disposal from silently dropping an uncommitted outcome.

Deliver

A persistence/outcome contract with retry and reconciliation behavior. Keep the change in the existing project structure; separate actual observations from the proposed acceptance scenario below.

Failure to prevent

A successful room broadcast does not prove a database commit; never reward twice after an uncertain response.

Acceptance scenario

Interrupt after persistence but before acknowledgement, retry with the same outcome ID and confirm exactly one durable reward. Follow the project’s execution and verification permissions. If execution or a target device is unavailable, provide the reproduction steps and name the remaining uncertainty; do not mark it passed.

Scope and sources

This skill belongs to Relay. Agent selection is restricted by Orqestria’s assigned-agent policy, including forced skill selection; instruction text alone is not an access control. These are original task workflows researched from official documentation, not a copied or endorsed vendor skill.

Enthaltene Dateien 1

  • SKILL.md