Changelog — HtbaH-Modul + UX-Updates

Dieser Lauf hat das HtbaH-Regelwerk im Charakterbogen + Battle-Map weitgehend abgebildet. Stand: 2026-05-24.

Quelle der Regeln: docs/research/HTBaH_Regelreferenz.md (offizielles HtbaH-Wiki, Mai 2026).

Übersicht der Commits (Reihenfolge: ältester → neuester)

1. Kampfbogen (Rüstung + Waffen)

1.1 Rüstung — Slot-basierte Verwaltung

Datenmodell (shared/engines/htbah.ts):

HtbahArmorPiece = {
  id, name,
  value: number,        // RW-Wert in HP-Punkten
  slot?: HtbahArmorSlot, // head/torso/shoulders/shield/hands/legs/feet/other
  tag?: HtbahArmorTag,   // leicht/mittel/schwer (Material-Klassifizierung)
  note?: string
}

Berechnung:

Gesamt-RW = Σ aller value-Felder (>= 0 geclampt)
htbahTotalArmor(data) = clamp(0, Σ piece.value)

Im Bogen: kompakter Slot+Tag-Dropdown pro Teil, Gesamt-Σ-RW-Badge oben.

1.2 Rüstungs-Nebenwirkungen (§6.2.3 erweitertes Modul)

htbahInitiativeBonus(data) = htbahTalentValue(data, 'handeln') - round(RW/10)
htbahArmorParadeBonus(data) = RW
htbahArmorAthleticsPenalty(data) = -floor(RW/2)

Beispiel RW 34: Parade +34, Init −3, Athletik −17.

Im Bogen erscheint ein Info-Block "🛡 Rüstungs-Effekte" sobald RW > 0.

1.3 Waffen — Kategorien & Sonderregeln

Datenmodell:

HtbahWeaponEntry = {
  id, name,
  damageFormula: string,        // NdM±X
  category?: HtbahWeaponCategory, // stumpf/hieb/stich/fernkampf/wurf/sonstige
  properties?: {
    schlagwaffe?: boolean,
    armorBreak?: number,
    aufspiessen?: boolean,
    huntingThreshold?: number,
    flink?: number, grob?: number,    // Trefferwurf Nahkampf
    genau?: number, schwer?: number,  // Trefferwurf Fernkampf
    schwert?: boolean,                // +5 Paradewurf
    stangenwaffe?: boolean,           // +10 Initiative
  },
  attackSkillId?: string,       // welcher Skill für den Trefferwurf?
  note?: string
}

Wirkungen der Sonderregeln:

Kombinierte Trefferwurf-Formel (htbahSkill mit selektierter Waffe):

Trefferwurf-Mod = (Spieler-Mod)
                + (Flink + Genau − Grob − Schwer)
                + (Self-Conditions-Mod, z.B. Blind −40, Frightened −40)
                + (Target-Conditions-Mod, z.B. Prone +20)
                + (Jagdwaffen-Bonus +15 falls Ziel-RW ≤ huntingThreshold)
                + (Wunden-Malus aus Schadensstufe, server-seitig)

2. Schadens- und Wurf-Mechanik

2.1 Kritischer Treffer × 2 (§2.5/§10)

// rollFree() in server/utils/dice.ts
if (input.critical) total = (sum + modifier) * 2

Workflow:

1. Spieler würfelt htbahSkill (Trefferprobe), Server liefert critical: true im Payload zurück.
2. MiniCharSheet trackt das in probeResultLast.
3. Nächster Schadenswurf passt critical: true mit, wenn Modus = damage und nicht Heilung.
4. Server verdoppelt die Endsumme, Payload bekommt damageCrit: true.
5. RollCard zeigt "✨ Krit. Treffer — Schaden ×2".
6. Krit-Flag wird nach dem Schadenswurf zurückgesetzt (Krit gilt nur für EINEN Treffer).

2.2 Krit-Schwellen

htbahCritThreshold(skillValue)            = max(1, floor(skillValue / 10))  // 10 %
htbahCritThresholdAufspiessen(skillValue) = max(1, floor(skillValue / 5))   // 20 %
htbahFumbleThreshold(skillValue)          = ceil(skillValue / 10) + 90      // obere 10 %

Krit nur bei Skill-Proben (nicht bei reinen Begabungsproben).

2.3 Schlagwaffen-Reroll

// pro Würfel des Schadenswurfs: ist es eine 1? → einmal neu würfeln
// Reroll-Liste wird transparent im Chat-Payload mitgesendet (schlagwaffeRerolls[])

2.4 DC-Schwierigkeits-Presets (§3.6)

Quick-Buttons im Probenwurf:

3. Zustände als Auto-Modifikatoren (§4.2)

Beim Probenwurf werden Conditions aus Token.statusText (CSV) automatisch eingerechnet:

Implementation:

htbahConditionMods(conditionIds: string[]): {
  selfAttack: number,        // wirkt nur bei Trefferwurf (Waffe gewählt)
  selfMod: number,           // wirkt auf JEDE Skill/Talent-Probe
  targetVsAttack: number,    // Bonus für Angreifer gegen dieses Ziel
  damageReduction: number,   // wird vom eigenen Schadenswurf abgezogen
  notes: string[],
}

MiniCharSheet liest activeToken.statusText (Self) und ggf. damageTarget.statusText (Target), addiert die Modifikatoren zum Wurf und schreibt die Effekte transparent ins Note-Feld (z.B. "Liegend (+20 vs.)", "Verängstigt (−40 Angr., −5 Schaden)").

4. Kampfmanöver (§4.1)

Neuer Button "Manöver" im MiniCharSheet öffnet Popup mit 6 vordefinierten Manövern. Auswahl setzt rollMod + rollNote vor, der Spieler klickt danach nur noch normal "Würfeln".

5. Initiative-Workflow

5.1 Datenmodell

InitiativeState = {
  active: boolean,
  round, currentIndex,
  entries: InitiativeEntry[],
  awaitingFromCharacters?: number[],  // characterIds, von denen noch Würfe ausstehen
}

5.2 SL-Workflow

1. SL klickt im Initiative-Tracker auf "Anfrage an Spieler".
2. Server schreibt alle Spieler-Charakter-IDs (nicht-DM-Token mit characterId) in awaitingFromCharacters und pushed via Pusher.
3. Bei jedem Spieler erscheint im MiniCharSheet ein roter Button "Initiative würfeln!".

5.3 Spieler-Wurf

POST /api/groups/:id/initiative/roll:

1W10 + htbahInitiativeBonus(data) + (stangenwaffeBonus ? 10 : 0)
       └─ = htbahTalentValue('handeln') − round(RW/10)

• Würfelt server-seitig.
• Schreibt Eintrag in entries (oder ersetzt existierenden des Chars).
• Entfernt characterId aus awaitingFromCharacters.
• Postet Roll-Message im Chat.

5.4 Parade/Ausweichen (§2.4)

Quick-Action-Button öffnet Popup mit:

• Handeln-Begabung (Default).
• Alle Skills, deren Name /pari|ausweich|block|parade/i matcht.

Klick → würfelt direkt mit modifier = Rüstungs-Parade-Bonus + (Schwert ? +5 : 0), Note "Parade/Ausweichen · Rüstung +X · Schwert +5".

Hinweis: Krit-Treffer und Schusswaffen sind nicht parierbar (im Popup angezeigt).

6. Magie-Modul "Zauberei" (§8)

Optionales Subsystem — magicState.active muss vom Spieler im Bogen aktiviert werden.

6.1 Datenmodell

HtbahMagicState = {
  active: boolean,
  mana: number,
  arkanum: number,                  // 0–5, Anzahl bekannter Zauber
  lehren: HtbahSpellLehreId[],      // max 3
}

6.2 Berechnungen

manaMax = arkanum × 2                            // §8.3
manaRegen = +1 pro Stunde Rast                   // §8.4

Komplexitätswurf = 3W10 + arkanum
Erfolg:           3W10 + arkanum >= Schwelle
Krit. Erfolg:     2+ Zehner im Wurf → KEIN Mana verbraucht
Krit. Misserfolg: 2+ Einser im Wurf → Mana verbraucht, KEIN Effekt

Schwellen pro Stufe (§8.2):

6.3 Die 12 Lehren

HTBAH_SPELL_LEHREN enthält alle: Schutz · Genesung · Segen · Tiergestalt · Erdmagie · Trugbild · Verfall · Böser Blick · Fluch · Beherrschung · Sturm · Beschwörung.

Max 3 Lehren pro Charakter (im Bogen via Toggle-Buttons enforced).

6.4 Quick-Cast im MiniCharSheet

Neuer "Zaubern"-Button (nur bei aktivem Magie-Modul) öffnet Popup:

• Spruchname-Input
• Stufe-Select (zeigt Schwelle + Mana-Kosten)
• Optional: Lehre-Tag

Klick → POST /api/groups/:id/magic/cast:

• Validiert: Eigentum + Modul aktiv + Mana >= Kosten.
• Server würfelt 3W10, addiert Arkanum, wertet aus.
• Mana-Update direkt in character.data.magicState.mana geschrieben.
• Chat-Message wird gepostet (mit Krit/Erfolg/Misserfolg + Würfeln + neuer Mana).
• Popup zeigt das Ergebnis sofort.

7. UX: Mobile / App-Modus / 2-Fenster

7.1 App-Modus (Vollbild-Karte)

Toggle-Button im Karten-Header. Aktiviert eine globale CSS-Klasse app-mode-active auf <html>, die:

• Layout-Header + Footer komplett ausblendet.
• Audio-Panel, Chat, Help-Text, inline MiniCharSheet, Resize-Handle hidden via app-mode-hide-Class.
• Karte nimmt volle Viewport-Höhe.
• Floating Action Button "Mein Sheet" unten rechts.
• Bottom-Sheet (Slide-up Drawer mit Backdrop + Drag-Handle) öffnet vollständiges MiniCharSheet (alle Quick-Actions, Würfler, Mana, Inventar).

Wird beim Verlassen der Seite automatisch aufgeräumt.

7.2 Zweites Fenster — /groups/:id/play/:mapId

Neue Route zeigt nur das MiniCharSheet im Vollbild. Synct via:

• Pusher Map-Channel (HP-Änderungen, Token-Updates)
• Pusher Group-Channel (Initiative-Freigabe)
• 8-Sekunden-Polling als Fallback

Im Battle-Map-Header öffnet der Button "Sheet-Fenster" diese Route per window.open(url, 'paperheros-sheet-{mapId}', 'width=420,height=900') — Smartphone-Hochformat-Aspect, ideal als Begleiter auf einem zweiten Display oder Smartphone.

7.3 Mobile-CSS-Polish

@media (max-width: 640px):

• min-height: 32px auf Buttons (Touch-Komfort).
• min-height: 48px auf .roll-cta-Hauptwürfeln-Buttons.
• min-height: 36px auf Inputs/Selects.
• font-size: 16px in Inputs → verhindert iOS-Auto-Zoom beim Focus.
• Größere border-radius + padding auf .parchment-card.

Bottom-Sheet nutzt 100dvh (dynamic viewport units), damit die iOS-Safari- Bottom-Bar nichts abschneidet.

8. Chat-Anzeige (RollCard)

Die RollCard zeigt für HtbaH-Würfe jetzt automatisch zusätzliche Felder, sofern gesetzt:

9. Server-Endpoints (neu)

11. Spell-Katalog (§8.12) — alle 60 Sprüche als One-Click-Lern-Liste

shared/engines/htbah-spell-catalog.ts enthält den kompletten Katalog — 12 Lehren × 5 Stufen = 60 Sprüche mit Name, Reichweite, Mana-Kosten, Effekt-Beschreibung und Aufladbar-Flag.

Datenmodell-Erweiterung:

HtbahMagicState.knownSpellKeys?: string[]   // <lehre>:<stufe>:<slug>

Im Charakterbogen (Magie-Sektion → Sprüche aus Katalog):

• Pro aktivierter Lehre erscheinen alle 5 Stufen als Toggle-Buttons.
• Klick = lernen / verlernen. Max 5 gelernte Sprüche (= Arkanum).
• Arkanum wird automatisch auf knownSpellKeys.length gesetzt.
• Mana max = Arkanum × 2 wird neu berechnet, Mana current entsprechend geclampt.
• Gelernte Sprüche werden visuell mit Akzent-Farbe hervorgehoben.

Im Mini-CharSheet Quick-Cast:

• Wenn der Spieler Sprüche gelernt hat, erscheint ein zusätzliches Dropdown „Gelernter Spruch" vor dem freien Spruchnamen-Feld.
• Auswahl pre-füllt automatisch Spruchname + Stufe + Lehre.
• Sentinel __free__ lässt freie Eingabe zu.

12. Magie bannen (§8.7) + Magie erkennen (§8.8)

Magie erkennen (POST /api/groups/:id/magic/detect):

1W10 + Arkanum >= 7  →  Magie erkannt (kein Mana-Verbrauch)

• Eigener Button im Magie-Quick-Cast-Popup unten.
• Kostet kein Mana (anders als reguläre Sprüche).
• Postet Roll-Message im Chat.

Magie bannen (POST /api/groups/:id/magic/dispel):

Wirker: 1W10 + Arkanum (kostet 1 Mana)
Ziel:   1W10 + Arkanum (kostet 1 Mana, wenn Ziel-Charakter mit aktivem Magie-Modul)
Wirker >= Ziel  →  Magie gebannt

• Eigener Button im Magie-Quick-Cast-Popup.
• Wirker zahlt immer 1 Mana, unabhängig vom Ergebnis (Regelwerk).
• Bei aktivem Ziel-Charakter: Ziel zahlt ebenfalls 1 Mana (Server zieht das automatisch ab).
• Ties gehen an den Wirker (pragmatische Auslegung).

13. Auto-Blutung-Tick (§4.2)

Vor dem Übergang in eine neue Initiative-Runde ruft der SL-Tracker automatisch POST /api/groups/:id/maps/:mapId/tick-bleed auf:

1. Server sucht alle Token auf der Karte mit bleeding-Condition im statusText.
2. Liest pro Token den Counter bleed:N aus den Custom-Labels des statusText (Default 1, wenn nicht vorhanden).
3. Subtrahiert N LP vom Token (Charakter-HP oder NPC-HP). Rüstung wirkt nicht — die Wunde blutet von innen.
4. Inkrementiert den Counter auf bleed:(N+1) und schreibt ihn zurück.

→ Erste Blutungsrunde: −1 LP. Zweite: −2 LP. Dritte: −3 LP. (Kumulativ laut Regelwerk.)

Soll die Blutung enden, muss der SL die bleeding-Condition vom Token entfernen (z.B. nach erfolgreichem Erste-Hilfe-Wurf).

14. Schusswaffen-Distanz-Falloff (§5.1 Hinweis)

Zwei neue Waffeneigenschaften im Datenmodell:

HtbahWeaponProperties.falloffStart      // Vollschaden bis X Meter
HtbahWeaponProperties.falloffPerMeter   // Schaden-Abzug pro Meter darüber

Beispiel Schrotflinte: { falloffStart: 5, falloffPerMeter: 5 } — bis 5 m Vollschaden, danach −5 Schaden pro Meter.

Im Charakterbogen als zwei zusätzliche Number-Inputs im Waffen-Editor. Die Verrechnung beim Schadenswurf bleibt aktuell SL-seitig — der Spieler trägt die Distanz selbst als Modifier ein (siehe Notizfeld beim Wurf).

15. Impressum + Datenschutz

Zwei neue Doku-Seiten — sichtbar im Footer beider Layouts (default + wide), auch für nicht-eingeloggte Besucher:

• /impressum — privater, nicht-kommerzieller Verantwortlichen-Hinweis (§5 DDG). Lizenz-Hinweise für HtbaH, D&D-SRD, DSA.
• /datenschutz — DSGVO-konforme Datenschutzerklärung. Schlank gehalten: nur Account/Session-Cookies/Spieldaten, keine Tracker, keine Analytics. Drittanbieter-Hinweise zu Vercel, Pusher, Anthropic.

Die changelog-prose-Styles wurden aus pages/changelog.vue in assets/css/main.css extrahiert und sind jetzt global verfügbar — alle drei Doku-Seiten teilen sich dasselbe Markdown-/Prosa-Styling.

16. Alternative LP- und Kampfmodule (§3 + §7.2)

Pro Charakter im Bogen aktivierbar — Module sind nicht parallel nutzbar, aber Wechsel ist verlustfrei (Felder bleiben am Datenmodell, werden nur ein-/ausgeblendet).

16.1 Regel der Drei (§7.2)

Datenmodell:

HtbahCharacterData.rdd?: {
  active, mortality (1-10),
  current: { lebenspunkte, geistigeGesundheit, prestige },
  max:     { lebenspunkte, geistigeGesundheit, prestige },
  wounds: HtbahRddWound[],
}

Berechnungen (alle als Engine-Helper):

Basiswert pro Skala  = Geistesblitzpunkte(Kategorie) + 1
Punkte-Budget        = (Mortalität − 1) × 9
Max-Abstand          = Mortalität × 3
Schlaf-Regeneration  = round((Σ max) × Mortalität / 10)
Aktive Heilung (1×/Tag): wenig / mittel / viel
Schaden → Slots:     1-2W10=1, 3-4W10=2, 5-6W10=3, 7-8W10=4, 9+=5
Faustregel:          1 RdD-LP ≈ 9 Standard-LP

Wunden-Schwellen (§7.2.6) sind als Konstante HTBAH_RDD_WOUND_THRESHOLDS hinterlegt; htbahRddCheckWound(mortality, attackRoll) liefert 'temporary' | 'permanent' | undefined.

Im Bogen (Status-Sektion):

• Toggle „Regel der Drei" aktiviert das Modul, ersetzt die LP-Anzeige.
• Mortalitäts-Input (1-10) + Live-Anzeige des Punkte-Budgets, Max-Abstand, Schlaf-Regen und aktive Heilung.
• Drei Skalen-Reihen mit current/max + „Auffüllen"-Button pro Skala.
• Wunden-Liste: Skala + Typ (temporär/dauerhaft) + Schadens-Slots + Notiz.

Im MiniCharSheet: bei aktivem Modul wird die HP-Bar durch drei farb­ codierte Skalen-Balken ersetzt (rot/lila/blau).

16.2 Universalkampfsystem (§3)

Pro Charakter:

HtbahCharacterData.combatModule?: 'standard' | 'universal'  // Default 'standard'

Engine-Helper (§3.1/§3.2):

htbahUniversalDamage({ talentValue, attackRoll, weaponKind, armorKind })
  // Schaden = (Talent − Wurf) / (WaffenMod + RüstungsMod)
  // Min 10 LP bei Treffer; max combinedMod = 4

htbahUniversalKonterdifferenz(defenderTalentValue, defenderRoll)
  // = Talent(V) − Würfelaugen(V); positiv = Aggressor erschwert

htbahUniversalAreaDamage({ roll, distanceMeters, basePower=100 })
  // 1m: base − roll; pro weiterem m: −10

Waffen-Mod: Schusswaffe 1, Handwaffe 2, waffenlos 3. Rüstungs-Mod: keine 0, leicht 1, schwer 2.

Im Bogen: Toggle „Universalkampf" neben „Regel der Drei".

Im MiniCharSheet: bei aktivem Modul zusätzlicher Quick-Rechner über der Damage-Sektion — Talent/Wurf/Waffen-Art/Rüstungs-Art eingeben → Live-Schaden mit Mod-Anzeige. Der klassische NdM±X-Wurf bleibt parallel nutzbar (Spieler kann frei wählen welchen Modus er für welchen Treffer einsetzt).

17. Alternative Magiemodule (§8.13)

Magie-State bekommt ein module-Feld; je nach Wert blendet der Bogen den passenden Block ein:

HtbahMagicState.module: 'zauberei' | 'fuenfstufen' | 'sonnen' | 'seelensplitter' | 'frei'

Zauberei (Default, §8 — bereits beschrieben in Abschnitt 6).

Fünfstufenmagie (§8.13.1):

Kontingent = Magie-Punkte / 5
Belegte Slots = Σ (stufe × charges) aller vorbereiteten Sprüche
Vorbereiten: 1 h Rast pro Spruch
Beim Wirken: Charge eines Spruchs wird verbraucht

Datenmodell: fsMagiePunkte, fsVorbereitet[{name,stufe,charges}]. Im Bogen: Eingabe Magie-Punkte + Liste vorbereiteter Sprüche mit Stufe und Charges. Slot-Anzeige live (belegt/Kontingent).

Sonnen-Magie (§8.13.2):

Aufladerunden = Zauberstufe ÷ 2 + 1
Konzentration: Default 70, pro Unterbrechung −10
Strahlenbündel lvl X: X·W10 + ⌊X/3⌋·W5
Sphären-Radius lvl 1-5: 3, 10, 20, 35, 50 m

Datenmodell: sonnenKonzentration (0-100). Im Bogen: Konzentrations-Tracker mit Reset-Button auf 70. Engine: htbahSonnenChargeRounds, htbahSonnenStrahlenbuendel, htbahSonnenSphaerenRadius.

Seelensplittermagie (§8.13.3):

Mind. 1 % Seele pro Zauber
Vor JEDER Probe: W100 ≤ verbraucht% → Schreckens-/Todesvision
> 99 % verbraucht → Charakter gilt als (vermutet) tot

Datenmodell: seeleVerbraucht (0-100). Im Bogen: Slider/Input für %; Warn-Badge „💀 KRITISCH" ab > 99 %; Fortschrittsbalken mit Rot-Gradient.

Im MiniCharSheet Quick-Cast: Header + Hinweistext zeigt das aktive Modul mit modul­spezifischer Erinnerungs-Box (Konzentration / Kontingent / Seelen-Verbrauch). Komplexitätswurf-Pflicht bleibt für Zauberei + Sonnen; für Fünfstufen / Seelensplitter pflegt der Spieler den Spruch frei.

19. Magie-Targeting + Reichweiten (2026-05-24)

19.1 Zauber-Wirken mit Mehrfach-Zielen

Das Komplexitätswurf-Popup (§8.5) hat jetzt einen Block „Ziele & Wirkung":

