Shared Map and Auto Discover

Versão em português logo abaixo da inglesa.

One map for the whole server. Everything any player explores shows up explored for everyone, and the places you find are marked on the map for everyone, with pixel icons and a one-word name that is always visible on the large map. Every player also shows on the map in their own color.

Install it on the server and on every player. Requires Jötunn.

What gets marked

Group	Examples	How it is discovered
Ores	Copper, Tin, Silver, Obsidian, Iron (muddy scrap piles), Black marble, Ancient scrap, Soft tissue, Flametal, Gammeltroll	When its name shows on your crosshair (up to 5 m), intact or already partly mined. Giant skeletons with a brain (Soft tissue), groups of ancient swords (Scrap) and the Petrified Gammeltroll are also marked by the visibility rule
Dungeons	Burial chambers, Sunken crypts, Troll and Bear caves, Frost caves, Infested mines and citadel, Putrid holes, Mörkhalla, Winding tunnels, Hildir's three dungeons	Visibility rule
Structures	Abandoned houses, towers, ruins, villages, Fuling villages and huts, greydwarf camps, stone circles, wells, dig sites, Mistlands spires with a Dvergr chest, Charred fortress, shipwrecks, runestones	Visibility rule
Gathering	Drake nests, volture nests, sulfur arches, infested trees, tar pits, broken Mistlands bridges (iron)	Visibility rule
Bosses	Eikthyr, The Elder, Bonemass, Moder, Yagluth, Fader and Kall Fimbulbringer	Visibility rule
Spawners	Greydwarf nests, evil bone piles, body piles, fire holes, Monuments of Torment, Effigies of Malice and the Deep North spawners	Visibility rule
Bases	Any bed with comfort 4 or more (shelter + bed + fire is already 4)	Visibility rule

Ore and spawner markers disappear by themselves when the deposit is mined out or the spawner is destroyed. So do the places that are worth what they hold: a bridge when its last iron piece is dismantled, a giant skeleton when its brain is mined out, a spire when its chest is emptied (within 10 minutes). A base marker disappears when the base loses its bed or drops below comfort 4. A fire that ran out of wood still counts, so the base does not vanish every time the fire goes out.

While a giant skeleton still has its brain, it is a single Soft tissue point: aiming at its skull, ribs or sword marks the tissue, not Marble or Scrap.

Visibility rule

A place is marked when, for 1.5 seconds in a row:

• it is in the center of your screen (you are looking at it);
• nothing blocks the view: terrain, trees, rocks and buildings block it, grass and bushes do not;
• it looks big enough for its contrast. The mod compares, in the image the game actually drew, the color of the place with the color around it. A drake nest on snow or a tower against the sky counts from far away (1.5% of the screen height); a house in a dark forest, at night or in fog, has to be closer (8%).

Walking into a place marks it even without looking. For spawners and beds, getting within 10 m counts.

Places only exist in the game within the simulation distance (about 130 to 190 m with the default setting), so nothing farther than that is ever marked.

Crossing off and hiding points

On the large map, right-click a point to open a small menu:

• Cross off (for everyone): puts the game's red X on the point. Every player sees it, on the map and on the minimap, and anyone can remove it.
• Hide for me: the point stays on your map and minimap at 10% visibility, and only for you. Right-click it again and choose Restore to bring it back.

Both are kept by the server, so they survive a new PC or a new mod profile. Right-clicking a marker you placed by hand still removes it, as in the base game. The menu needs a mouse.

Filters

The Filters button in the top left corner of the large map opens a window with all 61 types, in six groups. Unmark a type and its points leave your map and minimap at once; click a group title to switch the whole group.

Filters only change your own map. Hidden types are still discovered and still show for everyone else, but you do not get the discovery message for them. Your choice is saved in your own config file and applies on every server.

Shared map

The server keeps the combined explored map and sends it to everyone. The first time you join with the mod, your own explored map is added to it. Because of this, the Cartography Table is removed from the build menu (tables already built stay in the world). Markers you place by hand stay yours.

The server stores the points and the map in BepInEx/config/SharedMapAndAutoDiscover/<world>.vcmap, and the X marks and hidden points in <world>.marcas.txt next to it, never in the world folder. Once a day it keeps a dated copy of both in the copias folder (the last 14 stay).

Players on the map

Every player shows on the minimap and on the large map in their own color: the player icon, the name on the large map and your own arrow all use it.

