> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/pvpitems.md).

# PvPItems

Mantic Development's PvP Items Minecraft Plugin

PvPItems adds configurable partner items and combat abilities to your Minecraft server. Use the built-in items straight away, then customise their appearance, cooldowns and behaviour through the in-game editor. Create additional ability items with the tool builder.

Designed for Bukkit/Spigot-compatible servers from Minecraft 1.8 through 26.3. Use the Java version required by your server and a matching ManticLib build. Elytra features apply on server versions with elytra.

[Get PvPItems on BuiltByBit](https://builtbybit.com/resources/pvpitems-partner-items.21189/).

## Start here

* [Installation and first use](/pvpitems/installation.md)
* [Default items](/pvpitems/default-items.md)
* [Commands](/pvpitems/commands.md)
* [Configurations](/pvpitems/configurations.md)
* [Custom tool builder](/pvpitems/custom-tool-builder.md)
* [In-game editor](/pvpitems/in-game-editor.md)
* [Permissions](/pvpitems/permissions.md)

## What you can use

The original items include Switcher Balls, Potion Orbs, Blinder Balls, Throwable Cobwebs, Bones, Fake Pearls and Wing Clipper.

Seven additional standalone items are available automatically: Frost Bomb, Grappling Hook, Time Anchor, Fall Charm, Shockwave, Hotbar Scrambler and Healing Beacon. Each has its own configuration file, give command and entry in the main editor.

The separate custom tool builder starts with Dash, Speed, Resistance, Tracker, Heal, Regeneration, Fire Resistance and Cleanse presets.

## Example footage

* [Switcher Balls](https://gyazo.com/607d1698121bed2f0b7d76592483fef0)
* [Throwable Cobwebs](https://gyazo.com/756011149627bcdf72199bf34795d75e)
* [Blinder Balls](https://gyazo.com/86183d9e19ecaf90d9bf0cbd7e6eaa8c)
* [Potion Orbs](https://gyazo.com/74ebb63e143aa17618c7adc3f043f48d)

## Developer events

Existing events include `ThrowableWebLandEvent`, `SwitcherBallEvent`, `BlinderBallEvent`, `BoneUseEvent`, `FakePearlUseEvent` and `OrbUseEvent`.

`ToolUseEvent` covers custom ability items and the seven new standalone items. It is cancellable and exposes the player, item ID and an optional affected player through `getPlayer()`, `getToolId()` and `getTarget()`. The target may be null; standalone item IDs use the `default:` prefix.