SiegeCannon

[1.0.0] — 2026-05-01

Initial public release. Spun out of an in-development cooperative PvE defense plugin.

Added

• Mount-and-fire siege cannon: right-click an ArmorStand cannon to ride, left-click to fire, sneak to dismount.
• ±45° fan firing arc with action-bar feedback when the player tries to fire outside the arc.
• Two-stage ignition: left-click triggers a configurable fuse window (default 1s) before TNT actually launches.
• Block partitioning on cannon-shell explosions: each block is independently rolled into one of three buckets — fly as FallingBlock, vanilla destroy, or preserve in place.
• protect-blocks switch for arena servers that want damage and visuals without map damage.
• damage-multiplier for tuning cannon-shell DPS independently of vanilla TNT.
• Mob-only AoE damage: friendly fire is suppressed by default for the cannon-fired TNT.
• Custom HP and dramatic destruction sequence when a cannon takes lethal damage (event broadcast + particle / sound theatre + CannonDestroyEvent).
• Recoil feedback on fire (view pitch kick + cannon-body kickback). The kickback uses incremental ArmorStand teleport; an ItemDisplay-based smooth interpolation was explored during 1.0.0 development but reverted because per-model display.head anchors differ from ItemDisplay's entity anchor (sinking / floating). Tracked for 1.1.
• Global TPS-aware FallingBlock spawn cap (60 entities/tick) so multi-cannon volleys don't tank server performance.
• /cannon list, /cannon removeall, and /cannon spawn <x> <y> <z> [world] admin commands in addition to /cannon spawn, /cannon remove, /cannon reload.
• Public API: cancellable CannonFireEvent (fired before ignition) and informational CannonDestroyEvent (fired during destruction sequence).
• Bilingual (zh_CN / en_US) lang/ files; auto-resolves by player client locale.
• bStats anonymous metrics integration (opt-out via plugins/bStats/config.yml).
• Resource pack hook: cannon.model.use-custom: true sets minecraft:item_model to siegecannon:cannon_tnt; clients without the pack fall back to the vanilla TNT model.
• Config sanity clamps: every numeric config value has documented bounds; out-of-range values are clamped at load time and logged as warnings.

Notes

• siegecannon.use defaults to true so any player can spawn / remove cannons. siegecannon.admin (default op) gates list, removeall, reload, and the explicit-coordinate spawn form.
• Cannons are in-memory only in 1.0.0. Restarting the server wipes all spawned cannons. Persistence is on the roadmap.
• The Cannon abstract base class is exposed but the registry that lets third parties plug in custom cannon types is not yet wired up; only TntCannon is used internally. See README "API" section.
• Cooldown is tracked in server ticks, not wall-clock milliseconds, so heavy lag doesn't make cooldown "teleport" forward.