Полное руководство по EVE Miner Hub
От подключения персонажей до производства и торговли
EVE Miner Hub (EMH) собирает mining ledger всех подключённых персонажей, оценивает добычу, рассчитывает рефайн и сжатие, помогает планировать планетарное и обычное производство, сравнивает рынки и выводит статистику в OBS.
Все игровые даты и периоды в сервисе считаются по EVE Time (UTC). Данные поступают через официальный EVE ESI API, а вход персонажей выполняется только через EVE SSO.
1. Быстрый старт
- Зарегистрируйтесь. Создайте локальный аккаунт EMH с логином, email и паролем.
- Добавьте персонажей. В кабинете нажмите «Добавить персонажа» и подтвердите чтение mining ledger на официальной странице EVE SSO. Повторите для всех майнинг-персонажей.
- Продолжайте играть. EMH самостоятельно забирает изменения mining ledger. Активные персонажи обычно проверяются каждые 5 минут, остальные — реже, поэтому данные появляются не мгновенно.
- Создайте widget token. Он нужен кабинету для общей статистики, OBS и внешнего mining API.
- Для рынков выполните повторную авторизацию. В блоке «Станции и торговые маршруты» нажмите «Разрешить рынки и автопоиск».
Старый EVE token не получает новые разрешения автоматически. Удалять персонажа не нужно: повторная авторизация сохраняет его историю добычи и добавляет read-only доступ к структурам, точным рынкам структур и операциям кошелька.
2. Аккаунт и подключение персонажей
Обычное добавление персонажа
Кнопка «Добавить персонажа» запрашивает только разрешение esi-industry.read_character_mining.v1. Оно позволяет читать mining ledger. EMH не получает пароль EVE, не управляет кораблями и активами и не выполняет действия от имени пилота.
Один EVE-персонаж может быть связан только с одним локальным аккаунтом EMH. Если он уже подключён к другому пользователю, сервис не перенесёт его автоматически.
Основной персонаж и альты
Нажмите «Назначить основного» рядом с кнопкой добавления и выберите основу. Карточка основного персонажа получит синюю рамку и плашку «Основной», остальные будут отмечены как «Альт».
Основной персонаж — это приоритет для EVE-токена в общих функциях аккаунта, например при чтении доступных структур и их рынков. Если у основы нет требуемого разрешения или ACL, EMH безопасно попробует подходящего альта. Настройка не ограничивает статистику добычи: ledger по-прежнему собирается и суммируется для всех подключённых персонажей.
Повторная авторизация для рынков
Для точных стаканов Upwell и автоматического обнаружения рынков откройте «Анализ цен» → «Станции и торговые маршруты» и нажмите «Разрешить рынки и автопоиск». Запрашиваются read-only разрешения на:
- чтение названий и систем доступных структур;
- чтение точного order book доступной player structure;
- чтение операций кошелька для обнаружения location ID уже встречавшихся рынков.
Если доступ к нужным структурам распределён между несколькими персонажами, повторно авторизуйте каждого из них. Дополнительные ESI scopes на assets, личные ордера или структуры корпорации используются только при их фактическом наличии у token и не входят в обязательный основной набор.
Статусы и управление
- Активен — token можно обновлять и использовать для ESI.
- Токен истёк — нажмите «Обновить токен» и снова пройдите EVE SSO.
- Карточки персонажей можно перетаскивать, меняя порядок отображения.
- Клик по персонажу в анализе добычи включает фильтр только по нему.
- Удаление персонажа удаляет связанную с ним историю из EMH. Это действие нельзя отменить, поэтому используйте его только осознанно.
EVE tokens хранятся в зашифрованном виде. Авторизация проходит на стороне официального EVE SSO. Никому не отправляйте widget/API URL: находящийся в нём token открывает статистику добычи аккаунта.
3. Модуль «Анализ добычи»
Фильтры
Выберите всех персонажей или одного пилота, затем период: сегодня, вчера, неделя, месяц, всё время, конкретная дата или пользовательский диапазон. Границы периода считаются по UTC.
Главные показатели
- Объём, m³ — суммарный объём несжатой добычи.
- Стоимость руды — оценка добычи по текущей или исторической цене, в зависимости от выбранного периода.
- Количество — число добытых единиц по всем выбранным персонажам.
- Персонажи и типы руды — подробная разбивка с количеством, объёмом и ISK.
Сжатая добыча
Отдельный блок показывает потенциальный результат сжатия руды, льда и газа: количество сжатых единиц, итоговый объём и текущую стоимость published compressed types. Это рыночная оценка, а не проверка реального ангара.
Если у добытого типа нет опубликованного compressed-варианта в текущем SDE, он не входит в compressed totals и отображается как отсутствующий mapping.
Рефайн
EMH рассчитывает три готовых сценария:
| Сценарий | Выход | Для чего использовать |
|---|---|---|
| NPC-станция | 72,36% | Консервативная базовая оценка |
| Athanor + T2 rig | 87,62% | Рефайн на специализированной структуре |
| Tatara + T2 rig | 90,63% | Максимальный встроенный сценарий и основа production stock |
Руда перерабатывается только полными пакетами. Остаток меньше размера пакета не перерабатывается. Выход применяется ко всем полным пакетам стака, затем итог округляется вниз. В таблице видны количество, объём и стоимость полученных минералов, ice products или moon materials.
Для текущего периода используются актуальные цены. Для полностью исторической выборки EMH показывает дату, на которую оценивались материалы.
ISK/час флота
Метрика доступна для «Сегодня» и «Вчера». EMH определяет интервалы активности по изменениям mining ledger, обрезает их границами UTC-суток и объединяет пересекающиеся интервалы разных персонажей. Поэтому параллельная работа нескольких окон не умножает астрономическое время флота.
ISK/час = стоимость добычи периода / объединённое время активности флота
Это оценка по частоте обновлений ESI, а не секундомер внутри игрового клиента.
Рейтинг руды и тренды
- Что выгоднее копать сравнивает руды по ISK/m³ после сценария Tatara и переносит результат на объём выбранной добычи.
- Тренды по дням показывают динамику объёма, стоимости и ISK/час за длительный период.
По руде и по системам
Переключатель «По руде / По системам» меняет представление одной и той же выборки. Отчёт по системам показывает долю объёма и ISK, даты первой/последней добычи, число активных дней и состав руды. Эти данные доступны только внутри авторизованного кабинета и не передаются в публичный widget API.
4. Модуль «Планетрака»
«Планетрака» помогает оценить, какие полные PI-цепочки доступны в выбранной системе и какой продукт имеет наибольшую ожидаемую валовую стоимость.
- Выберите общий уровень навыков «Все в» от 1 до 5. Он определяет число колоний и расчётный профиль Command Center.
- Введите минимум три символа системы и выберите точное совпадение из списка.
- Изучите результат: планеты, доступные P0-ресурсы, лучшую цепочку, альтернативы и производственную пирамиду P4 → P0.
- Раскройте «Состав цепочки» у P1–P4 продукта, чтобы увидеть прямые inputs, вложенную цепочку и суммарный RAW на одну единицу.
Как читать прогноз
EMH рассматривает только полные цепочки, для которых все необходимые P0 присутствуют в системе. В сравнении используются актуальные оценки PI commodities и расчётный объём на неделю/месяц.
Расчёт не знает ваши extractor heads, hotspots, длину маршрутов, depletion, POCO tax, импорт/экспорт и фактическую загрузку фабрик. Недельная добыча P0 является объяснённой эвристикой. Используйте результат для сравнения цепочек, а не как гарантированный доход.
5. Модуль «Производство»
Производственный калькулятор разворачивает manufacturing blueprint до базового сырья, позволяет управлять Build/Buy/Stock и связывает расчёт с mining ledger.
5.1. Выбор продукта и серии
- Введите минимум два символа названия blueprint или готового предмета и выберите вариант из списка.
- Укажите число запусков основного чертежа.
- Выберите ME/TE. Быстрые пресеты: T1 10/20, invented T2 2/4, новый BPO/особый BPC 0/0.
- При необходимости задайте отдельные ME/TE компонентов.
- Введите фиксированную стоимость blueprint/BPC на всю серию: контракт, invention/copy cost или долю стоимости BPO.
5.2. Точные настройки площадки
Откройте блок «Точные настройки производства» и задайте фактический сценарий:
- NPC-станция, Raitaru, Azbel или Sotiyo;
- high-sec, low-sec или null-sec/wormhole;
- отдельные T1/T2 rigs на материалы и время;
- BX-801, BX-802 или BX-804;
- Industry и Advanced Industry;
- система производства и её актуальный Manufacturing Cost Index;
- налог площадки, налог продажи, broker fee и прочие расходы;
- Alpha/Omega и региональный сбор Exordium.
EMH включает в установку каждого реально строящегося job системную часть EIV, налог площадки, SCC 4% EIV, Alpha 0,25% EIV при необходимости и Exordium 5% EIV при выбранном регионе. Риги влияют на материалы или время, но не заменяют facility tax.
Выбранная rig считается подходящей для всей рассчитываемой цепочки. Если в игре компоненты строятся на разных структурах или под разными специализированными rigs, рассчитайте этапы отдельно.
5.3. Материалы из вашей добычи
Выберите период «Сегодня», «Неделя», «Месяц» или «Всё время». EMH виртуально переработает соответствующий mining ledger на Tatara с выходом 90,63%.
- Включите «Учитывать оценку добычи как склад материалов», чтобы использовать этот потенциальный stock в выбранном blueprint.
- Нажмите «Найти лучшие варианты», чтобы найти market-relevant изделия, полную цепочку которых можно покрыть полученными материалами.
Рекомендация показывает продукт, количество, экономическую прибыль, маржу, установку jobs, bottleneck и текущий ориентир ликвидности Jita. Материалы не считаются бесплатными: их Jita Sell value используется как opportunity cost. Так видно, сколько дополнительной стоимости может дать производство по сравнению с продажей материалов после рефайна.
Уже проданная или потраченная руда не вычитается автоматически. Каждый рекомендованный продукт использует доступный stock отдельно; список не является единым оптимизированным портфелем. Неизвестная цена контрактного blueprint в рекомендациях не учитывается — добавьте её после выбора продукта.
5.4. Выбор Build / Buy / Stock
После расчёта у каждого материала есть явный источник:
- Взять со склада — использовать mining stock и/или указанное вручную количество.
- Строить — раскрыть дочерний blueprint, добавить материалы, время и installation cost компонента.
- Купить в Jita — купить всё требование по Jita Sell, не списывая этот тип со склада.
Изменение источника автоматически пересчитывает цепочку. «Совокупное базовое сырьё» показывает полное разворачивание строящихся компонентов до непроизводимых материалов без вычета склада.
5.5. Как читать итог
| Показатель | Что означает |
|---|---|
| Cash Profit | Денежный результат: использованный собственный склад не требует новой закупки |
| Экономическая прибыль Jita Sell | Готовый продукт и собственный stock оценены по Sell; вычтены материалы, jobs, blueprint и комиссии |
| Экономическая прибыль Jita Buy | Немедленная продажа результата в реальные Buy-ордера; broker fee не применяется |
| ROI | Прибыль относительно полной экономической стоимости выбранного сценария |
| Break-even | Минимальная цена единицы продукта для безубыточности Sell-сценария |
| Время | Длительность root job и сумма цепочки при последовательном выполнении |
Если Jita Sell отсутствует, положительная global average ESI используется только как явно помеченная оценка. Если цены нет вообще, прибыль скрывается как неполная. Jita Buy никогда не подменяется average price.
5.6. Ограничения модели
Калькулятор не импортирует фактические assets, owned blueprints и их ME/TE, invention/reactions, личные skills и parallel slots. Логистику можно заложить в «Прочие расходы». Расчёт помогает сравнить сценарии, но не гарантирует продажу по текущей цене.
6. Анализ цен, станции и торговые маршруты
6.1. Графики материалов
Выберите категорию: руда, минералы, лёд, газ, лунные материалы или PI. Каталог справа можно фильтровать по названию и переключать клавиатурой. В категории «Руда» вместе с исходными mining types находятся их сжатые варианты руды, льда и газа. Они отмечены отдельной плашкой; цена, иконка, график и торговый маршрут используют реальный type ID и стакан именно сжатого товара, а не пересчёт цены несжатого исходника. Для впервые подключённого compressed type сначала может отображаться одна текущая свеча, после чего дневная OHLC-история накапливается при штатном обновлении цен. Для выбранного типа доступны свечи:
- 1Д — дневные OHLC;
- 1Н — недельная агрегация;
- 1М — месячная агрегация.
Базовая текущая цена — Jita 4-4 mid-price:
(максимальный Jita Buy + минимальный Jita Sell) / 2
Если доступна только одна сторона рынка, используется она. Если Jita orders отсутствуют, там, где это допустимо, применяется global average ESI.
6.2. Добавление рынков
- Повторно авторизуйте персонажа через «Разрешить рынки и автопоиск».
- Введите минимум три символа solar system и выберите точный вариант.
- Откройте поле станции. EMH объединит NPC, public market structures и доступные private candidates из wallet transactions.
- Выберите локацию и нажмите «Добавить станцию». Можно сохранить до 30 рынков.
Для неизвестной selective-ACL structure вставьте EVE showinfo link или числовой ID. Reference передаётся в POST body, после чего сервер проверяет metadata, систему и доступ вашим token. Свободно введённое название не считается выбранной станцией.
6.3. Источник ордеров
- NPC region — публичные region orders для NPC-станции.
- Public region — допустимый публичный fallback для доказанно public Upwell.
- Exact structure — точный authenticated order book player structure.
- Unavailable — market scope или ACL не позволяет получить приватный стакан; EMH не подменяет его ложным пустым рынком.
6.4. Jump Freighter маршрут
Выберите материал на графике, задайте вместимость JF и долю налогов/расходов. EMH независимо считает оба направления и два способа торговли:
- Jita → станция, сразу: купить по Jita Sell и продать в Buy выбранной станции;
- Jita → станция, через свои ордера: закупить ориентировочно по текущему Jita Buy и выставить по текущему Sell станции;
- станция → Jita, сразу: купить по Sell выбранной станции и продать в Jita Buy;
- станция → Jita, через свои ордера: закупить ориентировочно по текущему Buy станции и выставить по текущему Jita Sell.
Мгновенные сценарии проходят по реальной глубине исходных Sell и целевых Buy orders; количество ограничивается обоими стаканами, вместимостью JF и объёмом единицы. Сценарии через свои ордера оценивают полную выбранную загрузку по текущим max Buy/min Sell ориентирам, но существующий Buy volume не является доступным предложением, Sell volume не гарантирует спрос, а очередь и срок исполнения неизвестны. Профит после расходов считается как выручка × (1 − расходы %) − стоимость закупки; интерфейс также показывает загрузку, закупку, выручку и маржу.
Топливо, collateral, cyno chain, риск, время пилота и изменение цены в пути не моделируются отдельными строками. Добавьте их в процент расходов. Инструмент считает выбранный материал и сохранённые рынки, но не сканирует автоматически все items и station pairs.
7. OBS-виджет и темы
Создание и подключение
- В блоке «Виджет для OBS» нажмите «Сгенерировать токен».
- Скопируйте URL полного или компактного режима.
- В OBS Studio добавьте источник Browser Source и вставьте URL.
- Настройте размер browser source под ширину выбранной темы.
Полный режим показывает персонажей; compact скрывает их. Главная сумма — текущая стоимость сжатой добычи, стоимость несжатой руды остаётся вторичной строкой. Виджет автоматически обновляется; стандартный интервал — 180 секунд.
Параметры URL
| Параметр | Пример | Назначение |
|---|---|---|
lang | ru / en | Язык overlay |
mode | compact | Скрыть список персонажей |
period | today, week, month | Период статистики |
refresh | 180 | Обновление от 30 до 3600 секунд |
theme | ID темы | Закрепить конкретную тему в URL |
Темы
Доступны встроенные presets: стандартная, high-sec, low-sec, null-sec, лёд и газ. Можно создать пользовательскую тему и настроить ширину, отступы, скругление, фон/прозрачность, обводку, цвета, размеры текста и разрешённый шрифт.
Активная тема применяется к обычной ссылке. «Копировать URL» на карточке темы создаёт fixed-theme link: он сохранит выбранное оформление, даже если позже активировать другую тему.
Управление token
- Перегенерировать — старые OBS и API URL немедленно перестанут работать.
- Отозвать — отключить widget/API до генерации нового token.
Любой, кто получил ссылку, может читать общую статистику добычи аккаунта. Не публикуйте URL целиком на скриншотах, в чатах или логах. География добычи по системам через этот token не отдаётся.
8. Публичный API для интеграций
В кабинете рядом с OBS находится готовый URL mining JSON API. Он подходит для Discord-ботов, Google Sheets, собственных dashboards и других read-only интеграций.
Основной формат: /api/mining/<token>?period=week
Основные параметры
period:today,yesterday,week,month,all,rangeили датаYYYY-MM-DD;character_id: фильтр по персонажу владельца token;date_fromиdate_to: границы дляperiod=range.
Что возвращается
Response содержит персонажей, ores, totals, compressed, три сценария refine и, когда применимо, ISK/hour, ore ranking и daily trends. Location breakdown по solar systems намеренно отсутствует: он доступен только в session-authenticated кабинете.
API ограничен по частоте запросов. При слишком частом обращении возвращается HTTP 429 и Retry-After. Относитесь к URL как к bearer secret; отдельного логина поверх token нет.
9. Время, цены и обновление данных
- EVE Time / UTC. Mining dates, ticks, price history и фильтры не переводятся в локальный часовой пояс. Добыча после местной полуночи может относиться к предыдущей UTC-дате.
- Mining ledger. EMH хранит накопленную локальную историю и не удаляет старые записи только потому, что они вышли из текущего окна ESI.
- Частота. Активные персонажи опрашиваются чаще, но ESI cache, задержка cron и состояние token могут отложить отображение.
- Jita mid. Основная оценка использует max Buy и min Sell Jita 4-4. При отсутствии одной стороны берётся доступная сторона; при отсутствии ордеров возможна явно обозначенная global average.
- Историческая оценка. Для прошлых периодов EMH старается использовать ближайшую сохранённую цену не позже даты добычи. Текущий compressed stock оценивается по текущим ценам compressed types.
- Неполные цены. Нулевая или отсутствующая цена не должна восприниматься как бесплатный предмет. Производство помечает fallback/unavailable и скрывает неполную прибыль.
10. Решение частых проблем
Персонаж добавлен, но добыча не появилась
Проверьте статус token, выбранный UTC-период и наличие widget token. Подождите очередного ESI polling cycle. Mining ledger обновляется ESI не мгновенно.
Вместо статистики пустой кабинет
Для загрузки общей mining statistics нужен хотя бы один персонаж и сгенерированный widget token. Создайте token в блоке OBS/API.
Структуры не находятся или точный стакан недоступен
Нажмите «Разрешить рынки и автопоиск» и повторно авторизуйте персонажа с docking/ACL. Если structure не встречалась в public catalog или wallet transactions, вставьте её EVE showinfo link/ID. Отсутствие фактического ACL нельзя обойти авторизацией EMH.
Производство показывает неполную цену
Для одного из inputs или продукта нет Jita order и допустимой average price. Проверьте отмеченные строки, ликвидность предмета и ручную стоимость blueprint. EMH намеренно не считает неизвестную цену нулём.
Mining stock больше реального ангара
Он построен по mining ledger выбранного периода. Продажи и расход материалов не вычитаются, потому что это не ESI Assets. Выберите более подходящий период или скорректируйте сценарий вручную.
OBS не обновляется или показывает старый дизайн
Проверьте URL, refresh interval и cache Browser Source. Если token был перегенерирован, замените старую ссылку. Для fixed-theme URL убедитесь, что нужная тема не удалена.
Планетрака даёт слишком оптимистичный результат
Сравнение использует эвристику P0 capacity и не знает hotspots, depletion, layout и налоги POCO. Сверяйте прогноз со своей фактической колонией.
Контрольный список
- Все майнинг-персонажи подключены и имеют активный token.
- Для рынков повторно авторизован хотя бы один подходящий персонаж.
- Создан widget token, а URL хранится в секрете.
- Период проверен с учётом UTC.
- В production заполнены реальные ME/TE, площадка, система, налоги и blueprint cost.
- Mining stock не принимается за фактический ESI Assets.
- В торговый маршрут вручную заложены топливо, риск и время.
Сервис бесплатный. Если EMH помогает вашему флоту, вы можете заглянуть на страницу «Ваша поддержка».