StorageGuide

StorageGuide

Хватит обыскивать сундуки. Начни находить предметы. StorageGuide превращает вашу комнату хранения в Minecraft в чистую, доступную для поиска карту инвентаря с серверной поддержкой. Нажмите клавишу, введите название предмета или возьмите в руки предмет, который хотите убрать, и StorageGuide подсветит нужный сундук. Мод создан для реальных многопользовательских баз: один оператор один раз задаёт стену хранения, и каждый игрок получает одинаковую структуру без необходимости запоминать таблички, открывать случайные сундуки или спрашивать «где у нас хранится кварц?» в 900-й раз. StorageGuide также работает с набитыми шалкерами, остаётся видимым с шейдерпаками вроде Photon и даже может ловить неправильно размещённые предметы с помощью Big Brother — опциональной серверной системы мониторинга для поддержания порядка в общем хранилище.

Почему StorageGuide?

• Больше никакой рулетки с сундуками: Найдите один раз и идите прямо к нужному сундуку.
• Идеально для общих баз: Все следуют одной серверной схеме хранения.
• Настраивать действительно приятно: Внутриигровые меню, иконки предметов, подсказки при наведении, настройки цветов и управление с клавиш делают настройку простой.
• Учитывает шалкеры: Набитые шалкеры можно распределять по содержимому, а не только по цвету коробки.
• Порядок по умолчанию: Big Brother может предупредить, когда предметы кладут не туда.
• Дружелюбен к шейдерам: Отдельный рендеринг подсветки сохраняет маркеры сундуков видимыми с распространёнными шейдерными пайплайнами Iris.

Возможности

• Мгновенный поиск предметов: Ищите по названию, выберите результат и получите локальную подсветку сундука.
• Поиск по предмету в руке: Держите предмет и нажмите ~, чтобы сразу найти его назначение.
• Общие карты хранения: Одна серверная схема синхронизирует всех клиентов.
• Умная работа с шалкерами: Распределяйте полные шалкеры по совместимому содержимому с поддержкой всех цветов.
• Мониторинг Big Brother: Опционально обнаруживает неправильно размещённые предметы и ведёт постоянную историю с группировкой по игрокам.
• Настраиваемые объявления: Операторы могут настроить один или несколько шаблонов сообщений Big Brother с плейсхолдером {playername}.
• Подсветка, совместимая с шейдерами: Чёткие маркеры в мире работают с шейдерами Iris, включая Photon.
• Отточенные меню: Полосы прокрутки, иконки предметов, подсказки, выбор цвета и управление с клавиш доступны прямо в игре.
• Безопасная совместимость с мультиплеером: Сетевая часть учитывает версии, не отправляет вслепую неподдерживаемые форматы пакетов и рекомендует обновление для старых клиентов.
• Один jar для всех сторон: Используйте один и тот же мод Fabric на выделенных серверах, локальных хостах и клиентах.

Быстрый старт

1. Оператор создаёт сетку на одной вертикальной стороне комнаты хранения.
2. Оператор открывает каждую ячейку сетки и назначает предметы, которые должны лежать в этом сундуке.
3. Игроки нажимают O и вводят название предмета или держат предмет и нажимают ~.
4. StorageGuide локально подсвечивает подходящий сундук для этого игрока.

Управление

Любую клавишу можно изменить в меню управления Minecraft или прямо в экране клиентских настроек StorageGuide.

Создание сетки хранения

Для создания сетки нужны права оператора.

