ForHosting KIT · Haushalt, Küche und Freizeit

K.-o.-Turnierbaum mit automatischen Freilosen erstellen

Fünf Teams ergeben einen Turnierbaum mit acht Plätzen, drei Freilosen für die bestgesetzten Teams, einem Auftaktspiel und drei Runden bis zum Finale; dieselbe Liste liefert immer denselben Baum. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

Teilnehmer: North Stars, River Hawks, City Lions, Valley Foxes, Coastal Bears

Erhalten Sie

Teilnehmerzahl: 5
Turnierbaumgröße: 8
Anzahl der Freilose: 3
Rundenzahl: 3

Verwandeln Sie eine geordnete Teilnehmerliste in einen vollständigen K.-o.-Turnierbaum. Das Werkzeug berechnet die nächste Zweierpotenz, fügt nur die erforderlichen Freilose ein und nummeriert alle Spiele bis zum Finale. Die Eingabereihenfolge gilt als Setzliste. Es findet keine zufällige Auslosung statt: Dieselbe Teilnehmerliste erzeugt immer exakt denselben Turnierbaum.

Bereiten Sie die Teilnehmer in Setzreihenfolge vor

Beginnen Sie mit mindestens zwei Namen und ordnen Sie diese so, wie sie in der Setzliste gelten sollen. Der erste Eintrag erhält Setzplatz 1, der zweite Setzplatz 2 und so weiter. Namen können Personen, Teams, Vereine, Schulen, Projekte oder andere Teilnehmer bezeichnen, jeder Eintrag muss jedoch eine nicht leere Zeichenfolge sein.

Leerzeichen am Anfang und Ende werden entfernt, damit aus Anmeldedaten kopierte Bezeichnungen sauber bleiben. Doppelte Namen werden beibehalten, da verschiedene Teilnehmer denselben Anzeigenamen tragen können; ergänzen Sie bei Bedarf Stadt, Spielklasse oder Teamcode. Der Generator mischt das Feld nicht, fragt keine Rangliste ab und verwendet keinen Zufall.

Identische Eingaben ergeben deshalb immer denselben Plan. Falls eine Rangliste die Platzierung bestimmen soll, sortieren Sie die Namen vor dem Aufruf. Die Trennung von Auswahlregeln und Turnieraufbau ermöglicht es jeder Veranstaltung, ihre veröffentlichten Setzregeln ohne verborgene Annahmen anzuwenden.

Verstehen Sie Größe, Spiele und Freilose

Ein K.-o.-Turnierbaum funktioniert mit Feldgrößen, die Zweierpotenzen sind: 2, 4, 8, 16 und weitere. Liegt die Teilnehmerzahl dazwischen, wählt der Generator die kleinste Zweierpotenz, die alle aufnehmen kann. Die Differenz ist die Zahl der Freilose.

Fünf Teilnehmer benötigen beispielsweise ein Achterfeld: Drei gesetzte Teilnehmer kommen kampflos weiter, während die übrigen zwei das erste ausgetragene Spiel bestreiten. Freilose gehen nach einer festen Regel an die ersten Setzplätze; die verbleibenden Teilnehmer werden in Eingabereihenfolge gepaart. Jedes Erstrundenspiel enthält Name und Setznummer.

Bei einem Freilos wird außerdem angegeben, wer automatisch weiterkommt. Spätere Runden enthalten Quellen wie „Sieger aus Spiel 1“, sodass Ergebnisse eindeutig verbunden werden können. Die Antwort nennt zusätzlich Teilnehmerzahl, Feldgröße, Freilose und Rundenzahl, was Prüfung und Anzeige vereinfacht.

Nutzen Sie den Turnierbaum im Veranstaltungsablauf

Die ausgegebenen Runden eignen sich für eine Turnieransicht, einen druckbaren Ablaufplan, eine Spieldatenbank oder eine organisatorische Prüfliste. Lesen Sie Runden und Spiele in der gelieferten Reihenfolge. Zeigen Sie in der Auftaktrunde die Namen direkt an; bei einem Freilos übernehmen Sie den angegebenen Teilnehmer ohne Ergebnisabfrage in die nächste Runde.

Ersetzen Sie später jede Quellenangabe durch den Sieger des genannten Spiels. Die Funktion erstellt nur die Struktur: Sie erfasst keine Ergebnisse, bestimmt keine Sieger, plant keine Plätze, behandelt keine Rückzüge und setzt nicht neu. Diese Aufgaben sollten in Ihrer Anwendung bleiben, damit deren Regeln ausdrücklich dokumentiert sind.

