BQ BossBars

⭐ BQ BossBars
Display active BeautyQuests objectives with customizable boss bars.
Enhance your RPG experience with live quest progress directly on screen!

What This Plugin Does
BQ-BossBars integrates with BeautyQuests to automatically show each of a player’s active quests and it's objectives as individual boss bars.
It pulls real-time objective data using PlaceholderAPI placeholders and BeautyQuests API to update boss bar text:

• On quest start
  
  
• When stage changes
  
  
• Upon quest completion
  
  
• When quest is cancelled

Bar titles are cleaned of line breaks and other clutter to ensure proper display!

Features

• Shows quest progress dynamically for all active quests
  
  
• Configurable bar colors and quest name display (toggleable)
  
  
• /bq-bossbar command for live management (colors, clearing, toggling names)
  
  
• List active quests of a player or log to console when player starts/finishes/progresses quest stages!

Dependencies
This plugin requires the following to function:

• BeautyQuests
  
  
• PlaceholderAPI
  
  
• A Paper-based Minecraft server (target version: 1.21.4)

All dependencies must be installed and running for BQ-BossBars to operate correctly.

⚠️ Limitations

• Boss bar text is limited to ~170 characters (at GUI scale 2) due to Minecraft’s inability to make multi-line bossbars. Exceeding this limit may cause the text to overflow off the screen.
  
  
• A lot of quests at once can cause a lot of clutter at the screen, as every quest is treated as another bossbar!

MMOProfiles Compatibility
If you're using MMOProfiles, boss bars may persist after profile recreation or creating new profile if existing one already has quests active.
To fix this, add the following code to the MMOProfiles config at profile-create script:

reset_quests_bars:
        type: dispatch_command
        from_console: true
        op: false
        format: 'bq-bossbar clear %player_name%'
        target:
          type: caster

This ensures clean quest bar reinitialization when creating new profiles.

⚙️ Configuration Options
Located in config.yml:

displayQuestEvents: false   # Logs quest event updates to console
useQuestName: false         # Adds quest name to boss bar
nameColor: WHITE            # Color of quest names when shown
barColor: PINK              # Default boss bar color
reverseFill: false          # Control the fill type of the bar

All options can also be adjusted in-game via /bq-bossbar.

Compatibility Notes

• Built for Paper 1.21.4
  
  
• api-version: 1.21 – supports any 1.21.x server version

Commands
Command Description
/bq-bossbar help - show help for the plugin
/bq-bossbar display <on/off> - turn on or off logging of the quest events to the console (default: OFF)
/bq-bossbar color - let's you pick the color of the bossbars
/bq-bossbar name <on/off/color> - let's you change if you want to display quest name or just it's objectives, also allows for quest name color change (default: OFF/white)
/bq-bossbar fill <normal/reverse> - controls if the bar fills or empties during the progression of the quest stages.
/bq-bossbar clear <player> - removes all bossbars from the plugin from the selected player
/bq-bossbar reload - reload the plugin's config
/showquests <player> - list all active quests and their stages from a player

Installation

1. Install BeautyQuests and PlaceholderAPI
   
   
2. Drop BQ-BossBars.jar into your plugins/ folder
   
   
3. Start your server
   
   
4. Configure via /bq-bossbar or config.yml

Support & Feedback
Have a question or found a bug?
You can find me on the BeautyQuests discord!