MineTuner HUD

MineTuner HUD

Настраиваемый HUD производительности и статистики для Fabric.

Что такое MineTuner HUD?

MineTuner HUD заменяет ванильный экран отладки на внутриигровой HUD, который показывает только нужную вам статистику.

MineTuner — это чисто клиентский мод для Fabric. Он работает на любом сервере, и для его установки ничего не требуется на стороне сервера.

Возможности

• Несколько списков статистики — создавайте сколько угодно отдельных HUD-панелей, каждая со своим положением, стилем и настройками.
• Редактор с перетаскиванием (клавиша по умолчанию — H) — перетаскивайте списки в любое место экрана; правый клик по списку открывает его контекстное меню; правый клик по пустому месту создаёт новый список.
• Прилипание к центру при перетаскивании с видимой направляющей линией.
• 46 отслеживаемых параметров в четырёх категориях — производительность, игрок, мир и позиция — включая четыре необязательных параметра с аппаратных датчиков. Смотрите полную таблицу параметров ниже.
• Графики скользящей истории — некоторые параметры можно отображать в виде графика.
• Режим шаблона — альтернатива фиксированной раскладке списков статистики: пишите собственные строки текста и вставляйте токены параметров вроде {tps} и {fps} где угодно, свободно смешивая несколько параметров и обычный текст.
• Темы списков — сохраняйте полный внешний вид любого списка (фон, тень, свой цвет, масштаб текста, стиль графика) как именованную переиспользуемую тему; применяйте её к любому списку в один клик и выбирайте тему по умолчанию для новых списков.
• Экран Cloth Config (/minetuner config или через ModMenu, если он установлен) — экран настроек с поиском и единой прокруткой, охватывающий все поля minetuner.json, включая параметры тонкой настройки, для которых нет элементов управления в кастомном редакторе.
• Необязательная интеграция с LibreHardwareMonitor — включаемые по желанию параметры температуры GPU, частоты GPU, загрузки GPU и VRAM, опрашиваемые из Remote Web Server LibreHardwareMonitor в фоновом потоке.

Требования

MineTuner — чисто клиентский. На сервере ничего устанавливать не нужно.

Установка

1. Установите Fabric Loader.
2. Установите Fabric API и Cloth Config API в папку mods.
3. (Необязательно) Установите ModMenu для GUI-доступа к настройкам MineTuner.
4. Положите .jar MineTuner в папку mods.
5. Запустите игру.

Использование

Открытие редактора

Введите /minetuner gui или нажмите клавишу Open Editor (по умолчанию — H).

Управление в редакторе

Контекстное меню списка

Правый клик по списку открывает четыре действия:

• ⚙ Edit Stats — сгруппированная по категориям панель с поиском (Performance / Player / World / Position) для включения и выключения статов, изменения их порядка и открытия настроек отдельного стата: показ/скрытие префикса метки, количество знаков после запятой, отрисовка в виде графика и свои пороги цвета там, где это поддерживается.
• ▤ Appearance » — переименовать список, включить или выключить его фон и тень текста, переопределить цвет и масштаб текста (0.5×–2.0×), открыть Theme » для просмотра, применения, сохранения и удаления тем оформления, включить Template Mode и настроить привязку по горизонтали и вертикали.
• ⧉ Duplicate — клонировать список вместе со всеми его статами и настройками как основу для варианта.
• ✕ Delete — удалить список.

Темы списков

Тема — это именованный многоразовый набор всего, что касается того, как список выглядит: фон вкл/выкл, тень текста, свой цвет, масштаб текста и стиль графиков каждого стата. В неё не входит, какие статы показаны, их порядок, название списка или его место на экране — применение темы никогда не двигает список и не меняет его статы.

Откройте Appearance » Theme » из контекстного меню любого списка, чтобы:

• Применить тему — кликните по любой теме в списке, чтобы мгновенно придать текущему списку такой вид.
• Сохранить как новую тему — нажмите + Save as new theme, введите название и нажмите Enter, чтобы сохранить текущий вид списка как тему, которую потом можно применить к любому списку, включая тот, из которого она взялась. Если ввести название уже существующей пользовательской темы, она перезапишется («обновится») на месте вместо создания дубликата.
• Удалить тему — нажмите ✕ рядом с пользовательской темой. Встроенные темы помечены (built-in), их нельзя удалить, переименовать или перезаписать.

MineTuner поставляется с тремя встроенными темами:

Каждое поле внешнего вида, которое захватывает тема, можно также редактировать напрямую (не через тему) в панелях Appearance/Color-Scale или в полном экране Cloth Config ниже — темы просто позволяют применить несколько таких полей сразу.

Переключение оверлея

Нажмите клавишу Toggle Overlay (по умолчанию не назначена), чтобы мгновенно показать или скрыть HUD, не открывая редактор. Это не влияет на редактор: /minetuner gui по-прежнему открывается и показывает ваши списки как обычно, даже когда оверлей скрыт.

Полный экран настроек

