BeeRaid Dungeon Raids & Guardian Bees

BeeRaid Dungeon Raids ⭕ Custom Loot ✨ Guardian Bees
Turn your Minecraft server into a dangerous dungeon battlefield with BeeRaid — a configurable dungeon raid plugin featuring Guardian Bees, loot-filled shulkers, automatic events and PvP encounters!

Discover the dungeon.
Survive the Guardian Bees.
Unlock the shulkers.
Collect valuable loot.
⚔️ Fight for the rewards.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
• Configurable dungeon regions
• Custom dungeon setup using two positions (Pos1 and Pos2)
• Multiple shulkers in each dungeon
• Configurable shulker opening delays
• Automatic dungeon opening events
• Configurable event intervals and initial opening delays
• Guardian Bees that defend the dungeon
• Configurable maximum number of bees per dungeon
• Configurable bee targeting behavior
• Persistent dungeon bees during active events
• Automatic bee cleanup when a dungeon closes
• Customizable bee names
• Configurable loot for each shulker
• Minimum and maximum item amounts
• Individual loot chances
• Command-based rewards
• Economy reward support through configured commands
• Configurable PvP
• Dungeon structure protection
• Configurable operator handling
• Configurable countdown announcements
• Configurable dungeon opening duration
• English and Russian message localization
• Customizable Minecraft color codes
• Configurable settings in YAML files

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

GUARDIAN BEE SYSTEM
Guardian Bees protect active dungeons and make raids more challenging.

Features include:

• Guardian Bees spawn to defend the dungeon
• Bees can target players according to the configured rules
• Survival-only targeting can be enabled
• Maximum bee count can be configured
• Bee names can be customized in config.yml
• Active dungeon bees are managed by the plugin
• Bees are cleaned up when the dungeon closes

Example configuration:

settings:
bee:
name: '&e Guardian Bee'
max-bees-per-dungeon: 25
bees-only-target-survival: true
The available settings depend on the plugin version. Check your generated config.yml before adding new options.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SHULKER LOOT SYSTEM
Each dungeon can contain multiple shulkers with their own loot tables.

Configure the rewards available in each shulker, including:

• Diamonds
• Emeralds
• Gold ingots
• Golden apples
• Enchanted golden apples
• Netherite ingots
• Ancient debris
• Other supported Minecraft items

Each loot entry can define:

• Item material
• Minimum amount
• Maximum amount
• Chance of receiving the item

Example:

loot:
diamond:
type: ITEM
material: DIAMOND
min: 2
max: 8
chance: 100

golden_apple:
type: ITEM
material: GOLDEN_APPLE
min: 1
max: 2
chance: 15
In this example, diamonds have a 100% configured chance, while golden apples have a 15% chance.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⏱️ AUTOMATIC DUNGEON EVENTS
BeeRaid supports configurable dungeon event timing.

Example settings:

settings:
announce-countdown-seconds: 30
open-duration-seconds: 600
auto-open: true
• Configure countdown announcements
• Set the dungeon opening duration
• Enable or disable automatic opening
• Configure individual dungeon intervals
• Set the initial opening delay
• Configure opening delays for individual shulkers

This lets server owners create scheduled dungeon raids without manually starting every event.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CUSTOM REWARDS
BeeRaid supports configurable rewards through commands.

For example, a shulker reward can execute an economy command:

rewards:
money:
chance: 15
commands:
- 'eco give %player% 25000'
This example gives the configured command a 15% chance to run.

Economy note: The example requires a compatible economy plugin that provides the eco give command. The exact command depends on your server's economy plugin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ DUNGEON PROTECTION & PVP
Control how players interact with your dungeon.

Available configuration options include:

• Enable or disable PvP during events
• Protect dungeon structures
• Configure whether operators are ignored by certain rules
• Configure Guardian Bee targeting behavior

Example:

settings:
pvp: true
protect-structures: true
ignore-operators: false
Use these settings to create competitive dungeon events while protecting the surrounding structure.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CONFIGURATION & LANGUAGES
BeeRaid uses YAML configuration files to customize the plugin.

Depending on the version, these include:

• config.yml — general settings
• dungeons.yml — dungeon definitions, if supplied by the installed version
• messages_ru.yml — Russian messages, if supplied by the installed version
• messages_en_US.yml — English messages, if supplied by the installed version

You can customize supported settings, loot tables, event timing and messages without changing Java source code.

Minecraft color codes such as &a, &c, &e and &6 can be used where the plugin supports color translation.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ COMMANDS
The following commands should be verified against the installed version before publication:

/beedungeon help
/beedungeon setup
/beedungeon status
/beedungeon reload
• help — display available commands
• setup — access dungeon setup functionality
• status — check dungeon status
• reload — reload supported configuration files

Additional commands for selecting Pos1 and Pos2, registering shulkers and editing dungeon settings must match the commands actually implemented in the JAR.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERMISSIONS
beeraid.admin
Administrative permission for BeeRaid.

• Intended for plugin administration
• Default: OP

Example LuckPerms command:

/lp group admin permission set beeraid.admin true
Separate permissions such as beeraid.setup, beeraid.reload and beeraid.status should only be documented if they are implemented in the installed version.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

INSTALLATION

1. Download the BeeRaid JAR.
   
   
2. Make sure your server runs a compatible version of Paper.
   
   
3. Place the JAR in your server's plugins folder.
   
   
4. Restart the server.
   
   
5. Open the generated BeeRaid configuration files.
   
   
6. Configure the dungeon settings, event timing and bee behavior.
   
   
7. Define the dungeon region using the setup commands supported by your version.
   
   
8. Register the shulkers and configure their loot.
   
   
9. Configure rewards and any required economy plugin.
   
   
10. Start or wait for your first dungeon event.

Always make a backup of your configuration files before updating the plugin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ HOW TO CREATE YOUR FIRST DUNGEON
Step 1 — Select the dungeon region
Use the plugin's supported setup commands to select the first corner ( Pos1) and the opposite corner ( Pos2) of your dungeon.

The two positions define the region where dungeon mechanics and supported protection rules apply.

Step 2 — Register your shulkers
Place the shulkers inside the dungeon and use the plugin's supported shulker-registration command for each one.

Assign each shulker an identifier so you can configure its opening delay and loot separately.

Step 3 — Configure the loot
Open the dungeon configuration and add the items you want players to obtain.

Set each item's material, minimum amount, maximum amount and chance.

Step 4 — Configure the event
Choose the opening interval, countdown duration, event duration, PvP setting and Guardian Bee behavior.

Step 5 — Test the dungeon
Check the region, verify that the shulkers are registered correctly, and test the event before enabling automatic opening on a live server.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

HOW A DUNGEON RAID WORKS

1. A dungeon event starts automatically or through a supported command.
   
   
2. The countdown is announced.
   
   
3. The dungeon opens.
   
   
4. Guardian Bees defend the active dungeon according to the configured rules.
   
   
5. Players fight to reach the shulkers.
   
   
6. Shulkers become available according to their configured opening delays.
   
   
7. Players obtain the configured loot.
   
   
8. The event ends after its configured duration.
   
   
9. The plugin performs its configured dungeon and bee cleanup.

The exact event sequence depends on the settings and mechanics implemented in your installed version.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

REQUIREMENTS
• A compatible Paper server
• A compatible Java version for your Minecraft/Paper version
• Optional economy plugin if you use economy-command rewards

Check the plugin's metadata and release notes for the exact supported Minecraft versions.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SUPPORT & FEEDBACK
Found a bug or have an idea for a new dungeon mechanic?
Report issues, suggest improvements and share feedback to help make BeeRaid better!

discord: https://discord.gg/kwGyr8kC6