Konfiguration

Hauptdatei: plugins/KGInfoServs-BQBetterHud/config.yml

Ziel dieser Seite: jede wichtige Konfigurationszeile erklaeren.

BetonQuest Konfiguration (pflichtig)

In plugins/BetonQuest/config.yml:

conversation:
  default_io: kg_bqhud,menu,chest

In einzelnen Conversations kann zusaetzlich gesetzt werden:

conversationIO: kg_bqhud

Wenn in default_io noch kg_hud steht, durch kg_bqhud ersetzen.

Gesamtstruktur

language: "en"
standalone:
  resource-pack:
    output-mode: "folder"
    self-host-port: 8164
    public-url: ""
    output-folder: "plugins/KGInfoServs-BQBetterHud/resourcepack"
    force-pack: false
    pack-prompt: "Resource pack required for dialogue display."
    regenerate-on-startup: false
  x-offset: 0
  layout: ...
  text-alignment: ...
  text-fonts: ...
  y-offset: -200
option-sound:
  key: "minecraft:ui.button.click"
  volume: 1.0
  pitch: 1.0
typewriter:
  enabled: true
  speed: 30
selection-mode: "scroll"
selection-indicator:
  prefix: ""
  selected-color: "<#97deaa>"
  unselected-color: "<gray>"
  hand-base-y: -25
  hand-line-height: 10
  max-option-length: 0
updater:
  auto-download: false

language

Schluessel	Standard	Wirkung
language	en	Plugin-Sprache fuer Meldungen (en oder fr)

Resource Pack (standalone.resource-pack)

Schluessel	Standard	Wirkung
output-mode	"folder"	Ausgabe-Modus: folder (Ordner) oder self-host (direkt senden)
self-host-port	8164	HTTP-Port in self-host
public-url	""	Oeffentliche Pack-URL in self-host
output-folder	"plugins/KGInfoServs-BQBetterHud/resourcepack"	Zielordner im folder Modus
force-pack	false	Erzwingt Pack-Akzeptanz beim Client
pack-prompt	"Resource pack required for dialogue display."	Hinweis vor Download
regenerate-on-startup	false	Pack bei jedem Start neu erzeugen

Globale Position (standalone)

Schluessel	Standard	Wirkung
x-offset	0	Verschiebt komplettes HUD auf X
y-offset	-200	Verschiebt komplettes HUD auf Y

Layout (standalone.layout)

Elemente lassen sich mit x und y verschieben.

Elemente mit scale:

• dialogue-bg.scale
• answer-bg.scale
• avatar.scale

Komplette Referenz:

Schluessel	Standard	Wirkung
dialogue-bg.x	0	Dialog-Hintergrund X
dialogue-bg.y	20	Dialog-Hintergrund Y
dialogue-bg.scale	1.0	Dialog-Hintergrund Groesse
answer-bg.x	180	Antwort-Hintergrund X
answer-bg.y	-30	Antwort-Hintergrund Y
answer-bg.scale	1.0	Antwort-Hintergrund Groesse
npc-name.x	10	NPC Name X (mit Optionen)
npc-name.y	19	NPC Name Y (mit Optionen)
npc-name-spoken.x	6	NPC Name X (ohne Optionen)
npc-name-spoken.y	23	NPC Name Y (ohne Optionen)
name-bg.x	0	Namens-Hintergrund X
name-bg.y	14	Namens-Hintergrund Y
dialogue-text.x	10	Dialogtext X (mit Optionen)
dialogue-text.y	32	Dialogtext Y (mit Optionen)
dialogue-text.split-width	166	Zeilenumbruch-Breite Dialogtext
dialogue-text-spoken.x	10	Dialogtext X (ohne Optionen)
dialogue-text-spoken.y	36	Dialogtext Y (ohne Optionen)
options-scroll.x	226	Optionen X im scroll Modus
options-scroll.y	-25	Optionen Y im scroll Modus
options-scroll.line-height	14	Zeilenabstand Optionen scroll
options-fixed.x	190	Optionen X im fixed Modus
options-fixed.y	-25	Optionen Y im fixed Modus
options-fixed.line-height	8	Zeilenabstand Optionen fixed
options-fixed.split-width	160	Zeilenumbruch-Breite Optionen fixed
hand.x	175	Auswahl-Hand X
hand.y	-26	Auswahl-Hand Basis Y
hand.spacing	8	Vertikaler Abstand der Hand-Zeilen
avatar.x	-20	NPC Avatar X
avatar.y	0	NPC Avatar Y
avatar.scale	0.75	NPC Avatar Groesse
text-height	8	Text-Hoehe

Text Alignment (standalone.text-alignment)

Erlaubte Werte: left, center, right

Schluessel	Standard	Wirkung
dialogue	"center"	Dialogtext Ausrichtung
speaker	"left"	NPC Name Ausrichtung
options	"left"	Optionen Ausrichtung

Text Fonts (standalone.text-fonts)

Schluessel	Standard	Wirkung
dialogue	""	Reserviert fuer Schrift pro Bereich
speaker	""	Reserviert fuer Schrift pro Bereich
options	""	Reserviert fuer Schrift pro Bereich

Wichtig: In der aktuellen Build wird hauptsaechlich die Default-Schrift aus fonts.yml verwendet.

Option Sound (option-sound)

Schluessel	Standard	Wirkung
key	"minecraft:ui.button.click"	Sound bei Optionswechsel
volume	1.0	Lautstaerke
pitch	1.0	Tonhoehe

Typewriter (typewriter)

Schluessel	Standard	Wirkung
enabled	true	Typewriter Effekt an/aus
speed	30	Typewriter Geschwindigkeit

Selection Mode (selection-mode)

Schluessel	Standard	Wirkung
selection-mode	"scroll"	Auswahlmodus: scroll oder fixed

Selection Indicator (selection-indicator)

Schluessel	Standard	Wirkung
prefix	""	Prefix fuer ausgewaehlte Option
selected-color	"<#97deaa>"	Farbe ausgewaehlte Option
unselected-color	"<gray>"	Farbe nicht ausgewaehlte Optionen
hand-base-y	-25	Basis Y fuer Auswahl-Hand
hand-line-height	10	Y-Abstand je Zeile
max-option-length	0	Max Textlaenge Option (0 = unbegrenzt)

Updater (updater)

Schluessel	Standard	Wirkung
auto-download	false	Updates automatisch laden

Aenderungen anwenden

1. config.yml bearbeiten.
2. /bqhud reload ausfuehren.
3. Im Spiel pruefen.

Bei visuellen Aenderungen (layout, offsets, Avatare, Hintergruende) immer live testen.

Fonts (fonts.yml)

Datei: plugins/KGInfoServs-BQBetterHud/fonts.yml

Hauptbereiche:

• default: Standard-Schrift
• fonts: benannte eigene Schriften

Wichtige Schluessel:

Schluessel	Wirkung
default.scale	Schriftgroesse Standard
default.file	TTF Datei in plugins/KGInfoServs-BQBetterHud/fonts/
default.use-unifont	Nutzt Minecraft Schriften wenn true
fonts.<name>.file	Eigene TTF Datei
fonts.<name>.scale	Schriftgroesse dieser Schrift

Beispiel:

default:
  scale: 16
  file: ""
  use-unifont: false

fonts:
  title:
    file: "myfont.ttf"
    scale: 24
    use-unifont: false