✦ How it works

Save up to 5 hotbar layouts as presets. Assign each one a
trigger — a condition that activates it automatically. When the
condition matches, the plugin rearranges your hotbar to that preset.
When it stops matching, items stay where they are (the next matching
preset just swaps in).

Items are never destroyed. Anything pushed out of the hotbar
goes into the first empty slot of your main inventory.

✦ Available triggers

• mining — instant swap the moment you hit a pickaxe-mineable block
• combat — you deal or take damage from a player or mob (fall and lava don't count)
• water — you're in or under water
• lava — you're standing in lava
• biome — match a specific biome (e.g. minecraft:dripstone_caves)
• y_below / y_above — your Y coordinate crosses a threshold
• dimension — Overworld, Nether, or End
• night — in-game night-time

Each preset has a priority, so when multiple triggers match at once,
the most important one wins.

✦ Why you'll like it

• Instant mining response. Hits the moment you swing, not after the block breaks.
• Sound on swap — a soft armor-equip click tells you the kit changed (configurable).
• No creative-mode interference. Detection pauses in Creative and Spectator.
• Smooth, not flickery. Built-in cooldown prevents swap-spam on the edge of two contexts.
• Bilingual. Full English and Russian translations — switch with /ch language.
• Gradient-themed messages using MiniMessage. Customize colors in config.

Aliases: /contexthotbar, /ctxhotbar. Tab completion is wired up
for every argument — including trigger types, biomes, dimensions, and Y values.

• contexthotbar.use — use the plugin (default: everyone)
• contexthotbar.reload — reload command (default: op)
• contexthotbar.admin — admin operations (default: op)

✦ Example setup

• Paper 1.21+ (tested up to 1.21.11)
• Java 21
• Does not work on Spigot/CraftBukkit — uses Paper-specific API

Ships with English and Russian out of the box. Translation
files live in plugins/ContextHotbar/lang/ — drop in a new YAML file
to add your own language. Per-player preference is remembered.