ForHosting KIT · Entwickler-Tools

Würfeln mit Startwert

Ein Würfelgenerator mit Startwert erzeugt dieselbe Folge, solange Anzahl, Seitenzahl und Startwert unverändert bleiben.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Damit können Sie Tests, Spiele, Übungen und gemeinsame Szenarien wiederholen, bei denen alle Beteiligten identische Ergebnisse benötigen. Geben Sie die Anzahl der Würfel, die Seiten pro Würfel und einen nicht leeren Starttext an. Die Antwort listet jeden Wurf in seiner Reihenfolge auf und berechnet die Gesamtsumme.

Machen Sie einen Würfelwurf reproduzierbar

Gewöhnliche Würfelgeneratoren sollen überraschen. Reproduzierbarkeit ist jedoch wichtig, wenn eine andere Person oder ein späterer Durchlauf exakt dasselbe Resultat erhalten muss. Dieses Werkzeug wandelt Ihren Starttext in einen festen Anfangswert um und setzt anschließend für jedes akzeptierte Ergebnis einen deterministischen Generator fort. Wenn Sie dieselbe Würfelanzahl, dieselbe Seitenzahl und denselben Startwert senden, bleiben die geordneten Würfe und die Summe identisch. Schon die Änderung einer Eingabe erzeugt ein anderes Szenario. Als Startwert eignen sich der Name eines Testfalls, eine Spielkennung, die Bezeichnung einer Unterrichtseinheit oder jeder andere nicht leere Text, den Ihr Team speichern und weitergeben kann. Behandeln Sie ihn als Bestandteil der Szenariodefinition, nicht als Geheimnis. Die Antwort enthält eine Liste aller Würfe, damit Sie jeden Würfel und nicht nur die Summe prüfen können. Das hilft bei Regeln zu Paschen, höchsten oder niedrigsten Würfeln, einzelnen Erfolgen und späteren Wiederholungen. Zusätzlich wird die Summe ausgegeben, sodass für übliche Prüfungen keine weitere Rechnung nötig ist.

Wählen Sie Würfel und Seiten sorgfältig

Das Würfelfeld bestimmt die Anzahl unabhängiger Ergebnisse; das Seitenfeld legt den eingeschlossenen Wertebereich jedes Ergebnisses fest. Ein sechsseitiger Würfel liefert beispielsweise stets ganze Zahlen von 1 bis 6, ein zwanzigseitiger Würfel Werte von 1 bis 20. Zulässig sind 1 bis 1,000 Würfel und 2 bis 1,000,000 Seiten je Würfel. Ein Würfel mit weniger als zwei Seiten wird abgelehnt, weil er keine sinnvolle Zufallsauswahl darstellt. Auch Brüche und nicht numerische Werte werden zurückgewiesen und nicht unbemerkt gerundet. Die Implementierung ordnet 32-Bit-Werte per Verwerfungsmethode den Würfelseiten zu. Dadurch entsteht keine kleine Modulo-Verzerrung, wenn der Generatorbereich nicht gleichmäßig durch die Seitenzahl teilbar ist. Die Resultate sind auf Server und Browser deterministisch, weil der Algorithmus ausschließlich eindeutig definierte Ganzzahloperationen nutzt. Er greift weder auf Systemzufall noch auf Uhrzeit, Regionseinstellungen oder externe Dienste zu. Daher eignet er sich für wiederholbare Tests und Vorführungen, jedoch nicht für Kryptografie, Wetten oder sicherheitskritische Verlosungen.

Speichern und wiederholen Sie vollständige Szenarien

Für eine zuverlässige Wiederholung sollten Sie alle drei Eingaben gemeinsam speichern: Würfel, Seiten und Startwert. Nur die Summe genügt nicht, wenn Spielregeln später einzelne Würfe benötigen. Nur der Startwert genügt ebenfalls nicht, falls sich die Würfelkonfiguration ändern kann. Eine Testsuite kann den Startwert aus dem Fallnamen ableiten, die Fähigkeit aufrufen und die Würfe als lesbaren Nachweis aufbewahren. Eine Spielleitung kann den Startwert vor einer Sitzung veröffentlichen, damit alle Beteiligten eine Begegnung reproduzieren können, ohne dass die Ergebnisse vorab offengelegt werden. Lehrkräfte können einer ganzen Gruppe identische simulierte Daten geben und trotzdem den natürlichen Eindruck eines Würfelversuchs erhalten. Die Folge ist an den dokumentierten Algorithmus dieser Fähigkeit gebunden. Da sie zunächst als Beta angeboten wird, sollten Anwendungen für eine dauerhafte Archivwiedergabe auch die zurückgegebenen Würfe speichern. Die Automatisierung über die API kostet $0.002 je Anfrage; im Browser läuft dieselbe reine Berechnung lokal. Vergleichen Sie neben der Summe stets die geordnete Liste, denn unterschiedliche Folgen können dieselbe Summe ergeben.

Stabile Spieletests erstellen

Verwenden Sie benannte Startwerte in automatisierten Tests, damit Kampf-, Bewegungs- oder Wertungslogik wiederholbare Folgen erhält.

Eine Tischspielszene wiederholen

Teilen Sie Würfelkonfiguration und Startwert, damit alle dieselben geordneten Würfe und dieselbe Summe erzeugen können.

Unterrichtsaufgaben vorbereiten

Stellen Sie konsistente Würfeldaten für Wahrscheinlichkeitsaufgaben mit natürlich wirkenden Ergebnissen bereit.

Erzeugt derselbe Startwert immer dieselben Würfe?

Ja, sofern Würfelanzahl, Seitenzahl, Starttext und Algorithmus der Fähigkeit übereinstimmen.

Was geschieht bei weniger als 2 Seiten?

Die Anfrage endet mit einem Eingabefehler, da ein Würfel mindestens zwei mögliche Seiten benötigt.

Kann ich jeden Würfel statt nur der Summe sehen?

Ja. Die Würfelliste enthält jedes Ergebnis in Reihenfolge; das Summenfeld enthält deren Summe.

Eignet sich das für Kryptografie oder Echtgeldwetten?

Nein. Der Generator ist bewusst reproduzierbar und keine kryptografisch sichere Zufallsquelle.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Dieselbe reine Berechnung kann kostenlos in Ihrem Browser laufen.

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.

POSThttps://api.kit.forhosting.com/game/dice-roll-seeded

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

curl -X POST https://api.kit.forhosting.com/game/dice-roll-seeded \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dice":3,"sides":6,"seed":"campaign-round-7"}'
{
  "dice": 3,
  "sides": 6,
  "seed": "campaign-round-7"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.dice_roll_seeded",
  "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.

pro Anfrage$0.002

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

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →