Visuelle Anpassung

Dieser Leitfaden erklärt, wie Sie das visuelle Erscheinungsbild des Dialog-HUDs anpassen können.

🎨 Übersicht

Das eigenständige Rendering-System ermöglicht die Anpassung von:

• Hintergründe: Oberflächenhintergründe (Dialog, Antworten, NPC-Name)
• Avatare: NPC-Bilder
• Layout: X/Y-Positionen jedes Elements
• Skalierung: Größe visueller Elemente

📁 Ordnerstruktur

plugins/KGInfoServs-BQBetterHud/
├── avatars/          # NPC-Avatare (PNG)
├── backgrounds/      # Oberflächenhintergründe (PNG)
├── fonts/           # Benutzerdefinierte Schriftarten (TTF)
└── resourcepack/    # Generiertes Paket (Ordnermodus)

🖼️ Hintergründe

Standarddateien

Das Plugin bietet Standard-Hintergrundbilder:

• dialogue_bg.png - Dialog-Hintergrund
• answer_bg.png - Antwortoptionen-Hintergrund
• name_bg.png - NPC-Namen-Hintergrund

Anpassung

1. Platzieren Sie Ihre PNG-Bilder in plugins/KGInfoServs-BQBetterHud/backgrounds/
2. Verwenden Sie dieselben Dateinamen, um Standards zu ersetzen
3. Neustart oder führen Sie /bqhud reload aus

Empfohlene Größen:

• Dialog-Hintergrund: 256x128px
• Antwort-Hintergrund: 256x128px
• Namen-Hintergrund: 128x32px

👤 Avatare

Siehe Avatare-Leitfaden für vollständige Avatar-Anpassung.

📐 Layout-Konfiguration

Alle Positionen werden in config.yml unter standalone.layout konfiguriert.

Wichtige Konfigurationsoptionen

standalone:
  layout:
    dialogue-bg:
      x: 0
      y: 20
      scale: 1.0

    answer-bg:
      x: 180
      y: -30
      scale: 1.0

    npc-name:
      x: 10
      y: 19

    dialogue-text:
      x: 10
      y: 32
      split-width: 166

    avatar:
      x: -20
      y: 0
      scale: 0.75

Positionssystem

• Ursprung: Bildschirmmitte
• X-Achse: Negativ = links, Positiv = rechts
• Y-Achse: Negativ = oben, Positiv = unten
• Skalierung: 1.0 = normale Größe, 2.0 = doppelte Größe

🎯 Beispiele

Zentrierter Dialog

standalone:
  layout:
    dialogue-bg:
      x: 0
      y: 0
      scale: 1.2
    dialogue-text:
      x: 0
      y: 15

Größerer Avatar

standalone:
  layout:
    avatar:
      x: -30
      y: -10
      scale: 1.5

🔄 Änderungen Anwenden

Nach dem Ändern von Hintergründen oder Layout:

1. Führen Sie /bqhud reload aus
2. Testen Sie im Spiel mit einer Unterhaltung
3. Passen Sie Positionen nach Bedarf an

📚 Siehe Auch

• Konfiguration - Vollständige config.yml-Referenz
• Avatare - Avatar-System-Leitfaden
• Fehlerbehebung - Häufige Probleme