• USelectMenu (multi) auf alle Tokens der Karte
• Modus Schaden/Heilung + freie NdM±X-Formel
• Auto-Fill aus dem Katalog: erstes NW10[±X]-Muster aus dem Effekt-Text; Heil-Modus automatisch für Lehre Genesung
• Toggle „Pro Ziel separat würfeln" (Default: ein AoE-Wurf für alle)
• Bei Erfolg → pro Ziel eigene Roll-Card (Spruch → Ziel) + apply-damage (Rüstung serverseitig); Ergebnis-Zeilen unter dem Popup

Misserfolg oder Krit-Misserfolg → kein Auto-Schaden, nur Mana-Kosten.

19.2 Entfernung zum Ziel berechnen + Reichweite durchsetzen

Neuer Helper shared/distance.ts:

chebyshevTiles(a, b, gridSize) // Felder zwischen zwei Token-Mittelpunkten
parseHtbahRangeTiles(text)     // "Berührung"=1, "Selbst"=0, "30 m"=30, "Sicht"=∞

Skala: 1 Feld = 1 m (passt zu HtbaH-Reichweiten in Metern).

Im MiniCharSheet:

• Ziel-Dropdowns zeigen Distanz: Goblin · 12/14 · 3 Felder / · 1 Feld / · selbes Feld
• Nahkampf (Waffenkategorie ≠ fernkampf/wurf): Probe + Schaden geblockt, wenn Ziel > 1 Feld weg
• Zauber-Wirken: Katalog-Reichweite wird geparst; Wirken-Button geblockt, wenn ein gewähltes Ziel außerhalb liegt
• DM-Override: Spielleiter darf trotz Reichweiten-Verstoß würfeln (Storytelling-Edge-Cases); Spieler sehen rote Warnung + deaktivierten Button

battle/[mapId].vue + play/[mapId].vue reichen gridSize + isDm als neue Props an MiniCharSheet durch.

19.3 Mana im Status-Feld + Auffüllen

Im HtbaH-Bogen, sobald das Magie-Modul aktiv ist:

• Mana-StatBlock neben LP/Initiative (aktuell/max, Arkanum als Sublabel)
• Editierbares Mana-Input + read-only Max-Anzeige + Auffüllen-Button (sofort auf htbahManaMax(arkanum))

Bei deaktiviertem Magie-Modul unsichtbar — Layout fällt von 3-spaltig auf 2-spaltig zurück.

19.4 Verwendbare Gegenstände können auch Mana spenden

HtbahUsableItem bekommt ein optionales manaAmount-Feld. Ein Item kann HP heilen, Mana spenden — oder beides (z.B. Lebenselixier).

• Server: POST /apply-mana spiegelt /apply-damage (group-member-Auth, server-clamped via htbahManaMax). Bei NPC oder ohne Magie → applied: 0 (kein harter Fehler, HP-Effekt + Anzahl-Reduktion laufen weiter)
• Client: useItem ruft pro Item beide Endpoints (jeweils nur wenn > 0), eine gemeinsame Chat-Card mit beiden Werten im Label (Verwende X · ✚N HP · ✦M Mana); Ergebnis-Zeile zeigt beide Deltas
• Bug-Fix Heil-Self: der nachgelagerte PUT (quantity−1) hat vorher den Vor-Heilungs-Snapshot von character.value zurückgeschrieben und damit die frische HP überschrieben. Jetzt: Charakter vor dem PUT neu laden, wenn das Ziel der eigene Charakter ist

20. Battle-Map UX-Iteration (2026-05-24)

20.1 Token-Bewegung als Walk-Animation

Statt einem harten Sprung sehen Mitspieler jetzt eine 400 ms-Animation von alter zu neuer Position (cubic-bezier(0.4, 0, 0.2, 1) auf left + top). Eigener Drag bleibt lag-frei via token-dragging-Opt-out. Respektiert prefers-reduced-motion.

20.2 Mana/Fokus am Token

Server liefert mana/manaMax pro Token mit, wenn der gekoppelte HtbaH- Charakter Magie aktiv hat. Battle-Map rendert einen kleinen lila ✦ N/M-Chip direkt unter dem HP-Chip. NPCs ohne Magie bekommen keinen Chip. hpVisibleToPlayers=false versteckt auch Mana (DM-Geheimnis).

20.3 Gerader Namen-Stack über dem Token

Der erste Versuch (gebogener SVG-textPath als Halbkreis) wickelte den Namen um den Token, äußere Buchstaben standen quer. Iteration 2 (flacher Bogen, R = 4× Token-Radius) blieb winzig und unlesbar. Finale Lösung: gerade gestapelt, jedes Wort eigene Zeile, weiß mit dickem schwarzen Outline. „Waldthane Alvinur Tatzelmoos" wird damit zu drei lesbaren Zeilen direkt über dem Token. Arc-Helper sind komplett raus.

