🗡️ 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