🏆 Rare Items Hunter

Track the rarest items and events in Minecraft — with GUI, fireworks and global announcements.
Inspired by BastiGHG's rare item videos.

---

📸 Screenshots

!GUI Overview

!Item Lore & Found

!Chat Messages

---

✨ What does it do?

RareItemsHunter adds a collection tracker for the most unlikely things to happen in Minecraft. Players open the GUI with /ri, click the glass pane above or below an item to confirm they found it, and unlock a fireworks celebration with a personal timestamp.

When someone collects all 30+ items, a global server announcement fires and five simultaneous fireworks light up the sky.

---

🎯 Key Features

• 30+ built-in rare items & events
• Interactive GUI — glass panes above/below items to click and confirm finds
• Per-item timestamps — each find is saved with the exact date and time
• Progress bar — turns orange when you reach 100%
• Global chat announce — only fires when a player collects all items
• Localization — German (de) and English (en) out of the box, fully editable
• Custom items via config — extend the list without touching the source code

---

🎮 Commands

Command	Permission
/ri	rih.use
/ri help	rih.use
/ri reset <player>	rih.admin
/ri reload	rih.admin
/ri give <player> <id>	rih.admin

---

⚙️ Config example

language: de          # de | en
firework-power: 1
gui-title: "&8» &6&lSeltene Items &8«"
announce-find: true

custom-items:
  - id: "my_rare_block"
    material: "SPONGE"
    name: "&e&lMy Rare Block"
    chance: "~0.1 %"
    description: "Found in a special location"
    rarity: 34
    occurrence-only: false

---

🛠️ Requirements

• Paper 1.21.4+
• Java 21+

---

📁 Source Code

github.com/Zyvera-Systems/RareItemsHunter

---