🗺️ SurveyorMap

Minimapa persistente e client-side no HUD inferior esquerdo — espelha o mapa nativo do R.E.P.O. sem overlays falsos. Persistent client-side minimap in the bottom-left HUD — mirrors the native R.E.P.O. map with full fidelity.

Português

O SurveyorMap lê a câmera de mapa real do jogo e exibe um minimapa persistente no canto inferior esquerdo da tela durante o gameplay. Mesma geometria, mesmas cores e mesma fidelidade que o TAB — sem overlays falsos.

🎯 Funcionalidades

• 🗺️ Minimapa persistente — HUD inferior esquerdo, visível apenas durante o gameplay. Some nos menus e no lobby.
• 📷 Fidelidade nativa — lê a câmera de mapa real do jogo (activeTexture). Mostra a geometria real das salas, marcadores nativos e fidelidade das paredes.
• M — pressione para mostrar/ocultar o minimapa sem afetar o TAB nativo.
• 🛡️ TAB seguro — ao abrir o TAB, o minimapa persistente some automaticamente. O TAB não é afetado.
• 🎛️ Modo de edição F8 — cursor liberado e câmera suspensa automaticamente ao entrar no F8; você pode editar o minimapa sem mover a câmera do jogador. Config salva automaticamente ao sair.
• 🔍 Scroll (no F8) — ajusta o tamanho do minimapa.
• 🔎 + / - — ajustam o zoom dentro ou fora do F8.
• 👁️ Marcadores de inimigos — mostra posições de inimigos no mapa. Inimigos mortos/despawnados são removidos em ~2s. Forma e cor indicam o nível de ameaça de forma redundante.
• 🔇 Silencioso por padrão — DebugLogging=false; emite apenas uma linha no log em uso normal.
• 🟢 Client-side — nenhum outro jogador precisa instalar. Sem RPCs. Sem alteração de rede.

🎮 Controles

👁️ Sistema visual dos marcadores de inimigos

Forma e cor comunicam o mesmo nível de ameaça do inimigo, de forma redundante. Isso maximiza a legibilidade no minimapa pequeno — você identifica o perigo pela forma ou pela cor.

O nível de ameaça é derivado do campo difficulty do inimigo. Palavras-chave no nome/tipo podem elevar o nível (nunca reduzir):

• veryheavy → elevado para pelo menos Alta (triângulo/lilás)
• trudge, slow walker, boss, elite → elevado para Crítica (estrela/vermelho)
• hunt, huntsman, bang, rush, charge → elevado para pelo menos Alta (triângulo/lilás)

⚙️ Configuração

📋 Notas

• O minimapa é puramente client-side e não afeta outros jogadores.
• RevealRoomsMode = NativeGlobal chama RoomVolume.SetExplored(), o que também revela salas no TAB nativo — comportamento opt-in documentado, não é o padrão.
• Filtro de marcadores por sala inexplorada: removido em v1.0 (a API nativa de exploração de salas em modo Vanilla não é confiável o suficiente para uso em produção).

English

SurveyorMap reads the game's own map camera and displays a persistent minimap in the bottom-left HUD during gameplay. Same geometry, same colours, and same fidelity as the TAB map — no fake overlays.

🎯 Features

• 🗺️ Persistent minimap — bottom-left HUD, visible only during gameplay. Disappears in menus and lobby.
• 📷 Native map fidelity — reads the game's own map camera (activeTexture). Shows real room geometry, native markers, and wall fidelity.
• M — press to show/hide the minimap without affecting the native TAB map.
• 🛡️ TAB-safe — when you open the TAB map, the persistent minimap hides automatically. TAB is unaffected.
• 🎛️ F8 Edit Mode — cursor unlocked and camera suspended automatically on entry; edit the minimap without spinning the player's view. Config is saved on exit.
• 🔍 Scroll (in F8) — adjusts minimap size.
• 🔎 + / - — adjust zoom inside or outside F8.
• 👁️ Enemy markers — shows enemy positions on the map. Dead/despawned enemies are cleaned up in ~2s. Shape and colour both indicate threat level, redundantly.
• 🔇 Silent by default — DebugLogging=false; emits only one line in normal use.
• 🟢 Client-side — no other players need to install it. No RPCs. No network changes.

🎮 Controls

👁️ Enemy marker visual system

Shape and colour both communicate the same threat level — redundantly. This maximises readability on a small minimap — you recognise the danger by glyph or colour at a glance.

Threat level is derived from the enemy's difficulty field. Name/type keywords can only elevate the tier (never reduce it):

• veryheavy → elevated to at least High (triangle / lilac)
• trudge, slow walker, boss, elite → elevated to Critical (star / red)
• hunt, huntsman, bang, rush, charge → elevated to at least High (triangle / lilac)

⚙️ Configuration

📋 Notes

• The minimap is purely client-side and does not affect other players.
• RevealRoomsMode = NativeGlobal calls RoomVolume.SetExplored() which also reveals rooms in the native TAB map — intentional opt-in, not the default.
• Room-exploration-based marker filtering: removed in v1.0 (the native room exploration API in Vanilla mode is not reliable enough for production use).