Visual Customization

This guide explains how to customize the visual appearance of the dialogue HUD.

🎨 Overview

The standalone rendering system allows you to customize:

• Backgrounds: interface backgrounds (dialogue, answers, NPC name)
• Avatars: NPC images
• Layout: X/Y positions of each element
• Scale: size of visual elements

📁 Folder Structure

plugins/KGInfoServs-BQBetterHud/
├── avatars/          # NPC avatars (PNG)
├── backgrounds/      # Interface backgrounds (PNG)
├── fonts/           # Custom fonts (TTF)
└── resourcepack/    # Generated pack (folder mode)

🖼️ Backgrounds

Default Files

The plugin provides default background images:

• dialogue_bg.png - Dialogue background
• answer_bg.png - Answer options background
• name_bg.png - NPC name background

Customization

1. Place your PNG images in plugins/KGInfoServs-BQBetterHud/backgrounds/
2. Use the same filenames to replace defaults
3. Restart or run /bqhud reload

Recommended sizes:

• Dialogue background: 256x128px
• Answer background: 256x128px
• Name background: 128x32px

👤 Avatars

See Avatars Guide for complete avatar customization.

📐 Layout Configuration

All positions are configured in config.yml under standalone.layout.

Key Configuration Options

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

Position System

• Origin: Center of screen
• X axis: Negative = left, Positive = right
• Y axis: Negative = up, Positive = down
• Scale: 1.0 = normal size, 2.0 = double size

🎯 Examples

Centered Dialogue

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

Larger Avatar

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

🔄 Applying Changes

After modifying backgrounds or layout:

1. Run /bqhud reload
2. Test in-game with a conversation
3. Adjust positions as needed

📚 See Also

• Configuration - Complete config.yml reference
• Avatars - Avatar system guide
• Troubleshooting - Common issues