Запустите /minetuner config, откройте MineTuner из списка модов ModMenu (если он установлен) или кликните правой кнопкой по пустому месту в редакторе и выберите Open Full Config. Откроется экран Cloth Config, охватывающий все поля minetuner.json в одном месте — общие настройки (включая Default List Theme, тему, применяемую к каждому новому списку — её изменение никогда не затрагивает уже существующие списки), настройки аппаратных сенсоров, тонкая настройка GUI редактора и полная конфигурация каждого списка (включая стиль графиков, для которого нет отдельного элемента управления в кастомном редакторе).

Template Mode

По умолчанию каждый список работает в classic mode: одна строка на включённый стат, в порядке, заданном в Edit Stats. Template Mode — это опциональная альтернатива для каждого списка отдельно: вместо фиксированного набора статов вы пишете свои строки текста с токенами статов, вставленными где угодно.

Включите её через панель Appearance » списка. После включения строка Edit Stats в контекстном меню становится Edit Template Lines, где каждая строка редактируется как свободный текст с подтверждением по Enter и отменой по Esc.

Синтаксис токенов

Заключите токен статистики в фигурные скобки, чтобы подставить его значение: {tps} вставит текущий TPS. Всё остальное в строке — обычный текст.

FPS: {fps} | TPS: {tps:2} | {ping}ms

может отрисоваться как:

FPS: 144 | TPS: 19.86 | 42ms

Модификаторы (через запятую после двоеточия):

Модификаторы комбинируются через запятую, например {cpu:0,color=#FF5555}. color= и graph=true не комбинируются на одном токене — график рисует свою собственную раскраску.

Чтобы показать буквальную фигурную скобку, удвойте её: {{ → {, }} → }.

Нераспознанный или некорректный токен ({tsp}, {ping:2}, {tps:graph=yes}) никогда не отбрасывается — он отрисовывается обратно как обычный текст, вместе со скобками, и записывает однократное предупреждение в лог клиента, чтобы ошибка была заметна.

По умолчанию строка шаблона отрисовывается одним сплошным цветом: пользовательским цветом списка, если он задан, иначе белым. Настройка Show Prefix из классического режима здесь не применяется — просто не вводите метку, если она вам не нужна.

Полная таблица токенов

Смотрите таблицу Stat Reference — столбец Token содержит точный текст для использования внутри { }.

Аппаратные датчики (включаются через LibreHardwareMonitor)

Все остальные статистики, которые показывает MineTuner, берутся напрямую из JVM или собственного состояния Minecraft. А вот температура GPU, частота, загрузка и использование VRAM — нет: ни один API JVM их не предоставляет. Поэтому эти четыре — опциональная интеграция с LibreHardwareMonitor.

Как это работает

MineTuner опрашивает встроенный Remote Web Server LHM примерно каждые 1,5 секунды по умолчанию. Он никогда не обращается напрямую к драйверу GPU, SDK или разделяемой памяти и никогда не трогает поток рендера: если LHM недоступен, медленный или не запущен, затронутые статистики просто не отрисовываются — так же, как MSPT скрывается на удалённом сервере. Никакого встроенного нативного кода или вендорского SDK здесь нет.

Настройка

1. Установите и запустите LibreHardwareMonitor.
2. В LHM перейдите в Options → Remote Web Server → Run. По умолчанию это отдаёт http://localhost:8085/data.json.
3. Включите это в MineTuner через экран Cloth Config (/minetuner config → Hardware Sensors) и задайте там базовый URL.

Если статистика не отображается

Эта функция по задумке отказывает молча, так что проверьте по порядку:

• hardwareSensorsEnabled равен true.
• LHM запущен, и его Remote Web Server отображается как активный в собственном интерфейсе LHM.
• hardwareSensorBaseUrl совпадает с портом, который фактически использует Remote Web Server LHM.
• Ничто локальное (брандмауэр, антивирус) не блокирует loopback-соединение.

Файл конфигурации

Настройки сохраняются автоматически и атомарно в .minecraft/config/minetuner.json. Вы можете просмотреть или сделать резервную копию этого файла, но нет нужды редактировать его вручную для чего-либо, что уже доступно через внутриигровой редактор или экран Cloth Config. Если файл конфигурации не удаётся разобрать, MineTuner сохраняет его резервную копию как `minetuner.json.bak-` и начинает заново, вместо того чтобы молча его отбрасывать.

Совместимость

• Только клиентская часть — работает с любым сервером (vanilla, Paper, Fabric и т.д.).
• MSPT доступен только в одиночных и LAN-мирах — на удалённых серверах, где эти данные не передаются, он молча скрывается.
• Датчики GPU/VRAM включаются по желанию и требуют отдельно запущенного LibreHardwareMonitor с включённым Remote Web Server; иначе они молча скрываются.
• MineTuner регистрирует свой оверлей через HudElementRegistry из Fabric API, прикрепляя его прямо перед слоем чата, так что он не конфликтует с другими HUD-модами.