Eine gute Integration speichert den erzeugten Turnierbaum als unveränderlichen Ausgangsplan und führt Ergebnisse separat über Spielnummern. So bleibt die Historie auch bei Rückzug oder Korrektur erhalten. Prüfen Sie die endgültige Liste vor der Veröffentlichung, denn eine geänderte Reihenfolge verändert den Baum.

Anwendungsfälle

Ein Vereinsturnier organisieren

Wandeln Sie die endgültige Anmeldeliste in einen nummerierten Turnierbaum für Veröffentlichung und Durchführung um.

Turnierbäume in Veranstaltungssoftware einbauen

Erzeugen Sie nach Anmeldeschluss vorhersehbare Spiele und eindeutige Verweise auf die nächste Runde.

Einen internen Wettbewerb planen

Erstellen Sie eine klare K.-o.-Struktur für Teams, Spiele, Vorschläge, Vorführungen oder Schulwettbewerbe.

Häufige Fragen

Wie werden die Freilose berechnet?

Das Feld wächst bis zur kleinsten Zweierpotenz, die alle aufnimmt. Unbesetzte Plätze werden zu Freilosen.

Wer erhält ein Freilos?

Freilose gehen nach einer festen Regel an die ersten Teilnehmer der übermittelten Setzreihenfolge.

Mischt der Generator die Namen?

Nein. Er verwendet keinen Zufall. Sortieren oder mischen Sie die Liste vorab, wenn die Regeln eine Auslosung verlangen.

Dürfen zwei Teilnehmer denselben Namen haben?

Ja. Doppelte Anzeigenamen bleiben erhalten; die Setznummern unterscheiden die Einträge dennoch eindeutig.

Verwaltet das Werkzeug Ergebnisse und Sieger?

Nein. Es erzeugt den anfänglichen Baum und die Fortschrittsverweise; Ergebnisse verwaltet die aufrufende Anwendung.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/game/tournament-bracket-build

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/game/tournament-bracket-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"participants":["North Stars","River Hawks","City Lions","Valley Foxes","Coastal Bears"]}'

const res = await fetch("https://api.kit.forhosting.com/game/tournament-bracket-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "participants": [
      "North Stars",
      "River Hawks",
      "City Lions",
      "Valley Foxes",
      "Coastal Bears"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/tournament-bracket-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "participants": [
        "North Stars",
        "River Hawks",
        "City Lions",
        "Valley Foxes",
        "Coastal Bears"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/tournament-bracket-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"participants":["North Stars","River Hawks","City Lions","Valley Foxes","Coastal Bears"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"participants":["North Stars","River Hawks","City Lions","Valley Foxes","Coastal Bears"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/tournament-bracket-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "participants": [
    "North Stars",
    "River Hawks",
    "City Lions",
    "Valley Foxes",
    "Coastal Bears"
  ]
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.tournament_bracket_build",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Technische Hinweise

Dadurch ist das Ergebnis stabil, nachvollziehbar und lässt sich in einer Veranstaltungsseite, einem Anmeldesystem oder einer Wettkampf-API weiterverwenden.

Nutzen Sie den Turnierbaum im Veranstaltungsablauf

Eine automatisierte API-Anfrage kostet $0.002.

Technische Fragen

Wie viele Teilnehmer sind erforderlich?

Mindestens zwei Namen sind erforderlich. Eine kürzere Liste löst den Fehler invalid_input aus.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Im Browser lässt sich dieselbe deterministische Logik lokal ausführen.

Vollständige KIT-Dokumentation lesen →

K.-o.-Turnierbaum mit automatischen Freilosen erstellen

Im Browser ausführen – kostenlos

Rechenbeispiel

Bereiten Sie die Teilnehmer in Setzreihenfolge vor

Verstehen Sie Größe, Spiele und Freilose

Nutzen Sie den Turnierbaum im Veranstaltungsablauf

Anwendungsfälle

Ein Vereinsturnier organisieren

Turnierbäume in Veranstaltungssoftware einbauen

Einen internen Wettbewerb planen

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Fehler

Technische Hinweise

Nutzen Sie den Turnierbaum im Veranstaltungsablauf

Technische Fragen

danke