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. Zoomed out, the large map joins nearby markers of the same type and never draws one icon over another, and a bar at the bottom shows or hides each group with one click. Every portal in the world shows on the map as well, and the portal tag window lists them all. 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

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.

The Ancient Root of the Mistlands is where the Sap Extractor goes. Roots less than 30 m apart share one point, and the point never disappears, since the root cannot be destroyed.

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.

Portals

Every portal built in the world shows on everyone's map and minimap, even far away ones, with an icon for its kind (wood, stone or the old portal) and its tag, always visible on the large map. A portal without a pair is half transparent, so you can see from afar which one is still waiting for its pair. The server keeps the list and sends it to everyone: a new or renamed portal shows up within 5 seconds, and a destroyed one leaves the map at once. Portal markers are not saved to your character, and right-clicking one neither opens the menu nor deletes it.

Portal list

Press E on a portal and, below the game's tag window, a list shows every portal in the world, grouped by tag. The game connects two portals whose tags are exactly the same.

• Available: portals without a pair whose tag no pair uses. Click one: this portal takes its tag and the window closes, as with OK. The two connect within 5 seconds.
• Pairs: the connected portals, with the icons of both ends. "(this)" marks the pair of the portal you are tagging.
• Repeated: portals without a pair whose tag a pair already uses, marked "leftover". The game does not connect a third portal, so they stay alone until renamed.

Each section is in alphabetical order. Pairs and Repeated are only for reference: clicking them does nothing. Hover any line to see the place on a piece of the map about 1 km across, with the same fog as your minimap (two maps for a pair). With more than about 10 lines the list scrolls: the mouse wheel scrolls it without zooming the camera, and with a controller, the right stick does. You can still type a tag, and Esc cancels. Signs and tamed animals use the same window and get no list.

The server can turn portals off ("Portals on map"): then neither the map nor the list shows any. The Portals button of the group bar only takes them off your own map; the list still shows them.

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.

Group bar

