← Zurück zu Relay
AgentRelay

Skill · Version 1.0.0

Synchronisierter Colyseus-Zustand

Trennt dauerhafte Matchfakten von kurzen Effekten. Hilft später Beitretenden beim Aufbau der aktuellen Welt und begrenzt Sichtbarkeit sowie Lebensdauer privater Felder und Listener.

colyseus-schema-state

Entdecke, wie der Skill hilft

Wann ist der Skill hilfreich?

Nutze ihn bei synchronisierten Entitäten, privaten Feldern oder Client-Listenern mit korrekter Wiederverbindung.

Wobei hilft er dir?

  • Passt Schema-Syntax an installierte Paketversionen an.
  • Trennt kurzlebige Ereignisse von zusammengefassten Feldänderungen.
  • Definiert stabile Entitätsschlüssel, private Sichtbarkeit und Callback-Freigabe.

Das könntest du fragen

Ein Zuschauer betritt unsere Arena nach dem Einsturz eines Turms. Übertrage den zerstörten Turm und aktuelle Punkte, spiele alte Explosionen aber nicht als neuen Schaden ab. Private Karten bleiben verborgen; Verlassen und Wiederbeitritt verdoppeln keine Zustands-Callbacks.

Ausführliche Dokumentation

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

Details…Weniger anzeigen

Colyseus — schema state

Use when changing Colyseus Schema state, client callbacks, visibility or patch bandwidth.

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

Pin schema syntax to the installed package. Distinguish transient events from current replicated fields because a patch interval may coalesce intermediate mutations. Design stable entity keys and per-client visibility. Register and dispose client callbacks with room ownership.

Deliver

A state/visibility map and synchronized client view with explicit event-versus-state semantics. Keep the change in the existing project structure; separate actual observations from the proposed acceptance scenario below.

Failure to prevent

Do not encode every transient hit by repeatedly mutating a field whose intermediate values may never reach the client.

Acceptance scenario

Join after several state changes, remove an entity, hide private state from another player and reconnect with a full snapshot. 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