Skip to content

Home

Jump to bottom
speakernothing4-bit edited this page Jun 13, 2026 · 1 revision

Welcome to the swingsync wiki!

⚔️ SwingSync — Attack Cooldown HUD for Competitive PvP

Stop staring at your crosshair. Start winning fights.

SwingSync adds a fully standalone, customizable attack cooldown bar to your HUD — giving you a clean, always-visible readout of your weapon charge without ever taking your eyes off your opponent.

🎯 What It Does

In 1.9+ PvP, your attack cooldown is everything. Landing a full-charge hit deals significantly more damage than a spammed swing — and the difference between winning and losing a sword or axe fight often comes down to milliseconds of timing.

The vanilla cooldown indicator is a tiny sword icon buried at your crosshair. In the middle of a fight, that's the last place your eyes should be.

SwingSync moves that information where it belongs — a smooth, color-coded bar anchored anywhere on your screen, updating every frame so you never miss your timing window.

✨ Features

  • Standalone cooldown bar — completely separate from the crosshair, rendered as a clean segmented bar with real-time smooth updates
  • Color-coded charge states
    • 🔴 Red — not ready
    • 🟡 Yellow — charging
    • 🟢 Green — full charge, swing now
  • Ready flash — a subtle screen-edge pulse fires the moment your weapon is fully charged, so you feel it even during intense fights
  • Weapon-only mode — the bar automatically hides when you're not holding a weapon, keeping your HUD clean when it's not needed
  • Fully configurable via an in-game GUI (no config file editing required):
    • Bar width & height
    • Screen position (X/Y offset)
    • Toggle segmented vs. solid bar style
    • Enable/disable the ready flash
    • Show bar for all items or weapons only

🏆 Who Is This For?

  • Crystal PvP players who need precise axe timing between crystal explosions
  • Sword PvP players learning or refining W-tap and hit timing
  • Pot PvP players who want cleaner HUD awareness during fast-paced exchanges
  • Anyone moving from 1.8 PvP to 1.9+ who wants better timing feedback

⚖️ Is It Allowed On Servers?

Yes. SwingSync is 100% client-side and server-friendly.

  • Reads only data the game already provides via getAttackCooldownProgress() — nothing fabricated
  • Performs zero block interaction, packet modification, or reach changes
  • No automation of any kind — you still swing manually
  • Purely a visual remap of vanilla information, equivalent to watching the crosshair indicator in a more convenient location

It complies with the rules of virtually all competitive servers. When in doubt, check your server's specific mod policy.

📦 Installation

  1. Install Fabric Loader for Minecraft 1.21.11
  2. Download Fabric API
  3. Download SwingSync and drop the .jar into your .minecraft/mods/ folder
  4. Launch the game — the bar appears automatically
  5. Configure it via Mods → SwingSync → Config

Required Dependencies

Dependency Required
Fabric API ✅ Required
Cloth Config ✅ Required
Mod Menu ✅ Required (for config screen)

Created by Muhammad Umair · © All Rights Reserved

# ⚔️ SwingSync — Attack Cooldown HUD for Competitive PvP

Stop staring at your crosshair. Start winning fights.

SwingSync adds a fully standalone, customizable attack cooldown bar to your HUD — giving you a clean, always-visible readout of your weapon charge without ever taking your eyes off your opponent.

🎯 What It Does

In 1.9+ PvP, your attack cooldown is everything. Landing a full-charge hit deals significantly more damage than a spammed swing — and the difference between winning and losing a sword or axe fight often comes down to milliseconds of timing.

The vanilla cooldown indicator is a tiny sword icon buried at your crosshair. In the middle of a fight, that's the last place your eyes should be.

SwingSync moves that information where it belongs — a smooth, color-coded bar anchored anywhere on your screen, updating every frame so you never miss your timing window.

✨ Features

  • Standalone cooldown bar — completely separate from the crosshair, rendered as a clean segmented bar with real-time smooth updates
  • Color-coded charge states
    • 🔴 Red — not ready
    • 🟡 Yellow — charging
    • 🟢 Green — full charge, swing now
  • Ready flash — a subtle screen-edge pulse fires the moment your weapon is fully charged, so you feel it even during intense fights
  • Weapon-only mode — the bar automatically hides when you're not holding a weapon, keeping your HUD clean when it's not needed
  • Fully configurable via an in-game GUI (no config file editing required):
    • Bar width & height
    • Screen position (X/Y offset)
    • Toggle segmented vs. solid bar style
    • Enable/disable the ready flash
    • Show bar for all items or weapons only

🏆 Who Is This For?

  • Crystal PvP players who need precise axe timing between crystal explosions
  • Sword PvP players learning or refining W-tap and hit timing
  • Pot PvP players who want cleaner HUD awareness during fast-paced exchanges
  • Anyone moving from 1.8 PvP to 1.9+ who wants better timing feedback

⚖️ Is It Allowed On Servers?

Yes. SwingSync is 100% client-side and server-friendly.

  • Reads only data the game already provides via getAttackCooldownProgress() — nothing fabricated
  • Performs zero block interaction, packet modification, or reach changes
  • No automation of any kind — you still swing manually
  • Purely a visual remap of vanilla information, equivalent to watching the crosshair indicator in a more convenient location

It complies with the rules of virtually all competitive servers. When in doubt, check your server's specific mod policy.

📦 Installation

  1. Install [Fabric Loader](https://fabricmc.net/use/) for Minecraft 1.21.11
  2. Download [Fabric API](https://modrinth.com/mod/fabric-api)
  3. Download SwingSync and drop the .jar into your .minecraft/mods/ folder
  4. Launch the game — the bar appears automatically
  5. Configure it via Mods → SwingSync → Config

Required Dependencies

Dependency Required
[Fabric API](https://modrinth.com/mod/fabric-api) ✅ Required
[Cloth Config](https://modrinth.com/mod/cloth-config) ✅ Required
[Mod Menu](https://modrinth.com/mod/modmenu) ✅ Required (for config screen)

🛠️ Compatibility

Minecraft Fabric API Status
1.21.11 0.141.4+1.21.11 ✅ Supported

Created by Muhammad Umair · © All Rights Reserved

Clone this wiki locally