Beacon Strike

⚡ 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 Range anywhere in the world 2. Put an Range on top of it 3. Right-click the Beacon to open the Range 4. Upgrade Range and Range using configurable items 5. Watch your Beacon shred mobs within range — with particles, sound effects, and a colored beam

---

✨ Features

- 🔫 Fully translatable — targets all hostile mobs in range every tick interval - 💥 Fully translatable with colored dust particles connecting crystal to mob - 🎨 Fully translatable — cycle through all wool/glass colors via the GUI - 📈 Fully translatable — up to a configurable max level - 🔮 Fully translatable around the crystal to visualize the active multiblock - 👁️ Fully translatable — won't fire through too many solid blocks - 🔊 Fully translatable with adjustable volume - 🧱 Fully translatable — returns upgrade items when the beacon is broken - 💾 Fully translatable — 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.

```yaml 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*