# Only-Spear SMP
**One weapon. Thirteen tiers. Every kill makes it stronger.**
You spawn with a Wooden Spear. It is the only weapon you will ever need, because it is the only one
you get to keep — and every kill upgrades it, automatically, all the way to the **GOD Spear**.
Built for SMP servers where the whole season runs on a single weapon.
---
## How it works
Kill something with your spear and it upgrades on the spot. No crafting, no anvils, no grinding for
materials — the spear you are holding becomes the next one in the ladder, fully enchanted, and the
server sees who climbed.
Every spear carries **Curse of Vanishing**. You drop it on death and it is gone — but the mod hands
you your tier's spear back when you respawn, so you never lose progress to a bad fall. By default,
dying knocks you back down to the Wooden Spear. Turn that off in the config if your server prefers
a gentler season.
---
## The ladder
| Tier | Spear | | Tier | Spear |
|---|---|---|---|---|
| 1 | Wooden | | 8 | Iron |
| 2 | Stone | | 9 | **Redstone** |
| 3 | **Coal** | | 10 | Diamond |
| 4 | Copper | | 11 | **Emerald** |
| 5 | **Quartz** | | 12 | **Amethyst** |
| 6 | Golden | | 13 | **GOD** |
| 7 | **Lapis** | | | |
Minecraft 1.21.11 ships spears and the Lunge enchantment already, so this mod reuses the vanilla
wooden, stone, copper, golden, iron and diamond spears and adds the **seven that are missing** —
in bold above. Each new spear keeps vanilla's wooden shaft and changes only the head colour, so
they sit alongside the vanilla ones without looking bolted on. The GOD Spear is rainbow end to end,
and its name is rendered a letter at a time in every colour.
---
## Reading a spear
```
COPPER SPEAR
Curse of Vanishing
Lunge II
Sharpness III
Haste I
Speed I
SPECIAL ABILITIES
► Lightning-on-hit (10%)
```
Every spear shows the **same five enchantments** and only the levels climb. Everything else lives in
its own gold block, so a tier 13 spear is still something you can read at a glance instead of twenty
lines of roman numerals.
No tier carries more than five enchantments or five abilities. That limit is enforced by a check
that runs on every build.
---
## Enchantments
**Haste** and **Speed** are added by the mod and applied with a **genuinely infinite duration** —
your HUD shows the infinity symbol, not a countdown, and nothing is re-applied on a timer. The mod
only ever removes the effect it put there itself, so a beacon or an `/effect` command of your own is
left alone.
`Curse of Vanishing`, `Sharpness` and `Lunge` are vanilla.
## Special abilities
Four abilities run through the whole ladder and grow as you climb:
| Ability | What it does |
|---|---|
| **Lightning-on-hit** | 10% at Copper, rising to a guaranteed strike on the GOD Spear |
| **Light-foot** | No fall damage, at all |
| **Longreach** | Up to three extra blocks of attack range |
| **Life steal** | Heals you on every hit |
The fifth slot is that tier's **signature**, and it is *replaced* as you climb rather than piling up:
- **Chill** — slows whatever you hit *(Lapis, Iron)*
- **Shockwave** — throws every mob near your target into the air *(Redstone)*
- **Execute** — instantly finishes anything already below 12% health *(Diamond)*
- **Soul harvest** — speed and strength for five seconds on a kill *(Emerald)*
- **Bleed** — leaves the target withering *(Amethyst)*
- **Divine wrath** — an explosion on every hit that never touches the terrain *(GOD)*
---
## Server controls
| Command | Permission | What it does |
|---|---|---|
| `/onlyspear info` | everyone | Your tier and how many kills to the next one |
| `/onlyspear mode` | everyone | What currently counts as a kill |
| `/onlyspear mode players` | OP | **Only player kills** upgrade the spear |
| `/onlyspear mode mobs` | OP | **Only mob kills** upgrade the spear |
| `/onlyspear mode both` | OP | Both count (default) |
| `/onlyspear tier <player> <1-13>` | OP | Drop a player onto any tier |
| `/onlyspear reset <player>` | OP | Send them back to the Wooden Spear |
`mode` writes straight to the config, so the choice survives a restart. Run it PvP-only for a
hardcore season, or mob-only if you want a cooperative run.
Everything else lives in `config/onlyspear.json`: kills per upgrade, whether the killing blow has to
come from the spear, unbreakable spears, whether dying resets your tier, and more. Per-player
progress is stored in your world folder as plain JSON, so it is easy to inspect or edit.
---
## Details that matter on a server
- **Spears you craft yourself are safe.** The mod tags the spears it issues and only ever touches
those, so a spear you made at a crafting table is a normal item and will not be deleted.
- **Death messages name the weapon** — *"Steve was speared by Alex using AMETHYST SPEAR"*.
- **Nothing touches your max health.** An ability that raises the health bar has to lower it again
when the weapon leaves your hands, and health above the new maximum is lost — so it would quietly
drain hearts every time you swapped item. Longreach fills that slot instead.
- A creative tab, **Only-Spear SMP**, holds all thirteen spears in order.
---
## Requirements
- **Minecraft 1.21.11**
- **Fabric Loader** 0.19.3+
- **Fabric API**
Required on both the server and the client.
---
*Not affiliated with Mojang or Microsoft.*
The Only-Spear Mod Team