• The server gives each person the first free color the first time they join: red, blue, yellow, purple, orange, cyan, pink, green, white, black.
• The color belongs to the Steam account, so all characters of the same person share it.
• It never changes and is the same in every world of that server. The server keeps it in BepInEx/config/SharedMapAndAutoDiscover/cores-dos-jogadores.txt.

By default the mod also turns on the map's "Visible to other players" option for everyone and keeps it locked on. The server can turn that rule off, and then each player chooses again.

Languages

Marker names in English, Brazilian Portuguese, Spanish, French, German, Russian, Polish and Simplified Chinese. Other languages fall back to English. Wherever the game has an official name (greydwarf, guck, tar...), the translation uses it.

Configuration

Server rules (synced to all players): shared map on/off, remove cartography table, players always visible on map, seconds looking, minimum size for high, normal and low contrast, size of the screen center area, spawner and bed distance.

Per player: names on the minimap, discovery message, hidden marker types (edited by the Filters button), discovery log, flip screen capture (troubleshooting only).

Console commands

• sm_info: connection state, number of markers, crossed off and hidden points, hidden types and the last visibility check.
• sm_capture: saves the screen capture used for the contrast check to BepInEx/config/SharedMapAndAutoDiscover/capture.png.
• sm_colors: shows your map color and saves the 10 player icons to BepInEx/config/SharedMapAndAutoDiscover/player-icons.png.

---

Português

Um mapa só para o servidor inteiro. Tudo o que qualquer jogador explora aparece explorado para todos, e os lugares encontrados viram marcadores para todos, com ícone pixelizado e um nome de uma palavra sempre visível no mapa grande. Cada jogador também aparece no mapa com uma cor própria.

Instale no servidor e em todos os jogadores. Precisa do Jötunn.

O que é marcado

Grupo	Exemplos	Como é descoberto
Minérios	Cobre, estanho, prata, obsidiana, ferro (pilhas de sucata enlameada), mármore preto, sucata antiga, tecido mole, flametal, Gammeltroll	Quando o nome aparece na mira (a até 5 m), inteiro ou já minerado em parte. Os esqueletos de gigante com cérebro (Tecido mole), os grupos de espadas antigas (Sucata) e o Gammeltroll petrificado também são marcados pela regra de visão
Masmorras	Câmaras fúnebres, criptas afundadas, caverna troll, caverna do urso, cavernas de gelo, mina e cidadela infestadas, buracos pútridos, Mörkhalla, túneis sinuosos, as três masmorras da Hildir	Regra de visão
Estruturas	Casas abandonadas, torres, ruínas, vilas, vilas e cabanas Fuling, acampamentos de anões cinzentos, círculos de pedra, poços, escavações, pináculos da Névoa com baú dvergr, fortaleza carbonizada, naufrágios, pedras de runa	Regra de visão
Coleta	Ninhos de dragão, ninhos de uruvul, arcos de enxofre, árvores infestadas, poços de betume, pontes quebradas da Névoa (ferro)	Regra de visão
Chefes	Eikthyr, Ancião, Massa Óssea, Moder, Yagluth, Fader e Kall Fimbulbringer	Regra de visão
Spawns	Ninhos de anões cinzentos, pilhas de ossos malignos, pilhas de corpos, buracos de fogo, Monumentos da Tormenta, Efígies da Malícia e os spawns do Norte profundo	Regra de visão
Bases	Qualquer cama com conforto 4 ou mais (abrigo + cama + fogueira já dá 4)	Regra de visão

Os marcadores de minério e de spawn somem sozinhos quando o depósito acaba ou o spawn é destruído. O mesmo vale para os lugares que valem pelo que guardam: a ponte quando a última peça de ferro é desmontada, o esqueleto de gigante quando o cérebro acaba, o pináculo quando o baú é esvaziado (em até 10 minutos). O marcador de base some quando a base perde a cama ou fica com conforto abaixo de 4. A fogueira conta mesmo apagada, para a base não sumir do mapa toda vez que a lenha acaba.

Enquanto o esqueleto de gigante ainda tem o cérebro, ele é um ponto só de Tecido mole: mirar no crânio, nas costelas ou na espada marca o tecido, e não Mármore nem Sucata.

Regra de visão

Um local é marcado quando, por 1,5 segundo seguido:

