Item Collector

A Pokedex for Hytale items. Track every item you discover, browse a full collection grid, favorite your best finds, and work toward 100% completion. "New Item Found!" notifications let you know the moment you pick up something new.

Features

Collection GUI

Full collection page — browse every item in the game in a paginated grid
Discovered items show their icon and name; undiscovered items appear as locked placeholders
3 Tabs: All Items, Favorites, and Recent Discoveries
Search by item name or number (e.g. "wild" finds Wild Berries, "12" finds all #12xx items)
Sort alphabetically, by discovery date (newest/oldest toggle), or by category
Favorites — click the star on any discovered item to favorite it (gold star = favorited, gray star = not favorited)
Tooltips — hover over any item for rarity, categories, and description
Progress header shows your discovery count and percentage (e.g. "2/3173 Discovered (0.06%)")
Sort preferences saved per player
Item cells highlight on hover/press
UI sound feedback when toggling favorites

Discovery Notifications

"New Item Found!" notifications for first-time item discoveries
World-based tracking (each world has separate discovery history)
Instant notifications with star icon
No duplicate notifications (vanilla handles regular pickups)

Milestones

Earn milestone notifications as you discover more items:

10 — Explorer
25 — Collector
50 — Enthusiast
100 — Connoisseur
150 — Archivist
200 — Scholar
300 — Master Collector
400 — Legendary
100% — COMPLETIONIST

Requirements

Java 21 or 25
Hytale Early Access

Installation

Download ItemCollector-1.0.0.jar from the Files tab
Put the JAR in %AppData%\Roaming\Hytale\UserData\Mods\
Copy the ItemCollector/ asset folder into the same Mods\ directory
Start server and join game
Pick up any item — if it's your first time with that item in this world, you'll see "New Item Found!"
Use /collect to open the collection page

Usage

Discovery notifications appear automatically when you pick up an item for the first time. No setup needed.

Use /collect to open the collection page whenever you want to browse your progress.

Commands

/collect — Open the Item Collector (All Items tab)
/collect favorites or /collect fav — Open the Favorites tab
/collect recent — Open the Recent Discoveries tab
/collect stats — Show discovery stats in chat
/collect help — Show command usage
/newitem — Show plugin info
/newitem reset — Clear all discovered items for current world (creates backup)

Configuration

Settings are saved per-world in: %AppData%\Roaming\Hytale\UserData\Saves\[WORLD_NAME]\mods\BeyondSmash_NewItemIndicator\config.json

Collection data (favorites, sort preferences) is saved per-player alongside the config.

How It Works

New Discoveries: When you pick up an item for the first time in a world:

Shows "New Item Found!" notification with star icon
Displays the item's name in bright gray text
Saves to discovery history
Records a timestamp for chronological sorting in the collection GUI
Future pickups of the same item show vanilla notifications only

World-Based System:

Each world tracks discovered items separately
Creative world discoveries ≠ Adventure world discoveries
Discovery history persists across game sessions

Collection GUI:

Browse all items in the game — discovered items show icons, undiscovered are locked
Search by name, ID, or item number
Sort by A-Z, newest/oldest, or category
Star your favorites for quick access
Hover for rich tooltips with rarity, categories, and description
Active tabs and sort buttons highlighted with colored underline

Notification Display:

Location: Lower-right corner of screen
Icon: White star
Primary text: "New Item Found!" (gold color)
Secondary text: Item name (bright gray)
Duration: 4 seconds

Backup System

The /newitem reset command creates automatic backups before clearing your discovered items:

Backups stored in: %AppData%\Roaming\Hytale\UserData\Saves\[WORLD_NAME]\mods\BeyondSmash_NewItemIndicator\backups\
Keeps last 3 backups automatically (deletes older ones)
Backup naming format: config_YYYY-MM-DD_HH-mm-ss.json
Only affects the current world (other worlds are unaffected)

Example backup:

config_2026-01-30_14-23-45.json

Troubleshooting

Notification doesn't show up

Make sure you haven't discovered this item before in this world
Check that vanilla item pickup notifications are working
Try /testnewitemindicator to verify notifications work

Collection GUI doesn't open

Make sure the ItemCollector/ asset folder is in your Mods\ directory
Check server logs for errors

Want to test without losing progress?

Use /testnewitemindicator instead of /newitem reset
Backups are in the backups\ folder if you accidentally reset

Where's my config file? %AppData%\Roaming\Hytale\UserData\Saves\[WORLD_NAME]\mods\BeyondSmash_NewItemIndicator\config.json

(Replace [WORLD_NAME] with your actual world name)

Can I manually edit discovered items? Yes, edit the config.json while the game is closed. Each world has a UUID key with an array of discovered item IDs.

Version History

v2.0.0 — Item Collector

Rebranded from New Item Indicator to Item Collector
Added collection GUI — full grid page with search, sort, favorites, and tooltips
Added /collect command with tabs: All Items, Favorites, Recent
Added /collect stats and /collect help
Added milestone notifications (Explorer, Collector, Enthusiast, etc.)
Added favorite system with star icons and sound feedback
Added rich item tooltips with rarity, categories, and description
Added progress tracking header with percentage
Item cells highlight on hover/press

v1.0.1

Added ServerVersion to manifest for Update 3 compatibility

v1.0.0

Initial release
First-time item discovery notifications
World-based tracking system
Backup system for reset command
Star icon with gold "New Item Found!" text
Item name display in bright gray
Commands: /newitem, /newitem reset

Author

BeyondSmash

New Item Collector