REST-API · v1

DayZ Item-API

Die komplette Item-Datenbank als JSON, frei nutzbar mit persönlichem API-Key. Für Discord-Bots, Server-Tools, Overlays und eigene Projekte.

DZPage in Claude, Codex und anderen KI-Assistenten nutzenMCP-Server

DZPage betreibt einen MCP-Server (Model Context Protocol). Verbinde ihn einmal, und dein KI-Assistent schlägt beim Helfen selbst auf DZPage nach: Item-Werte, Loot, Infizierte, die Serverliste und Spiel-Updates. Er kann außerdem deine Serverdateien und Logs prüfen. Kein Konto und kein API-Key nötig.

Serveradresse

https://dzpage.com/mcp

Claude (Web und Desktop-App)

Öffne die Einstellungen, geh zu Connectors und füge einen eigenen Connector hinzu: als Name DZPage, als URL die Serveradresse oben.

Claude Code

Einmal im Terminal ausführen:

claude mcp add --transport http dzpage https://dzpage.com/mcp

Codex (CLI und IDE-Erweiterung)

Einmal ausführen oder den Block in ~/.codex/config.toml eintragen:

codex mcp add dzpage --url https://dzpage.com/mcp

# ~/.codex/config.toml
[mcp_servers.dzpage]
url = "https://dzpage.com/mcp"

Cursor und VS Code

Ein Klick öffnet die App auf deinem Computer, die vor dem Hinzufügen von DZPage nachfragt. Passiert nichts, nimm die Konfiguration darunter.

Zu Cursor hinzufügen In VS Code installieren

Andere Clients

Jeder Client, der entfernte MCP-Server über Streamable HTTP unterstützt, funktioniert. In einer JSON-Konfiguration sieht das so aus:

{
  "mcpServers": {
    "dzpage": {
      "type": "http",
      "url": "https://dzpage.com/mcp"
    }
  }
}

Was dein Assistent damit kann

search_itemsDie Item-Datenbank nach Namen in jeder Sprache durchsuchen
get_itemAlle Werte eines Items: Gewicht, Größe, Waffenwerte, Magazine, Anbauteile, Loot-Tiers und Spawn-Gebäude
where_to_find_itemWo ein Item auf einer Karte spawnt: die Orte mit den meisten passenden Gebäuden, mit Koordinaten und Link zur Loot-Map
compare_weaponsSchusswaffen vergleichen: Schaden auf Entfernung und Treffer bis zum Tod mit und ohne Weste
get_infectedLeben, Trefferzonen, Angriffe und Drop-Chancen aller Infizierten
search_serversCommunity-Server für PC, PlayStation und Xbox mit aktuellen Spielerzahlen finden
dayz_update_changesWas jedes DayZ-Update an der types.xml, events.xml und den anderen Vanilla-Dateien geändert hat
day_night_settingsDie gewünschte Länge von Tag und Nacht in die Werte für die serverDZ.cfg umrechnen
explain_server_settingEine Einstellung aus globals.xml oder cfggameplay.json erklären: Bedeutung, Vanilla-Wert, Bereich und passender Editor
validate_config_fileAlle Syntaxfehler einer XML- oder JSON-Serverdatei auf einmal finden
analyze_server_logDie Probleme in einem Server-Log erklären und wie man sie behebt
find_toolDich zum passenden DZPage-Tool für eine Aufgabe führen

Frag zum Beispiel

Wie viele Treffer braucht eine AKM auf 200 m gegen einen Spieler mit Plattenweste?
Warum stürzt mein Server ab? Hier ist das RPT-Log.
Was hat das letzte DayZ-Update an der types.xml von Chernarus geändert?

Kostenlos und nur lesend, bis zu 120 Anfragen pro Minute je IP-Adresse, davon bis zu 6 Datei- oder Logprüfungen. Dateien und Logs, die dein Assistent schickt, werden nur geprüft und nicht gespeichert.

Zugang & Fair Use

Alle /api/v1-Endpunkte brauchen einen kostenlosen API-Key. Er hält Missbrauch draußen und macht faire Rate-Limits möglich. Der Key kostet nichts.

Mit Discord einloggen (das Konto selbst ist kostenlos).
Erstelle in den Einstellungen einen kostenlosen API-Key.
API-Key erstellen und bei jeder Anfrage mitsenden.

# Empfohlen / recommended
curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm"

# Alternative
curl -H "X-Api-Key: dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"

Halte deinen Key geheim: Ruf die API von deinem Server, Bot oder Backend auf. Wer den Key hat, verbraucht dein Kontingent. Du kannst einen Key jederzeit in den Einstellungen widerrufen und einen neuen erstellen; der alte funktioniert sofort nicht mehr.

Die Spieldaten sind und bleiben für alle frei zugänglich. Die API ist kostenlos und bleibt es. DayZ und seine Spieldaten gehören Bohemia Interactive a.s.

API-Keys verwalten

API-Key erforderlich

Sende den Key als „Authorization: Bearer“- oder „X-Api-Key“-Header bei jeder Anfrage.

60 → 300 Requests/min

