R3CT Collector 📖✨

The ultimate completionist and collection mod for Minecraft! R3CT Collector automatically scans all items in your game (including those from other mods) and generates a beautifully categorized interactive Catalog. Gather items, earn XP, claim milestone rewards, and compete with other players on your server! Built for both Fabric and NeoForge!

✨ Features

📖 Dynamic Catalog System: * The mod automatically scans Creative Tabs to generate categories. It adapts perfectly to any modpack, no matter how big!
- Submit items you find in the world to unlock them in your personal Catalog.
- Check your progress with visually pleasing progress bars and dynamic percentage colors.

🎁 Progression & Rewards: * Earn Experience Points for every unique item you submit! The XP amount scales with the item's vanilla rarity (Common, Uncommon, Rare, Epic).
- Milestone Loot: Receive random configurable loot boxes every X items you collect.
- 100% Completion: Finish an entire category to receive a special reward!

🏆 Integrated Server Leaderboard: * Compete with your friends! The Catalog features a built-in "Top 10" Leaderboard.
- Hover over a player's head in the leaderboard to inspect their exact completion percentage for every category.

🔄 Cross-Platform: * Fully native support and identical features for both Fabric and NeoForge.

🔌 Dependencies & Requirements

To run this mod, you will need to install a few library mods depending on your loader:

For Fabric:

Fabric API (Required)
Mod Menu (Optional - to access in-game client settings)

For NeoForge:

Nothing!

📖 Documentation

For detailed guides on how to configure blacklists, adjust rewards, and tweak the mod's mechanics, visit our official Wiki: 👉 View the Wiki

<details> <summary>Click to see popular topics 💡</summary>

</details>

⚙️ Configuration & Customization

The mod is highly customizable! There are two ways to configure it:

1. In-Game Settings (Client-side)

Players can access the mod settings via Mod Menu (on Fabric) or the Mods tab (on NeoForge). Here, users can:

Adjust the GUI scale of the Catalog Book to perfectly fit their screen resolution.

2. File Configuration (Server-side / Modpack Creators)

All core mechanics, loot pools, and blacklists can be completely rewritten. After running the mod once, navigate to the config/r3ct_collector/ folder:

r3ct_collector_items.json - Manage blacklists. Exclude specific mods, creative tabs, or individual items from being scanned.
r3ct_collector_rewards.json - Tweak the XP granted for item rarities, customize the milestone intervals, and set up specific loot pools and category completion rewards.
r3ct_collector_client.json - Client-side settings (GUI Scale).

Note: The mod features an auto-migration system. If the config format updates in future versions, your old config will be safely backed up!

📥 Installation

Download the latest release from the Versions tab.
Download the required dependencies listed above for your specific mod loader.
Place all .jar files into your Minecraft mods folder.
Press K (default keybind) in-game to open your Catalog and start collecting!

📦 Check out my other mods!

If you enjoy this mod, you might also like my other projects:

🎯 R3CT Daily Quests & Rewards

A highly configurable Daily Quests & Rewards mod! Keep players engaged with dynamic tasks, login rewards, streaks, and competitive leaderboards.

💖 Support the Development

I'm a computer science student, and I develop game mods and software in my free time. If my work has improved your server or modpack, consider supporting my coding journey! Every coffee helps me survive late-night debugging sessions. ☕💻

🌟 Memberships & Perks

Want to get more involved? Check out my Ko-fi memberships for exclusive perks:

🥉 Iron Supporter: Behind-the-scenes previews and a special Discord role.
🥈 Gold Supporter: Voting power for new features and priority issue reviews.
🥇 Diamond Supporter: Name in the Hall of Fame and custom feature requests!

Join a Tier and support the mod!

📄 License

This project is available under the MIT License. Feel free to learn from the code and include it in your modpacks!