Blacklists Setup

🚫 Blacklists Setup

Because R3CT Collection automatically scans every item in the game to build its Catalog, you might end up with categories or items you don't want players to see (e.g., admin tools, debug items, or specific mod mechanics).

The r3ct_collection_items.json file allows you to effortlessly filter out unwanted content using simple toggles and lists.

File Location: config/r3ct_collection/r3ct_collection_items.json

---

📝 The JSON Structure

The file contains quick boolean toggles and three distinct arrays: "blacklistedMods", "blacklistedTabs", and "blacklistedItems".

{
  "_comment_version": "Do not change the version number! It is used for automatic config updates.",
  "version": 2,

  "onlyVanillaItems": false,
  "blacklistVanillaSpawnEggs": true,
  "blacklistModdedSpawnEggs": true,

  "_comment_blacklists": "Add item, mod, or tab IDs here to hide them from the Collector's Book.",
  "blacklistedMods": [
    "r3ct_collection",
    "create"
  ],
  "blacklistedTabs": [
    "minecraft:spawn_eggs",
    "minecraft:op_blocks"
  ],
  "blacklistedItems": [
    "minecraft:bedrock",
    "minecraft:command_block",
    "minecraft:potion#minecraft:luck"
  ]
}

---

🔍 Parameter Breakdown

1. Quick Toggles (Booleans)

For common configurations, you don't need to manually type out lists. Just set these to true or false:

• onlyVanillaItems: When set to true, the mod ignores all modded items entirely. Only standard Minecraft items will appear in the book.
• blacklistVanillaSpawnEggs: Automatically hides all standard Minecraft spawn eggs.
• blacklistModdedSpawnEggs: Automatically hides all spawn eggs added by other mods.

2. blacklistedMods

Blocks entire mods from being registered in the Catalog.

• Format: Use the mod's namespace (the prefix before the colon in item IDs).
• Example: Adding "create" will completely hide every item and tab associated with the Create mod.

3. blacklistedTabs

Hides specific Creative Inventory tabs, but keeps the items available if they appear in other allowed tabs.

• Format: The exact registry name of the Creative Tab.
• Example: "minecraft:colored_blocks" ensures that all colored blocks (like wool, concrete, and terracotta) don't get their own dedicated category page in the book.

4. blacklistedItems

Hides individual items from the Catalog, regardless of what tab they are in.

• Format: The exact registry name of the item.
• Special Variants: You can target specific item states (like specific potions, splash potions, or tipped arrows) by using a # separator.
• Examples:
• "minecraft:bedrock" prevents players from needing to collect Bedrock.
• "minecraft:potion#minecraft:luck" hides only the Potion of Luck, keeping all other standard potions in the book.

---

💡 Pro Tip for finding IDs:

To easily find the exact ID of an item or mod, press F3 + H in-game to enable Advanced Tooltips. When you hover over an item in your inventory, you will see its dark gray registry name at the bottom (e.g., minecraft:diamond_sword).