Skip to content

BSXRay/Beacon-Strike

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ BeaconStrike

Feel free to join the discord https://discord.com/invite/xDaMaRJGSS

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

About

Beacon Strike is a defense plguin against hostile mobs.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages