Player Guide

Player Guide

Home › Player Guide

Everything on this page happens in-game. You don't need to touch a single file — the editor can build simple "these five items" groups and full rule-based groups ("all vanilla logs except oak") alike.

Getting Around

• Open your inventory with JEI visible. To the left of JEI's config button you'll find the Groups button — it opens the Group Manager.
• The Manager shows every group as a card: icon, name, member count, and an enable/disable switch. What else you can do depends on where the group came from:
  • Your own groups — edit, delete, everything.
  • Groups from a mod or a KubeJS script — enable/disable, plus Copy as Custom (more below). The source owns them, so direct editing is off.
  • Batch-select cards to enable/disable many at once (batch delete works on your own groups).
• In the JEI list itself, a group shows up as a single stacked icon with a count badge. Click to expand or collapse it. Hover for a preview of what's inside.

Quick Start: Your First Group

Say you want barrels, crafting tables, and chests in one group:

1. Open the Group Manager and hit New Group.
2. Type a name — "Utility Blocks".
3. You land on the Contents tab. Search for barrel on the left, click it to add. Repeat for the others.
4. The right side shows a live preview of the group.
5. Save. Done — the JEI list now shows one entry instead of three.

The Three Editor Tabs

Contents — pick things by hand

The left panel lists everything JEI knows about, split into Items, Fluids, and Other Types tabs. Other Types is where custom mod ingredients live — Mekanism chemicals, Applied Replication matter, anything a mod shows in JEI. They appear automatically; you never need to enable support for them.

Handy tricks:

• The search box understands @mod (by mod), #tag (by tag), and $text (by tooltip text). Hover the box for a reminder.
• Drag across the grid to add or remove a whole run of entries at once.
• For items with variants (potions, enchanted books): a plain click adds the exact variant you're looking at (when it carries extra data), while Ctrl-click adds the whole item — all variants. If the group picked up variants you didn't want, you probably Ctrl-added the whole item.
• Hovering an entry tells you if another group already displays it, and which one wins.

Rules — match by logic instead of by hand

Instead of clicking 200 chairs, write one rule: namespace is mcwfurnitures and the registry name ends with _chair. Rules and hand-picked content can coexist in the same group.

Rules are built from blocks you can nest:

• Any of… — match if at least one condition inside matches (OR)
• All of… — match only if every condition matches (AND)
• Not… — exclude whatever matches inside

and the conditions themselves: ID, tag, and namespace (for items, fluids, and custom types), plus the item-only checks — block tag, registry-name starts with / contains / ends with, exact variant, data component equals, and a field inside a data component.

A mixed example you can build entirely in the Rules tab — "all vanilla logs, plus Macaw's gutters, but never oak". Note the shape: the exclusion sits beside the OR, inside an outer All — putting Not inside the Any would match nearly everything that isn't oak:

• All of…
  • Any of…
    • All of… → block tag minecraft:logs + namespace minecraft
    • All of… → namespace mcwroofs + name starts with gutter_
  • Not… → item ID minecraft:oak_log

Settings — looks and behavior

• Front and Back Icon — the collapsed group's icons, picked from the group's own contents. Fluids and custom ingredients work as icons too. Leave them empty and the group just uses its first two members.
• Five color overrides — name text, collapsed header, expanded header, expanded background, expanded border.
• Priority — when two groups both match the same entry, the higher-priority group displays it.
• Group ID — shown here with a copy button (useful for pack authors and translations).
• Enabled, and a JEI preview. The preview shows everything the group's filter matches — the live list can show fewer, because entries claimed by a higher-priority group don't appear twice.

Enabling, Disabling, Copying

• The enable switch applies instantly — no reload, the JEI list updates as soon as you close the Manager.
• Want to change a mod's or script's group? Copy as Custom gives you a fully editable copy of it — rules, settings, everything. "Disable the original group" is checked by default (so you don't see both), applies when you save the copy, and you can untick it.

When Something Looks Wrong

Run down this list:

1. Group doesn't show up in JEI — is it enabled? A group also only forms when at least 2 of its members are currently visible in JEI.
2. Group scattered while searching — that's the "Ungroup Small Search Results" option (on by default): if a search matches only 2–4 of a group's members, they're shown as plain entries instead of a header. Turn it off in the mod config if you'd rather keep headers.
3. Fewer members than expected — another group with higher priority may have claimed some entries. The hover tooltip on a cell in the editor tells you who won.
4. An entry you added shows a green corner — it's already covered by one of your rules; no need to add it by hand.
5. A group from a pack/mod can't be edited — that's by design. Copy as Custom if you want your own version.