BannerHelmet

A Minecraft plugin that allows players to wear banners on their heads with customizable potion effects.

Description

Equip banners as helmets and gain powerful potion effects based on the banner's color - perfect for RPG servers, team identification, or just showing off your style!

How to Use

1. Hold a banner in your main hand
2. Run /bh (or /bannerhelmet)
3. The banner moves to your helmet slot and appears above your head
4. You automatically receive the banner's potion effects
5. Run /rbh (or /removebannerhelmet) to remove it

Features

• 🎨 Wear Any Banner - All 16 banner colors can be equipped as helmets
• ⚡ Unique Effects - Each banner color grants different potion effects
• 🔧 Fully Configurable - Customize effects, levels, and permissions
• 🔄 Hot Reload - Update config without restarting the server
• 🌐 Folia Compatible - Full support for Folia's multi-threaded regions
• 🎮 Easy Commands - Simple commands to equip and remove banners

Commands

Command	Aliases	Description	Permission
/bannerhelmet	/bh	Equip a banner from your hand	bannerhelmet.use (if required)
/removebannerhelmet	/rbh	Remove your banner helmet	bannerhelmet.use (if required)
/bannerhelmetreload	-	Reload the plugin configuration	Operators/Console only

Default Banner Effects

Banner Color	Effect(s)
⚪ White	Slow Falling I
🟠 Orange	Fire Resistance I
🟣 Magenta	Regeneration I
🔵 Light Blue	Speed I
🟡 Yellow	Strength I
🟢 Lime	Night Vision I
🩷 Pink	Glowing I
⚫ Gray	Resistance I
◻️ Light Gray	Mining Fatigue III
🔷 Cyan	Slowness I
🟣 Purple	Invisibility I
🔵 Blue	Haste I
🟤 Brown	Jump Boost I
🟢 Green	Oozing I
🔴 Red	Hunger I
⚫ Black	Blindness I + Darkness I

Installation

1. Download the latest BannerHelmet-X.X.jar from Releases
2. Place the JAR file in your server's plugins folder
3. Start or reload your server
4. Configure the plugin in plugins/BannerHelmet/config.yml
5. Use /bannerhelmetreload to apply config changes

Configuration

# Require permission to use the plugin
require-permission: false

# Banner Effects Configuration
banner-effects:
  # Enable or disable banner effects
  enabled: true
  
  # Effects for each banner color
  # Format: "EFFECT_NAME LEVEL"
  effects:
    WHITE_BANNER:
      - "SLOW_FALLING 1"
    ORANGE_BANNER:
      - "FIRE_RESISTANCE 1"
    # ... (see config.yml for all options)

Configuration Options

• require-permission: Set to true to require the bannerhelmet.use permission
• banner-effects.enabled: Toggle all banner effects on/off globally
• banner-effects.effects: Customize effects for each banner color
  • You can add multiple effects per banner
  • Format: "EFFECT_NAME LEVEL" (e.g., "SPEED 2")
  • Effect names use Minecraft's potion effect names (SPEED, STRENGTH, etc.)

Permissions

Permission	Description	Default
bannerhelmet.use	Allows using banner helmet commands	Everyone (if require-permission is false)
bannerhelmet.reload	Allows reloading the config	Operators only

License

This project is licensed under the MIT License - see the LICENSE file for details.