Avatars and backgrounds

Automatic NPC avatar link

Yes, avatar linking is automatic if your avatar filename matches the NPC npc_id.

Mapping rule:

1. Plugin reads NPC name.
2. Keeps first token before space/comma.
3. Removes accents and non-ASCII chars.
4. Lowercases result.

Example:

• Andre, le Forgeron -> npc_id = andre
• expected file: plugins/KGInfoServs-BQBetterHud/avatars/andre.png

If no match is found, fallback is nameless.png.

Avatar folder

Path:

• plugins/KGInfoServs-BQBetterHud/avatars/

Rules:

• png format
• filename must match npc_id

Examples:

• andre.png
• merchant.png
• guard_captain.png

Backgrounds (UI textures)

Backgrounds are not auto-linked per NPC.

They are global UI textures.

Path:

• plugins/KGInfoServs-BQBetterHud/backgrounds/

Supported files:

• dialogue.png
• answer.png
• hand.png
• name_start.png
• name_mid.png
• name_end.png

Move and scale avatar/backgrounds

You can tune positions and sizes in config.yml:

standalone:
  layout:
    avatar:
      x: -20
      y: 0
      scale: 0.75
    dialogue-bg:
      x: 0
      y: 20
      scale: 1.0
    answer-bg:
      x: 180
      y: -30
      scale: 1.0

• x / y: movement
• scale: size (only on keys that expose it)

Apply changes

1. Add/replace PNG files in avatars/ or backgrounds/.
2. Run /bqhud reload.
3. Check in game.

Depending on standalone.resource-pack.output-mode:

• self-host: players get the refreshed pack automatically.
• folder: regenerate and republish your server pack.