Attribute Swap Window

Attribute Swap Window is a lightweight, server-side Paper plugin that restores attribute swapping and gives server owners control over the swap timing window.

It is designed especially for modern Minecraft PvP mechanics involving fast item swaps, including Spear, Mace, and other attribute-based combat interactions.

100% server-side — players do not need to install any mods.

✨ Features

• 🔄 Restores attribute swapping behavior on Paper
• ⏱️ Configurable swap window from 1–20 ticks
• ⚔️ Designed for fast PvP attribute swaps
• 🔨 Works with combat mechanics involving Spear and Mace
• 🛠️ Built-in Paper attribute swap fix
• 🎮 Change the swap window directly in-game
• 💻 Commands work from both players and server console
• 📁 Simple configuration
• 🖥️ Server-side only
• 🚫 No client mod required
• ⚡ Lightweight with no dependencies

📥 Installation

1. Download the plugin .jar
2. Place it inside your Paper server's plugins folder
3. Start the server
4. If the plugin applies the Paper attribute swap fix during the first startup, restart the server once
5. Run

/aswap status

to confirm everything is working

That's it! Players can join with a completely normal Minecraft client.

⚙️ Commands

/aswap status— Shows the current plugin status and swap window.

/aswap window <ticks>— Changes the swap timing window from 1–20 ticks.

/aswap on— Enables the custom swap window.

/aswap off — Disables the custom swap window.

/aswap reload — Reloads the plugin configuration.

/aswap paperfix — Checks and applies the required Paper attribute swap setting.

⏱️ Swap Window

Minecraft normally runs at 20 ticks per second, meaning one tick is approximately 50 milliseconds.

• 1 tick = 50 ms
• 2 ticks = 100 ms
• 4 ticks = 200 ms
• 6 ticks = 300 ms
• 10 ticks = 500 ms
• 20 ticks = 1000 ms

For example:

/aswap window 6

A higher value provides a more forgiving swap window, while a lower value requires more precise timing.

🖥️ Server-Side Only

Attribute Swap Window runs entirely on the server.

Players do not need to install Fabric, Forge, NeoForge, or any client-side mod.

Simply install the plugin on your Paper server and players can use their normal Minecraft clients.

🎮 Compatibility

• Platform: Paper
• Minecraft: 26.1 – 26.2
• Environment: Server-side
• Client installation: Not required
• Dependencies: None

🔐 Permission

Administrative /aswap commands require:

aswap.admin

Server operators have this permission by default.