rpg-westreiche/tools/add_guild_notes.py
torsten ae1ffb5016 Hausregel: Ruestungsklasse aufsteigend (RK = Zielwert, GAB = 19 - THAC0)
- neue Hausregel-Datei + Changelog-Eintrag 20.11.2026
- alle Zauber- und Monstereintraege umgestellt (RK 5 [14] -> RK 14, Kollegiums-Schild 16)
- Dornenwand: Schadensformel invertiert (1W8 + (19 - RK))
- Summarien (A5 + A4) und Website neu gebaut
2026-11-20 17:47:36 +01:00

401 lines
14 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/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 16 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()