⚡ BeaconStrike

Turn your Beacon into a weapon. Place an End Crystal on top — and watch it hunt.

BeaconStrike is a Minecraft plugin that transforms the humble Beacon into an automated mob-defense turret. Stack an End Crystal on any Beacon, upgrade it with configurable items, and it will fire a sonic boom beam at every nearby hostile mob — automatically.

---

🎬 How It Works

1. Place a Beacon anywhere in the world
2. Put an End Crystal on top of it
3. Right-click the Beacon to open the upgrade GUI
4. Upgrade Damage and Range using configurable items
5. Watch your Beacon shred mobs within range — with particles, sound effects, and a colored beam

---

✨ Features

• 🔫 Automated mob turret — targets all hostile mobs in range every tick interval
• 💥 Sonic boom beam with colored dust particles connecting crystal to mob
• 🎨 16 beam colors — cycle through all wool/glass colors via the GUI
• 📈 Upgradeable damage & range — up to a configurable max level
• 🔮 Orbit particles around the crystal to visualize the active multiblock
• 👁️ Line-of-sight check — won't fire through too many solid blocks
• 🔊 Configurable hit sound with adjustable volume
• 🧱 Break-safe — returns upgrade items when the beacon is broken
• 💾 Persistent data — upgrade levels and colors survive server restarts
• 🌐 Fully translatable — every message is editable in config.yml

---

🧱 Multiblock Setup

   [End Crystal]   ← place on top
   [  Beacon   ]   ← right-click to open GUI

Simply right-click any End Crystal item onto the top of a Beacon. That's it.

---

🖥️ GUI Overview

Right-click the Beacon to open the upgrade interface:

Slot	Item	Function
Top row	Colored Glass Pane	Visual decoration matching beam color
Center	Redstone	Click to cycle beam color
Left	Damage Item	Right-click to upgrade / Left-click to downgrade damage
Middle	Book	Info display
Right	Range Item	Right-click to upgrade / Left-click to downgrade range

---

⚙️ Configuration

All settings are in config.yml — including every player-facing message.

max-level: 10
damage-item: FIRE_CHARGE
damage-per-item: 2
range-item: BLAZE_ROD
range-per-item: 5
base-range: 10
base-damage: 1
tick-interval: 20        # 20 ticks = 1 second
beam-y-offset: 1.5
line-of-sight-block-limit: 10
hit-sound: ENTITY_WITHER_DEATH
hit-sound-volume: 0.5
orbit-particles: true

Recommended upgrade items

Purpose	Suggestions
Damage	FIRE_CHARGE, WITHER_SKELETON_SKULL, NETHER_STAR, DRAGON_EGG
Range	BLAZE_ROD, AMETHYST_SHARD, PRISMARINE_CRYSTALS, SCULK

---

💬 Commands & Permissions

Command	Description
/beaconstrike reload	Reloads the config without restarting

No permission nodes required by default — open to all operators.

---

📦 Installation

1. Download the .jar file
2. Drop it into your server's /plugins folder
3. Restart the server
4. A config.yml will be generated automatically

Requires: Paper/Spigot 1.21+

---

🐛 Known Limitations

• End Crystals placed via BeaconStrike are entities, not blocks — they can be destroyed by explosions
• The plugin targets all vanilla hostile mob types; custom mobs from other plugins are not targeted

---

📄 License

This project is provided as-is. Feel free to use it on your server or fork it for personal use.

---

Made by bsxray