Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for kernitus

Configure combat-related mechanics from 1.9 onwards

Report OldCombatMechanics?

R

2.6.0

2.6.0 (2026-09-01)

This release adds optional per-modeset permissions and improves item handling when players change hotbar slots or swap hands. It also fixes inventory compatibility errors and prevents sword item data from disconnecting players when shared through chat plugins.

Configuration

  • Added optional access control for individual modesets. Enable mode-permissions.enabled and grant oldcombatmechanics.modeset.<modeset> to decide which modesets each player may select. Tab completion, commands, joining, and changing worlds respect these permissions. The option is disabled by default, preserving existing behaviour. Related to #905.

Fixes

  • Fixed attack-range and per-item attack cooldown handling when players change hotbar slots or swap hands. OCM now applies settings to the new main-hand item and restores a spear's native reach after removing its range override. Fixes #925 and #939.

  • Fixed inventory compatibility errors that could produce repeated stack traces when disable-offhand processed inventory clicks on some server versions. Sword-blocking hand swaps also use safer inventory-view tracking. Fixes #911.

  • Fixed Paper sword-blocking item data using an invalid duration when serialised by item-chat plugins. Sharing a sword through plugins such as InteractiveChat no longer disconnects recipients because of a negative consumable duration. Fixes #937 via #938.

Report issues on GitHub.

Information

Published
September 1, 2026
Author
9Downloads

Platforms

Paper
Paper
1.9–26.2