Hyperion

[3.0.0] - 2026-09-05

⚠️ Two breaking changes read before updating: - Requires Paper. This build needs Paper (api-version 26.2) and won't load on Spigot. Don't update until your server is on Paper. - Old Hyperions stop working. The sword is now identified by a data tag instead of its name. Swords given before this update are just named iron swords reissue them with /givehyperion. License changed from GPL-3.0 to AGPL-3.0.

For admins

- Fully configurable via `config.yml`: teleport distance/sound, implosion damage and radius, the whole Wither Shield healing kit (potion effects, durations, sounds), and the item itself (material, damage, name, lore MiniMessage supported). - `/hyperionreload` reload the config with no restart. New hyperion.reload permission (ops by default). - `/givehyperion [player]` now works from console, targets other players, has tab completion, and reports unknown player names instead of failing silently. - `givehyperion.give` permission is now actually enforced. It was defined but never checked before. Still defaults to everyone set default: false in paper-plugin.yml if you don't want players giving it to themselves. - Bad config values are logged and replaced with safe defaults a typo can't crash the server.

For players

- Ability no longer double-fires. It used to trigger twice per right-click (double teleport distance, double damage, double message). Now it's one clean cast. - Teleport can't strand you in walls, water, or lava anymore it now checks your full hitbox and finds a safe spot, or cancels if there isn't one. - Melee hits now deal the sword's real damage instead of vanilla iron sword damage. - The sword only works in your main hand. Using it off-hand shows a (rate-limited) notice instead. - Damage numbers shown are now accurate previously the reported number was unrelated to the actual damage dealt. - Right-clicking a block (door, chest, button) while holding the sword no longer triggers both the block and the ability. - If your inventory is full when receiving a sword, it now drops at your feet instead of vanishing.

Under the hood

- Implosion now uses one shared damage roll per cast, checks a proper sphere (not a cube), and attributes kills/deaths to the player. - Teleport uses an eye-level raytrace with wall margin, zeroes velocity, and preserves rotation. - Commands rebuilt on Paper's Brigadier API; chat messages moved to Adventure components; tooltips use item data components. - Cooldown tracking switched to a lightweight primitive map, cleared properly on quit/disable/reload. - Sound names in config are matched leniently (case, punctuation don't matter). - README rewritten for Paper with setup, permissions, and full config reference. Full Changelog: https://github.com/Mitra-88/Hyperion/compare/1.8.0...3.0.…