NoStunSlam

Short description

Prevents axe shield-break → mace follow-up "stun-slam" combos in PvP, configurable per-world and per-server.

Long description

NoStunSlam blocks immediate follow-up mace hits after a player breaks another player's shield with an axe, preventing instant "stun-slam" combos that are commonly abused in PvP. It is lightweight, configurable, and intended for Bukkit-compatible servers.

Features:

• Per-world enable/disable toggles.
• Two blocking modes: TICK_WINDOW (blocks for N ticks) and REQUIRE_LANDING (blocks until attacker lands).
• Bypass permission for trusted players.
• Runtime commands for toggling and reloading config.
• Minimal dependencies - compiled against Paper API 1.21.11.

Commands

• /nostunslaM toggle - Toggle protection for your current world.
• /nostunslaM toggle <world> - Toggle protection for a specific world (use from console or with permission).
• /nostunslaM status - Show enabled/disabled status for your current world.
• /nostunslaM reload - Reload config and worlds file.

Permissions

nostunslaM.admin - Management (toggle/status/reload). Default: op.
nostunslaM.bypass - Allows player to bypass stunslam blocking. Default: false.

See src/main/resources/plugin.yml for the authoritative command/permission declarations.

Example config

The plugin generates a default config.yml on first-run. Example contents:

mode: TICK_WINDOW
block-window-ticks: 10
blocked-message: "&cYou cannot mace so quickly after breaking a shield!"
log-blocks: false

Example worlds file

disabled-worlds:
  - example_world

Admin notes

• Give moderators the nostunslaM.admin permission via your permissions plugin (e.g., LuckPerms):

lp group moderator permission set nostunslaM.admin true

• To exempt a user from blocking:

lp user <username> permission set nostunslaM.bypass true

• Use /nostunslaM toggle <world> from console to change per-world state without being online in that world.

Compatibility & installation

• Target platform: Bukkit-compatible servers (Paper/Spigot/CraftBukkit) implementing the Bukkit API for Minecraft 1.21.
• Built against Paper API 1.21.11-R0.1-SNAPSHOT (see build.gradle.kts). The plugin declares api-version: '1.21' in plugin.yml.
• It should run on other 1.21.x server builds, but functionality is not guaranteed across major Minecraft versions (e.g., 1.20 or 1.22).

Installation:

1. Download the plugin JAR from the releases or Modrinth.
2. Drop NoStunSlam-<version>.jar into your server plugins/ folder.
3. Restart the server.

Support / Source

If you find bugs or issues, message Mexz on Discord.