A bar at the bottom of the large map, above the key hints, has a big button for each group: Bases, Portals, Ores, Gathering, Dungeons, Bosses (with the Citadel, where the Queen is), Quests (Hildir's three dungeons, the Mysterious Locations and the quest pins), Merchants (Haldor, Hildir and the Bog Witch), Structures and Spawners. Each button shows how many points the group has.

• Click a button to show or hide the whole group. What you chose inside it is kept: turn the group back on and it comes back the same.
• Right-click it, or click its arrow, to open the group's list. Click a type to hide or show it, and its star to give it priority on the zoomed-out map.
• All and None sit at the end of the bar. Each list also has Show only this group and Show all types.
• An orange dot on a button means some types of the group are hidden.
• The Structures list also hides structures by who lives there. Hostile places spawn monsters of their own (the normal spawns of the biome do not count). Neutral ones only have Dvergr, who do not attack unless provoked. Empty ones have no creatures of their own. The server works it out for each point from the place itself, so a house in the Meadows is Empty and one in the Black Forest is Hostile.

Merchants and quest pins are icons the game itself puts on your map: they are only hidden from your screen, nothing is deleted, and they come back when you show them again.

The bar only changes 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 choices are saved in your own config file and apply on every server. The bar needs a mouse.

Zoomed out

Up close (a view up to 750 m tall), every marker shows with its name. Farther out, the large map keeps itself readable:

• Markers of the same type that are close together become a single icon in their middle, with the count (×5). Right-click it to zoom in there. As you zoom in, the groups split.
• No icon is drawn over another. When not everything fits, bases, portals, bosses, quests and merchants always keep their exact place. Starred types come next, then the rarest types on your map. Small buildings come last (houses, towers, ruins, stones, runestones and the like), and from afar they only show where the map has room around them.
• An icon that does not fit waits until you zoom in, and meanwhile it is listed in the tooltip of the icon that took its place.
• Only portals show their names. Hover any icon to see what it is and how many points it stands for.

The game opens the map at about 2,450 m. The minimap does not change. "Detail by zoom" in the config turns all this off. "Far view (m)" (1,500) and "Near view (m)" (750) set where the levels change.

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, portals 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 groups, hidden marker types, hidden inhabitant classes and starred types (all edited by the group bar), detail by zoom with the far and near view heights, discovery log, flip screen capture (troubleshooting only).

Console commands

• sm_info: connection state, number of markers, crossed off and hidden points, hidden groups, types and inhabitant classes, starred types, the portals received from the server (and how many have no pair), the zoomed-out layout 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. Com o mapa grande afastado, os marcadores do mesmo tipo perto uns dos outros viram um só, e nenhum ícone fica em cima de outro; uma barra no pé do mapa mostra ou esconde cada grupo com um clique. Os portais do mundo também aparecem no mapa, e a janela de nome do portal lista todos eles. 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

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.

A Raiz anciã das Terras nevoadas é onde vai o Coletor de seiva. Raízes a menos de 30 m uma da outra ficam num ponto só, e o ponto nunca some, porque a raiz não pode ser destruída.

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.

Portais

Todo portal construído no mundo aparece no mapa e no minimapa de todos, mesmo os distantes, com um ícone para cada tipo (madeira, pedra ou o portal antigo) e o nome dele, sempre visível no mapa grande. O portal sem par fica meio transparente, para você ver de longe qual ainda espera o par. O servidor guarda a lista e manda para todos: um portal novo ou renomeado aparece em até 5 segundos, e o destruído sai do mapa na hora. Os marcadores de portal não ficam salvos no personagem, e o clique direito num deles não abre o menu nem o apaga.

Lista de portais

Aperte E num portal e, embaixo da janela de nome do jogo, uma lista mostra todos os portais do mundo, agrupados pelo nome. O jogo liga dois portais de nome exatamente igual.

• Disponíveis: portais sem par cujo nome nenhum par usa. Clique num: este portal ganha o nome dele e a janela fecha, como no OK. Os dois se ligam em até 5 segundos.
• Pares: os portais ligados, com os ícones das duas pontas. "(este)" marca o par do portal que você está nomeando.
• Repetidos: portais sem par cujo nome um par já usa, marcados como "sobra". O jogo não liga um terceiro portal, então eles ficam sozinhos até alguém trocar o nome.

Cada seção sai em ordem alfabética. Pares e Repetidos são só consulta: o clique neles não faz nada. Passe o mouse numa linha para ver o lugar num pedaço do mapa de cerca de 1 km de lado, com a mesma névoa do seu minimapa (dois mapas, num par). Com mais de umas 10 linhas, a lista rola: a roda do mouse rola a lista sem mexer no zoom da câmera, e no controle quem rola é o analógico direito. Dá para digitar o nome como antes, e o Esc cancela. Placas e animais domados usam a mesma janela e não têm lista.

O servidor pode desligar os portais ("Portals on map"): aí nem o mapa nem a lista mostram portal nenhum. O botão Portais da barra de grupos só os tira do seu mapa; a lista continua mostrando.

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.

Barra de grupos

Uma barra no pé do mapa grande, acima das dicas de teclas, tem um botão grande para cada grupo: Bases, Portais, Minérios, Coleta, Masmorras, Chefes (com a Cidadela, onde fica a Rainha), Missões (as três masmorras da Hildir, as Localizações misteriosas e os pinos de missão), Mercadores (o Haldor, a Hildir e a Bruxa do Pântano), Estruturas e Spawns. Cada botão mostra quantos pontos o grupo tem.

• Clique num botão para mostrar ou esconder o grupo inteiro. O que você escolheu dentro dele fica guardado: religou o grupo, ele volta igual.
• Botão direito nele, ou a setinha, abre a lista do grupo. Clique num tipo para esconder ou mostrar, e na estrela dele para dar prioridade no mapa afastado.
• Tudo e Nada ficam no fim da barra. Cada lista também tem Ver só este grupo e Mostrar todos os tipos.
• Um ponto laranja no botão avisa que há tipos escondidos dentro do grupo.
• A lista das Estruturas também esconde as estruturas por quem vive nelas. Os lugares Com inimigos geram monstros próprios (os que nascem normalmente no bioma não contam). Os Neutros só têm dvergr, que não atacam se não forem provocados. Os Sem habitantes não têm criatura própria. O servidor faz essa conta para cada ponto, pelo próprio local: uma casa do Prado fica em Sem habitantes, e uma da Floresta Negra, em Com inimigos.

Mercadores e pinos de missão são ícones que o próprio jogo põe no seu mapa: eles só somem da sua tela, nada é apagado, e eles voltam quando você mostra de novo.

A barra só muda 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. A barra precisa de mouse.

Mapa afastado

De perto (a vista com até 750 m de altura), todos os marcadores aparecem, com nome. Mais afastado, o mapa grande se arruma para continuar legível:

• Os marcadores do mesmo tipo perto uns dos outros viram um ícone só, no meio deles, com o número (×5). O botão direito nele aproxima o mapa ali. Ao aproximar, os grupos se dividem.
• Nenhum ícone fica em cima de outro. Quando não cabem todos, bases, portais, chefes, missões e mercadores ficam sempre no lugar exato. Depois vêm os tipos com estrela, e então os tipos mais raros no mapa de vocês. As construções pequenas vêm por último (casas, torres, ruínas, pedras, runas e afins), e de longe só aparecem onde o mapa tem espaço em volta.
• O ícone que não cabe espera você aproximar e, enquanto isso, aparece na dica do mouse do ícone que ficou com o lugar.
• Só os portais mostram o nome. Passe o mouse num ícone para ver o que é e quantos pontos ele junta.

O jogo abre o mapa com uns 2.450 m de altura. O minimapa não muda. "Detail by zoom" na configuração desliga tudo isso. "Far view (m)" (1.500) e "Near view (m)" (750) mudam onde os níveis trocam.

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, portais 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, grupos desligados, tipos ocultos, classes de habitantes ocultas e tipos com estrela (todos editados pela barra de grupos), detalhe pelo zoom com as alturas de longe e de perto, 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, grupos, tipos e classes ocultos, tipos com estrela, os portais recebidos do servidor (e quantos estão sem par), o mapa afastado 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.