Advanced Discovery Maps

Description

Advanced Discovery Maps: A Topological and Telemetry Overhaul 🔗

Advanced Discovery Maps is a professional-grade evolution of the original discovery_maps mod for Luanti. It features a completely rewritten rendering engine, introducing advanced cartographic tools such as topographic shading, multi-layered geological scanning, and a highly responsive UI with dynamic waypoint telemetry.

This project was built focusing on extreme optimization, delivering complex 3D-aware mapping while maintaining a tiny memory footprint and preventing CPU throttling on entry-level hardware.

✨ Key Features & Improvements 🔗

• Topographic Shading & Dual-Buffer Rendering: Generates both standard satellite and relief maps simultaneously. It uses differential height calculations to apply directional shadow multipliers, perfectly simulating 3D terrain illumination.
• Deep Cave & Bathymetric Scanning: The engine uses a "penetrating ray" algorithm to map underwater topography seamlessly. It also includes a strict State Machine vegetation filter to prevent tree canopies from being misidentified as cave ceilings.
• Asynchronous VoxelManip Engine: Synchronous map generation has been replaced with passive memory reading. Maps are drawn asynchronously using a task queue, avoiding Out of Memory (OOM) crashes and stuttering.
• Advanced UI/UX & Virtual Touch Navigation: The formspec has been mathematically redesigned to prevent clipping on any screen resolution. Click anywhere on the map to instantly center your view.
• Target-Tracking Telemetry: Replaced the legacy "greedy scanner" with a selectable dropdown target system. The engine isolates your chosen waypoint and calculates the exact Euclidean distance without unnecessary background loop iterations.
• Logarithmic Scaling & Dynamic Grids: Player avatars use a log-dampened scaling formula (Chevron polygon) to remain visible without obscuring the map. The cartesian grid subdivides dynamically based on your zoom level.
• Longitudinal Profiles (Topographic Analysis): Instantly generate cross-sectional elevation profiles of the terrain along the X or Z axis.
• Native i18n Support: Fully decoupled UI text using Luanti's native translation system (Spanish .tr file included).

🤝 Credits and Acknowledgements 🔗

This mod is a heavily optimized and expanded fork of the original discovery_maps by TomCon .

AI Assistance Disclosure: Much of the refactoring, logical optimization, and geometric stabilization of the user interface were developed with the help of the following Artificial Intelligences: Gemini, ChatGPT, DeepSeek, Grok, Claude, Vibe (LeChat).

Mapas de Descubrimiento Avanzados: Una Revisión Topológica y Telemétrica 🔗

Mapas de Descubrimiento Avanzados es una evolución profesional del mod original discovery_maps para Luanti. Incluye un motor de renderizado completamente rediseñado, con herramientas cartográficas avanzadas como sombreado topográfico, escaneo geológico multicapa y una interfaz de usuario altamente receptiva con telemetría dinámica de puntos de referencia.

Este proyecto se desarrolló con un enfoque en la optimización extrema, ofreciendo mapeo 3D complejo con un consumo mínimo de memoria y evitando la limitación de la CPU en hardware básico.

✨ Características y Mejoras Clave 🔗

• Sombreado Topográfico y Renderizado de Doble Búfer: Genera simultáneamente mapas satelitales estándar y de relieve. Utiliza cálculos de altura diferencial para aplicar multiplicadores de sombra direccionales, simulando a la perfección la iluminación del terreno 3D.

• Escaneo Batimétrico y de Cuevas Profundas: El motor utiliza un algoritmo de "rayos penetrantes" para mapear la topografía submarina sin problemas. También incluye un estricto filtro de vegetación basado en máquinas de estados para evitar que las copas de los árboles se confundan con techos de cuevas.

• Motor asíncrono de manipulación de vóxeles: La generación síncrona de mapas se ha sustituido por una lectura pasiva de memoria. Los mapas se dibujan de forma asíncrona mediante una cola de tareas, evitando fallos por falta de memoria (OOM) y tirones.

• Interfaz de usuario avanzada y navegación táctil virtual: La especificación del formulario se ha rediseñado matemáticamente para evitar el recorte en cualquier resolución de pantalla. Haz clic en cualquier parte del mapa para centrar la vista al instante.

• Telemetría de seguimiento de objetivos: Se ha sustituido el antiguo "escáner voraz" por un sistema de objetivos desplegable seleccionable. El motor aísla el punto de referencia elegido y calcula la distancia euclidiana exacta sin iteraciones innecesarias en segundo plano.

• Escalado logarítmico y cuadrículas dinámicas: Los avatares de los jugadores utilizan una fórmula de escalado amortiguada logarítmicamente (polígono de chevrón) para permanecer visibles sin ocultar el mapa. La cuadrícula cartesiana se subdivide dinámicamente según el nivel de zoom.

• Perfiles longitudinales (Análisis topográfico): Genera instantáneamente perfiles de elevación transversales del terreno a lo largo del eje X o Z.

• Compatibilidad con i18n nativa: Texto de la interfaz de usuario totalmente independiente mediante el sistema de traducción nativo de Luanti (archivo .tr en español incluido).

🤝 Créditos y agradecimientos 🔗

Este mod es una bifurcación altamente optimizada y ampliada del discovery_maps original de TomCon.

Divulgación de asistencia de IA: Gran parte de la refactorización, la optimización lógica y la estabilización geométrica de la interfaz de usuario se desarrollaron con la ayuda de las siguientes inteligencias artificiales: Gemini, ChatGPT, DeepSeek, Grok, Claude y Vibe (LeChat).