Unabhängige Würfel für Onlinespiele

Würfe, die niemand auf dem Server drehen kann.

RandomDice.org liefert kryptografisch sichere, unverzerrte Ganzzahlen und einen öffentlichen Beleg für jeden Wurf. Spieler können die Zahl prüfen. Studios können den Würfel nicht stillschweigend „setzen“.

Kostenlosen API-Schlüssel holen

Kostenlos 10,000 Aufrufe pro UTC-Tag und Schlüssel. Mehr nötig? Kontakt.

Demo-Wurf · Würfel

Kunden

Spiele, die schon offen würfeln.

Diese Studios rufen RandomDice.org für Kampf, Beute oder Tischwürfe auf. Klicke ein Logo, um das öffentliche Wurfprotokoll zu öffnen — Würfe der letzten 15 Minuten, das Pflichtfeld player_name, Parameter und Zeitstempel. Suche dort deinen Spitznamen. Zeigt ein Spiel eine andere Zahl als das Protokoll, nutzt es unser Ergebnis nicht.

Öffentliche Würfe von Rento Öffentliche Würfe von Ludo Öffentliche Würfe von Backgammon Öffentliche Würfe von Rento Öffentliche Würfe von Ludo Öffentliche Würfe von Backgammon

Zweck

Spieler sollten dem Zufall des Hauses nicht vertrauen müssen.

In einem gehosteten Spiel gehört der Server dem Studio. Ein „zufälliger“ Würfel kann gewichtet, neu gewürfelt oder nachträglich getauscht werden. Das ist eine Absprache, kein Wurf. RandomDice.org steht außerhalb des Spiels: Der Server fragt uns nach einer Zahl, wir erzeugen sie mit PHP random_int() (einem CSPRNG) und veröffentlichen die Würfe der letzten 15 Minuten jedes gelisteten Spiels — einschließlich des Pflichtfelds player_name — damit jeder den Wert prüfen kann.

  • Unverzerrter Bereich. Gleichverteilte Ganzzahlen von min bis max, Standard 1–6.
  • Öffentliche Würfe. Die Würfe der letzten 15 Minuten jedes gelisteten Spiels kann jeder sehen — Spitzname, Werte, Parameter und Zeitstempel. Klicke ein Kundenlogo und suche deinen Spitznamen.
  • Öffentlicher Beleg. Jeder Aufruf liefert auch eine id und eine verify_url.
  • Kostenloses Kontingent. 10,000 API-Aufrufe pro UTC-Tag und Schlüssel. Darüber hinaus kontaktiere uns.

So geht’s

Eine JSON-API. Von überall aufrufbar.

Funktioniert aus der Adresszeile, mit curl, fetch, Python, Java, Godot HTTP, Unity und älteren Backends, die JSON senden können — alles, was HTTPS erreicht. Authentifiziere dich mit einem Bearer-Token, X-Api-Key oder dem Parameter api_key.

Endpunkt

GET or POST https://randomdice.org/api/v1/roll

Parameter

player_name (Pflicht, 1–40 Zeichen), min (Standard 1), max (Standard 6), count (1–100, Standard 1). Authentifizierung mit Authorization: Bearer, X-Api-Key oder api_key (praktisch für GET im Browser). Optionale eigene Zeichenketten: als zusätzliche Felder oder im Objekt params — höchstens 10, Schlüssel und Werte höchstens 32 Zeichen. Sie werden gespeichert und im öffentlichen Protokoll gezeigt. Aufrufe ohne player_name werden abgelehnt. Eine HTTP-Anfrage zählt als ein Kontingent-Aufruf, auch wenn count ein Stapel ist.

Kontingent

10,000 Aufrufe pro UTC-Tag. Header: X-RateLimit-Limit, Remaining, Reset. Darüber antwortet die API mit 429.

Browser-GET — in die Adresszeile einfügen:https://randomdice.org/api/v1/roll?api_key=rd_live_YOUR_KEY&player_name=FlashMan&min=1&max=6&count=1
curl -H "Authorization: Bearer rd_live_YOUR_KEY" \
  "https://randomdice.org/api/v1/roll?player_name=FlashMan&min=1&max=6&count=1&match_id=arena-12"
fetch("https://randomdice.org/api/v1/roll", {
  method: "POST",
  headers: {
    "Authorization": "Bearer rd_live_YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    player_name: "FlashMan",
    min: 1,
    max: 6,
    count: 3,
    params: { match_id: "arena-12", round: "3" }
  })
})
import requests
r = requests.get(
  "https://randomdice.org/api/v1/roll",
  params={"player_name": "FlashMan", "min": 1, "max": 20, "count": 1, "match_id": "arena-12"},
  headers={"Authorization": "Bearer rd_live_YOUR_KEY"},
)
print(r.json())

Eine erfolgreiche Antwort enthält player_name, params, values, id, verify_url und (sobald das Spiel gelistet ist) public_log_url. Zeige diese Links den Spielern. Die Würfe der letzten 15 Minuten sind auf der Spielseite öffentlich und nach Spitzname suchbar, einschließlich eigener Parameter. Fehler sind JSON: { "ok": false, "error": { "code", "message" } }.

API-Schlüssel

Schlüssel in einem Schritt.

Keine Freigabe abwarten. Der Schlüssel wird einmal auf dieser Seite gezeigt und dir per E-Mail geschickt. Das Kontingent beginnt bei 10,000 Aufrufen pro UTC-Tag. Denselben Schlüssel fügst du ein, wenn du dein Spiel einreichst, damit das Logo auf der Startseite dein öffentliches Wurfprotokoll öffnet.

Captcha-Bild

Einreichen

Spiel listen und einen Zertifikatsstempel erhalten.

Das sperrt die API nicht. Es ist das geprüfte Kundenverzeichnis und das öffentliche Wurfprotokoll. Füge den vollständigen API-Schlüssel von oben ein — nach der Freigabe ist dein Logo auf der Startseite anklickbar und öffnet die Würfe der letzten 15 Minuten, filterbar nach Spitzname. Ausstehende Einträge bleiben in der Warteschlange, bis wir sie per E-Mail freigeben oder ablehnen.

Pflicht. Füge den vollständigen Schlüssel aus „API-Schlüssel“ ein, nicht das kurze Präfix. Wir speichern eine Verknüpfung zu diesem Schlüssel, nicht das Geheimnis. Nach der Freigabe zeigt ein Klick auf dein Logo die Würfe der letzten 15 Minuten mit Spielerfilter.

Captcha-Bild

Kontakt

Kontingent, Partnerschaften oder ein Problem mit einem Wurf.

Wir veröffentlichen hier kein Postfach. Sende das Formular, wir antworten an die angegebene Adresse.

Captcha-Bild