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

1. Download ItemCollector-1.0.0.jar from the Files tab
2. Put the JAR in %AppData%\Roaming\Hytale\UserData\Mods\
3. Copy the ItemCollector/ asset folder into the same Mods\ directory
4. Start server and join game
5. Pick up any item — if it's your first time with that item in this world, you'll see "New Item Found!"
6. 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