🛰️ OrbitalStrike
Minecraft plugin — Orbital cannon system

Cannon System
Players can establish virtual cannons in orbit. Each cannon is assigned a unique name and loaded with a specific type of ammunition (payload). Cannons can be fired by command or via a special Fishing Rod targeting tool.
Attack Payloads
🔴 STAB — Precision Strike
A focused attack that drops a continuous column of TNT onto a single point, drilling deep into the ground. Ideal for breaching bunkers or reinforced bases.
🟡 NUKE — Area Bombardment
A massive area-of-effect strike. Drops a main warhead from high altitude with expanding rings of TNT to carpet-bomb a large area. Ideal for surface annihilation.
🟣 RECURSION — Chain Reaction
Creates devastating chain-detonation effects across the target zone for cascading destruction.
⚡ EMP — Electromagnetic Pulse
Emits a sequence of expanding electromagnetic pulses that disable Redstone devices, shatter glass, and cripple enemies with Blindness and Weakness.
Firing Mechanisms
🔵 By Command
Fire immediately at the crosshair location or at specific X, Y, Z coordinates using /cannon fire or /cannon target.
🟢 By Item
A special item linked to a specific cannon. Clicking with the item fires at the location the player is looking at. Can be crafted in survival mode if recipes are configured.

Commands
| Command | Description |
|---|---|
/cannon create <name> [payload] |
Create a cannon at your location |
/cannon remove <name> |
Remove a cannon |
/cannon list |
List all cannons |
/cannon fire <cannon> |
Fire payload at crosshair |
/cannon info <cannon> |
Show info for a cannon |
/cannon target <cannon> <x> <y> <z> |
Fire at specific coordinates |
/cannon give <player> <cannon> |
Give targeting tool to a player |
/cannon set <cannon> <param> <value> |
Set a parameter for a cannon |
/cannon reload |
Reload configuration |
Permissions
| Node | Description |
|---|---|
orbitalstrike.use.<cannon> |
Use a specific orbital strike cannon |
orbitalstrike.admin |
Create and manage cannons |
WorldGuard Integration
Flag: osc-enable
Controls whether OrbitalStrike cannons are allowed to fire within a WorldGuard region.
Default:
deny— Regions that have not explicitly set this flag will block all orbital strikes by default.
| Value | Effect |
|---|---|
allow |
Orbital strikes are permitted in this region |
deny |
Orbital strikes are blocked (default for all regions) |
Set to allow to enable strikes in a specific region — useful for designated PvP or war zones.
All Versions
+ Add Version## What's New
This major update brings full support for Minecraft **1.21 through 26.1.2**, along with long-awaited fixes and performance improvements.
## Features & Fixes
- Cooldown System** The cooldown setting on cannons now actually prevents firing until the timer expires. Set it in
cannons.ymlper-cannon. - Safety Limit** — Nuke strikes now cap at a configurable maximum TNT count (
max-tnt-per-strikeinconfig.yml, default -1). No more accidental server melts. - EMP Shockwave reworked** — Smoother visual effects, better performance, and more reliable block destruction.
- Permissions overhaul** —
orbitalstrike.usenow defaults totrueso all players can use cannons by default. Granular craft permissions (orbitalstrike.craft.*) have been added. - Crafting recipes now require permission by default** — Server owners must explicitly grant
orbitalstrike.craft.<recipe>to players. - Fixed cannons.yml configuration** — The item and settings sections now use proper YAML format.
## Bug Fixes
- Cooldown field now actually works (it was defined but never checked)
- Fishing rod cannon tools can no longer accidentally cause issues when fishing
- Fixed several cases where the plugin would crash with
ClassCastExceptionon certain item types - Plugin no longer leaks memory over time (fixed listener registration)
- Improved error messages for missing targets, invalid materials, and blocked regions
- Fixed EMP particle effects not rendering on Paper 26+
## Performance
- Nuke strikes now have a configurable TNT cap (
max-tnt-per-strikeinconfig.yml, default -1) to prevent server lag. - EMP shockwave effects are significantly more performant
- Overall particle effect handling has been optimized
- Full documentation**: https://github.com/NguyenDevs/Orbitalstrike
- Report issues**: https://github.com/NguyenDevs/Orbitalstrike/issues
- EMP Payload:** Added the new EMP payload type capable of creating large-scale shockwaves. EMPs can effectively disable Redstone mechanics and apply debuff effects to entities within their blast radius.
- Dynamic Particle Trails System:** Introduced a brand-new, highly customizable particle trails system for projectiles. Server owners can now create beautiful and intricate trail trajectories with complete freedom.
- Crafting Recipes:** Added example crafting recipes for cannons, allowing players to obtain and use them easily in survival mode.
# ⚙️ Changes & Improvements
- Cleaned Configurations:** Restructured and cleaned up all configuration files. They are now much cleaner, more intuitive, and easier for server owners to read and customize.
- World Restrictions Logic:** Changed the world restriction mechanic from a whitelist ("Enabled Worlds") to a blacklist ("Disabled Worlds") approach, offering greater flexibility during setup.
- Improved WorldGuard Integration:** Fixed issues and optimized the WorldGuard soft-depend hooks, ensuring stable and accurate plugin behavior within protected regions (claims).
# ⚠️ Breaking Changes
- Major Core Refactoring:** This update involves significant structural changes to the core systems of the plugin. To avoid any incompatibility issues caused by old data structures, please **backup** your existing
.ymlconfiguration files and allow the plugin to regenerate them after updating!
- Add Worldguard flag support: _**osc-enable**_
- By default, regions that don't have this flag set will automatically assume you're setting a **deny** flag.
- Please delete your entire
OrbitalStrikefolder before installing this update.** The plugin will regenerate all configuration files with the new structure.
## ✨ New Features
### 🎯 Customizable Trigger Items
- Per-cannon trigger customization** - Each cannon type can now have its own unique trigger item
- Configure in
cannons.ymlwith new item attributes: - Material** - Set any item type as a trigger
- Durability** - Control item durability consumption
- Cooldown** - Individual cooldown periods per cannon
### ⛓️ Recursive Payload Type
- New "Recursive" cannon** - Creates devastating chain-detonation effects
- Configurable chain reaction parameters
- Perfect for area denial and tactical strikes
### 📝 Enhanced Configuration
- Improved configuration documentation** - All options now include detailed descriptions
- Better messaging system** - Clearer player feedback and notifications
- Logging options** - New logging configuration for monitoring
Two new commands will be added to support the new feature.
> Add _/cannon set <cannon> <parameter> <value>_ - Set a parameter for a cannon
> Add _/cannon info <cannon>_ - Show info for a cannon
These two commands will be updated to use actual cannons rather than creating virtual ones based on config values.
> Modify _/cannon fire <cannon>_
> Modify _/cannon target <cannon> <x> <y> <z>_
Added the **_update-notify: true_** option to _config.yml_ to notify admins and the console when a new version is released.