OrbitalStrike v2.0.0 — Break Change

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.yml per-cannon.
• Safety Limit — Nuke strikes now cap at a configurable maximum TNT count (max-tnt-per-strike in config.yml, default -1). No more accidental server melts.
• EMP Shockwave reworked — Smoother visual effects, better performance, and more reliable block destruction.
• Permissions overhaul — orbitalstrike.use now defaults to true so 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 ClassCastException on 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-strike in config.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

🚀 New Features

• 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 .yml configuration 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.

⚠️ Breaking Changes

Please delete your entire OrbitalStrike folder 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.yml with 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

From now on, each cannon will be able to customize its own parameter values. The values in config.yml are only for mapping when creating a new default cannon.

Two new commands will be added to support the new feature.

Add /cannon set - Set a parameter for a cannon Add /cannon info - 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 Modify /cannon target

Added the update-notify: true option to config.yml to notify admins and the console when a new version is released.