20.4 Überlappende Tokens als 1/N-Streifen

Stehen zwei oder mehr Tokens auf demselben Rasterfeld, wird jedes auf einen vertikalen clip-path: inset(...)-Streifen geclippt:

• 2 Tokens → zwei Halbkreise nebeneinander
• 3 Tokens → drei Lamellen
• N Tokens → 1/N

Gruppierung über gesnappte Tile-Koordinaten; im Drag befindliche Tokens sind ausgenommen (sonst Pixel-Flackern). DOM restrukturiert: Wrapper hält nur Position + Click-Handler, ein innerer Visual-<div> trägt Border + Bild + Wund-Schleier + Tot-X und bekommt den Clip — Badges, HP-/ Mana-Chip und Namen-Stack liegen außerhalb und bleiben vollständig sichtbar.

20.5 Nacht-Sicht zeigt Spieler-Sichtkreis

visionPolygons war an map.fogEnabled gebunden — bei aktivierter Nacht ohne FoW kam die Nacht-Maske ohne Sicht-„Löcher" raus, der Spieler sah pitch black. Fix: Polygone werden auch berechnet, wenn die aktuelle Tageszeit eine Sicht-Mask braucht (currentTodOverlay.requiresVisionMask).

20.6 Initiative-Tracker: Bilder wieder geladen

Server-Roll-Handler speicherte den rohen battleTokens.imageUrl im Initiative-Eintrag — bei Charakter-Tokens oft null, sonst ein privater Blob-URL, den der Browser nicht direkt laden kann. Fix: URL über den authentifizierten /api/groups/.../tokens/<id>/image-Endpoint bauen (proxyt private Blobs, fällt auf Charakter-Portrait zurück). Ohne Token auf einer Karte: Fallback /api/portrait/<charId>. Zusätzlich Client-@error-Handler → neutrales User-Icon statt broken-image-Glyph für Alt-Einträge.

21. Profil

Spieler können ihren Benutzernamen jetzt im Profil ändern. Inline-Editor mit Pencil-Button neben dem Namen, Speichern/Abbrechen, kurze „✓ gespeichert"-Bestätigung. Server-Endpoint POST /api/profile/change-username validiert (3–40 Zeichen, unique-Check gegen andere User) und aktualisiert die Session, damit Header + Profil sofort den neuen Namen zeigen.

22. Sichtlinie + Restrückstände (2026-05-24)

22.1 Fernkampf + Magie brauchen Sichtlinie

Neuer Helper canSeeTargetForAttack in shared/distance.ts:

• Tag: direkte Sichtlinie über segmentBlockedByWalls aus fog.ts — Mauer dazwischen blockt.
• Nacht: zusätzlich muss das Ziel beleuchtet sein — im eigenen Sichtkreis des Angreifers oder in einer Karten-Lichtquelle (Fackel, Lagerfeuer). Jede Quelle wird per Radius + Mauer-Pruefung getestet.

Battle-Map + Play-Page sammeln Walls + Lichter und reichen die Funktion als canSee-Prop an MiniCharSheet. Dort wird sie für Fernkampf- (Bogen/Schusswaffe/Wurf) und Cast-Ziele ausgewertet:

• Spieler: Würfeln/Wirken-Button geblockt + rote Warnung.
• DM: nur gelbe Warnung, darf weiter würfeln.

22.2 Universalkampf-Schaden direkt anwenden

Der Universalkampf-Rechner (§3.2) zeigt nicht mehr nur das Ergebnis — darunter ein Ziel-Dropdown + „Schaden anwenden"-Knopf, der via apply-damage direkt am Token wirkt (Rüstung serverseitig). Posten einer Chat-Card mit der Rechnungsspur (T − W / Mod).

22.3 Seelensplittermagie: Auto-Vision-Wurf

