JEI Trail

# JEI Trail

A client-side addon for **Just Enough Items (JEI)** on **NeoForge 1.21.1**.
It helps you follow long crafting chains without losing your place: the recipe screen gets a "previous" window on the left and a "future" window on the right.

> **Client only.** Install it on your game; servers do not need it, and you can join servers that don't have it.
> **Requires JEI** 19.20 or newer for Minecraft 1.21.1.

## Features

### ◀ Previous window (left)
When you open another item from the recipe screen (left or right click on an ingredient, or JEI's show-recipe / show-uses keys), the view you came from moves to the left window instead of disappearing.
The recipe you went through is outlined in gold.
Click the window's title to bring that whole view back to the center.

### Future window ▶ (right)
Hover over any item for half a second, and the right window shows how it is made.
Hold **Caps Lock** while hovering to see what it is used in instead.
A small red ring fills up next to the cursor while you wait, and flashes when the preview is ready.
It works on items in the recipe screen, in the previous window, in JEI's item list and in bookmarks.

### Full JEI windows on the sides
Both side windows are real, smaller copies of the JEI recipe screen: category tabs, the recipe title with arrows, pages, catalysts and recipe buttons all work there.
They scroll independently from the center.
Clicking an item in a side window opens it in the center (left click: how to make it, right click: what it is used in).

### Hide decorative variants
A toggle button (stone stairs icon) above the recipe screen hides "junk" recipes that only make decorative block variants:
- cutter-style recipes (stonecutter, Chipped, Rechiseled and similar) when one block makes 6 or more variants;
- recipes from decoration mods such as Macaw's, Create Deco, furniture and railing mods (the list is configurable).

They are hidden only in "what is this used in" lookups and when browsing a category. "How do I make X" always shows everything.

### Priority targets
Each recipe gets a small target button.
Click it to mark that recipe as the preferred way to make the item; click again to clear it.
The future window opens straight on the preferred recipe. Without a priority, it opens on the crafting table recipe if there is one.

### ☰ Menu with bookmarks
While the previous window takes the left side, JEI's own bookmark list is hidden.
A thin strip appears on the left edge instead: hover over it to slide out a panel with all your JEI bookmarks.
In that panel, left click shows how an item is made, right click shows its uses, and the mouse wheel scrolls.
If **FTB Quests** is installed, the panel also has a "Quests" button that opens the quest book. FTB Quests is optional.

### Narrower center window
The center recipe screen is a bit narrower (160 px instead of 198) to leave room for the side windows.
It still widens itself for recipes that need more space.

## Settings

`config/jeitrail.json` is created on first launch:

| key | meaning |
|---|---|
| `hideDecorativeVariants` | decorative-variant filter on/off (same as the toggle button) |
| `cutterMinVariants` | how many variants from one block count as junk (default 6) |
| `decorativeMods` | decoration mod IDs; `*` at the end means "starts with" |
| `neverHideCategories` | recipe categories where nothing is ever hidden, e.g. `"minecraft:stonecutting"` |
| `priorityFirstEverywhere` | `true`: the priority recipe (or crafting table) also opens first in the center window |
| `hoverDelayMs` | hover delay for the future window, in ms (default 500) |
| `centerWidth` | center window width (default 160; 0 = JEI's own) |
| `sideWidth` | side window width in its own scale (default 160) |
| `sidePanelScale` | side window size relative to the center (default 0.8) |

Priorities are saved in `config/jeitrail-priorities.json`.
If the screen is too narrow for the side windows, they switch off and JEI works as usual.

## License

MIT.

---

# JEI Trail (русский)

Клиентский аддон к **Just Enough Items (JEI)** для **NeoForge 1.21.1**.
Помогает идти по длинным цепочкам крафта и не терять, откуда пришёл: у окна рецептов появляются окно «предыдущий» слева и окно «будущий» справа.

> **Только для клиента.** Ставится в свою игру. Серверу мод не нужен, и на серверы без него заходить можно.
> **Нужен JEI** версии 19.20 или новее для Minecraft 1.21.1.

## Что умеет

### ◀ Предыдущий (слева)
Ты открываешь другой предмет из окна рецептов: ЛКМ или ПКМ по ингредиенту или клавишами JEI «показать рецепт» / «показать применение».
Тогда вид, с которого ты пришёл, не пропадает, а переезжает в левое окно.
Рецепт, через который ты перешёл, обведён золотой рамкой.
Клик по подписи над окном возвращает весь этот вид в центр.

### Будущий ▶ (справа)
Наведи курсор на любой предмет на полсекунды, и правое окно покажет, из чего он делается.
Если держать **Caps Lock**, окно покажет, куда предмет используется.
Пока ждёшь, у курсора заполняется красное кольцо, а когда готово, оно мигает.
Работает на предметах в окне рецептов, в окне «предыдущий», в списке предметов JEI и в закладках.

### Боковые окна — это настоящий JEI
Оба боковых окна — полные уменьшенные копии окна рецептов JEI. В них работают вкладки категорий, название рецепта со стрелками, страницы, катализаторы и кнопки у рецептов.
Листаются отдельно от центра.
Клик по предмету в боковом окне открывает его в центре: ЛКМ — как сделать, ПКМ — куда идёт.

### Скрытие декоративных вариантов
Кнопка-тумблер (иконка каменных ступенек) над окном рецептов прячет «мусорные» рецепты, которые делают только декоративные варианты блоков:
- рецепты резаков (камнерез, Chipped, Rechiseled и похожие), если из одного блока делается 6 и больше вариантов;
- рецепты модов-декора: Macaw's, Create Deco, мебель, перила и т. п. Список настраивается.

Прячутся они только в режиме «где используется» и при листании категорий. «Как сделать X» показывает всё.

### Приоритеты (мишени)
У каждого рецепта есть маленькая кнопка-мишень.
Клик делает рецепт основным способом получить предмет, повторный клик снимает выбор.
Окно «будущий» сразу открывается на приоритетном рецепте. Если приоритета нет — на рецепте верстака, если он есть.

### Меню ☰ с закладками
Пока слева показано окно «предыдущий», собственный список закладок JEI прячется.
Вместо него у левого края появляется узкая полоска. Наведи на неё, и выедет панель со всеми закладками JEI.
В панели ЛКМ показывает, как сделать предмет, ПКМ — где он используется, колёсико листает.
Если установлен **FTB Quests**, сверху панели есть кнопка «Квесты», она открывает книгу квестов. FTB Quests не обязателен.

### Центральное окно уже
Центральное окно рецептов немного уже (160 вместо 198), чтобы по бокам хватило места.
Для широких рецептов оно само расширяется.

## Настройки

Файл `config/jeitrail.json` создаётся при первом запуске:

| ключ | что значит |
|---|---|
| `hideDecorativeVariants` | фильтр декоративных вариантов вкл/выкл (то же, что кнопка) |
| `cutterMinVariants` | сколько вариантов из одного блока считать мусором (6) |
| `decorativeMods` | ID модов-декора; `*` в конце значит «начинается с» |
| `neverHideCategories` | категории, где никогда ничего не прятать, например `"minecraft:stonecutting"` |
| `priorityFirstEverywhere` | `true`: приоритетный рецепт (или верстак) открывается первым и в центральном окне |
| `hoverDelayMs` | задержка наведения для окна «будущий», мс (500) |
| `centerWidth` | ширина центрального окна (160; 0 — как в JEI) |
| `sideWidth` | ширина боковых окон в их собственном масштабе (160) |
| `sidePanelScale` | размер боковых окон относительно центрального (0.8) |

Приоритеты хранятся в `config/jeitrail-priorities.json`.
Если экран слишком узкий для боковых окон, они выключаются, и JEI работает как обычно.

## Лицензия

MIT.