rpg-westreiche/tools/add_guild_notes.py

402 lines
14 KiB
Python
Raw Normal View History

#!/usr/bin/env python3
"""Ergänzt in den arkanen Zauberdateien einen Abschnitt „Gilde".
Zuordnung folgt der Ausrichtung der Gilden (siehe
`RPG/5-Regeln/Hausregeln/Gildenzauber.md`):
KOL Königliches Magie-Kollegium – staatliche Lizenz, Kampf und Schutz
AKA Arkane Akademie – Erkenntnis, Divination, Illusion, Verwandlung
BRU Bruderschaft des Wortes – Schrift, Sprachen, Siegel, Wände, Information
ZFM Zentrum für Monsterüberwachung– Monsterkunde, Erkennung, Eindämmung, Feldmagie
KON Das arkane Konvent – Geist, Verwandlung, verbotene Grenzbereiche
ZIR Zirkel der Magier – Meta-Magie, seltene Varianten (kein Lehrbetrieb)
ELD Meister Eldoras' Akademie – Forschung, alte Siegel (keine offene Lehre)
Grad 1–2 sind Allgemeingut und werden überall gelehrt; dort wird nur ein
Schwerpunkt vermerkt. Ab Grad 3 gilt der Gildenlehrplan.
Aufruf: python3 tools/add_guild_notes.py [--check]
"""
from __future__ import annotations
import re
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
SPELLS = ROOT / "RPG" / "5-Regeln" / "Zauber" / "Arkan"
GUILD_NAME = {
"KOL": "Königliches Magie-Kollegium",
"AKA": "Arkane Akademie",
"BRU": "Bruderschaft des Wortes",
"ZFM": "Zentrum für Monsterüberwachung",
"KON": "Das arkane Konvent",
"ZIR": "Zirkel der Magier",
"ELD": "Meister Eldoras' Akademie in Kandelstein",
}
GUILD_FOCUS = {
"KOL": "staatliche Lizenzlehre, Kampf- und Schutzzauber",
"AKA": "Erkenntnis, Divination, Illusion und Verwandlung",
"BRU": "Schrift, Sprachen, Siegel und Wände",
"ZFM": "Monsterkunde, Erkennung und Eindämmung",
"KON": "Geist, Verwandlung und verbotene Grenzbereiche",
"ZIR": "Meta-Magie und seltene Varianten, kein regulärer Lehrbetrieb",
"ELD": "Forschung und alte Siegel, keine offene Lehre",
}
# Zauber ab Grad 3: welche Gilden lehren sie?
MAPPING: dict[str, list[str]] = {
# ---- Grad 3 -----------------------------------------------------------
"blitzschlag": ["KOL"],
"feuerball": ["KOL"],
"fliegen": ["AKA", "KOL"],
"furcht": ["KON"],
"geisterform": ["KON"],
"hast": ["AKA", "KOL"],
"hellsehen": ["AKA"],
"illusion bannen": ["AKA"],
"infravision": ["AKA", "ZFM"],
"lähmung": ["KON", "KOL"],
"magie bannen": ["KOL"],
"nichtentdeckung": ["BRU", "AKA"],
"person festhalten": ["KOL", "ZFM"],
"phantomross": ["KON", "AKA"],
"schutz vor bösem": ["KOL"],
"schutz vor bösem, 3m radius": ["KOL"],
"schutz vor normalen geschossen": ["KOL"],
"schwarzes licht": ["KON"],
"seiltrick": ["AKA"],
"spektrale kraft": ["KON"],
"suggestion": ["KON"],
"trugbild": ["AKA"],
"unsichtbarkeit": ["AKA"],
"unsichtbarkeit – 3 m radius": ["AKA"],
"unsichtbarkeit – 3 m radius, illusionist": ["AKA"],
"wasser atmen": ["AKA"],
# ---- Grad 4 -----------------------------------------------------------
"andere verwandeln": ["AKA"],
"dimensionstür": ["AKA"],
"eiswand": ["KOL"],
"emotion": ["KON"],
"fester nebel": ["KOL"],
"feuerwand": ["KOL"],
"fluch bannen": ["KOL"],
"geringe erschaffung": ["AKA"],
"illusorische ausdauer": ["AKA"],
"massenverwandlung": ["AKA"],
"monster bezaubern": ["ZFM"],
"pflanzenwachstum": ["AKA"],
"phantastischer killer": ["AKA"],
"regenbogenmuster": ["AKA"],
"schattenmonster": ["KON"],
"schleier der verlassenheit": ["KON"],
"selbst verwandeln": ["AKA"],
"verbesserte unsichtbarkeit": ["AKA"],
"verwirrung": ["AKA"],
"zauberauge": ["BRU", "ZFM"],
# ---- Grad 5 -----------------------------------------------------------
"chaos": ["KON"],
"elementar beschwören": ["KOL", "AKA"],
"fels zu schlamm verwandeln": ["AKA"],
"große erschaffung": ["AKA"],
"halbschattenmonster": ["KON"],
"heimsuchung": ["KON"],
"höhere ebene kontaktieren": ["AKA", "KON"],
"illusion": ["AKA"],
"magisches gefäß": ["KON"],
"monster festhalten": ["ZFM"],
"projiziertes abbild": ["AKA"],
"schattenhafte verwandlung": ["KON"],
"schattenwurf": ["KON"],
"schein": ["AKA"],
"spiegellabyrinth": ["AKA"],
"spiegelwelt": ["AKA"],
"steinwand": ["BRU", "KOL"],
"telekinese": ["AKA"],
"teleportation": ["AKA"],
"todeswolke": ["KOL"],
"untote beleben": ["KON"],
"verstand schwächen": ["KON"],
"wand durchqueren": ["AKA"],
"zeitfluss": ["ZIR", "AKA"],
# ---- Grad 6 -----------------------------------------------------------
"antimagische hülle": ["KOL"],
"ausgelöste illusion": ["AKA"],
"desintegration": ["KOL"],
"durch den spiegel": ["AKA"],
"erde bewegen": ["AKA", "KOL"],
"geas": ["KON"],
"irreführung": ["AKA"],
"massensuggestion": ["KON"],
"permanente illusion": ["AKA", "ZIR"],
"reinkarnation": ["AKA", "KON"],
"säurenebel": ["KOL"],
"schatten": ["KON"],
"stein zu fleisch": ["AKA"],
"todeszauber": ["KOL", "KON"],
"traum manifestieren": ["KON"],
"traumqueste": ["KON"],
"unsichtbarer verfolger": ["ZFM", "AKA"],
"verkörperung": ["KON"],
"vision": ["AKA", "BRU"],
"wahrer blick": ["AKA", "BRU"],
"wasser senken": ["AKA"],
"wasser teilen": ["AKA"],
"schrift binden": ["BRU"],
"zunge lösen": ["BRU"],
"siegel siegeln": ["BRU"],
"alte zunge": ["ELD"],
"siegel erneuern": ["ELD"],
"formel lesen": ["ZIR"],
"verzögerter spruch": ["ZIR"],
"spruchdoppelung": ["ZIR"],
"wetterkontrolle": ["AKA"],
}
# Schwerpunkte für Allgemeingut-Zauber (Grad 1–2)
FOCUS: dict[str, list[str]] = {
"akustische illusion": ["AKA"],
"arkanes lesen": ["AKA", "BRU"],
"arkanes lesen (illusionist)": ["AKA"],
"bauchreden": ["KON"],
"chromatische kugel": ["AKA"],
"farbstrahl": ["AKA"],
"glamour": ["AKA"],
"hypnotismus": ["KON", "AKA"],
"illusion entdecken": ["AKA"],
"licht": ["AKA"],
"licht (illusionist)": ["AKA"],
"magie entdecken": ["AKA", "ZFM"],
"magischer riegel": ["BRU"],
"magisches geschoss": ["KOL"],
"nebelwand": ["AKA"],
"person bezaubern": ["KON"],
"phantastische kraft": ["AKA"],
"phantastische kraft (illusionist)": ["AKA"],
"schild": ["KOL"],
"schlaf": ["KON"],
"schrecken": ["KON"],
"schutz vor bösem": ["KOL"],
"schwebende scheibe": ["AKA"],
"sprachen lesen": ["BRU"],
"tanzende lichter": ["AKA"],
"blitz - taubheit": ["KON"],
"blindheit - taubheit": ["KON"],
"böses entdecken (magier)": ["KOL"],
"dauerhaftes licht (magier)": ["AKA"],
"esp (gedanken lesen)": ["AKA"],
"falsche aura": ["KON", "BRU"],
"faszinieren": ["KON", "AKA"],
"flammenpfeil": ["KOL"],
"flüsternder wind": ["AKA"],
"gegenstand lokalisieren (magier)": ["BRU", "ZFM"],
"hypnotisches muster": ["AKA"],
"klopfen": ["AKA", "BRU"],
"levitation": ["AKA"],
"magie entdecken (illusionist)": ["AKA"],
"magischer mund": ["BRU"],
"magischer verschluss": ["BRU"],
"netz": ["ZFM", "KOL"],
"phantastische kraft (magier)": ["AKA"],
"quasimorph": ["KON"],
"spiegelbilder": ["AKA"],
"spiegelbilder (illusionist)": ["AKA"],
"unsichtbares entdecken": ["ZFM", "AKA"],
"unsichtbarkeit (illusionist)": ["AKA"],
"dunkelheit": ["KON"],
"unsichtbarkeit": ["AKA"],
"verbesserte phantastische kraft": ["AKA"],
"verschwimmen": ["AKA"],
}
EXCLUSIVE_HINT = {
"ZFM": "Monsterbezug ist Alleinstellungsmerkmal des Zentrums – keine andere Gilde lehrt diesen Zauber.",
"KON": "Verbotene Grenzlehre: nur das Konvent lehrt diesen Zauber, andere Gilden verweigern ihn.",
"ZIR": "Meta-Magie: Der Zirkel lehrt nicht für Fremde – Aufnahme nur über Meisterprüfung und ein Dienstversprechen.",
}
# Exklusive Signaturfassungen: Die Standardversion lehrt jede Gilde, aber nur die
# genannte Gilde lehrt ihre eigene Fassung (siehe Gildenzauber §5).
# key -> [(code, Name der Fassung, "Vorteil; Nachteil")]
SIGNATUREN: dict[str, list[tuple[str, str, str]]] = {
"feuerball": [
("KOL", "Kollegiums-Feuerball", "Radius 4,5 m statt 6 m, dafür +1 auf den Spruchcheck; "
"kleinerer Wirkungsbereich"),
("AKA", "Akademie-Feuerball", "kann einen Verbündeten im Wirkungsbereich ausnehmen; "
"−1 auf den Spruchcheck"),
],
"magisches geschoss": [
("KOL", "Kollegiums-Geschoss", "+1 auf den Spruchcheck; kein zusätzlicher Schaden, "
"streng lizenzierte Komponente"),
],
"schild": [
("KOL", "Kollegiums-Schild", "RK 3 gegen alle Angriffe; Dauer nur 1 Phase"),
],
"licht": [
("AKA", "Akademie-Licht", "Dauer 12 Phasen; Radius nur 3 m"),
],
"unsichtbarkeit": [
("AKA", "Akademie-Unsichtbarkeit", "doppelte Dauer; endet, wenn das Ziel spricht"),
],
"schlaf": [
("KON", "Konvents-Schlaf", "2W8 TW + 1W4 TW betroffen; Ziele erhalten +2 auf den Rettungswurf"),
],
"magischer riegel": [
("BRU", "Bruderschafts-Riegel", "Dauer 4W6 Phasen; das Öffnen ist laut und alarmiert die "
"Umgebung"),
],
"magischer mund": [
("BRU", "Bruderschafts-Mund", "bis zu 50 Wörter; nur eine Auslösung, danach endet der Zauber"),
],
"monster festhalten": [
("ZFM", "Monsterfessel", "+1 auf den Spruchcheck gegen natürliche Monster; wirkt nur gegen "
"Tiere, Riesentiere und magische Bestien, nicht gegen Humanoide, "
"Untote oder intelligente Monster"),
],
"zauberauge": [
("ZFM", "Jägerauge", "sieht auch unsichtbare Kreaturen und Wärmespuren; das Auge ist für "
"magische Detektion sichtbar, kürzere Dauer"),
],
"zeitfluss": [
("ZIR", "Zirkel-Zeitfluss", "wirkt auch auf einen Verbündeten in Reichweite; der Anwender "
"altert um 1W4 Jahre"),
],
"permanente illusion": [
("ZIR", "Zirkel-Permanenz", "hält bis zur nächsten Sonnenwende, ohne Bindung an einen Ort; "
"nur einmal pro Monat wirkbar"),
],
"klopfen": [
("ELD", "Eldoras-Schlüssel", "öffnet auch magisch versiegelte Türen und Truhen; die Öffnung "
"ist laut und hinterlässt eine sichtbare Spur"),
],
"steinwand": [
("ELD", "Eldoras-Wand", "hält doppelt so lange und ist gegen Bannen resistent; wirkt nur in "
"altem Mauerwerk, Fels oder Fundament"),
],
}
def signatur_lines(stem: str) -> list[str]:
key = base_name(stem)
return [f"- **Signatur (nur hier) – {name}** ({GUILD_NAME[code]}): {text}."
for code, name, text in SIGNATUREN.get(key, [])]
EXCLUDE_REASON = {
"KOL": "kein Kampf- oder Schutzzauber, damit nicht Teil der Lizenzlehre",
"AKA": "kein Forschungsfeld der Akademie",
"BRU": "kein Bezug zu Schrift, Sprachen, Siegeln oder Wänden",
"ZFM": "kein Monster- oder Feldbezug",
"KON": "liegt außerhalb der verbotenen Grenzbereiche",
"ZIR": "kein Standardlehrbetrieb, nur Varianten und Meta-Magie",
"ELD": "reine Forschung, keine Lehre für Fremde",
}
def base_name(stem: str) -> str:
return re.sub(r"\s*\([^)]*\)", "", stem).strip().lower()
def guild_section(kind: str, grade: int, stem: str) -> str:
key = stem.lower()
base = base_name(stem)
if grade <= 2:
gilden = FOCUS.get(key) or FOCUS.get(base)
lines = [
"## Gilde",
"",
"> **Zugang:** Allgemeingut (Grad 1–2) – alle Gilden lehren die "
"Standardversion, unabhängig von ihrer Ausrichtung "
"(siehe [[Gildenzauber]]).",
]
if gilden:
namen = ", ".join(
f"**{GUILD_NAME[g]}** ({GUILD_FOCUS[g]})" for g in gilden
)
lines.append("")
lines.append(f"- **Schwerpunkt bei:** {namen}.")
lines.append(
"- Andere Gilden lehren den Zauber ebenfalls, aber ohne "
"eigene Variante oder Zusatzausbildung."
)
lines += signatur_lines(stem)
return "\n".join(lines) + "\n"
gilden = MAPPING.get(base) or MAPPING.get(key)
if not gilden:
return "" # unbekannt -> im Check melden
namen = "; ".join(f"**{GUILD_NAME[g]}** ({GUILD_FOCUS[g]})" for g in gilden)
lines = [
"## Gilde",
"",
"> **Zugang:** Gildenlehrplan ab Grad 3 – nicht Allgemeingut "
"(siehe [[Gildenzauber]]).",
"",
f"- **Gelehrt von:** {namen}.",
]
taught = set(gilden)
missing = [g for g in GUILD_NAME if g not in taught]
if missing:
lines.append(
"- **Nicht im Angebot:** "
+ "; ".join(f"{GUILD_NAME[g]} ({EXCLUDE_REASON[g]})" for g in missing)
+ "."
)
if len(gilden) == 1 and gilden[0] in EXCLUSIVE_HINT:
lines.append(f"- **Hinweis:** {EXCLUSIVE_HINT[gilden[0]]}")
lines += signatur_lines(stem)
return "\n".join(lines) + "\n"
def insert_section(text: str, section: str) -> str:
marker = "\n## Wirkung"
if marker not in text:
return text
head, rest = text.split(marker, 1)
return f"{head}\n\n{section}{marker}{rest}"
def main() -> None:
check = "--check" in sys.argv
force = "--force" in sys.argv
changed = 0
unknown: list[str] = []
already = 0
for path in sorted(SPELLS.rglob("*.md")):
grade = int(re.search(r"Grad (\d)", path.parent.name).group(1))
text = path.read_text(encoding="utf-8")
section = guild_section("", grade, path.stem)
if not section:
unknown.append(f"Grad {grade}/{path.stem}")
continue
if "## Gilde" in text:
if not force:
already += 1
continue
text = re.sub(r"\n## Gilde\n.*?(?=\n## )", "\n", text, flags=re.S)
if check:
print(f"[check] {path.relative_to(ROOT)}")
continue
path.write_text(insert_section(text, section), encoding="utf-8")
changed += 1
print(f"ergänzt: {changed}, bereits vorhanden: {already}, unbekannt: {len(unknown)}")
for u in unknown:
print(" ??", u)
if __name__ == "__main__":
main()