Installation

1. Copy the plugin

Place the plugin jar in plugins/.

Generated folder name: plugins/KGInfoServs-BQBetterHud/.

2. First start

Start the server once to generate files:

• config.yml
• fonts.yml
• messages_en.yml
• messages_fr.yml
• license.key
• avatars/ folder
• backgrounds/ folder

3. Activate license

Open plugins/KGInfoServs-BQBetterHud/license.key.

Replace PASTE_YOUR_LICENSE_KEY_HERE with your license key, then restart the server.

4. Link BetonQuest

In your BetonQuest conversations, use conversationIO: kg_bqhud.

conversations:
  guide_intro:
    quester: "Guide"
    conversationIO: kg_bqhud
    first: "start"

Global BetonQuest option:

conversation:
  default_io: kg_bqhud,menu,chest

If this line still has kg_hud, replace it with kg_bqhud.

4.1. ItemsAdder integration (optional)

If you use ItemsAdder to manage your server resource pack, you can automatically merge KG_BQBetterHud assets.

Open plugins/ItemsAdder/config.yml and add:

resource-pack:
  merge_other_plugins_resourcepacks_folders:
    - KGInfoServs-BQBetterHud/resourcepack

Then run /iazip to regenerate the ItemsAdder pack with KG_BQBetterHud assets included.

Automatic merging

ItemsAdder will automatically include avatars, backgrounds, and fonts from KG_BQBetterHud in its generated resource pack.

5. Quick validation

After restart:

• /bqhud reload works,
• a conversation opens with conversationIO: kg_bqhud,
• players receive the resource pack (depending on your output-mode).

6. First recommended tuning

• tune standalone.resource-pack.output-mode
• tune standalone.layout.* positions
• tune standalone.x-offset and standalone.y-offset
• tune selection-mode and selection-indicator.*

Then run /bqhud reload.