sBossBars - Smart & Scriptable BossBar Messages
Tired of boring chat announcements? Want to display dynamic, eye-catching information to your players? sBossBars is here to help!
sBossBars is a lightweight yet powerful Minecraft plugin that allows server owners to easily create and manage highly customizable BossBar messages. Trigger them based on server events, player actions, or set up informative rotating schedules. With seamless PlaceholderAPI integration, your messages can be truly personalized and data-driven.
Why Choose sBossBars?
- Easy to Configure: Uses intuitive YAML files ("scripts") to define how and when your BossBars appear. No complex in-game commands needed for setup!
- Event-Driven: Show BossBars when players join, on their first join, when they change worlds, (and more to come!).
- Scheduled & Rotating: Create groups of announcements that cycle automatically, perfect for tips, event reminders, or server news.
- Highly Customizable: Control the text (with full &color code and PlaceholderAPI support), color, style (solid, segmented), and progress of each BossBar.
- Lightweight & Performant: Designed to be efficient and not bog down your server.
- PlaceholderAPI Support: Leverage the power of PlaceholderAPI to display dynamic information like player stats, server info, and much more directly in your BossBars.
- Permission Control: Fine-tune who sees which BossBars using standard Minecraft permissions.
- World Whitelists/Blacklists: Restrict specific BossBars to certain worlds.
Key Features:
- Create static BossBars that are always visible (or shown on demand).
- On-Join BossBars: Welcome players or provide initial information.
- Scheduled BossBar Groups: Rotate through multiple messages at configurable intervals.
- Full control over text, color (BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW), and style (SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20).
- Set custom progress for bars.
- /sbossbar reload command for easy configuration updates without a server restart.
- Commands to manually show/hide bars for specific players or globally.
- Debug mode for easier troubleshooting.
How to Use:
- Install sBossBars and PlaceholderAPI (required for placeholder functionality).
- Configure your BossBars in the bars.yml file located in the plugins/sBossBars/ folder.
- Define a unique ID for each bar.
- Set its text, color, style, and progress.
- Configure triggers like on_join or schedule.
- Use /sbossbar reload to apply your changes.
- Grant permissions as needed (e.g., sbossbars.admin for commands, or custom permissions per bar).
Example bars.yml
Code (Text):
bars:
welcome_message:
text: "&aWelcome to &lMyAwesomeServer&a, %player_name%!"
color: GREEN
style: SOLID
progress: 1.0
on_join:
enabled: true
duration: 10 # seconds
# permission: "sbossbars.bar.welcome" # Optional permission
vote_reminder:
text: "&eRemember to /vote daily for rewards!"
color: YELLOW
style: SEGMENTED_10
progress: 1.0
schedule:
enabled: true
group: "reminders"
display_time: 30 # seconds this bar is shown
order: 1
Commands:
- /sbossbar reload - Reloads the plugin's configuration. (Permission: sbossbars.admin)
- /sbossbar show <player/@a> <bar_id> [duration_seconds] - Shows a defined BossBar. (Permission: sbossbars.admin)
- /sbossbar hide <player/@a> <bar_id/@all> - Hides a BossBar. (Permission: sbossbars.admin)
- /sbossbar list - Lists all configured BossBar IDs. (Permission: sbossbars.admin)
Dependencies:
- PlaceholderAPI (Required for full functionality, but the plugin will run without it with limited features)
Future Plans:
- More event triggers (e.g., on specific command usage, region enter/leave).
- Dynamic progress updates based on placeholders.
- In-game GUI for easier bar management.
- API for other plugins to interact with sBossBars.