Wayfinder [Minimap]

A square/circle minimap with you at the center, configurable zoom, update frequency, hostile mobs, etc.

31.5 тысяча загрузок

Обновлён 6 дней назад

Улучшение Качества Жизни Утилиты Геймплей Разное

Скачать последнюю версию (67.1 КБ)

Скриншоты

Описание

️ Wayfinder

Плагин мини-карты на стороне сервера для Hytale, который отображает наложение HUD в реальном времени с изображениями карты, направлением компаса и координатами.

Стоит отметить, что этот мод больше похож на PoC / техническое демо, чем на полностью отполированный продукт. Хотя он хорошо работает для основных случаев использования, есть некоторые ограничения и грубые края, о которых следует знать:

Minimap представляет собой фиксированную сетку 40x40 пикселей и не поддерживает панорамирование или прокрутку.
Картографические изображения являются базовыми и не могут точно представлять все биомы или структуры.
Расширенные функции, такие как точки доступа, маркеры или пользовательские значки, не реализованы
Производительность может варьироваться в зависимости от серверного оборудования и количества игроков.

Depend Зависимости

Плагин	Версия	требуемый
мультипликатор	1.0.2+	Нет (необязательно)

Примечание: MultipleHUD является необязательным. При установке Wayfinder использует его для совместимости с другими плагинами HUD. Если он не установлен, Wayfinder отображает HUD напрямую, но если у вас есть другие моды HUD, они могут конфликтовать и вызывать сбои, проблемы с отображением, пустые карты, удары с серверов и т. Д.

️ Известные несовместимости

Плагин	Вопрос	Альтернатива
Шпион	Причин, по которым мини-карта становится пустой	Блоккио

Особенности

Минимум в реальном времени 40x40 пиксельная сетка, отображающая фактические данные карты мира
Дисплей Compass - Показывает кардинальное направление (N, NE, E, SE, S, SW, W, NW) с заголовком степени
Координационный дисплей Живые координаты X, Y, Z
Игровые часы Отображает текущее внутриигровое время (12-часовой или 24-часовой формат) с индикатором солнца / луны
Конфигурируемые уровни Zoom - Многократные предустановки зума (близкий, средний, дальний)
️️ Настраиваемая частота обновления Выберите из очень быстрых, быстрых, нормальных или медленных скоростей обновления
Выбор формы - Отображение мини-карты в виде квадрата или круга
Регулируемая позиция - Переместите мини-карту в любой угол экрана
Враждебные NPC Blips - Смотрите близлежащие враждебные толпы как цветные точки на мини-карте
- Настраиваемый режим обнаружения: статический список типов NPC (с дикими картами) или основанный на отношении
- Настраиваемый цвет блипа на уровне сервера и игрока
- Серверные и перплеерные переключатели
Игровые маркеры - Смотрите на других игроков как на цветные точки на мини-карте
- Настраиваемый цвет блипа на уровне сервера и игрока
- Серверные и перплеерные переключатели
Вращение карты - Выберите северную (фиксированную) или поворотную ориентацию
Ориентировочный индикатор игрока Стрела показывает, с какой стороны вы сталкиваетесь в северном режиме
s Настройки для игроков - Видимость, зум, положение, блипы, формат часов и предпочтения вращения сохраняются во время сеансов
Оптимизация производительности Картографические пиксели обновляются только при изменении позиции игрока
Режим Performance Опциональные пошатнувшиеся обновления распространяют изменения пикселей в нескольких кадрах, чтобы уменьшить заикание клиента
️ Игровые настройки UI Легкая конфигурация через визуальный интерфейс

Команды

Командование	Алиса	Описание
`/wayfinder open`	`WF Открыть`	Показать мини-карту
`Вейфиндер ближний`	`WF закрывается`	Спрячьте мини-карту
`/wayfinder переключатель`	`/wf переключатель`	Мини-карта видимости
`/wayfinder настройки`	`/wf настройки`	Откройте меню настроек

️ Конфигурация

