Creator-Handbuch

Überblick

Dice & Screen nutzt ein Namespace- & Content-Pack-System für alle spielbaren Inhalte. Jede Content-Datei gehört zu einem Creator (z. B. diceandscreen) und einem Pack (z. B. baseset). Das ermöglicht:

• Modding: Eigene Inhalte ohne Kollision mit Core-Content
• Pack-Verwaltung: Ganze Content-Gruppen an-/ausschalten
• Klare Trennung: Core vs. Erweiterung vs. Homebrew

1. Das Namespace-Schema

Jede Content-Datei hat drei Pflichtfelder, aus denen die ID automatisch gebildet wird:

{
  "creator": "diceandscreen",
  "pack": "baseset",
  "itemname": "longsword_common",
  "name": { "de": "Langschwert", "en": "Longsword" }
}

Die eindeutige ID wird zusammengesetzt: creator:pack:itemname

diceandscreen:baseset:longsword_common

Bezeichner-Regeln

• creator: Name des Erstellers (z. B. diceandscreen, myhomebrew)
• pack: Name des Packs (z. B. baseset, expansion1)
• itemname: Eindeutiger Name innerhalb des Packs, lowercase (z. B. longsword_common)

2. Dateinamen-Konvention

Da der Doppelpunkt (:) auf Windows ungültig ist, wird der Dateiname mit Unterstrich gebildet:

ID:       diceandscreen:baseset:longsword_common
Dateiname: diceandscreen_baseset_longsword_common.json

Die JSON-Felder creator, pack, itemname bleiben als separate Werte erhalten.

3. Content-Domänen

Folgende Content-Typen unterstützen das Namespace-System:

Domäne	Ordner	Beschreibung
Items	data/items/	Waffen, Rüstungen, Tränke, Schmuck, Misc
Abilities	data/abilities/	Fähigkeiten, Zauber, Reaktionen
Forms	data/forms/	Verwandlungs-Formen (Wild Shape etc.)
Summons	data/summons/	Beschwörungs-Templates
Enemies	data/enemies/	Gegner-Definitionen
Feats	data/feats/	Feat-Definitionen

4. Eigenes Content-Pack erstellen

Schritt 1: Creator- & Pack-Namen wählen

Wähle einen eindeutigen Creator-Namen (z. B. myhomebrew) und einen Pack-Namen (z. B. mymodules).

Schritt 2: JSON-Datei erstellen

Lege eine Datei im entsprechenden Ordner an, z. B. data/items/myhomebrew_mymodules_flaming_sword.json:

{
  "creator": "myhomebrew",
  "pack": "mymodules",
  "itemname": "flaming_sword",
  "name": { "de": "Flammenschwert", "en": "Flaming Sword" },
  "type": "WEAPON",
  "rarity": "RARE",
  "damage": "1d8",
  "damageType": "FIRE",
  "weight": 3.0,
  "value": 500
}

Schritt 3: Im Pack-Manager aktivieren

Öffne den Pack-Manager im Startscreen. Dein Pack myhomebrew:mymodules erscheint automatisch in der Liste. Aktiviere es mit dem Toggle-Schalter.

5. Pack-Manager-UI

Der Pack-Manager ist über einen Button im Startscreen erreichbar (vor Session-Start). Er zeigt alle entdeckten Packs mit Toggle-Schaltern:

• Core-Pack (diceandscreen:baseset): Immer aktiv, nicht deaktivierbar (ausgegraut)
• Eigene Packs: Können an-/ausgeschaltet werden
• Mod-Packs: Werden automatisch beim Start entdeckt

Packs sind fix pro Session — sie können nur vor Session-Start geändert werden, nicht in einer laufenden Session.

6. Verhalten bei deaktivierten / fehlenden Packs

Wenn ein Charakter Content referenziert, der nicht geladen ist — egal ob wegen deaktiviertem Pack, fehlender Mod-Datei oder Mod-Update — greift die Phantom-Logik:

• Der Content wird ausgeblendet (Platzhalter: Name = ID, keine Stats, keine Mechanik)
• Der Charakter bleibt spielbar mit Lücken
• Die Referenz-Daten bleiben in der Save-Datei erhalten
• Bei Reaktivierung des Packs wird der Content wieder angezeigt

7. Save-Format

Charaktere speichern Namespace-IDs (diceandscreen:baseset:longsword_common). Bei Save-Format-Brüchen (z. B. Wechsel von flachen IDs auf Namespace-IDs) ist keine Backward-Kompatibilität gewährleistet — alte Saves mit flachen IDs laden nicht mehr. Dies wird im Changelog dokumentiert.