️ 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> [kills]` – 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