# 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.*