60 Anfragen pro Minute je Key. Jede Antwort trägt X-RateLimit-Header.

Echte Spieldaten

Direkt aus den DayZ-Configs extrahiert, aktualisiert nach Updates.

GET`/api/v1/items`

Items durchsuchen und filtern (paginiert)

Parameter	Beschreibung
q	Suche in Name und Klassenname (fuzzy)
cat	Kategorie, z. B. Weapon, Food / Drink, Ammo
tier	Loot-Tier: Tier1 bis Tier4 oder Unique
sort	name (Standard), damage, rpm oder weight
page	Seite, ab 1
limit	Treffer pro Seite, 1 bis 100 (Standard 48)
icons	1 = nur Items mit Icon
lang	Sprache des name-Felds: en, de, fr, es, it, ru, pl, cs, pt, zh (Standard en)

curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm&limit=5&lang=de"

{
  "meta": { "total": 12, "page": 1, "pages": 3, "limit": 5 },
  "items": [
    {
      "class_name": "AKM",
      "slug": "akm",
      "name": "KA-M",
      "category": "Weapon",
      "has_icon": true,
      "weight": 2140,
      "size_w": 8, "size_h": 3,
      "loot_tiers": ["Tier4"],
      "damage": 9.5,
      "icon": "https://dzpage.com/icons/full/AKM.png",
      "icon_thumb": "https://dzpage.com/icons/thumb/AKM.webp",
      "url": "https://dzpage.com/de/items/akm"
    }
  ]
}

GET`/api/v1/items/{class_name}`

Einzelnes Item mit allen Details

Akzeptiert Klassennamen (Groß-/Kleinschreibung egal) oder Slug. Liefert alle Felder: Waffen-Stats, Munition, Magazine, Aufsätze, Loot-Daten, Spawn-Gebäude, Rezepte, alle übersetzten Namen und die kompletten Rohdaten aus der Spiel-Config.

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/items/AKM?lang=de"

// JavaScript (Node.js, Discord-Bot, …)
const res = await fetch("https://dzpage.com/api/v1/items/AKM", {
  headers: { Authorization: "Bearer " + process.env.DZPAGE_API_KEY },
});
const { item } = await res.json();
console.log(item.names.de, item.weapon_stats.rpm_full_auto);

GET`/api/v1/categories`

Alle Kategorien mit Item-Anzahl

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/categories"

GET`/api/v1/meta`

Datenstand: Import-Datum, Item-Anzahl, Spiel-Build

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"

Fehler, Limits & Stabilität

Fehler sind immer JSON mit stabilem Fehlercode, verständlicher Meldung und Doku-Link:

{
  "error": "invalid_api_key",
  "message": "Invalid or revoked API key. …",
  "docs": "https://dzpage.com/api"
}

Status · Code	Bedeutung
401 · missing_api_key	Kein API-Key gesendet. Ergänze den „Authorization: Bearer“- oder „X-Api-Key“-Header.
401 · invalid_api_key	Der Key existiert nicht oder wurde widerrufen.
404 · not_found	Kein Item mit diesem Klassennamen oder Slug.
429 · rate_limited	Rate-Limit ausgeschöpft. Warte Retry-After Sekunden und versuch es erneut.
5xx	Serverfehler. Einfach erneut versuchen. Falls dauerhaft: melde es auf unserem Discord.

Jede erfolgreiche Antwort enthält Rate-Limit-Header, damit sich dein Client selbst drosseln kann:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1789000000
Retry-After: 31   (nur bei 429 / only on 429)

Spielregeln

Ein Key deckt eigene Projekte, Bots und Server-Tools ab. Fair Use innerhalb des Rate-Limits.
Bei Nutzung in eigenen Projekten freuen wir uns über einen Link auf dzpage.com.
Item-Icons (icon-/icon_thumb-URLs) bleiben frei verlinkbar. Sie sind langzeit-gecacht und brauchen keinen Key.
Die API ist v1: Felder kommen ggf. dazu, bestehende Felder werden nicht entfernt oder umbenannt.

Lädt …

Das Werkzeug wird vorbereitet

DZPage in Claude, Codex und anderen KI-Assistenten nutzenMCP-Server

Claude (Web und Desktop-App)

Claude Code

Codex (CLI und IDE-Erweiterung)

Cursor und VS Code

Andere Clients

Was dein Assistent damit kann

Frag zum Beispiel

Zugang & Fair Use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Fehler, Limits & Stabilität

Spielregeln

DZPage in Claude, Codex und anderen KI-Assistenten nutzenMCP-Server

Claude (Web und Desktop-App)

Claude Code

Codex (CLI und IDE-Erweiterung)

Cursor und VS Code

Andere Clients

Was dein Assistent damit kann

Frag zum Beispiel

Zugang & Fair Use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Fehler, Limits & Stabilität

Spielregeln

GET`/api/v1/items`

GET`/api/v1/items/{class_name}`

GET`/api/v1/categories`

GET`/api/v1/meta`

GET`/api/v1/items`

GET`/api/v1/items/{class_name}`

GET`/api/v1/categories`

GET`/api/v1/meta`