VkSpearSmp

# 🗡️ VkSpearSmp **VkSpearSmp** is a fully featured PvP progression plugin built around Minecraft’s modern spear combat system, designed specifically for **Paper servers running 1.21.11 and newer**. The plugin replaces traditional weapon progression with a **skill-based, kill-driven spear system**, encouraging fast-paced combat, player movement mastery, and fair progression. Instead of crafting stronger weapons, players must **earn their power through combat**. Every player starts with a basic wooden spear, and only valid spear kills count toward progression. As players secure kills, their spear becomes stronger, gains enchantments automatically, and eventually upgrades into higher tiers — all without manual crafting or repairs. ## 🔥 Core Gameplay Mechanics VkSpearSmp introduces a **kill-based upgrade system** where each confirmed spear kill increases the spear’s effectiveness. Every kill adds sharpness to the spear (up to a configurable limit), and once the required number of kills is reached, the spear upgrades to the next tier: **Wooden → Stone → Iron → Diamond → Netherite** When a spear upgrades: * The kill counter resets cleanly * Sharpness resets for balanced progression * The spear transforms into its new tier automatically * Upgrade particle effects are played for visual feedback Higher tiers unlock additional mechanics, such as **Lunge enchantments**, making combat more aggressive and rewarding for skilled players. ## ⚔️ Advanced Spear Combat Combat in VkSpearSmp is designed to feel **powerful and momentum-based**. Spear damage scales with player speed, meaning faster movement results in higher damage. This rewards smart positioning, sprinting, and timing rather than simple click-spamming. Server owners can optionally enable **high-impact or one-shot potential**, making spear combat deadly when executed correctly, while still remaining configurable and balanced. All spears are: * **Unbreakable** * **Non-craftable** * **Non-enchantable by players** * Automatically enchanted only through progression This ensures full control over balance and prevents exploits. ## 📊 Player Progression & Stats Each player has their own spear progression and statistics. Kills are only counted if the final blow was delivered using a spear, ensuring fair and accurate tracking. Admins can view, reset, or modify player progress using built-in commands. The system is designed to be: * Per-player * Persistent * Exploit-resistant ## 🛠️ Admin Control & Configuration VkSpearSmp includes a complete set of **permission-based admin commands**, allowing server staff to manage spears and progression easily: * `/spear help` – View all available commands * `/spear give <player> <tier> ` – Give a spear of any tier * `/spear reset <player>` – Reset a player’s spear * `/spear stats <player>` – View player spear stats * `/spear reload` – Reload the configuration Everything is **fully configurable via `config.yml`**, including: * Kill requirements per tier * Damage scaling * One-shot behavior * Upgrade effects * Enchantment levels * Permissions ## 🧩 Compatibility & Performance * **Minecraft Version:** 1.21.11+ * **Server Software:** Paper * **Performance:** Lightweight and optimized * **No external dependencies** VkSpearSmp is designed to be stable, efficient, and suitable for long-running SMP servers without impacting performance. ## 🎯 Ideal Use Cases VkSpearSmp is perfect for: * Competitive SMP servers * PvP-focused survival worlds * Custom progression game modes * Events, challenges, and tournaments * Servers looking for fresh combat mechanics