UltimatePVP

Ultimate PVP, the perfect plugin for any PVP project.

---

📑 Table of Contents

• ✨ Features
• 🪦 Graves / GraveStonesPlus
• ⚔️ Combat & PvP System
• ⚔️ Duel System
• ✨ Glow System
• 💙 Hearts HUD & Linked Hearts
• 🪞 Nametag Management
• 🛠️ Installation
• 📜 License
• 📬 Contact

---

✨ Features

• ❤️ Lives System

  • Players start with a configurable number of lives (startingLives)
  • Maximum lives also configurable (maxLives)

• 💞 Linked Hearts

  • Can be enabled via config (linkedheart.enabled)
  • Links players' lives for shared survival

• 🩺 Revive GUI

  • Revive players via GUI
  • Works with Linked Hearts (configurable via linkedheart.enabled)

• 👻 Spectator Bypass & Listener

  • Spectators can fly, be invisible & interact
  • Can be enabled/disabled server-side

• 🧭 Teleportation

  • Configurable radius (randomTeleport.radius)

• 🧭 Teleporter Listener

  • Interactive teleporters & Hotbar GUI (LinkedHeart-Spectator)

• ⚔️ Combat Manager

  • Tracks combat status, duels & dummy players
  • Configurable: Enderpearls per combat (max-enderpearls-per-combat)
  • Configurable: Cobweb limit per player (max-cobwebs-per-combat)

• ✨ Glow Effect

  • Can be enabled via config (glowing)
  • Duration & interval configurable (glow-duration-seconds, glow-interval-minutes)
  • Option: Lose heart on logout (glow-lose-heart-on-logout)

• ❌ Blocker / Exploit Prevention

  • Multiple options in the config to prevent exploits

• 🧩 PluginHub

  • PluginHUB support

• 📝 Discord Integration & Logger

  • Logs kills & admin events via webhooks (discord-link)

• 👫 Carry Mechanic

  • Carry players, mobs, or blocks

• 🤖 FancyNPC Integration

  • Supports logout dummies

• 🌐 SkinFetcher

  • Loads & caches player skins from Mojang

• 🪦 Dummy & Offline Player Support

  • Logout dummies, damage handling, heart integration
  • Mini heart bar above NPC names

• 🪆 Dummy Manager

  • Spawns, armor protection, sound effects, auto removal
  • Heart integration and Linked Hearts supported

• 🍂 InstaLeafDecay

  • Can be enabled via config (InstaLeafDecay.enabled)

• 🗡️ Combat Restrictions

  • Limited Enderpearls (max-enderpearls-per-combat)
  • PvP can be enabled/disabled server-side
  • Cobweb management (max-cobwebs-per-combat)
  • Commands restricted during combat except for bypass players

• 🛡️ Armor Lock

  • Can be enabled via config (armorlock.enabled)
  • Duration configurable (armorlock.duration_seconds)
  • Reminder intervals configurable (armorlock.reminders_seconds)
  • One free slot swap, cooldown applies after

• 🪞 Nametag Management

  • Can be enabled via config (nametags.enabled)

• 🧵 Keep Inventory Customization

  • Percentage of items retained on death configurable:
    • In combat (keepInventoryPercentageCombat)
    • Normally (keepInventoryPercentageNatural)

• 🖥️ Quit & Spawn Listener

  • Logout penalties, random spawning for new players

• 📝 Player Join Notices

  • Info about ArmorLock & recommended modifications

• 📦 Data Stores

  • Persistent storage for lives, Linked Hearts & duels

• 🎨 Texture Pack Force

  • Can be enabled via config (texturepack.force-on-join)
  • Default pack & port configurable (texturepack.default-pack, texturepack.port)

• ⛔ Ban Utilities

  • Checks & unbans players

• 💙 Hearts HUD

  • Displays lives & Linked Hearts
  • Icons & bars configurable (hearts.use_font_glyphs, hearts.bar_0–bar_3, hearts.linked_icon)

• 💬 Message Utilities

  • Sends messages with plugin prefix & colored components

• 🎨 Texture Glyphs

  • Customizable heart & LinkedHeart icons

• 📝 TabComplete Utilities

  • Supports command completion in-game

---

🪦 Graves / GraveStonesPlus

Download: GraveStonesPlus

Essential Settings:

• PercentageDrops: 100
• keepInventoryPercentageCombat: 0.5
• keepInventoryPercentageNatural: 0.0

Optimal Settings:

• GlowingEffectNearGrave: false
• GraveTimeLimit: -1
• DisableArmorStands: true
• GiveCompassOnRespawn: false
• KeepAllExp: true

---

config.yml

# ==== Nametags ====
nametags:
  enabled: true

# ==== Herzen / Gameplay ====
startingLives: 3
maxLives: 3

hearts:
  use_font_glyphs: true
  bar_0: 
  bar_1: 
  bar_2: 
  bar_3: 
  linked_icon: 

# ==== LinkedHeart ====
linkedheart:
  enabled: true

# ==== ArmorLock ====
armorlock:
  enabled: true
  duration_seconds: 600
  reminders_seconds:
    - 300
    - 180
  minutes: 10

# ==== Random Teleport ====
randomTeleport:
  radius: 5000

# ==== Texturepack ====
texturepack:
  force-on-join: true
  default-pack: "texturepack.zip"
  port: 8080

# ==== InstaLeafDecay ====
InstaLeafDecay:
  enabled: true

# ==== Keep Inventory ====
keepInventoryPercentageCombat: 0.5
keepInventoryPercentageNatural: 0.0

# ==== Glowing ====
glowing: true
glow-interval-minutes: 20
glow-duration-seconds: 60
glow-lose-heart-on-logout: true

# ==== Gombat Usage ====
max-cobwebs-per-combat: 64
max-enderpearls-per-combat: 32

# ==== Links ====
discord-link: "https://discord.gg/deinserver"

# ==== Blocker ====
noopgap: true
nonether: true
Nototems: true
fireworkplacementallowed: false
nonetherite: true
fireworkCrossbowEnabled: false
allow-punch: false
allow-mending: false
villagerTradingEnabled: false

---

🛠️ Installation

1. Place MinecraftHelden.jar in the plugins folder
2. Start the server, plugin initializes automatically
3. Use commands in-game
4. Optional: Extend with external plugins (FancyNPC, InstaLeafDecay, Carry)
5. Configure texture pack & optionally start TexturePackForce

---

📜 License

Copyright (c) 2025 Jannik Scholl

• Usage on servers with 10+ players must be agreed upon
• Old versions not allowed
• Public server use without permission prohibited

---

📬 Contact

• Discord (fastest response): Discord
• Email: [email protected]

---

Thank you for trying Ultimate PVP ! Enjoy playing & contributing.