# Gemstone Arsenal — The Ultimate Gem Experience 💎
**The most massive gemstone & mineral mod for Minecraft 1.20.1!**
---
## ⛏️ What's Inside
### 200+ Unique Gemstones & Metals
From common Howlite and Chalk to legendary Mithril, Celestium, and mythic Cosmicite — each gem comes with a **complete equipment set**:
- ⚔️ **Full Tool Sets** — Sword, Pickaxe, Axe, Shovel, Hoe
- 🛡️ **Full Armor Sets** — Helmet, Chestplate, Leggings, Boots
- 🏹 **Ranged Weapons** — Bow, Crossbow
- 🛡️ **Shield & Horse Armor**
- 🔱 **Tridents** — 22 rare gem tridents with unique stats
### 🪨 900+ Ore Variants
Every gem spawns in **9 stone types**: Stone, Deepslate, Andesite, Calcite, Diorite, Granite, Tuff, Netherrack, and End Stone. Find ores everywhere you explore!
### 🔥 Gem Forge
A custom smelting block for processing your gems. Craft it with 8 Obsidian + 1 Diamond.
### 🏛️ World Structures
- **Ancient Forge** — Contains rare gem loot
- **Crystal Temple** — Epic treasures inside
- **Gem Mine** — Ore-rich underground structures (9 variants!)
- **Mithril Tower** — Legendary rewards await
### ⚡ Speed Ore (NEW!)
A special cyan ore that grants **Speed** when wearing the full armor set:
- 1 piece → Speed I
- 3 pieces → Speed II
- Full set → Speed III + Haste I
The Speed Pickaxe has **15.0 mining speed** — the fastest in the mod!
---
## 🏆 Tier System (6 Tiers)
| Tier | Rarity | Examples |
|------|--------|----------|
| **Tier 1** | Common | Howlite, Chalk, Flint, Pumice |
| **Tier 2** | Uncommon | Citrine, Amber, Fluorite, Peridot |
| **Tier 3** | Rare | Ruby, Sapphire, Garnet, Jade, Opal |
| **Tier 4** | Epic | Titanium, Platinum, Bismuth, Cobalt |
| **Tier 5** | Legendary | Mithril, Celestium, Draconium, Soul Crystal |
| **Tier 6** | Mythic | Cosmicite, Eternium, Divinium, Voidium |
Higher tiers = more damage, durability, mining speed, and armor protection.
---
## 🎨 Features
- **Custom Main Menu** — Animated gem-themed title screen with floating particles, color-shifting title, and cosmic background
- **In-Game Guidebook** — 120-page interactive book accessible from the main menu. Covers every gem, tier, crafting recipe, structure, and mechanic in the mod
- **Hand-crafted Textures** — Every block and item has detailed, Minecraft-style pixel art with proper ore clusters, gem facets, lamp glow effects, and pillar patterns
- **Balanced Worldgen** — 56 ores spawn underground in 3 tiers: Common (8 vein, 6/chunk), Uncommon (5 vein, 3/chunk), Rare (3 vein, 1/chunk)
- **3 Languages** — English, Ukrainian, and more
- **Sound Effects** — All blocks have proper sounds (stone, crystal, metal)
- **Full Recipe Support** — Crafting, smelting, and block↔gem conversion for everything
---
## 📊 By the Numbers
- **4,700+ blocks** (ores, gem blocks, lamps, pillars, stairs, slabs, walls)
- **2,900+ items** (gems, ingots, tools, armor, weapons, shields, tridents)
- **900+ ore variants** across 9 stone types
- **56 underground ore veins** with balanced spawn rates
- **536+ crafting recipes**
- **120-page guidebook**
- **265 sound events**
---
## 📋 Requirements
- Minecraft **1.20.1**
- Forge **47.2.0+**
- Java **17**
---
## 👥 Credits
Created by **MEMANKZIK** & **KRYZHYK** 🧊
Made with ❤️ in Ukraine 🇺🇦
---
*Gemstone Arsenal — because diamonds are just the beginning.*
