Spear Overhaul

Paper

Spigot

Purpur

Bukkit

Folia

Java 21+

<h1 align="center">⚔️ SpearOverhaul</h1> <p align="center"> <b>The Ultimate Spear Weapon System for Competitive Minecraft Servers</b><br/> <i>Armor Penetration • Extended Reach • Scarcity Economy • Zero Lag</i> </p>

---

🔥 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 20% armor bypass. 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 Zero performance impact over swords and axes: - Uses native Zero performance impact (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 | |------|-------------| | 7 legendary weapons | Unlimited crafting. Standard vanilla rules. | | 7 legendary weapons | 🔥 Only 7 legendary weapons can exist on the entire server. Ever. | | 7 legendary weapons | 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: ```yaml 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

- ✅ Spigot (Recommended) - ✅ Spigot - ✅ Spigot (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. (Optional) `SpearOverhaul.jar` 2. (Optional) it into `/plugins` 3. (Optional) your server 4. (Optional) Install (Optional) for economy features 5. (Optional) Install %%MD1%% 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

```yaml

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?

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

<p align="center"> <b>Author:</b> AlantheDevv<br/> <b>Version:</b> 1.0 | <b>API:</b> Minecraft 1.21+<br/> <b>Support:</b> <a href="https://github.com/AlantheDevv">GitHub Issues</a> </p>