Eigene Zauber, Regeln und Quellenbücher in SpellForge
So bringst du deine eigenen Inhalte als JSON-Datei in die App – einmal Schritt für Schritt und einfach erklärt, einmal technisch bis ins Detail.
.json. Darin stehen deine Zauber oder deine Klassenregeln in einer festen Form. In der App wählst du die Datei aus, die App prüft sie, zeigt dir eine Vorschau – und danach sind deine Inhalte im Spellbook, im Regelwerk und bei deinen Charakteren verfügbar.{"name","spells":[…]} oder reines Array), Regel-Datensatz ({"name","classes","class_features"}) und Quellenbuch ({"kind":"supplement",…}). Alle sind UTF-8-JSON mit snake_case-Schlüsseln. Die Dateien liegen nur lokal auf deinem Gerät; es gibt keinen Upload.1 · Worum geht es? Welche Datei brauche ich?
Zauber-Datensatz
Du willst nur Zauber ergänzen oder den kompletten Zauberbestand austauschen. Es ist immer ein Zauber-Datensatz aktiv (Umschalten in den Einstellungen).Regel-Datensatz
Du willst Klassen (Tabellen, Merkmale, Unterklassen) austauschen oder komplett eigene Klassen anlegen. Es ist immer ein Regel-Datensatz aktiv.Quellenbuch
Du willst ein Buch/Erweiterung hinzufügen (Zauber, Unterklassen, optionale Merkmale, neue Klasse). Jedes Buch hat einen eigenen Schalter und wird zusätzlich zu den Datensätzen geladen.| Ich möchte … | Nimm … |
|---|---|
| 3 eigene Zauber für meine Runde hinzufügen | Quellenbuch (empfohlen) – lässt sich jederzeit ausschalten |
| Ein Regelwerk-Buch (z. B. Erweiterungsband) mit Zaubern und Unterklassen abbilden | Quellenbuch |
| Die Zauber des Grundregelwerks komplett ersetzen | Zauber-Datensatz |
| Alle 12 Klassen mit eigenen Tabellen | Regel-Datensatz |
| Eine neue Klasse (z. B. Magieschmied) ergänzen, ohne die anderen anzufassen | Quellenbuch mit classes + class_features |
2 · Schnellstart: dein erstes Quellenbuch in 10 Minuten
- Vorlage laden. Lade die frei verwendbare Vorlage herunter:
- In einem Texteditor öffnen. Am Rechner z. B. VS Code, Notepad++ oder TextEdit (im Modus „Reiner Text“). Nicht Word benutzen – es ersetzt die geraden Anführungszeichen durch typografische und zerstört das JSON.
- Namen ändern. Ändere
"name","short"(Kürzel, 2–5 Buchstaben) und"id"(nur Kleinbuchstaben, Zahlen, Bindestriche, z. B."meine-runde"). - Zauber anpassen. Ändere Namen, Grad und Beschreibung des Beispielzaubers. Die Zauber-
idmuss einmalig sein (z. B."meine-runde-funkenregen"). - Prüfen. Füge den Inhalt unten im Datei-Prüfer ein. Er meldet Tippfehler, bevor du in der App importierst.
- Aufs Gerät bringen. Datei per AirDrop, iCloud Drive, E-Mail oder USB auf das iPad/Tablet legen (App „Dateien“).
- Importieren. In SpellForge: Einstellungen → Quellenbücher → „Quellenbuch importieren …“, Datei wählen, Vorschau lesen, bestätigen.
- Ausprobieren. Im Spellbook erscheint dein Zauber mit einem Kennzeichen (z. B. MR · 2014). Mit dem Schalter in den Einstellungen schaltest du das Buch jederzeit aus und wieder an.
3 · JSON in 5 Minuten
{ geschweiften } Klammern, eine Liste in [ eckigen ] Klammern. Alles wird mit Kommas getrennt – aber nach dem letzten Eintrag kommt kein Komma.{
"name": "Funkenregen", ← Text: in geraden Anführungszeichen
"level": 1, ← Zahl: ohne Anführungszeichen
"ritual": false, ← Ja/Nein: true oder false (klein, ohne Anführungszeichen)
"classes": ["Magier", "Barde"], ← Liste: eckige Klammern, Einträge mit Komma getrennt
"higher_levels": null ← „leer / nicht vorhanden“
}
| Typ | Aussehen | Beispiel |
|---|---|---|
| Text (String) | "…" | "1 Aktion" |
| Zahl | ohne Anführungszeichen, Punkt als Dezimalzeichen | 3, 7.5 |
| Wahrheitswert | true / false | "ritual": false |
| Liste | [ … ] | ["V", "G"] |
| Objekt | { "feld": wert } | {"v": true} |
| Leer | null | "higher_levels": null |
Die fünf häufigsten Anfängerfehler
- Komma nach dem letzten Eintrag (
["a", "b",]) – nicht erlaubt. - Fehlendes Komma zwischen zwei Einträgen.
- Typografische Anführungszeichen („ “ ‚ ’) statt gerader
"– kommt von Word/Notizen-Apps. - Anführungszeichen im Text: Innerhalb eines Textes mit
\"schreiben ("Er sagt \"Hallo\"") oder deutsche „Zitate“ verwenden. - Zeilenumbruch im Text: Ein Text darf nicht über mehrere Zeilen laufen. Für neue Absätze nimmst du einen neuen Eintrag in der Liste (siehe
description).
ä-Ersatzschreibung nötig (funktioniert aber). Unbekannte zusätzliche Felder werden beim Laden ignoriert; fehlende Pflichtfelder führen zu einer Fehlermeldung mit dem Pfad („Feld „range“ fehlt (spells › Eintrag 3)“).4 · Importieren, an- und ausschalten, löschen
Import (iPad und Android gleich)
- Datei auf das Gerät legen (Dateien-App / Download-Ordner).
- Einstellungen öffnen. Je nach Dateityp:
- Zauber-Datensatz → Abschnitt „Zauber-Datensatz“ → „Zauber-Datensatz importieren …“
- Regel-Datensatz → Abschnitt „Regeln-Datensatz“ → „Regeln-Datensatz importieren …“
- Quellenbuch → Abschnitt „Quellenbücher“ → „Quellenbuch importieren …“
- Die App zeigt eine Vorschau: was enthalten ist (Anzahl Zauber, Klassen, Unterklassen …), was fehlt oder auffällt (gelb, Import trotzdem möglich) und Fehler (rot, Import gesperrt).
- Bestätigen. Zauber-/Regel-Datensätze werden sofort aktiv; Quellenbücher werden eingeschaltet.
Wie die Teile zusammenspielen
| Was | Wie viele aktiv? | Ausschalten |
|---|---|---|
| Zauber-Datensatz | genau 1 (Auswahl) | anderen wählen; der mitgelieferte SRD-Satz bleibt immer da |
| Regel-Datensatz | genau 1 (Auswahl) | anderen wählen |
| Quellenbuch | beliebig viele | Schalter an der Buchzeile; „Löschen“ entfernt die Datei vom Gerät |
id anwenden: Zauber anhängen – bei gleicher Zauber-id ersetzt der Buchzauber den Basiszauber; Unterklassen und extra_sections an die Klasse anhängen (gleicher Name wird übersprungen); class_features_add an features anhängen; Klassen aus classes nur ergänzen, wenn der Schlüssel noch nicht existiert. (3) spell_class_additions_ids fügt vorhandenen Zaubern Klassen hinzu. Ausgeschaltet = alles davon verschwindet; Charaktere behalten ihre Einträge und zeigen „Quellenbuch deaktiviert“.Wo steht die Zauber-ID?
Jeder Zauber zeigt seine id klein unten in der Ecke der Karte bzw. des Detailbereichs, bei Buchzaubern mit Kürzel und Edition davor (XRA · 2014 · frostfinger). Damit findest du den Eintrag in deiner JSON-Datei per Suchen sofort wieder.
… oder Pfeile mit Erklärungen. Sie zeigen den Aufbau und sind nicht als Datei gültig. Fertig lauffähige Dateien findest du in den Vorlagen oben.5 · Die Zauber-Datei
Aufbau
Entweder eine Liste von Zaubern ([ {…}, {…} ]) oder – empfohlen – ein Objekt mit Namen und Quellenangabe:
{
"name": "Meine Hausregel-Zauber",
"source": "Eigene Runde",
"license": "Eigene Inhalte",
"spells": [ { … Zauber 1 … }, { … Zauber 2 … } ]
}
Ein vollständiger Zauber
{
"id": "meine-runde-funkenregen",
"name": "Funkenregen",
"level": 1,
"school": "Hervorrufung",
"ritual": false,
"casting_time": "1 Aktion",
"range": "9 m",
"components_raw": "V, G, M (eine Prise Zunder)",
"components": { "v": true, "g": true, "m": true, "material": "eine Prise Zunder" },
"duration": "Unmittelbar",
"concentration": false,
"description": [
"Ein glitzernder Funkenregen fällt auf einen Punkt in Reichweite. Kreaturen im Würfel von 3 m Kantenlänge erleiden 1W6 Feuerschaden.",
"Ein zweiter Absatz steht als zweiter Eintrag der Liste."
],
"higher_levels": "Der Schaden steigt pro Grad über 1 um 1W6.",
"classes": ["Magier", "Zauberer"],
"source": "Meine Runde"
}
Alle Felder
| Feld | Typ | Bedeutung und Regeln | |
|---|---|---|---|
id | Text | Pflicht | Eindeutig innerhalb der Datei (und am besten global). Nur a–z, 0–9, -; Umlaute auflösen (ä→a, ß→ss). Wird in Charakteren gespeichert – später nicht mehr ändern! |
name | Text | Pflicht | Anzeigename. Nicht leer. |
level | Zahl | Pflicht | 0 = Zaubertrick, 1–9 = Zaubergrad. Alles andere ist ein Fehler. |
school | Text | empfohlen | Eine der acht Schulen, deutscher Schlüssel (siehe Schlüsselwörter). Fehlt sie, kommt ein Hinweis. |
ritual | true/false | Pflicht | Kann der Zauber als Ritual gewirkt werden? |
casting_time | Text | Pflicht | Beginnt mit 1 Aktion, 1 Bonusaktion, 1 Reaktion (auch 1 action … in Englisch), sonst gilt „Länger“ (z. B. 1 Minute, 10 Minuten). Wichtig für den Filter und „Am Tisch“. |
range | Text | Pflicht | Beginnt mit Selbst, Berührung (Touch/Self englisch) – alles andere zählt als Fernbereich (9 m, Sicht). |
components_raw | Text | Pflicht | Die Komponenten so, wie sie auf der Karte stehen: V, G, M (Fledermausfell). |
components | Objekt | optional | {"v":true,"g":false,"m":true,"material":"…"} – für Symbole/Filter. material darf null sein. Fehlt das Objekt, zeigt die App components_raw. |
duration | Text | Pflicht | Unmittelbar, 1 Stunde, Konzentration, bis zu 1 Minute … |
concentration | true/false | Pflicht | Steuert die Konzentrationsverwaltung und die Konzentrationswürfe im Kampf. |
description | Liste von Texten | Pflicht | Ein Eintrag = ein Absatz. Mindestens ein Eintrag. Würfel schreibst du so: 2W6 (Deutsch) bzw. 2d6 (Englisch) – daran erkennt die App Schadens- und Heilwürfel. |
higher_levels | Text oder null | optional | Der Text „Auf höheren Graden“. Ohne Text: null oder weglassen. |
classes | Liste | Pflicht | Klassenschlüssel (deutsch, siehe unten). Nur Zauber mit mindestens einer Klasse sind für Charaktere dieser Klassen auswählbar. Leere Liste = Hinweis „nicht auswählbar“. |
source | Text | Pflicht | Wo der Zauber herkommt (wird im Detail angezeigt). Kann ein beliebiger Text sein. |
id nie doppelt vergeben. • Absätze als Liste. • Klassen und Schulen immer deutsch schreiben, auch wenn die App englisch läuft. • Lieber zu viel components_raw als zu wenig.id, Zauber ohne Namen, level außerhalb 0–9, leere Datei. Hinweise (Import möglich): ohne school, ohne Beschreibung, ohne classes, unbekannte Klassenschlüssel, leere Reichweite/Zeitaufwand/Dauer, fehlende Komponenten.6 · Die Regel-Datei (Klassen)
classes ist die Tabelle der Klasse (Trefferwürfel, was sie kann, was es auf jeder Stufe 1–20 gibt). class_features sind die Texte dazu (Beschreibung der Merkmale, Unterklassen). Beide Teile verwenden denselben Klassenschlüssel, z. B. "Magier".{
"name": "Meine Regeln",
"source": "Eigene Runde", "license": "Eigene Inhalte",
"classes": { "Magier": { … Tabelle … } },
"class_features": { "Magier": { … Texte … } }
}
Teil 1: classes[Schlüssel]
{
"name": "Magier",
"hit_die": 6,
"hp_level_1": "6 + Konstitutionsmodifikator",
"hp_per_level": "1W6 (oder 4) + Konstitutionsmodifikator pro Magierstufe nach der 1. Stufe",
"saving_throws": ["Intelligenz", "Weisheit"],
"skills": { "count": 2, "options": ["Arkane Kunde", "Geschichte", "Heilkunde"] },
"armor": "Keine", "weapons": "Dolche, Kampfstäbe", "tools": "Keine",
"spellcasting": {
"ability": "Intelligenz",
"mode": "zauberbuch",
"prepared": { "ability": "Intelligenz", "plus": "Magier-Stufe", "min": 1 },
"ritual_casting": true,
"focus": "Arkaner Fokus",
"spellbook": { "start": 6, "per_level": 2 }
},
"levels": [
{ "level": 1, "proficiency_bonus": 2, "features": ["Zauberwirken"], "cantrips_known": 3, "spell_slots": { "1": 2 } },
… Stufe 2 bis 20 …
]
}
| Feld | Bedeutung |
|---|---|
name | Anzeigename in deiner Sprache (z. B. „Magier“ oder „Wizard“). |
hit_die | Zahl der Seiten des Trefferwürfels: 6, 8, 10, 12. |
hp_level_1, hp_per_level | Texte für die Regelanzeige. |
saving_throws | Zwei Attribute (deutsche Schlüssel). |
skills | count = wie viele Fertigkeiten gewählt werden, options = Liste erlaubter Fertigkeiten oder der Text "beliebig". |
armor, weapons, tools | Texte (Übungen). |
spellcasting | Nur für Zauberwirker (sonst weglassen oder null). Siehe unten. |
levels | Genau 20 Einträge (Stufe 1–20). Sonst Hinweis „x statt 20 Stufen“. |
Zauberwirken (spellcasting)
| Feld | Wert | Wirkung |
|---|---|---|
ability | Attribut | Zauberattribut → Zauber-SG und Angriffsbonus (8 + Übung + Mod / Übung + Mod). |
mode | "bekannt" | Zauberer, Barde, Hexenmeister …: feste Zahl bekannter Zauber aus spells_known der Stufenzeile. |
"vorbereitet" | Kleriker, Druide, Paladin: Anzahl = Attributsmodifikator + Stufe (mindestens min). Steht bei plus ein Text, der mit "halbe" beginnt, zählt die halbe Stufe (abgerundet). | |
"zauberbuch" | Magier: Zauberbuch (spellbook.start Zauber zu Beginn, per_level pro Stufe) + vorbereitete wie oben. | |
prepared | Objekt | {"ability","plus","min"} – Formel für vorbereitete Zauber. |
ritual_casting | true/false | Kann Rituale ohne Vorbereitung wirken. |
focus | Text | Zauberfokus. |
pact_magic | true | Hexenmeister-Stil: statt spell_slots gibt die Stufenzeile pact_slots an. |
starts_at_level | Zahl | Halbzauberer (Paladin, Waldläufer): Zauberwirken erst ab dieser Stufe (meist 2). |
Eine Stufenzeile (levels[])
| Feld | Bedeutung |
|---|---|
level Pflicht | 1–20. |
proficiency_bonus Pflicht | Übungsbonus der Stufe (2 + (Stufe−1)/4, abgerundet: Stufe 1–4 = 2, 5–8 = 3 …). |
features Pflicht | Liste der Merkmalsnamen dieser Stufe (leer [] erlaubt). Die Namen müssen zu class_features passen, damit der Text verknüpft wird. |
cantrips_known | Zahl der Zaubertricks. |
spells_known | Bekannte Zauber (mode: "bekannt"). |
spell_slots | Zauberplätze je Grad als Objekt mit Grad-Text als Schlüssel: {"1": 4, "2": 3}. Nicht genannte Grade = 0. |
pact_slots | Paktmagie: {"count": 2, "level": 2} = 2 Plätze des 2. Grades. |
invocations_known | Zahl der Anrufungen (Hexenmeister). |
prepared_spells | Nur 2024er Tabellen: vorbereitete Zauber direkt aus der Tabelle (hat Vorrang vor der Formel). |
extras | Eigene Tabellenspalten als Objekt: {"Kampfrausch-Anzahl": 3, "Kampfrausch-Schaden": "+2"}. Werte dürfen Zahl oder Text sein; null = leer. |
Teil 2: class_features[Schlüssel]
{
"equipment": ["(a) ein Kampfstab oder (b) ein Dolch", "ein Zauberbuch"],
"features": [
{
"name": "Arkane Erholung",
"levels": [1],
"text": ["Absatz 1", "Absatz 2"],
"sections": [ { "name": "Unterabschnitt", "text": ["…"] } ],
"options": [ { "name": "Wahl A", "text": ["…"] }, { "name": "Wahl B", "text": ["…"] } ]
}
],
"subclass_intro": { "name": "Arkane Tradition", "text": ["Wähle auf Stufe 2 …"] },
"subclasses": [
{
"name": "Schule der Funkenweber",
"intro": ["Beschreibung der Unterklasse."],
"features": [
{ "name": "Funkenlese", "level_hint": 2, "text": ["…"], "sections": [] }
],
"sections": [],
"spell_list": {
"title": "Domänenzauber",
"rows": [ { "level": 1, "spells": ["Segnen", "Wunden heilen"] } ]
}
}
],
"extra_sections": [ { "name": "Dein Zauberbuch", "text": ["…"] } ]
}
| Feld | Bedeutung |
|---|---|
equipment | Liste von Startausrüstungs-Zeilen. |
features[] | Basismerkmale: name, levels (ab welchen Stufen), text (Absätze), sections (benannte Unterabschnitte, kann leer sein), options (Auswahlmöglichkeiten wie Kampfstile, Anrufungen, Metamagie; optional). |
subclass_intro | Einleitung zur Unterklassenwahl (optional, null erlaubt). |
subclasses[] | Unterklassen mit intro, features (jeweils level_hint = Stufe, auf der du es erhältst), sections und optionaler spell_list (Domänen-/Schwurzauber je Stufe, Zaubernamen müssen im Zauber-Datensatz existieren). |
extra_sections[] | Textkästen der Klasse (z. B. „Dein Zauberbuch“). |
class_featuresequipment, features, subclasses und extra_sections müssen vorhanden sein (leere Listen [] sind in Ordnung). In jedem Merkmal sind name, text und sections Pflicht.7 · Das Quellenbuch
{
"kind": "supplement",
"id": "meine-runde",
"name": "Meine Runde – Hausregeln",
"short": "MR",
"edition": "2014",
"language": "de",
"source": "Eigene Runde",
"license": "Eigene Inhalte",
"spells": [ { … Zauber wie in Abschnitt 5 … } ],
"subclasses": {
"Magier": [ { "name": "Schule der Funkenweber", "intro": ["…"], "features": [ … ], "sections": [] } ]
},
"extra_sections": {
"Barbar": [ { "name": "Optionale Regel: Wilder Sprung", "text": ["…"] } ]
},
"class_features_add": {
"Kämpfer": [ { "name": "Neuer Kampfstil", "levels": [1], "text": ["…"], "sections": [], "options": [ { "name": "Wurfwaffen", "text": ["…"] } ] } ]
},
"spell_class_additions_ids": { "Magieschmied": ["meine-runde-funkenregen"] },
"classes": { "Meine Klasse": { … Tabelle wie in Abschnitt 6 … } },
"class_features": { "Meine Klasse": { … Texte wie in Abschnitt 6 … } }
}
| Feld | Bedeutung | |
|---|---|---|
kind | Pflicht | Immer "supplement". Daran erkennt die App ein Quellenbuch. |
id | Pflicht | Eindeutiges Kürzel der Datei: nur a–z 0–9 -. Importierst du eine zweite Datei mit gleicher id, ersetzt sie das alte Buch. |
name | Pflicht | Name in der Liste der Quellenbücher. |
short | Pflicht | Kürzel für das Kennzeichen an Zaubern und Unterklassen (2–5 Zeichen, z. B. XRA). |
edition | Pflicht | "2014" oder "2024" – die Regelversion, für die das Buch geschrieben ist. Wird als Chip angezeigt (2014), genau wie bei den SRD-Datensätzen. |
language, source, license | optional | Information zur Datei; source/license erscheinen in der Import-Vorschau. |
spells | optional | Zauber (Format wie in Abschnitt 5). Bei gleicher id wie ein Basiszauber ersetzt dein Buchzauber ihn – praktisch, um Fehler zu korrigieren. |
subclasses | optional | Objekt: Klassenschlüssel → Liste neuer Unterklassen (Format wie in class_features.subclasses). |
extra_sections | optional | Klassenschlüssel → Liste von {name, text[]}. Erscheinen im Regelwerk unter „Weitere Abschnitte“ mit Kennzeichen. |
class_features_add | optional | Klassenschlüssel → zusätzliche Klassenmerkmale (z. B. optionale Merkmale, neue Kampfstile). |
spell_class_additions_ids | optional | Klassenschlüssel → Liste von Zauber-IDs. Fügt bestehenden Zaubern die Klasse hinzu (z. B. die Zauberliste einer neuen Klasse). Unbekannte IDs werden ignoriert und in der Vorschau gewarnt. Verschwindet beim Ausschalten wieder. |
classes + class_features | optional | Nur für komplett neue Klassen. Existiert der Klassenschlüssel schon, wird nichts überschrieben. |
class_features_add für optionale Merkmale, spell_class_additions_ids für die Magieschmied-Zauberliste) sind genau so aufgebaut.8 · Schlüsselwörter (immer deutsch schreiben)
Intern speichert die App alle festen Begriffe mit dem deutschen Schlüssel. Die Anzeige wird automatisch in die Sprache der App übersetzt. Schreibe diese Werte deshalb genau so, mit Umlauten und Groß-/Kleinschreibung.
Klassen
| Schlüssel | Englisch |
|---|---|
Barbar | Barbarian |
Barde | Bard |
Druide | Druid |
Hexenmeister | Warlock |
Kämpfer | Fighter |
Kleriker | Cleric |
Magier | Wizard |
Magieschmied | Artificer |
Mönch | Monk |
Paladin | Paladin |
Schurke | Rogue |
Waldläufer | Ranger |
Zauberer | Sorcerer |
Eigene Klassenschlüssel sind möglich. Die Import-Vorschau führt sie als „unbekannte Klassen“ auf (nur ein Hinweis, kein Fehler).
Zauberschulen
| Schlüssel | Englisch |
|---|---|
Bannmagie | Abjuration |
Beschwörung | Conjuration |
Erkenntnismagie | Divination |
Hervorrufung | Evocation |
Illusion | Illusion |
Nekromantie | Necromancy |
Verwandlung | Transmutation |
Verzauberung | Enchantment |
Attribute
| Schlüssel | Kürzel | Englisch |
|---|---|---|
Stärke | STÄ | Strength |
Geschicklichkeit | GES | Dexterity |
Konstitution | KON | Constitution |
Intelligenz | INT | Intelligence |
Weisheit | WEI | Wisdom |
Charisma | CHA | Charisma |
Fertigkeiten
| Attribut | Fertigkeiten (Schlüssel) |
|---|---|
| Stärke | Athletik |
| Geschicklichkeit | Akrobatik, Fingerfertigkeit, Heimlichkeit |
| Intelligenz | Arkane Kunde, Geschichte, Nachforschungen, Naturkunde, Religion |
| Weisheit | Heilkunde, Mit Tieren umgehen, Motiv erkennen, Überlebenskunst, Wahrnehmung |
| Charisma | Auftreten, Einschüchtern, Täuschen, Überzeugen |
Editionen
edition | Bedeutung |
|---|---|
"2014" | Fünfte Edition (SRD 5.1, Spielerhandbuch 2014 und die Erweiterungsbände dazu) |
"2024" | Überarbeitete Regeln (SRD 5.2.1) |
9 · Datei-Prüfer im Browser
Füge den Inhalt deiner Datei ein. Die Prüfung läuft nur in deinem Browser – nichts wird hochgeladen. Sie prüft das, was auch die App beim Import prüft (die App bleibt maßgeblich).
10 · Fehlersuche
| Meldung | Bedeutung / Lösung |
|---|---|
| Keine gültige Zauberliste: Datei beschädigt … | Das JSON ist syntaktisch kaputt (fehlendes Komma, falsches Anführungszeichen, überzähliges Komma). Im Prüfer oder auf jsonlint.com die Zeile finden. |
| Feld „range“ fehlt (spells › Eintrag 3) | Im dritten Zauber fehlt das Pflichtfeld range. „Eintrag 3“ zählt ab 1. |
| Falscher Wert bei … | Ein Feld hat den falschen Typ (z. B. "level": "3" statt 3, oder description als Text statt Liste). |
| Doppelte Zauber-IDs: … | Zwei Zauber haben dieselbe id. Eindeutig machen. |
| Ungültiger Grad bei: … | level muss 0–9 sein. |
| Ohne Klassenzuordnung (nicht auswählbar) | classes ist leer – der Zauber existiert, kann aber keinem Charakter angeboten werden. |
| Unbekannte Klassen: … | Schreibfehler im Klassenschlüssel (Magierin, Wizard). Siehe Schlüsselwörter. |
| x: y statt 20 Stufen in der Tabelle | levels enthält nicht genau 20 Einträge. |
| Zauberwirker, aber ohne Zauberplätze | spellcasting vorhanden, aber nirgends spell_slots/pact_slots. |
| Bitte unter Einstellungen › Quellenbücher importieren | Du hast ein Quellenbuch im falschen Bereich gewählt. |
| Zauber aus Unterklassen-Listen fehlen im aktiven Zauber-Datensatz | In spell_list steht ein Zaubername, den es im aktiven Datensatz nicht gibt (Schreibweise prüfen). |
| Zauber erscheint, aber mit altem Text | Ein anderes Quellenbuch ersetzt ihn mit gleicher id (kleinere Buch-id gewinnt) – Zauber-ID in der Kartenecke vergleichen. |
| „Quellenbuch deaktiviert“ bei einem Charakter | Der Charakter verwendet einen Zauber/eine Unterklasse eines ausgeschalteten Buchs. Schalter wieder anmachen – nichts ist verloren. |
id aus der Kartenecke zeigt dir sofort, in welcher Datei und Zeile ein Fehler steckt.11 · Mit KI-Hilfe erzeugen
Du kannst einen KI-Assistenten (Claude, ChatGPT, …) bitten, JSON für dich zu schreiben. Das klappt gut, wenn du ihm das Format mitgibst. Kopiere diese Vorlage und ergänze am Ende deine Inhalte:
Erzeuge eine gültige JSON-Datei für die App SpellForge (Quellenbuch-Format).
Regeln:
- Ausgabe NUR als JSON in UTF-8, gerade Anführungszeichen, keine Kommentare, keine Kommas nach dem letzten Eintrag.
- Oberste Ebene: {"kind":"supplement","id":"","name":"…","short":"<2-5 Zeichen>","edition":"2014","language":"de","source":"…","license":"Eigene Inhalte","spells":[…]}
- Jeder Zauber hat GENAU diese Felder: id (a-z,0-9,-; eindeutig), name, level (0-9), school (Bannmagie|Beschwörung|Erkenntnismagie|Hervorrufung|Illusion|Nekromantie|Verwandlung|Verzauberung), ritual (true/false), casting_time (z. B. "1 Aktion"), range (z. B. "9 m"), components_raw (z. B. "V, G, M (Fledermausfell)"), components {v,g,m,material|null}, duration, concentration (true/false), description (Liste von Absätzen), higher_levels (Text oder null), classes (Liste aus Barbar, Barde, Druide, Hexenmeister, Kämpfer, Kleriker, Magier, Magieschmied, Mönch, Paladin, Schurke, Waldläufer, Zauberer), source.
- Würfel im Text als "2W6".
Meine Zauber: …
12 · Urheberrecht und Datenschutz
- Mitgeliefert werden nur frei lizenzierte Inhalte: das SRD 5.1 und 5.2.1 (Wizards of the Coast, CC-BY-4.0).
- Eigene Inhalte (Hausregeln, selbst geschriebene Zauber) gehören dir – gib sie weiter, wie du magst.
- Bücher von Verlagen (Spielerhandbuch, Erweiterungsbände) sind urheberrechtlich geschützt. Aus gekauften Büchern erstellte Dateien sind nur für den eigenen Gebrauch gedacht – nicht veröffentlichen, nicht teilen, nicht hochladen.
- Datenschutz: Importierte Dateien bleiben auf deinem Gerät. SpellForge überträgt sie nirgendwohin. Der Prüfer auf dieser Seite arbeitet lokal im Browser.
13 · Fragen und Antworten
Meine Datei hat Umlaute – geht das?
Ja. UTF-8 ist Pflicht; Umlaute und „ß“ schreibst du einfach.
Kann ich mehrere Quellenbücher gleichzeitig nutzen?
Ja, beliebig viele. Bei gleicher Zauber-id gewinnt das Buch mit der alphabetisch kleineren Buch-id.
Was passiert mit meinen Charakteren, wenn ich ein Buch lösche?
Nichts geht verloren. Die Charaktere behalten ihre Einträge und zeigen „Quellenbuch deaktiviert“. Importierst du das Buch erneut (gleiche id), ist alles wieder da.
Kann ich die id eines Zaubers später ändern?
Besser nicht – Charaktere speichern Zauber über die id. Lege den Zauber stattdessen neu an.
Wie bringe ich Ordnung in große Dateien?
Teile Inhalte in mehrere Quellenbücher auf (z. B. eins pro Buch/Kampagne). So kannst du sie einzeln schalten.
Funktioniert das auch auf dem Handy?
Die App ist für Tablets gebaut; Import und Quellenbuch-Schalter funktionieren überall dort, wo die App läuft.
Ich komme nicht weiter.
Nutze in der App „Wünsche & Feedback“ (Einstellungen) und füge die Meldung aus der Import-Vorschau ein.