Spielideen & Features

Euer nächstes Feature

Gemeinsame Objekte

Teilt uninterpretierte Spieldaten mit expliziten Zugriffsrichtlinien, indizierten Abfragen und ursprünglichen Revisionen.

SDK: developSpielersession erforderlich
Godot
Illustration für Gemeinsame Objekte
Euer sichtbares Ergebnis

Lest vor dem Erstellen die Belegung des Eigentümers. Beim Erstellen wird deren Revision verwendet; Aktualisieren und Löschen verwenden die ursprüngliche Objektrevision. Eigentümer, Gruppe und der beim Erstellen festgelegte Ablaufzeitpunkt bleiben unverändert.

Video folgt

Für diesen Schritt fehlt noch das Video. Die Anleitung und der MCP-Auftrag sind bereits nutzbar.

Gemeinsame Objekte

Dasselbe Projekt vorbereiten

  1. Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

    Gemeinsame Objekte →
  2. Erstellt diese Testeinträge im Dashboard-Formular oder verwendet passende vorhandene Einträge. Die Werte sind Beispieldaten, kein aktueller Projektstand.

    Schlüssel
    bases
    Leserichtlinie
    all
    Schreibrichtlinie
    owner
    Rasterposition
    true
    Maximale Bytes pro Objekt
    1024
    Maximale Objekte pro Eigentümer
    1

    Schlüssel bleiben reserviert. Nach der ersten Verwendung sind Richtlinien, Suchschema, TTL und Position unveränderlich. Archivieren sperrt neue Schreibvorgänge; Lesen und Löschen bleiben möglich.

    Dieses erste Beispiel liest Daten. Es erstellt keine Gruppe, keinen Match und kein Objekt. Eine leere Liste ist eine gültige erste Antwort.

  3. Speichert die Einträge, ladet sie neu und prüft sie vor dem Beispiel. Erhaltet andere vorhandene Definitionen.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Dieses SDK-Beispiel nutzt develop. Prüft, ob die nötigen APIs in eurem installierten SDK verfügbar sind.

Verbindet zuerst den vorgesehenen Spieler über den Schnellstart. Ruft read_world_map() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

GDScript
res://scripts/shared_objects.gd
horizOn-Aufruf
1extends Node
2​
3# Verified SDK Develop API. Call explicitly after restoring the existing player.
4func read_world_map() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.sharedObjects.queryObjects(user.userId, "bases", {
9 "mode": "rectangle", "minX": -10, "maxX": 10,
10 "minY": -10, "maxY": 10, "limit": 20
11 })
12 if not result.success:
13 push_warning(result.errorCode)
14 return
15 for object in result.data.objects:
16 var bytes: PackedByteArray = object.data
17 print(object.id, " bytes=", bytes.size())
18 # Respect result.data.pollAfterSeconds; no automatic poll or page loop.
19 # Keep dataBase64 and lossless search-string wrappers unchanged on metadata edits.
20 # Mutations need durable original bytes, IDs and If-Match revision before one send.
21 # An unknown create is reconciled through getRecoveryUsage/queryRecoveryObjects.
22 # No new identity, replacement revision or automatic create retry.
Vollständiges SDK-Beispiel öffnen ↗

Weltkarte

Speichert die Basen der Eigentümer als uninterpretierte Bytes. Fragt ein konfiguriertes Rasterrechteck mit ganzzahligen Koordinaten ausdrücklich ab; aktualisiert mit der ursprünglichen Objektrevision. Die Position dient als Abfrageindex und prüft keine Spielregeln.

Asynchrones PvP

Wählt einen Gegner über eine begrenzte, nicht gleichverteilte Ganzzahlabfrage. Ladet dessen Verteidigungsbytes und validiert das Spiel mit einem serververwalteten Validated Actions-Lauf. Nur ein vertrauenswürdiges Backend entscheidet das Ergebnis und sendet eine unveränderliche Inbox-Mitteilung.

Verwendet passende Spielersitzungen, eine dauerhaft gespeicherte ursprüngliche Schreibabsicht und ausdrücklich angeforderte, begrenzte Lesevorgänge. Vertrauenswürdige Ergebnisprüfung und Inbox-Zustellung gehören auf euer Spiel-Backend; Account Keys gehören niemals in Spiel-Builds.

Testet euer neues Feature.

Lest vor dem Erstellen die Belegung des Eigentümers. Beim Erstellen wird deren Revision verwendet; Aktualisieren und Löschen verwenden die ursprüngliche Objektrevision. Eigentümer, Gruppe und der beim Erstellen festgelegte Ablaufzeitpunkt bleiben unverändert.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Endpunkte
  • GET/shared-objects/collections
  • GET/shared-objects/{collection}/usage
  • GET/shared-objects/{collection}/objects/{objectId}
  • POST/shared-objects/{collection}/query
  • POST/shared-objects/{collection}/objects
  • PUT/shared-objects/{collection}/objects/{objectId}
  • DELETE/shared-objects/{collection}/objects/{objectId}
Alle Endpunkte in der API-Referenz
Illustration für Bestenlisten
Unser Vorschlag für den nächsten Schritt

Gebt jeder Runde einen Highscore.

Speichert den Score nach dem Spiel und zeigt, wer vorne liegt. Eure Verbindung und Spielersession nutzt ihr weiter.