⚔️ SpearOverhaul

The Ultimate Spear Weapon System for Competitive Minecraft Servers
Armor Penetration • Extended Reach • Scarcity Economy • Zero Lag

---

🔥 Overview

Tired of boring vanilla combat? Your players deserve more.

SpearOverhaul transforms the humble spear into a tactical, skill-based weapon that rewards positioning and timing. Outrange your opponents. Pierce through Netherite armor. Dominate the battlefield.

"This plugin single-handedly revived our SMP's PvP scene." — Server Admin

---

⚡ Features That Set You Apart

🛡️ Armor Penetration

Spears are the ultimate tank busters. Configure how much armor your spears ignore:

• Default: 20% armor bypass = True damage that melts tanks
• Fully configurable in config.yml

🗡️ Extended Reach (+1.5 Blocks)

Win every trade. Spears give you a massive range advantage over swords and axes:

• Uses native Minecraft 1.21 Attributes (PLAYER_ENTITY_INTERACTION_RANGE)
• Zero performance impact — no hacky or fake entities

🏆 Scarcity Economy (Game-Changing)

Create legendary, one-of-a-kind weapons that players will fight wars over:

Mode	Description
NONE	Unlimited crafting. Standard vanilla rules.
SINGLE	🔥 Only ONE SPEAR can exist on the entire server. Ever.
PER_TIER	One spear per tier = 7 legendary weapons maximum.

Imagine the chaos when someone crafts the Diamond Spear first.

💰 Vault Economy Integration

Charge players to craft. Make Netherite Spears cost $5,000 in-game currency:

attributes:
  netherite:
    attack-damage: 7.0
    crafting-cost: 5000.0  # Players PAY to craft

📊 PlaceholderAPI Leaderboards

Track everything. Display it on scoreboards, holograms, or NPCs:

• %spearoverhaul_kills_total% — Player's total spear kills
• %spearoverhaul_top_kills_total% — Server's #1 spear assassin
• %spearoverhaul_crafted_diamond% — Has the Diamond Spear been claimed?

🖥️ Multi-Platform Support

• ✅ Paper (Recommended)
• ✅ Purpur
• ✅ Folia (Native async support)
• ✅ Spigot (Degraded mode)

---

📦 What's Included

Feature	Status
7 Spear Tiers (Wood → Netherite)	✅
Custom Shaped Recipes	✅
Armor Penetration Mechanic	✅
Extended Reach Attribute	✅
Scarcity Modes (SINGLE / PER_TIER)	✅
Vault Economy Costs	✅
PlaceholderAPI Integration	✅
MiniMessage RGB Messages	✅
Folia Thread-Safe	✅
Auto-Save Statistics	✅
MemoryGuard Protection	✅
Lightweight YAML Storage	✅

---

🚀 Quick Start (2 Minutes)

1. Download SpearOverhaul.jar
2. Drop it into /plugins
3. Restart your server
4. (Optional) Install Vault for economy features
5. (Optional) Install PlaceholderAPI for leaderboards

That's it. Zero configuration required to start.

---

🎮 Commands & Permissions

Command	Description
/spear reload	Reload config without restart
/spear status	View current mode and crafted spears
/spear reset <tier|all>	Reset crafting locks
/spear stats [player]	View kill/craft statistics

Permissions:

• spearoverhaul.admin — Full control
• spearoverhaul.craft.* — Craft all tiers
• spearoverhaul.bypass.limit — Ignore scarcity restrictions (for admins)

---

💬 Server Broadcasts

When someone crafts a legendary spear, the entire server will know:

[Server] The first Diamond Spear has been crafted by Steve!

Fully customizable with MiniMessage gradients and RGB colors.

---

📈 Config Preview

# Scarcity Mode: NONE, SINGLE, or PER_TIER
mode: PER_TIER

# Armor Penetration (20% bypass)
mechanics:
  armor-penetration:
    enabled: true
    percent: 0.2

# Economy Costs (Vault)
attributes:
  diamond:
    attack-damage: 6.0
    crafting-cost: 2000.0

---

🛒 Ready to Transform Your Server?

SpearOverhaul isn't just a plugin — it's a complete weapon overhaul that your players will love.

Author: AlantheDevv
Version: 1.0 | API: Minecraft 1.21+
Support: GitHub Issues