Конфигурация сервера

Расположенный в mods/x3Dev_Wayfinder/config.json:

{
"ZoomLevels": {
"Близко": 1,
"Средний": 2,
"Далеко": 4
?
"DefaultZoom": "Средний",
«DefaultCorner»: «TopLeft»
«DefaultShape»: «Квадрат»,
«Обновление частот»: {
"Очень быстро": 100,
"Быстрый": 250,
"Нормальный": 500,
«Медленный»: 1000
?
"DefaultUpdateFrequency": "Обычная",
"UpdateIntervalMs": 500,
"InitialDelayMs": 500,
"AutoShowOnJoin": правда,
"EnableHostileMobTracking": правда,
«HostileMobColor»: #ff3333
"Враждебный Мобранж": 48,
"UseHostileList": правда,
"HostileNpcTypes": ["Skeleton*", "*_Void", "Trork_*", "Goblin_*"],
"EnablePlayerTracking": правда,
"PlayerMarkerColor": "#3399ff",
«PlayerTrackingRange»: 64
?

Вариант	Тип	по умолчанию	Описание
`Уровни Zoom`	Карта	Близко: 1, Среднее: 2, Дальнее: 4	Доступные уровни зума (имя → блоки на пиксель)
`DefaultZoom`	Струна	`"Средний"`	Уровень зума по умолчанию для новых игроков
`DefaultCorner`	Струна	`"Вверху слева"`	Минимум по умолчанию для новых игроков. Действительные значения: `Левый верх`, `Верхний правый`, `Внизу слева`, `Боттомрайт`
`Форма по умолчанию`	Струна	`"Квадрат"`	Форма мини-карты по умолчанию для новых игроков. Действительные значения: `Площадь`, `Круг`
`Обновление частотных опций`	Карта	Очень быстро: 100, Быстро: 250, Нормально: 500, Медленно: 1000	Доступные частоты обновления (имя -> миллисекунды)
`Частота обновления`	Струна	`"Нормальный"`	Частота обновления по умолчанию для новых игроков
`Обновление Interval Мисс`	целое число	`500`	Наследие в миллисекундах между обновлениями minimap
`Первоначальная задержка`	целое число	`500`	Задержка перед первым обновлением после отображения мини-карты
`AutoShowOnJoin`	булевый	`истинный`	Автоматически показывать мини-карту, когда игроки присоединяются
`Включить HostileMobTracking`	булевый	`истинный`	Master Toggle для враждебных блипов NPC на мини-карте
`HostileMobColor`	Струна	`"#ff3333"`	По умолчанию шестнадцатеричный цвет для враждебных всплесков NPC
`Враждебный режим`	целое число	`48`	Диапазон обнаружения в блоках для враждебных NPC (8-128)
`Используйте враждебный список`	булевый	`истинный`	`истинный` = использование `HostileNpcTypes` список, `ложный` Использование системы NPC
`HostileNpcTypes`	массив	(см. ниже)	Паттерны типа NPC обозначаются как враждебные. Поддержка wildcards: `Скелет` (приставка), `Void` (суффикс) `Паук` (содержит)
`Скачать PlayerTracking`	булевый	`истинный`	Master Toggle для маркеров игроков на мини-карте
`PlayerMarkerColor`	Струна	`"#3399ff"`	Цвет гекса по умолчанию для маркеров игроков
`ИгрокTrackingRange`	целое число	`64`	Диапазон обнаружения в блоках для других игроков (8-128)

Конфигурация игрока

Сохраняется для игрока в mods/x3Dev_Wayfinder/players/{uuid}.json:

{
"PlayerUuid": "player-uuid-here",
"Видимый": правда,
"Зум": 2,
"Угол": "Вверху слева",
"Форма": "Квадрат",
"UpdateIntervalMs": 500,
"ShowHostileMobs": правда,
"HostileMobColor": нуль,
"RotateWithPlayer": ложный,
"Use24HourClock": ложный,
"ShowPlayers": правда,
"PlayerMarkerColor": нуль,
«Режим исполнения»: ложный
?

Вариант	Тип	по умолчанию	Описание
`видимый`	булевый	`истинный`	Показана ли мини-карта
`Зум`	целое число	`2 2`	Текущий уровень зума (блоки на пиксель)
`угол`	Струна	`"Вверху слева"`	Минимальная позиция на экране
`форма`	Струна	`"Квадрат"`	Минимальная форма`Площадь` или `Круг`)
`Обновление Interval Мисс`	целое число	`500`	Частота обновления в миллисекундах (от опций сервера)
`Шоу-враждебные толпы`	булевый	`истинный`	Стоит ли показывать враждебные всплески NPC
`HostileMobColor`	Струна	`нулевой`	Обычный враждебный цвет блика переопределяется (`нулевой` = использовать сервер по умолчанию
`RotateWithPlayer`	булевый	`ложный`	`ложный` Север всегда вверх, `истинный` Карта вращается с игроком
`Использование 24HourClock`	булевый	`ложный`	`ложный` 12-часовой формат (AM/PM), `истинный` 24-часовой формат
`Игроки Show`	булевый	`истинный`	Показать других игроков на мини-карте
`PlayerMarkerColor`	Струна	`нулевой`	Пользовательский маркер цвета override`нулевой` = использовать сервер по умолчанию
`Режим Performance`	булевый	`ложный`	Позволяет шататься обновления пикселей, чтобы уменьшить заикание клиента

️ Соображения производительности

Важно: Wayfinder - это серверный мод. Все мини-карты и обновления обрабатываются сервером и отправляются клиентам в виде пакетов пользовательского интерфейса.

Режим Performance

Если игроки испытывают заикание клиентов при обновлении мини-карты, они могут включить Режим Performance В меню настроек. Это распространяет обновления пикселей по нескольким кадрам:

Режим	поведение	Лучшее для
Оставить (по умолчанию)	Обновление 1600 пикселей одновременно	Максимальная визуальная отзывчивость
На	Обновления разделены на 2 горизонтальные полосы	Снижение заикания на стороне клиента

Когда включен режим производительности:

Сетка 40x40 разделена на верхнюю и нижнюю половины.
Каждая половина обновлений на чередующихся клещах
Полное обновление карты занимает 2 цикла обновления вместо 1
Цикл обновления всегда завершается полностью, даже если игрок перестает двигаться (предотвращает десинхронизацию карты).

Установка

Скачать Wayfinder и разместить на сервере мод папка
(необязательно) Download мультипликатор Совместимость с другими HUD плагинами
Запустите сервер — конфигурация по умолчанию будет создана автоматически
отрегулировать config.json По мере необходимости для требований вашего сервера

Показать оригинальное описание (English)

🗺️ Wayfinder

A server-side minimap plugin for Hytale that displays a real-time HUD overlay with map imagery, compass direction, and coordinates.

Its worth noting that this mod is more of a PoC / tech demo than a fully polished product. While it functions well for basic use cases, there are some limitations and rough edges to be aware of:

The minimap is a fixed 40x40 pixel grid and does not support panning or scrolling
Map imagery is basic and may not represent all biomes or structures accurately
Advanced features like waypoints, markers, or custom icons are not implemented
Performance may vary based on server hardware and player count

📋 Dependencies

Plugin	Version	Required
MultipleHUD	1.0.2+	No (Optional)

Note: MultipleHUD is optional. If installed, Wayfinder uses it for compatibility with other HUD plugins. If not installed, Wayfinder displays the HUD directly, but if you do have other HUD mods, they may conflict and cause crashes, display issues, blank maps, kicks from the servers etc.

⚠️ Known Incompatibilities

Plugin	Issue	Alternative
EyeSpy	Causes the minimap to render blank	Blocchio

✨ Features

📍 Real-time Minimap — 40x40 pixel grid displaying actual world map data
🧭 Compass Display — Shows cardinal direction (N, NE, E, SE, S, SW, W, NW) with degree heading
📐 Coordinate Display — Live X, Y, Z coordinates
🕐 In-Game Clock — Displays current in-game time (12-hour or 24-hour format) with sun/moon indicator
🔍 Configurable Zoom Levels — Multiple zoom presets (Close, Medium, Far)
⏱️ Configurable Update Frequency — Choose from Very Fast, Fast, Normal, or Slow update speeds
🔲 Shape Selection — Display the minimap as a square or circle
📍 Adjustable Position — Move the minimap to any corner of the screen
🔴 Hostile NPC Blips — See nearby hostile mobs as colored dots on the minimap
- Configurable detection mode: static NPC type list (with wildcards) or attitude-based
- Customizable blip color at server and per-player level
- Server-wide and per-player toggles
🔵 Player Markers — See other players as colored dots on the minimap
- Customizable blip color at server and per-player level
- Server-wide and per-player toggles
🔄 Map Rotation — Choose north-up (fixed) or rotate-with-player orientation
➡️ Directional Player Indicator — Arrow shows which way you're facing in north-up mode
💾 Per-Player Settings — Visibility, zoom, position, blips, clock format, and rotation preferences persist across sessions
⚡ Performance Optimized — Map pixels only update when player position changes
🚀 Performance Mode — Optional staggered updates spread pixel changes across multiple frames to reduce client stuttering
🎛️ In-Game Settings UI — Easy configuration through a visual interface

🎮 Commands

Command	Alias	Description
`/wayfinder open`	`/wf open`	Show the minimap
`/wayfinder close`	`/wf close`	Hide the minimap
`/wayfinder toggle`	`/wf toggle`	Toggle minimap visibility
`/wayfinder settings`	`/wf settings`	Open the settings menu

⚙️ Configuration

Server Configuration

Located at mods/x3Dev_Wayfinder/config.json:

{
  "ZoomLevels": {
    "Close": 1,
    "Medium": 2,
    "Far": 4
  },
  "DefaultZoom": "Medium",
  "DefaultCorner": "TopLeft",
  "DefaultShape": "Square",
  "UpdateFrequencyOptions": {
    "Very Fast": 100,
    "Fast": 250,
    "Normal": 500,
    "Slow": 1000
  },
  "DefaultUpdateFrequency": "Normal",
  "UpdateIntervalMs": 500,
  "InitialDelayMs": 500,
  "AutoShowOnJoin": true,
  "EnableHostileMobTracking": true,
  "HostileMobColor": "#ff3333",
  "HostileMobRange": 48,
  "UseHostileList": true,
  "HostileNpcTypes": ["Skeleton*", "*_Void", "Trork_*", "Goblin_*"],
  "EnablePlayerTracking": true,
  "PlayerMarkerColor": "#3399ff",
  "PlayerTrackingRange": 64
}

Option	Type	Default	Description
`ZoomLevels`	Map	Close: 1, Medium: 2, Far: 4	Available zoom levels (name → blocks per pixel)
`DefaultZoom`	String	`"Medium"`	Default zoom level for new players
`DefaultCorner`	String	`"TopLeft"`	Default minimap position for new players. Valid values: `TopLeft`, `TopRight`, `BottomLeft`, `BottomRight`
`DefaultShape`	String	`"Square"`	Default minimap shape for new players. Valid values: `Square`, `Circle`
`UpdateFrequencyOptions`	Map	Very Fast: 100, Fast: 250, Normal: 500, Slow: 1000	Available update frequencies (name -> milliseconds)
`DefaultUpdateFrequency`	String	`"Normal"`	Default update frequency for new players
`UpdateIntervalMs`	Integer	`500`	Legacy fallback milliseconds between minimap updates
`InitialDelayMs`	Integer	`500`	Delay before first update after showing minimap
`AutoShowOnJoin`	Boolean	`true`	Automatically show minimap when players join
`EnableHostileMobTracking`	Boolean	`true`	Master toggle for hostile NPC blips on the minimap
`HostileMobColor`	String	`"#ff3333"`	Default hex color for hostile NPC blips
`HostileMobRange`	Integer	`48`	Detection range in blocks for hostile NPCs (8-128)
`UseHostileList`	Boolean	`true`	`true` = use `HostileNpcTypes` list, `false` = use NPC attitude system
`HostileNpcTypes`	Array	(see below)	NPC type patterns to mark as hostile. Supports wildcards: `Skeleton` (prefix), `_Void` (suffix), `Spider` (contains)
`EnablePlayerTracking`	Boolean	`true`	Master toggle for player markers on the minimap
`PlayerMarkerColor`	String	`"#3399ff"`	Default hex color for player markers
`PlayerTrackingRange`	Integer	`64`	Detection range in blocks for other players (8-128)

Player Configuration

Stored per-player at mods/x3Dev_Wayfinder/players/{uuid}.json:

{
  "PlayerUuid": "player-uuid-here",
  "Visible": true,
  "Zoom": 2,
  "Corner": "TopLeft",
  "Shape": "Square",
  "UpdateIntervalMs": 500,
  "ShowHostileMobs": true,
  "HostileMobColor": null,
  "RotateWithPlayer": false,
  "Use24HourClock": false,
  "ShowPlayers": true,
  "PlayerMarkerColor": null,
  "PerformanceMode": false
}

Option	Type	Default	Description
`Visible`	Boolean	`true`	Whether the minimap is currently shown
`Zoom`	Integer	`2`	Current zoom level (blocks per pixel)
`Corner`	String	`"TopLeft"`	Minimap position on screen
`Shape`	String	`"Square"`	Minimap shape (`Square` or `Circle`)
`UpdateIntervalMs`	Integer	`500`	Update frequency in milliseconds (from server options)
`ShowHostileMobs`	Boolean	`true`	Whether to show hostile NPC blips
`HostileMobColor`	String	`null`	Custom hostile blip color override (`null` = use server default)
`RotateWithPlayer`	Boolean	`false`	`false` = north always up, `true` = map rotates with player
`Use24HourClock`	Boolean	`false`	`false` = 12-hour format (AM/PM), `true` = 24-hour format
`ShowPlayers`	Boolean	`true`	Whether to show other players on the minimap
`PlayerMarkerColor`	String	`null`	Custom player marker color override (`null` = use server default)
`PerformanceMode`	Boolean	`false`	Enables staggered pixel updates to reduce client stuttering

⚠️ Performance Considerations

Important: Wayfinder is a server-side mod. All minimap rendering and updates are processed by the server and sent to clients as UI packets.

Recommendations for High-Population Servers

If you plan to run Wayfinder on servers with many concurrent players, consider the following adjustments:

Players	Recommended `UpdateIntervalMs`
1-3	`100`
4-5	`200-300`
6-10	`500`
11+	`1000`

Note: I haven't tested the above values, it all comes down to your server hardware. Adjust based on actual performance and player experience.

Additional tips:

🔄 The minimap only sends pixel updates when a player's position changes, reducing unnecessary traffic
📊 Monitor server performance and adjust UpdateIntervalMs accordingly
🚫 Consider setting AutoShowOnJoin to false and letting players opt-in on very large servers
🔍 Higher zoom levels (more blocks per pixel) may reduce update frequency as players traverse the world faster relative to the map

Performance Mode

If players experience client stuttering when the minimap updates, they can enable Performance Mode in the settings menu. This spreads pixel updates across multiple frames:

Mode	Behavior	Best For
Off (default)	All 1,600 pixels update at once	Maximum visual responsiveness
On	Updates split into 2 horizontal bands	Reducing client-side stuttering

When Performance Mode is enabled:

The 40x40 grid is divided into top and bottom halves
Each half updates on alternating ticks
A full map refresh takes 2 update cycles instead of 1
The update cycle always completes fully, even if the player stops moving (prevents half-map desync)