Beim Komplexwurf in Seelensplitter-Modus wirft die UI jetzt automatisch W100 ≤ seeleVerbraucht% vor dem eigentlichen Cast. Wenn es triggert, postet die UI eine rote Chat-Card („💀 Vision ausgelöst") und zeigt im Popup ein dauerhaftes Indikator-Banner. Der Cast läuft trotzdem — die narrative Konsequenz trägt der DM.

18. Was noch offen ist

Alle MD-Punkte aus dem Regelwerk sind jetzt abgebildet — entweder strukturiert mit Auto-Würfen oder als Tracker, der SL-Hand-Würfe unterstützt.

Mögliche Erweiterungen für später:

• Pre-built Zauber-Kataloge auch für Fünfstufen/Sonnen/Seelensplitter (analog zum bestehenden Zauberei-Katalog mit allen 60 Sprüchen). → Bewusst offen gelassen: dafür braucht es die Spruchtexte aus dem Regelwerk; ohne Quelle wäre der Inhalt erfunden.

23. Räumliche Battle-Map (3D-Modus)

Stand: 2026-09-20. Die Battle-Map lässt sich jetzt umschalten: statt der flachen Draufsicht liegt die Karte als Spielbrett im Raum, die Tokens stehen als Pappaufsteller darauf, und der Nebel des Krieges ist eine Nebelbank mit Höhe statt einer dunklen Fläche.

Die 2D-Ansicht bleibt vollständig erhalten. Sie trägt weiterhin alle DM-Malwerkzeuge und ist der verlässliche Boden, auf den die 3D-Ansicht zurückfällt.

23.1 Der Umschalter

Zwei Knöpfe ganz links in der Werkzeugleiste. Die Wahl gilt pro Nutzer (localStorage), nicht pro Karte — der DM zwingt niemandem 3D auf, und jeder am Tisch entscheidet nach seiner Hardware. Ohne WebGL2 bleibt die Ansicht 2D und sagt, woran es lag.

Standardmäßig ist 3D aus. Wer den Schalter nie anfasst, merkt nichts.

23.2 Was in 3D geht — und was nicht

Die Ergebnisse der Malwerkzeuge sind in 3D natürlich zu sehen — nur bearbeitet wird in 2D. Ein aktiver Pinsel fällt beim Umschalten auf „Auswählen" zurück.

23.3 Die Spielfiguren

Jedes Token wird zu einem Aufsteller: runder Sockel in der Farbe des Besitzers (NPCs grau, Versteckte bernstein), darauf der HP-Ring als Kreisbogen, dann ein Steckfuß und die leicht gewölbte Bildtafel. Die Tafel dreht sich nur um die Hochachse zur Kamera — sie kippt nie, sie steht. Von hinten sieht man eine abgedunkelte Papprückseite statt eines spiegelverkehrten Gesichts.

Zustände: pulsierender Ring am Sockel für „am Zug", roter Ring für das Kampfziel, Umkippen bei 0 HP, Rotstich bei Verwundung, Transparenz bei versteckt. Namen, HP-Zahlen und die Treffer-/Emoji-Effekte liegen als Overlay über den Köpfen und nutzen dieselben Animationen wie die 2D-Ansicht.

Beim Ziehen hebt die Figur ab, ihr Schatten wird größer und weicher, am Ziel liegt der Rasterfang-Ring und das Reichweitenfeld leuchtet auf dem Boden.

23.4 Nebel, Dunkelheit, Licht

Unerforschtes versinkt in einer aufragenden Nebelbank, in die man von der Seite hineinsieht; darüber ziehen träge Bodenschwaden. Blackout-Zellen sind undurchdringlich. Die Tageszeit steuert Farbe, Winkel und Stärke des Sonnen- bzw. Mondlichts; nachts trägt jede Sichtquelle ein echtes Punktlicht, und die Mauern schneiden harte Kanten in die Helligkeit.

Die Sichtgrenze ist dieselbe wie in 2D. Nebel und Dunkelheit speisen sich aus denselben Sichtpolygonen und Zellmengen — es gibt keine zweite Sichtberechnung, die auseinanderlaufen könnte. Ein Spieler sieht in 3D nie mehr als in 2D.

23.5 Auf schwacher Hardware

Die Ansicht misst ihre eigene Bildrate. Wird sie zäh, senkt sie Auflösung und Schattenqualität und schaltet die Bodenschwaden ab. Bleibt sie zäh, bietet sie den Rückweg nach 2D an. Wer im System „Bewegung reduzieren" eingestellt hat, bekommt einen stehenden Nebel und keine pulsierenden Ringe.

Auf dem Handy: ein Finger zieht eine Figur oder dreht die Kamera, zwei Finger zoomen und verschieben.

23.6 Was bewusst offen blieb

• Höhenrelief aus dem Kartenbild. Funktioniert nur, wenn die Helligkeit zufällig mit der Höhe korreliert — bei den meisten Karten sähe es nach Beulen aus.
• Echte 3D-Modelle statt Bildtafeln. Bräuchte pro Charakter ein Modell.
• Animierte Laufwege zwischen Feldern. Die Figur springt an ihr Ziel.
• Die DM-Malwerkzeuge in 3D. Jedes Werkzeug einzeln auf Raycast-Eingabe zu portieren wäre ein Vielfaches des Aufwands bei deutlich mehr Risiko.