# Основы
§fWayfarer's Map§r рисует карту всего, что вы §aуже видели§r. Новые места появляются на карте по мере исследования.

- §e{key:open_map}§r — открыть / закрыть большую карту
- §e{key:toggle_minimap}§r — показать / скрыть мини-карту
- §e{key:new_waypoint}§r — новая метка там, где вы стоите

> Все клавиши и как их поменять — раздел §bКлавиши§r.

# Клавиши
Все клавиши мода меняются в §bНастройки → Управление§r Minecraft (раздел §fWayfarer's Map§r); здесь они показаны так, как назначены сейчас.

- §e{key:open_map}§r — открыть / закрыть большую карту
- §e{key:toggle_minimap}§r — показать / скрыть мини-карту
- §e{key:zoom_in}§r / §e{key:zoom_out}§r — приблизить / отдалить мини-карту
- §e{key:new_waypoint}§r — новая метка там, где вы стоите
- §e{key:waypoint_list}§r — список меток
- §e{key:cave_mode}§r — режим пещер (авто / выкл / вкл)

§fСначала без клавиши§r (назначьте, чтобы переключать, не открывая карту; действуют и на мини-карту):
- §e{key:mode_blocks}§r — 2D-карта, §e{key:mode_plantless}§r — 2D-карта без растений
- §e{key:mode_topo}§r — топография, §e{key:mode_biomes}§r — биомы
- §e{key:light}§r — освещение (авто / день / ночь), §e{key:chunk_grid}§r — сетка чанков
- §e{key:ores}§r — рудные жилы, §e{key:fluids}§r — подземные жидкости, §e{key:claims}§r — приваты
- §e{key:powerfails}§r — сбои питания, §e{key:nodes}§r — ноды Таумкрафта
- §e{key:hostile_mobs}§r — враждебные мобы, §e{key:passive_mobs}§r — нейтральные, §e{key:friendly_mobs}§r — мирные
- §e{key:pets}§r — питомцы, §e{key:players}§r — игроки

§fНа большой карте (не меняются):§r
- §eПробел§r — вернуться к игроку, §eEsc§r — закрыть
- §eQ§r / §eE§r — повернуть 3D-вид

# Кнопки карты
Вверху карты — §fиконки§r, при наведении видно название.

§fСлева:§r
- §bШестерёнка§r — настройки
- §bФлажок§r — список меток
- §bДиаграмма§r (§fStats§r) — сколько места на диске занимают карты §fвсех миров§r, и по §fэтому миру§r (все измерения или одно, из выпадающего списка): 2D- и 3D-карта, метки, жилы GregTech, подземные жидкости и ноды Таумкрафта (если стоят моды); размеры пересчитываются при каждом открытии
- §bКорзина§r — очистка: очистить папку логов, удалить 2D- или 3D-карту всех измерений этого мира либо 2D, 3D или всю карту одного измерения (каждая кнопка переспрашивает). Метки не удаляются
- §bФотоаппарат§r — снимок всей карты (2D или 3D, как показана). Сохраняется в §fscreenshots/wayfarmap§r, открывается в браузере: колесо приближает до отдельных блоков. Размер на выбор: 3D — от 2 до 64 пикс. на блок (и ночь), 2D — от 1 до 16. §foverview.png§r — вся карта одной картинкой в полном выбранном разрешении
- §bСлои§r — меню §bСлои аддонов§r: галочки руд, жидкостей, приватов, сбоев питания и нод Таумкрафта (только для установленных модов), меню не закрывается, можно переключить сразу несколько

§fСправа:§r
- §bПрицел§r — следовать за игроком: включено — карта всегда открывается на вас, выключено — там, где её закрыли
- §bКрипер§r — мобы: галочки §fнейтральные мобы§r, §aмирные мобы§r, §fпитомцы§r, §cвраждебные мобы§r и §fигроки§r (меню не закрывается); всё выключено — никого не видно. §aЗелёная§r точка — только мирные мобы, §cкрасная§r — только враждебные, тусклая иконка — никого
- §bСетка§r — сетка чанков
- §bРежимы§r — список: §f2D-карта§r, §f3D-карта§r (изометрия как в Dynmap), §f2D-карта без растений§r, §fТопография§r (цвет по высоте и изолинии), §fБиомы§r и для операторов §fЗагрузка области§r; иконка показывает режим. В 3D §eQ§r / §eE§r поворачивают вид, справа §bползунок качества§r: 8, 16, 32 или 64 пикс. на блок (больше — чётче, меньше — быстрее)
- §bХолм с туннелем§r — пещеры: подсвечена — вкл, с точкой — авто, тусклая — выкл
- §bСолнце§r / §bЛуна§r — освещение, нажатие переключает по кругу: §bполутёмный круг§r с точкой — авто (как сутки в игре), §bсолнце§r — всегда день, §bлуна§r — всегда ночь
- §bДва человечка§r — товарищи по команде онлайн (появляется, когда они есть)
- §bКрестик§r справа с краю — закрыть карту (как §eEsc§r)
- §b?§r внизу справа — эта справка
- §bi§r в углу рядом с ней — о моде: версия, создатель, тестеры и ссылки (GitHub, Boosty, Telegram)

Любую кнопку вверху карты, кроме §bшестерёнки§r и названия измерения, можно скрыть: §bНастройки → Карта мира → Кнопки на карте§r. Там же §fмасштаб интерфейса§r.

# Навигация по карте
- §eЛКМ + тянуть§r — двигать карту
- §eКолесо§r — масштаб (к точке под курсором)
- §eПробел§r — вернуться к игроку
- Карта открывается §fтам, где вы её закрыли§r — с тем же масштабом и измерением (с включённым §bПрицелом§r — всегда на вас)
- §eПКМ§r по пустому месту — меню: §bТелепорт сюда§r, §bНовая метка§r, §bБыстрая метка§r (обычная метка сразу, названием — координаты) и на 2D-карте §bУдалить регион§r (квадрат 512×512 блоков вокруг точки из 2D-карты, после подтверждения; загруженные чанки вернутся, когда изменятся или загрузятся заново)
- §eПКМ§r по метке — меню: §bПоделиться§r (в чат), §bТелепорт§r, §bИзменить§r, §bУдалить§r, §bВыключить§r (пропадает из мира и с миникарты; на большой карте остаётся бледной, и в этом же меню её можно включить)

§fДругие измерения:§r нажмите на §b[0] Overworld ▾§r вверху — откроется список всех измерений, сохранённых в карте. Выберите любое, чтобы посмотреть его карту, не находясь там.
- Координаты пересчитываются для Незера (1:8)
- Метки, руды и жидкости показываются для выбранного измерения
- §eПробел§r — вернуться в своё измерение к игроку

! В чужом измерении нельзя телепортироваться и менять приваты, а игрок и мобы не показываются.

Сквозь §fстекло§r на карте видно, что под ним, с лёгким оттенком цвета стекла (§bНастройки → 2D-карта → Видеть сквозь стекло§r).

Внизу слева показаны координаты под курсором. §7(?)§r значит, что это место ещё не исследовано.

# Метки (вейпоинты)
Метка — это точка с §fименем§r, §fцветом обводки§r и §fиконкой-предметом§r. Видна на карте, мини-карте и в мире.

- Создать: §e{key:new_waypoint}§r, §eПКМ → Новая метка§r или кнопка в списке меток
- Редактировать: §eПКМ§r по метке на карте или в списке §b(§e{key:waypoint_list}§b)
- Цвет выбирается в палитре: квадратик цвета → оттенок, насыщенность, яркость
- Иконка — любой предмет; чтобы искать, §fкликните по полю поиска§r. Иконка рисуется §fкак в инвентаре§r: блоки объёмные, предметы модов со своим видом (инструменты Tinkers' — со своими частями)
- На карте рядом с именем пишется §fрасстояние§r до метки

- §bМетка смерти§r — при смерти на этом месте сама ставится метка §cСмерть§r с черепом; все они лежат в группе §fСмерти§r (если её удалить, она создастся снова при следующей смерти), хранятся последние несколько (§bНастройки → Вейпоинты → При смерти§r)
- §bНа карте§r в списке меток — открывает большую карту, по центру — эта метка (в её измерении)
- §bЛуч§r в редакторе — через столбец метки в мире проходит §fлуч как у маяка§r её цвета — от самого низа мира до верха (по умолчанию выключен)
- §bВ чат§r в редакторе — метка отправляется в чат; у игроков с модом появится её название и кнопка §a[Добавить]§r, по клику метка добавится им §fвместе с группой§r (группа создастся, если её нет)

> Длинные имена обрезаются, чтобы надписи не налезали друг на друга. Полное имя — внизу при наведении.

> Меток очень много (сотни)? Ограничьте §bНастройки → Вейпоинты → Дальность§r: в мире рисуются только ближние, на картах видны все.

# Группы меток
Группы помогают прятать метки пачкой, например §f«Руды»§r или §f«Базы»§r.

- Создайте группу в списке меток §b(§e{key:waypoint_list}§b)
- §eПеретащите метку ЛКМ§r на группу, чтобы переложить её
- Кнопка рядом с группой скрывает / показывает §fвсе её метки сразу§r

# Телепорт
! Телепорт работает §fтолько если у вас есть право на /tp§r на сервере (или читы в одиночной игре). Без права кнопок телепорта нет.

- §eПКМ → Телепорт сюда§r — на самую высокую безопасную точку
- Если высота места неизвестна (не исследовано), карта §fспросит Y§r в отдельном окне
- В списке меток — кнопка телепорта к метке

# Пещеры
Режим пещер показывает §fслой под землёй§r вместо поверхности.

- §bПещеры§r / §e{key:cave_mode}§r: §fавто§r — включается, когда вы под землёй; §fвкл§r / §fвыкл§r — всегда
- §fПолзунок§r справа выбирает слой высоты (по 16 блоков)
- Слои запоминаются: исследованная пещера остаётся на карте
- Под землёй §fтемно§r в любое время суток: светло только там, где стоят §fфакелы§r и другие источники света (если освещение не закреплено на «День»; в Незере пещеры светлые)

> Чтобы пещеры попали на карту, по ним нужно пройти — карта рисует то, что рядом с вами.

# Биомы и поиск
- §bБиомы§r — раскрашивает карту по биомам (в любом измерении, и в Незере, и под землёй); при наведении внизу пишется биом
- §fПоле поиска§r появляется сверху в режиме биомов, руд или жидкостей
- Пример: введите §e«Ocean»§r — всё лишнее станет §7серым§r, а океаны §6обведутся§r
- §eEsc§r в поле — очистить поиск, §eEnter§r — выйти из поля

# Топография
- §bРежимы → Топография§r — поверхность по высоте, в стиле JourneyMap: вода однотонная §9тёмно-синяя§r (у берега светлее), суша — ровные ступени от §2тёмно-зелёного§r у берега через серо-зелёный и сизый к §dлавандовому§r и почти §fбелым§r вершинам
- Тёмно-коричневые §fизолинии§r между ступенями соединяют места одной высоты: чем гуще линии, тем круче склон
- Биомы и топография заменяют друг друга: включение одного выключает другое. Работает и на миникарте
- Шаг изолиний и сами линии — §bНастройки → 2D-карта§r
- Строится по высотам исследованной поверхности; пещеры и 3D-карта в этом режиме не показываются

# Вид карты
- §bОсвещение§r (солнце / луна) — одна кнопка по кругу: §fавто§r (карта §fследует за временем суток§r) → §fвсегда день§r → §fвсегда ночь§r; ночью места у факелов, ламп и лавы светятся
- §bСетка§r — сетка чанков 16×16
- §b3D-карта§r — мир в изометрии как в Dynmap: рисуется из самих блоков (текстуры, трава и листва в цвет биома, свет неба и факелов, тени под деревьями, вода единой толщей со дном на мелководье, соединённые текстуры Chisel, тайл-энтити (сундуки, таблички, машины), трубы и кабели GregTech, кропы, кровати как в игре; ночью — свет факелов, растения, полублоки, ступени, заборы). §eQ§r / §eE§r или кнопка со стрелкой — повернуть вид на 4 стороны. Блоки запоминаются, пока вы ходите; места, исследованные раньше или командой, видны столбиками из цветов плоской карты, пока вы там не побываете. Тайлы рисуются в фоне, дальние уровни сохраняются на диск. Под крышами и навесами виден настоящий пол, а не сплошной камень (на сколько блоков вниз заглядывать — §bНастройки → 3D-карта → Заглядывать под крыши§r). Только поверхность; биомы и пещеры — плоские. Метки, игроки и команда видны и в 3D, слои аддонов, сетка и мобы — только на плоской карте
- §bМобы§r — меню с галочками: нейтральные, мирные, питомцы, враждебные, игроки. На кнопке видно, кто сейчас показан
- Мобы и игроки показываются §fиконками-лицами§r; подробные фильтры — в настройках §b(Сущности)

# Руды и жидкости
Нужен мод §fVisualProspecting§r (GTNH). Включаются в меню §bСлои аддонов§r (иконка слоёв вверху слева) галочками §bРуды§r и §bЖидкости§r — работают §fпо очереди§r, включена только одна.

- Наведение на жилу — подсказка с составом
- §eПКМ по жиле → Отслеживать§r — в мире появится маркер с расстоянием
- §eПКМ по жиле → Истощена§r — пометить жилу выработанной (станет тусклой)
- Поиск сверху находит руды и жидкости по названию

! Жилы появляются только после разведки (выкопанные руды, образцы, сканер).

# Сбои питания (GregTech)
Если машине GregTech не хватило энергии, GregTech отмечает это как §fсбой питания§r. Галочка §bСбои питания§r в меню §bСлои аддонов§r показывает их на карте и миникарте — §cкрасной рамкой§r со значком молнии.

- Наведение — какая машина, координаты, сколько раз и когда был последний сбой
- При приближении под значком пишется машина и сколько времени прошло
- §eПКМ по сбою → Убрать отметку§r — сбросить сбой (как в GregTech)
- §eПКМ по сбою → Поставить метку здесь§r — сделать метку к машине
- Поиск сверху находит сбои по названию машины

> Сбои видит вся ваша команда: их присылает сервер GregTech.

# Ноды Таумкрафта (TCNodeTracker)
Нужны §fThaumcraft§r и §fTCNodeTracker§r. Ноды, которые вы нашли и записали в TCNodeTracker, видны на карте и миникарте — значок ноды в цвете §fсамого сильного аспекта§r с этим аспектом внутри. Включаются галочкой §bНоды Таумкрафта§r в меню §bСлои аддонов§r.

- Наведение — тип ноды, модификатор, все аспекты с количеством и координаты
- При приближении под значком пишутся главные аспекты
- §eПКМ по ноде → Отслеживать§r — в мире появляется метка ноды с расстоянием, как у отслеживаемой жилы (видна сквозь блоки)
- §eПКМ по ноде → Удалить ноду§r — нода удаляется из списка TCNodeTracker
- Поиск сверху по аспектам: §e«ignis»§r, §e«aer ordo»§r — остальные ноды тускнеют

# Приваты (ServerUtilities)
Нужны §fServerUtilities§r и §fNavigator§r на сервере. Включите галочку §bПриваты§r в меню §bСлои аддонов§r.

§fЛКМ + тянуть прямоугольник:§r
- §eCtrl§r — заприватить чанки
- §eShift§r — загрузить чанки (chunkload), только свои
- §eCtrl+Shift§r — и то, и другое

§fПКМ + тянуть прямоугольник:§r
- §eCtrl§r — снять приват
- §eShift§r — выгрузить
- §eCtrl+Shift§r — §cубрать всё§r (и загрузку, и приват)

Цвета: каждый приват — в цвет своей команды, ваши тоже (чуть ярче). Загруженные чанки обведены чёрной рамкой — одной вокруг каждой загруженной области.

! Приваты видны и меняются §fтолько в измерении, где вы стоите§r: сервер ServerUtilities всегда берёт измерение игрока. Чтобы заприватить в Незере — зайдите в Незер.

! Выделение не больше §f64×64§r чанков. Лимиты приватов и загрузок задаёт сервер — счётчик внизу справа.

# Общая карта команды
У каждого игрока §fсвоя карта§r. Если мод стоит и §fна сервере§r (вместе с §fServerUtilities§r), в команде карта становится §aобщей§r.

- Создали или вступили в команду — §fвся ваша карта§r (все измерения и пещеры) в фоне уходит команде, а вы получаете карту команды
- Карты участников §fобъединяются§r: для каждого участка остаётся самый свежий
- Новые открытия товарищей появляются у вас сразу, ваши — у них
- Зашли позже — §fдогружается всё§r, что команда открыла без вас, §fво всех измерениях§r (сначала текущее), а ваше новое уходит команде
- Измерения, где была команда, сразу открыты в списке под заголовком карты — §fбез посещения§r
- Хранится на сервере, в папке мира §7wayfarmap/teams§r

- §fТоварищи всегда видны§r на карте и миникарте — голова в §9синей рамке§r с именем, даже далеко и в другом измерении (при его просмотре)
- Иконка §bДва человечка§r справа вверху (есть, когда кто-то из команды онлайн) — список товарищей с измерением; клик переносит карту к товарищу, даже в другое измерение

! Без команды карта остаётся только вашей — чужая к вам не попадёт.
> Выключить: §bНастройки → 2D-карта → Общая карта команды§r.

# Загрузка области (/wf chunkload)
Команда наносит на карту §fбольшую область вокруг вас§r, не обходя её: сервер сам грузит (и генерирует, если нужно) чанки, а карта их рисует.

- §e/wf chunkload 2d <радиус>§r — плоская карта, радиус в чанках
- §e/wf chunkload 3d <радиус>§r — плоская и 3D-карта (дольше)
- §e/wf chunkload status§r — сколько готово
- §e/wf chunkload stop§r — остановить
- §e/wf regionload 2d|3d <радиус>§r — только сохранённые в мире чанки, ничего не генерируется; §efull§r вместо радиуса — все файлы регионов измерения

§fС карты:§r §bРежимы → Загрузка области§r (только для операторов) показывает чанки §aна карте§r (зелёные), §7сохранённые в мире§r, но ещё не нанесённые (серые), и §cв очереди§r (красные).
- §eCtrl+ЛКМ, протянуть§r — загрузить серые чанки прямоугольника из регионов как есть (ничего не генерируется)
- §eShift+ЛКМ, протянуть§r — сгенерировать чанки прямоугольника (и те, что ещё не созданы)
- §eCtrl+Shift+ЛКМ, протянуть§r — сгенерировать со всеми слоями пещер
- §eCtrl+ПКМ, протянуть§r — §cудалить§r прямоугольник с карты сразу (и из очереди). Чанки, загруженные вокруг вас, сразу нанесутся заново
- §eShift+ПКМ, протянуть§r — отменить: красные чанки прямоугольника убираются из очереди
- §bЗагрузить всё из регионов§r — все сохранённые чанки этого измерения разом (с подтверждением; ничего не генерируется)
- §bУдалить карту измерения§r — вся карта этого измерения (с подтверждением; метки остаются)
- Если включено §bНастройки → 3D-карта → Запоминать блоки§r, всё перечисленное делается и для 3D-карты

- Ход виден на большой карте внизу: сколько чанков готово и §fсколько секунд прошло§r
- Вышли из мира или ушли в другое измерение — загрузка встаёт на паузу и продолжается, когда вы вернётесь
- Скорость — §bНастройки → Команды§r

! Нужны права оператора (в одиночной игре — читы). На общем сервере большой радиус нагружает сервер.

# Настройки
Кнопка §bНастройки§r на карте открывает все параметры мода по разделам:

- §fМини-карта§r — размер, угол экрана, масштаб, координаты и биом, §fкруглая форма§r и §fповорот по взгляду§r (направление взгляда всегда вверху). По краю миникарты подписаны стороны света: N, E, S, W
- §fКарта мира§r — §fмасштаб интерфейса§r (карта и окна мода не зависят от «Интерфейса» Minecraft; «Авто» подбирает размер под окно) и какие §fкнопки§r показывать на карте
- §f2D-карта§r — пещеры, освещение, цвета, стекло, слои модов, скорость сканирования, автосохранение, общая карта команды
- §f3D-карта§r — 3D-вид, сторона обзора, качество, сглаживание, запись блоков, скорость копирования, заглядывание под крыши
- §fСущности§r — игроки, враждебные и мирные мобы, лимит иконок, высота
- §fВейпоинты§r — где показывать, размер, ширина надписей, дальность, §fметки смерти§r
- §fКоманды§r — скорость §e/wf chunkload§r на сервере и клиенте, размер партии
- §fЛоги§r — подробные логи 2D- и 3D-карты для поиска проблем

Внутри раздела параметры собраны в подпункты. Параметры, которые зависят от переключателя, стоят под ним с отступом и тускнеют, пока он выключен.

> Наведите на название параметра — появится его полное описание.