1. Посмотрите на один угол стены хранения и нажмите [.
2. Посмотрите на диагонально противоположный угол и нажмите [ снова.
3. StorageGuide создаёт по одной ячейке для каждого блока в этом прямоугольнике. Оба угла должны лежать в одной вертикальной плоскости X/Y или Z/Y. Каждая ячейка размером в один блок представляет одну позицию хранения — обычно блок, занятый сундуком, или половину двойного сундука. Создание новой сетки заменяет текущую настроенную сетку, поэтому назначайте стену только после выбора её окончательных границ.

Назначение предметов сундукам

1. Нажмите [ один раз, чтобы показать настроенную сетку.
2. Посмотрите на подсвеченную ячейку и нажмите [ снова.
3. Выберите все типы предметов, которые должны лежать в этом сундуке.
4. Нажмите «Сохранить», чтобы применить черновик. Редактор сообщит, сколько предметов было назначено сундуку или удалено из него. Редактор выбирает первый подходящий блок сетки на линии взгляда. Таблички и рамки, закреплённые перед сундуком, не мешают его выбрать. Список предметов строится из обычных вкладок креативного инвентаря и исключает технические записи, доступные только операторам. Выбранные предметы подсвечиваются цветом строки, а длинные списки используют прокрутку колёсиком мыши с полосой прокрутки. Сундук может принимать несколько типов предметов, но назначение предмета новой ячейке удаляет его из предыдущей, чтобы у поиска всегда было одно место назначения. Выход из мира, открытие меню паузы или нажатие Escape отменяет активный процесс редактирования без сохранения незавершённого изменения.

Поиск предмета

Нажмите O, чтобы открыть пустое поле поиска. Результаты появляются по мере ввода и используют чистые названия предметов без пространства имён minecraft:. Выберите результат, чтобы закрыть меню и подсветить назначенный ему сундук. Поиск использует нативные внутриигровые иконки предметов, прокрутку колёсиком мыши и полосу прокрутки, когда результаты не помещаются. Чтобы пропустить меню, держите предмет в любой руке и нажмите клавишу ~. Главная рука имеет приоритет, когда предметы есть в обеих руках. Если предмету не назначен сундук, StorageGuide очищает предыдущий результат и сообщает, что подходящей ячейки нет. Нажатие ~ ненадолго меняет рамку выбранного слота хотбара, показывая статус поиска:

• Зелёный означает, что у выбранного предмета есть настроенное место хранения.
• Красный означает, что предмет не назначен ни одному сундуку.
• Непустые шалкеры становятся зелёными только тогда, когда всё их содержимое принадлежит одному настроенному сундуку. Статус ненадолго перекрашивает оригинальную текстуру выбранного слота Minecraft, плавно возвращает её к обычному виду через короткую задержку и немедленно отменяется при смене слота. Оба цвета статуса, цвет подсветки найденного сундука и сам индикатор можно изменить в экране конфигурации StorageGuide через Mod Menu.

Шалкеры

Поиск предмета в руке понимает все цветные и неокрашенные шалкеры:

• Непустой шалкер направляется по своему содержимому. Каждый непустой слот должен содержать предмет, назначенный той же ячейке хранилища.
• Пустые слоты игнорируются.
• Правильно упакованный шалкер подсвечивает сундук, который принимает его содержимое, даже если самому шалкеру назначен другой цвет.
• Пустой шалкер обрабатывается как обычный предмет и находит сундук, назначенный именно этому цвету шалкера.
• Если какой-либо из содержащихся предметов не назначен или содержимое принадлежит разным ячейкам, ни один сундук не подсвечивается, и игрок видит: The shulker box has items incompatible with any chest configuration.

Подсветка и шейдеры

StorageGuide отрисовывает собственные маркеры ячеек в мире вместо стандартных контуров блоков. Благодаря этому подсветка поиска и редактирования остаётся видимой при распространённых шейдерных пайплайнах Iris, включая Photon и BSL. Подсветка работает на стороне клиента и видна только тому игроку, который её запросил. Она не изменяет блоки, контейнеры или освещение на сервере.

Big Brother

Опциональный мониторинг Big Brother объявляет, когда игрок добавляет несовместимый предмет в настроенный сундук. По умолчанию отключён и требует прав оператора для настройки.

/storageguide big_brother
/storageguide big_brother on
/storageguide big_brother off
/storageguide sloppiness_detector
/storageguide sloppiness_detector on
/storageguide sloppiness_detector off

Команда sloppiness_detector остаётся как совместимый псевдоним. Команда без on или off сообщает текущее состояние. Настройка сохраняется в config/storageguide.json. Big Brother:

• проверяет только что добавленные предметы, а не предупреждает просто потому, что старый неправильно размещённый предмет уже присутствует;
• не предупреждает при удалении предметов;
• понимает любую половину двойного сундука;
• принимает непустой шалкер, когда всё его содержимое принадлежит этому сундуку;
• обрабатывает пустой цветной шалкер согласно назначению именно этого предмета-шалера; и
• записывает каждый обнаруженный случай в постоянную историю, даже если объявление не отправляется;
• позволяет операторам исключать отдельные настроенные сундуки из обнаружения; и
• применяет настраиваемую задержку объявлений для каждого игрока и каждого сундука, чтобы предотвратить спам в чате. По умолчанию предупреждения транслируются как `Big Brother caught slacking off.Операторы могут изменить сообщение в настройках оператора. Несколько шаблонов можно разделить символом|`; при каждом объявлении Big Brother выбирается один из них. Любой может открыть историю через клиентские настройки StorageGuide или выполнив:

/storageguide history

История открывается как список игроков с кнопкой для каждого игрока, показывающей количество пойманных случаев. При выборе игрока отображаются его данные, начиная с самых новых, с иконками предметов. Задержка объявлений не удаляет и не объединяет записи истории.

Совместимость в мультиплеере и версиях

Сервер владеет сеткой, назначениями и настройкой Big Brother. Клиенты запрашивают действия и отрисовывают полученные результаты. При подключении совместимые клиенты и серверы обмениваются версиями мода и протокола. Более новые сборки сообщают поддерживаемые типы пакетов и используют устаревшие форматы запросов, когда другая сторона не поддерживает новый формат. Неподдерживаемые пользовательские пакеты не отправляются вслепую, что предотвращает разрыв соединения со старым участником из-за изменения формата. Если игрок подключается с более старой версией клиента StorageGuide, чем сервер, StorageGuide рекомендует обновиться, чтобы получить новейший интерфейс и исправления совместимости. Для полной функциональности по возможности поддерживайте сервер и клиенты на одной версии StorageGuide.

Настройка и резервные копии

По возможности настраивайте StorageGuide прямо в игре:

• Откройте Меню Escape → StorageGuide или Mod Menu → StorageGuide → Configure, чтобы изменить подсветку найденного сундука, цвет хотбара для найденного предмета, цвет хотбара для отсутствующего предмета, привязки клавиш или индикатор хотбара.
• Операторы могут выбрать Operator Settings на этом экране, пока подключены к серверу.
• Игроки могут выполнить /storageguide или /storageguide settings, чтобы открыть клиентские настройки StorageGuide. Операторы могут выполнить /storageguide operator_settings, чтобы напрямую открыть настройки оператора, хранящиеся на сервере.
• Operator Settings управляет Big Brother, задержкой объявлений, шаблонами объявлений и тем, обязателен ли StorageGuide у подключающихся клиентов.
• Используйте [ для создания сетки хранилища и назначения предметов. Изменения ячеек остаются черновиком до нажатия Save, после чего редактор показывает количество назначенных/удалённых предметов.
• Экран редактирования ячейки позволяет исключить этот сундук из Big Brother, не удаляя назначения его предметов.
• Команды /storageguide big_brother доступны для управления через команды, а /storageguide sloppiness_detector остаётся псевдонимом. Инструменты в игре проверяют изменения и автоматически поддерживают согласованность назначений. Клиентские цвета сохраняются в:

config/storageguide-client.json

Сервер хранит эту конфигурацию в:

config/storageguide.json

Файл содержит границы сетки, назначения и исключения ячеек, настройки оператора, шаблоны сообщений Big Brother и историю Big Brother. Ручное редактирование предназначено только для продвинутого восстановления или миграции. Если это необходимо, сначала остановите сервер и сделайте резервную копию перед изменением или восстановлением файла.

Решение проблем

• Элементы управления ничего не делают: Убедитесь, что StorageGuide и Fabric API установлены и на клиенте, и на сервере. Также проверьте, не назначена ли та же клавиша другому управлению в настройках игры.
• У StorageGuide нет кнопки Configure: Установите Mod Menu на клиент. Он опционален и не требуется на сервере.
• Игрок не может редактировать сетку: Создание сетки и редактирование назначений требуют прав оператора.
• Operator Settings отсутствует: Сначала подключитесь к серверу с правами оператора, затем откройте его из клиентских настроек StorageGuide или выполните /storageguide operator_settings.

• Operator Settings сообщает, что требуются права: Меню остаётся доступным для просмотра, но серверные настройки может изменять только оператор.

• Клиент отключается при подключении: Сервер может требовать, чтобы все подключающиеся игроки установили совместимый клиент StorageGuide.
• StorageGuide рекомендует обновиться: Ваш клиент старее сервера. Установите текущую версию StorageGuide, чтобы не потерять поддержку нового интерфейса или пакетов.
• Сундук не срабатывает на Big Brother: Проверьте, не помечена ли эта ячейка как исключённая в её окне редактирования.
• Результат поиска не появляется: Подсветку сундука могут создавать только назначенные предметы.
• Шалкер отклонён: Всё его непустое содержимое должно быть назначено одной ячейке хранения.
• Подсветка скрыта шейдером: Убедитесь, что клиент запущен на текущей версии. Совместимость с Photon использует собственный рендерер подсветки мода.