Wayfinder [Minimap]

🗺️ Wayfinder

Un plugin de minimapa del lado del servidor para Hytale que muestra una superposición de HUD en tiempo real con imágenes del mapa, dirección de la brújula, coordenadas, puntos de interés de NPC hostiles y de jugadores, ¡y con un reloj incorporado!

Es importante señalar que este mod es más una prueba de concepto / demostración técnica que un producto completamente pulido. Si bien funciona bien para casos de uso básicos, hay algunas limitaciones y detalles a tener en cuenta:

• El minimapa es una cuadrícula fija de 40×40 píxeles y no soporta desplazamiento ni panorámica.
• Las imágenes del mapa son básicas y pueden no representar todos los biomas o estructuras con precisión.
• Las funciones avanzadas como puntos de ruta, marcadores o iconos personalizados no están implementadas.
• El rendimiento puede variar según el hardware del servidor y el número de jugadores.

📋 Dependencias

Plugin	Version	Required
MultipleHUD	1.0.1+	Sí

✨ Características

• 📍 Minimap en tiempo real — Cuadrícula de 40×40 píxeles que muestra datos del mapa del mundo actual.
• 🧭 Pantalla de brújula — Muestra la dirección cardinal (N, NE, E, SE, S, SW, W, NW) con el rumbo en grados.
• 📐 Pantalla de coordenadas — Coordenadas X, Y, Z en vivo.
• 🕐 Reloj en el juego — Muestra la hora actual en el juego (formato de 12 horas o 24 horas).
• 🔍 Niveles de zoom configurables — Múltiples preajustes de zoom (Cerca, Medio, Lejos).
• 📍 Posición ajustable — Mueve el minimapa a cualquier esquina de la pantalla.
• 🔴 Puntos de NPC hostiles — Ve a los mobs hostiles cercanos como puntos de colores en el minimapa
  • Modo de detección configurable: lista de tipos de NPC estáticos (con comodines) o basado en actitudes.
  • Color de punto personalizable a nivel de servidor y por jugador.
  • Conmutadores a nivel de servidor y por jugador.
• 🔵 Marcadores de jugadores — Ve a otros jugadores como puntos de colores en el minimapa
  • Color de punto personalizable a nivel de servidor y por jugador.
  • Conmutadores a nivel de servidor y por jugador.
• 🔄 Rotación del mapa — Elige norte arriba (fijo) o rotar con la orientación del jugador.
• 💾 Configuración por jugador — Visibilidad, zoom, posición, puntos, formato del reloj y preferencias de rotación persisten entre sesiones.
• ⚡ Optimizado para rendimiento — Los píxeles del mapa solo se actualizan cuando cambia la posición del jugador.
• 🎛️ Interfaz de configuración en el juego — Configuración fácil a través de una interfaz visual.

🎮 Comandos

Comando	Alias	Descripción
/wayfinder open	/wf open	Muestra el minimapa
/wayfinder close	/wf close	Oculta el minimapa
/wayfinder toggle	/wf toggle	Alterna la visibilidad del minimapa
/wayfinder settings	/wf settings	Abre el menú de configuración

⚙️ Configuración

Configuración del servidor

Ubicada en mods/x3Dev_Wayfinder/config.json:

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

Opción	Tipo	Predeterminado	Descripción
ZoomLevels	Mapa	Cerca: 1, Medio: 2, Lejos: 4	Niveles de zoom disponibles (nombre → bloques por píxel)
DefaultZoom	String	"Medium"	Nivel de zoom predeterminado para nuevos jugadores
DefaultCorner	String	"TopLeft"	Posición predeterminada del minimapa para nuevos jugadores. Valores válidos: TopLeft, TopRight, BottomLeft, BottomRight
UpdateIntervalMs	Integer	100	Milisegundos entre actualizaciones del minimapa
InitialDelayMs	Integer	500	Retraso antes de la primera actualización después de mostrar el minimapa
AutoShowOnJoin	Boolean	true	Mostrar automáticamente el minimapa cuando los jugadores se unan
EnableHostileMobTracking	Boolean	true	Conmutador maestro para puntos de NPC hostiles en el minimapa
HostileMobColor	String	"#ff3333"	Color hexadecimal predeterminado para puntos de NPC hostiles
HostileMobRange	Integer	48	Rango de detección en bloques para NPC hostiles (8-128)
UseHostileList	Boolean	true	true = usar lista HostileNpcTypes, false = usar sistema de actitudes de NPC
HostileNpcTypes	Array	(ver abajo)	Patrones de tipo de NPC para marcar como hostiles. Soporta comodines: Skeleton* (prefijo), *_Void (sufijo), *Spider* (contiene)
EnablePlayerTracking	Boolean	true	Conmutador maestro para marcadores de jugadores en el minimapa
PlayerMarkerColor	String	"#3399ff"	Color hexadecimal predeterminado para marcadores de jugadores
PlayerTrackingRange	Integer	64	Rango de detección en bloques para otros jugadores (8-128)

Configuración del jugador

Almacenada por jugador en mods/x3Dev_Wayfinder/players/{uuid}.json:

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

Opción	Tipo	Predeterminado	Descripción
Visible	Boolean	true	Si el minimapa se muestra actualmente
Zoom	Integer	2	Nivel de zoom actual (bloques por píxel)
Corner	String	"TopLeft"	Posición del minimapa en la pantalla
ShowHostileMobs	Boolean	true	Si se deben mostrar los puntos de NPC hostiles
HostileMobColor	String	null	Sustitución de color de punto hostil personalizado (null = usar el predeterminado del servidor)
RotateWithPlayer	Boolean	false	false = norte siempre arriba, true = el mapa rota con el jugador
Use24HourClock	Boolean	false	false = formato de 12 horas (AM/PM), true = formato de 24 horas
ShowPlayers	Boolean	true	Si se deben mostrar otros jugadores en el minimapa
PlayerMarkerColor	String	null	Sustitución de color de marcador de jugador personalizado (null = usar el predeterminado del servidor)

⚠️ Consideraciones de rendimiento

Importante: Wayfinder es un mod del lado del servidor. Todo el renderizado y las actualizaciones del minimapa son procesados por el servidor y enviados a los clientes como paquetes de UI.

Recomendaciones para servidores de alta población

Si planeas ejecutar Wayfinder en servidores con muchos jugadores concurrentes, considera los siguientes ajustes:

Jugadores	Intervalo de actualización recomendado UpdateIntervalMs
1-3	100
4-5	200-300
6-10	500
11+	1000

Nota: No he probado los valores anteriores, todo depende del hardware de tu servidor. Ajusta según el rendimiento real y la experiencia de los jugadores.

Consejos adicionales:

• 🔄 El minimapa solo envía actualizaciones de píxeles cuando cambia la posición de un jugador, reduciendo el tráfico innecesario.
• 📊 Monitorea el rendimiento del servidor y ajusta UpdateIntervalMs en consecuencia.
• 🚫 Considera establecer AutoShowOnJoin en false y permitir que los jugadores opten por unirse en servidores muy grandes.
• 🔍 Niveles de zoom más altos (más bloques por píxel) pueden reducir la frecuencia de actualización a medida que los jugadores recorren el mundo más rápido en relación con el mapa.

📦 Instalación

• Descarga MultipleHUD y colócalo en la carpeta mods de tu servidor.
• Descarga Wayfinder y colócalo en la carpeta mods de tu servidor.
• Inicia el servidor: la configuración predeterminada se creará automáticamente.
• Ajusta config.json según sea necesario para los requisitos de tu servidor.