Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

kernitus/BukkitOldCombatMechanics

Repository files navigation

by kernitus and Rayzr522

Fine‑tune Minecraft combat, movement, and item balance without breaking your server. OldCombatMechanics is a free, open‑source toolkit for Spigot & Paper that lets you mix 1.8‑style snappiness with modern features, per world and per player.

Why servers pick OCM

  • 🧩 Modular: enable only what you need: cooldowns, tool damage, knockback, shields, potions, reach, sounds, more.
  • 🚀 Performant: lean listeners only enabled as needed to keep tick time low.
  • 🗺️ Modesets: ship different rules for different worlds or players; perfect for mixed PvP/PvE, minigames, or duels.
  • Backwards‑friendly: runs on Java 8+, supports 1.9 to latest; integrates cleanly with PlaceholderAPI and ProtocolLib.
  • Tested for you: live integration tests run real Paper servers across multiple versions every build.
  • 💸 Zero cost: fully open source, optional basic telemetry (bStats only), no paywalls.

Quick start

  1. Drop the jar into plugins/ (Spigot or Paper-derivatives 1.9+).
  2. Restart and edit config.yml to pick your modules and modesets.
  3. Use /ocm reload to apply changes instantly.
  4. Hand players /ocm modeset <name> to let them choose their ruleset.

Paper Spigot Bukkit


🧰 Modesets

  • Per-player/per-world presets that decide which features are active; each world has an allowed list and a default modeset.
  • Let players pick ( /ocm modeset <name> ) to run, for example, 1.8-style PvP in an arena world while keeping vanilla rules in survival.

⚙ Configurable Features

Features are grouped in modules as listed below, and can be individually configured and disabled. Disabled modules will have no impact on server performance.

⚔ Combat

Tweak timing, damage, and reach.

  • Attack cooldown: adjust or remove 1.9+ cooldown
  • Attack frequency: set global hit delay
  • Tool damage: pre-1.9 weapon values
  • Attack range (Paper 1.21.11+): 1.8-style reach
  • Critical hits: control crit multiplier
  • Player regen: tune regen rates

🤺 Armour

Balance defence and wear.

  • Armour strength: scale armour protection
  • Armour durability: change durability loss

🛡 Swords & Shields

Control block and sweep behaviour.

  • Sword blocking: restore old right-click block
  • Shield damage reduction: scale shield protection
  • Sword sweep: enable or disable sweeps
  • Sword sweep particles: hide or show sweep visuals

🌬 Knockback

Shape knockback per source.

  • Player knockback: adjust PvP knockback
  • Fishing knockback: fishing-rod knockback
  • Fishing rod velocity: pull speed
  • Projectile knockback: arrows and other projectiles

🧙 Gapples & Potions

Change consumable power.

  • Golden apple crafting and effects: notch and normal
  • Potion effects and duration: old-style values
  • Chorus fruit: teleport behaviour and range

❌ New feature disabling

Toggle later-version mechanics.

  • Item crafting: block selected recipes
  • Offhand: disable offhand use
  • New attack sounds: mute new swing sounds
  • Enderpearl cooldown: enable or remove cooldown
  • Brewing stand refuel: alter fuel use
  • Burn delay: adjust fire tick delay

🔌 Compatibility & Testing

  • OCM targets Spigot 1.9+ and runs on Java 8 and up.
  • We stick to Spigot/Paper APIs for forward compatibility; NMS/reflection is used only when necessary.
  • Integration tests boot real servers on 1.12, 1.19.2, and 1.21.11 each build to verify behaviour.
  • Most plugins work fine with OCM. Explicitly tested integrations include PlaceholderAPI (see wiki).

⚡ Development Builds

Oftentimes a particular bug fix or feature has already been implemented, but a new version of OCM has not been released yet. You can find the most up-to-date version of the plugin on Hangar.

🤝 Contributions

If you are interested in contributing, please check this page first.


bStats