---
type: explanation
title: Custom-Spiele
summary: Registrier und hoste dein eigenes Spiel statt eines aus dem Marketplace, mit einem Replay-Artefakt, sodass es die Verifizierung gaten kann.
---

Die meisten Kunden betten ein Spiel aus dem [Marketplace](/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](/docs/site-keys/games) 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](/docs/game-customization/overview)). 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](/docs/game-customization/overview): Spiele registrieren und verwalten.
- [Spiele und das Spiel-Gate](/docs/site-keys/games): ein Spiel zur Verifizierung verlangen und die Abspielbarkeits-Anforderung.
- [Schema-Referenz](/docs/references/customization-schema): die Feldtypen, aus denen du ein Custom-Schema verfasst.