Custom PVP Items
Custom PvP items plugin with abilities and full configuration!
44
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
Custom PVP Items
⚔️ CustomItems-PVP-Plugin
Custom Minecraft plugin for creating custom PvP items with abilities, effects, and configurable systems.
---
✨ Features
* 🧪 Fully configurable custom items * ⚡ Ability system (on hit, right click, etc.) * 🎯 Custom effects, sounds and behaviors * 📦 Easy-to-edit config * 🛠️ Lightweight and performance-focused
📜 Full items list
* 🪶 DashBlade --> Iron sword with a dash ability upon right clicking * ❄️ FrostBlade --> Diamond sword that freezes enemies for a time on hit after its ability has been activated via right clicking * 🔥 RageBlade --> Netherite sword with a rage ability activated via right clicking. Gives the player strenght 2 and makes all hits critical hits * 🔨 DashMace --> A mace with a dash ability upon right clicking * 🔨 SpiderMace --> A mace that has a % chance to web the opponent on hit * 🪓 VoidAxe --> A netherite axe that curses enemies with darkness, slowness and blindness on hit after its ability has been activated via right clicking * 🔱 SkyPiercer --> A trident that when thrown dashes the player throu the path of the throw dealing damage to all enemies in a certian range * 🥚 MagicSwapper --> An egg that swaps the places of 2 players when one of them hits another with it
! Note / All of the cooldowns, durations and damage amounts can be edited in the config.yml
---
⚙️ Installation
1. Download the latest `.jar` from releases 2. Place it into your `/plugins` folder 3. Start or restart your server 4. Edit the config file generated in `/plugins/CustomItems/` 5. Reload or restart the server
---
📄 Configuration Example
```yaml id="lq6v8c" dashblade: name: "&f&l🪶 Swiftwind Blade" cooldown-seconds: 15 speed: 3.5 trail-count: 25 ```
📄 Full config.yml
```yaml items: frostblade: name: "&b&l❄ Frostbound Blade" cooldown-seconds: 25 freeze-seconds: 5
rageblade: name: "&4&l⚔ Crimson Rageblade" duration-seconds: 10 cooldown-seconds: 25
dashblade: name: "&f&l🪶 Swiftwind Blade" cooldown-seconds: 15 speed: 3.5 trail-count: 25
dashmace: name: "&f&l🔨 Dash Mace" cooldown-seconds: 15 speed: 3.2 trail-count: 18
voidaxe: name: "&8&l🌙 Void Axe" duration-seconds: 10 cooldown-seconds: 20
spidermace: name: "&7&l🕷 &7&lS&8&lp&f&li&7&ld&8&le&f&lr &f&lM&7&la&8&lc&f&le" web-chance-percent: 50
skypiercer: name: "&b&l☁ Sky &3&lPiercer 🗡" limit-blocks: 8 raw-damage: 9.0 radius: 2.0 cooldown-seconds: 25
magicswapper: name: "&9&l🔮 Magic Swapper" cooldown-seconds: 3 ```
---
🎮 Commands
* `/customitem <item>` — Recive a custom item * `/ci <item>` — Recive a custom item
Items listed below
* `frostblade` * `rageblade` * `dashblade` * `dashmace` * `voidaxe` * `spidermace` * `skypiercer` * `magicswapper`
---
🔐 Permissions
* `customitem.use` ---> Allows players to use the command /customitem or /ci
Individual permissions for each custom item below
* `frost.give` * `rage.give` * `swiftwind.give` * `dashmace.give` * `void.give` * `spider.give` * `skypiercer.give` * `swapper.give`
*! Note / A player needs both the command permission and the item permission to be able to recive it via commands.*
---
💡 Notes
* Designed for Paper servers * Works best for you with a properly configured config * Performance optimized for real server environments
---
💬 Support / Contact
Need help or a custom plugin?
👉 Discord: https://discord.com/users/876238056275984435 Or add: `qd_ducky`
---
⭐ Support
If you like this project, consider starring the repository — it helps a lot!
---
📜 License
This project is licensed under the MIT License.
