Custom-Spiele
Die meisten Kunden betten ein Spiel aus dem Marketplace ein. Willst du lieber dein eigenes Spiel betreiben, kannst du ein Custom-Spiel registrieren: ein Spiel, das du selbst hostest, identifiziert durch eine id, die du wählst, statt eines aus dem Katalog zu nehmen.
Diese Seite ist ein Überblick darüber, was ein Custom-Spiel ist und was es braucht, eines zu nutzen. Ein Spiel im Detail zu verfassen (das Spiel, sein Schema und sein Replay zu schreiben) ist separat behandelt.
Ein Custom-Spiel registrieren
Nutz auf der Spiele-Seite eines Site-Keys (oder des Teams) das Custom-Spiel-Eingabefeld im Panel Spiel hinzufügen: gib eine id ein und klick Definieren. Anders als ein Marketplace-Spiel hat ein Custom-Spiel kein Autoren-Manifest, also definierst du sein Schema selbst im Editor (die Felder, die jedes Preset setzen kann) und verfasst dann Presets dagegen.
Eine Custom-Spiel-id kann ein beliebiger String im GitHub-Repo-Stil sein. Wählst du eine id, die auch im Marketplace existiert, hat dein Custom-Spiel Vorrang für diese id; Caputchin warnt dich zu dem Zeitpunkt und serviert nie still das Marketplace-Spiel stattdessen.
Hosting und das Replay-Artefakt
Du hostest das spielbare Spiel selbst und richtest das Widget mit dem game-src-Attribut darauf. Um ein Custom-Spiel als Verifizierungs-Gate zu nutzen, braucht Caputchin auch ein Replay-Artefakt: eine kleine Headless-Version des Spiels, die es erneut ausführen kann, um ein Ergebnis zu bestätigen. Du lädst das auf dem Einstellungen-Tab des Spiels hoch. Bis ein Replay-Artefakt hochgeladen ist und seine Prüfung besteht, zeigt sich ein Custom-Spiel als Nicht abspielbar und kann keinen Site-Key gaten.
Presets und Skin-Assets
Die Sprach-, Skin- und Konfigurations-Presets eines Custom-Spiels lösen sich auf und werden zur Laufzeit genau angewendet wie die eines Marketplace-Spiels, auf denselben Tarifstufen (siehe den Überblick). Der einzige Unterschied ist, woher das Feld-Schema kommt: du verfasst es im Dashboard, statt es von einem Marketplace-Manifest zu erben.
Ein Vorbehalt: weil du das spielbare Spiel selbst hostest, referenzier jedes Bild, Audio oder Video, das deine Skin-Presets nutzen, per absoluter URL. Es gibt kein Plattform-Bundle, gegen das ein relativer Asset-Pfad aufgelöst würde.
Siehe auch
- Überblick zur Spiel-Anpassung: Spiele registrieren und verwalten.
- Spiele und das Spiel-Gate: ein Spiel zur Verifizierung verlangen und die Abspielbarkeits-Anforderung.
- Schema-Referenz: die Feldtypen, aus denen du ein Custom-Schema verfasst.