(https://img.shields.io/badge/Paper-1.21.11-blue.svg)](https://papermc.io) (https://img.shields.io/badge/Spigot-1.21.11-orange.svg)](https://www.spigotmc.org) (https://img.shields.io/badge/Purpur-1.21.11-purple.svg)](https://purpurmc.org) (https://img.shields.io/badge/Bukkit-1.21.11-red.svg)](https://bukkit.org) (https://img.shields.io/badge/Folia-1.21.11-green.svg)](https://papermc.io/downloads/folia) (https://img.shields.io/badge/License-All%20Rights%20Reserved-red.svg)](#) (https://img.shields.io/badge/Java-21+-red.svg)](https://adoptium.net/) <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 **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: ```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 - ✅ **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 (https://www.spigotmc.org/resources/vault.34315/) for economy features 5. **(Optional)** Install (https://www.spigotmc.org/resources/placeholderapi.6245/) 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 ` | 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: ``` 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? **SpearOverhaul** 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> Minecr