SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedGameplay & overhauls

OldCombatMechanics

by kernitus · for Minecraft

Configure combat-related mechanics from 1.9 onwards

2.8KDownloads
26d agoLast updated
MPL 2.0License
PaperLoaders

About OldCombatMechanics

From Hangar

Configure combat-related mechanics from 1.9 onwards

by kernitus

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. It is built for PvP networks, minigames, BedWars/SkyWars-style games, duels, KitPvP, practice arenas, and mixed PvP/PvE worlds that need different combat rules in different places.

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; reflection lookups are cached and recurring tasks are minimised (shared where possible) to keep tick time low on busy PvP servers.
  • 🗺️ 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 PacketEvents.
  • ✅ 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.

GitHub Spigot Bukkit Paper


🧰 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 whilst 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; on Paper 1.21.2+ we also add the native sword blocking animation via the consumable component
  • 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.9.4, 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).

🧾 Licence

  • Source code in the GitHub repository is under the Mozilla Public License 2.0 (MPL‑2.0).
  • Pre-built jars bundle PacketEvents (GPLv3). Those binary distributions are provided under GPLv3 terms due to the included dependency.
  • If you build a jar without PacketEvents, you may distribute that build under MPL‑2.0, subject to its terms.

⚡ Development Builds

Oftentimes a particular bug fix or feature has already been implemented, but a new version of OCM has not been released yet.

If you are looking for the newest changes, use the Snapshot channel on this page, or check GitHub Actions: https://github.com/kernitus/BukkitOldCombatMechanics/actions

🤝 Contributions

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

Read the full description on Hangar →

Highlights

From source data

Game versions

Supports 65 Minecraft versions, the newest being 26.3.

Loaders

Runs on Paper.

Footprint

Rated a light load on a server.

OldCombatMechanics on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers, for Paper servers. We download it from Hangar, place it, and restart the server.
Server side
Required on the server
Server type needed
Paper
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
2.8.0, released 2026-10-26

Game versions by loader

LoaderGame versionsNewest
Paper1.9 to 26.3 (65 versions)26.3

From 23 recorded builds of OldCombatMechanics.

Recent builds

BuildReleasedGame versionsLoaders
2.8.02026-10-261.9 to 26.3 (65 versions)Paper
2.7.1-SNAPSHOT+552c3b5 snapshot2026-10-261.9 to 26.3 (65 versions)Paper
2.7.1-SNAPSHOT+b06313b snapshot2026-10-261.9 to 26.3 (65 versions)Paper
2.7.1-SNAPSHOT+392aabc snapshot2026-10-261.9 to 26.3 (65 versions)Paper
2.7.1-SNAPSHOT+9a6744a snapshot2026-10-261.9 to 26.3 (65 versions)Paper
2.7.1-SNAPSHOT+c2ecb48 snapshot2026-10-241.9 to 26.3 (65 versions)Paper

Run OldCombatMechanics on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Hangar as “Plugins”

Gameplay & overhauls

New mechanics, content and overhauls that change how the game plays.

Runs on your server

From source side support

Hangar lists OldCombatMechanics as required on the server. Check its Hangar page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
Paper
Runs on
Serverrequired on the server
Game versions
26.3 and 64 earlier
Requires
One-click install needs a Paper server.

Verified at the source

  • ✓HangarOfficial listing, checked 2026-10-27Open ↗
  • ✓Authorkernitus, as published on Hangar
  • ✓LicenseMPL 2.0Free

OldCombatMechanics, answered

Generated from the mod’s own source data.

Do my players need to install OldCombatMechanics?

Hangar lists OldCombatMechanics as required on the server. Check its Hangar page to see whether players need it too.

Which loaders does it support?

Paper.

Is it free?

Yes. OldCombatMechanics is free to download from Hangar. Its license is MPL 2.0.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run OldCombatMechanics on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add OldCombatMechanics in one click.