Troubleshooting

1. No dialogue HUD appears

Check:

• conversation uses conversationIO: kg_bqhud
• if conversationIO is not set everywhere, conversation.default_io contains kg_bqhud
• plugin is enabled on startup
• license is valid

2. Resource pack is not applied

Check:

• standalone.resource-pack.output-mode
• if self-host: public-url and port reachability
• if folder: server pack was rebuilt/redeployed after generation

3. NPC avatar not loaded

Check:

• file exists in plugins/KGInfoServs-BQBetterHud/avatars/
• filename matches expected npc_id
• .png extension

Mapping reminder:

• NPC name Andre, le Forgeron -> andre.png

4. Background not updated

Check:

• file is in plugins/KGInfoServs-BQBetterHud/backgrounds/
• exact supported filename is used
• /bqhud reload was run

5. Position/scale does not change

Check:

• correct key under standalone.layout.*
• numeric value is valid
• /bqhud reload run after editing

6. Command denied

Check bqhud.admin permission.

7. License error on startup

Check:

• license.key content
• outbound internet access

Quick checklist

• conversationIO: kg_bqhud
• conversation.default_io contains kg_bqhud (or replace kg_hud)
• /bqhud reload after edits
• output-mode matches your distribution flow
• avatars/backgrounds are in correct folders with exact names