⚔️ 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)
- Download
SpearOverhaul.jar - Drop it into
/plugins - Restart your server
- (Optional) Install Vault for economy features
- (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 controlspearoverhaul.craft.*— Craft all tiersspearoverhaul.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