• está no centro da tela (você está olhando para ele);
• nada tapa a visão: relevo, árvores, rochas e construções tapam; grama e arbustos, não;
• parece grande o bastante para o contraste que tem. O mod compara, na imagem que o jogo desenhou, a cor do local com a cor em volta. Um ninho de dragão na neve ou uma torre contra o céu contam de longe (1,5% da altura da tela); uma casa na floresta escura, de noite ou na neblina, precisa estar mais perto (8%).

Entrar no local marca sem precisar olhar. Para spawns e camas, basta chegar a 10 m.

Os locais só existem no jogo dentro da distância de simulação (uns 130 a 190 m na configuração padrão), então nada mais longe que isso é marcado.

Marcar com X e excluir pontos

No mapa grande, o clique direito num ponto abre um menu pequeno:

• Marcar com X (para todos): põe no ponto o X vermelho do jogo. Todos os jogadores veem, no mapa e no minimapa, e qualquer um pode tirar.
• Excluir para mim: o ponto fica no seu mapa e no minimapa com 10% de visibilidade, só para você. Clique nele com o botão direito de novo e escolha Restaurar para trazê-lo de volta.

Os dois ficam guardados no servidor, então continuam valendo num PC novo ou num perfil de mods novo. O clique direito num marcador feito à mão continua apagando, como no jogo. O menu precisa de mouse.

Filtros

O botão Filtros, no canto superior esquerdo do mapa grande, abre uma janela com os 61 tipos, em seis grupos. Desmarque um tipo, e os pontos dele saem na hora do seu mapa e do minimapa; clique no título de um grupo para mudar o grupo inteiro.

Os filtros só mudam o seu mapa. Os tipos ocultos continuam sendo descobertos e aparecem para os outros, mas você não recebe a mensagem de descoberta deles. A sua escolha fica no seu arquivo de configuração e vale em qualquer servidor.

Mapa compartilhado

O servidor guarda o mapa explorado de todos juntos e manda para cada um. Na primeira vez que você entra com o mod, o seu mapa explorado entra no de todos. Por isso, a Mesa de cartografia sai do menu de construção (as mesas já construídas ficam no mundo). Os marcadores que você faz à mão continuam só seus.

O servidor guarda os pontos e o mapa em BepInEx/config/SharedMapAndAutoDiscover/<mundo>.vcmap, e os X e os pontos excluídos em <mundo>.marcas.txt, ao lado dele, nunca na pasta do mundo. Uma vez por dia, ele guarda uma cópia datada dos dois na pasta copias (ficam as últimas 14).

Jogadores no mapa

Cada jogador aparece no minimapa e no mapa grande com uma cor própria, que vale para o ícone dele, o nome no mapa grande e a sua própria seta.

• O servidor dá a cada pessoa a primeira cor livre na primeira vez que ela entra: vermelho, azul, amarelo, roxo, laranja, ciano, rosa, verde, branco, preto.
• A cor é da conta Steam, então todos os personagens da mesma pessoa têm a mesma cor.
• Ela nunca muda e é a mesma em todos os mundos daquele servidor. O servidor guarda as cores em BepInEx/config/SharedMapAndAutoDiscover/cores-dos-jogadores.txt.

Por padrão, o mod também liga para todos a opção "Visível para outros jogadores" do mapa e a deixa travada. O servidor pode desligar essa regra, e aí cada jogador volta a escolher.

Idiomas

Os nomes dos marcadores estão em inglês, português do Brasil, espanhol, francês, alemão, russo, polonês e chinês simplificado. Os outros idiomas caem no inglês. Onde o jogo tem nome oficial (anão cinzento, gosma, betume...), a tradução usa esse nome.

Configurações

Regras do servidor (valem para todos os jogadores): mapa compartilhado, tirar a mesa de cartografia, jogadores sempre visíveis no mapa, segundos olhando, tamanho mínimo para contraste alto, normal e baixo, tamanho da área central da tela e distância de spawns e camas.

De cada jogador: nomes no minimapa, mensagem ao descobrir, tipos ocultos (editados pelo botão Filtros), registro das descobertas no log e captura de tela invertida (só para diagnóstico).

Comandos de console

• sm_info: estado da conexão, número de marcadores, pontos com X e excluídos, tipos ocultos e a última avaliação de visão.
• sm_capture: grava em BepInEx/config/SharedMapAndAutoDiscover/capture.png a captura de tela usada no contraste.
• sm_colors: mostra a sua cor no mapa e grava os 10 ícones de jogador em BepInEx/config/SharedMapAndAutoDiscover/player-icons.png.