Guides

Abrir portas no router (port forwarding)

Para os amigos entrarem pela Internet, o router de casa tem de deixar passar o tráfego do servidor até ao teu PC. O Project Zomboid usa UDP 16261 e 16262 (os valores por defeito; a página Rede da app mostra os do teu perfil).

1. Na app, abre Rede e copia o IP local deste PC (algo como 192.168.1.20).
2. Ainda na Rede, carrega em Criar regra…. O Windows pede autorização uma vez: é a regra da firewall, só para estas portas e só em redes privadas.
3. Abre a página do router no browser (normalmente 192.168.1.1 ou 192.168.0.1; está numa etiqueta no router) e entra com a password do router.
4. Procura Port forwarding, NAT ou Servidores virtuais.
5. Cria uma regra para UDP 16261 e outra para UDP 16262, as duas a apontar para o IP local do passo 1.
6. Guarda. Os amigos entram com o teu IP público (na Rede, «Ver o meu IP público») e a porta 16261.

Não consegues abrir portas?

Alguns operadores usam CGNAT (o IP público do router não é só teu) e aí o port forwarding não funciona. Alternativa: uma VPN de rede virtual (por exemplo Radmin VPN ou Hamachi). Tu e os amigos entram na mesma rede virtual e ligam-se ao IP da VPN. A app não instala nada disto por ti.

Nunca abras a porta do RCON no router. A app deixa o RCON sempre desligado e escreve UPnP=false, para o servidor não abrir portas sozinho.

Os amigos não conseguem entrar

Vê os pontos por esta ordem; a maior parte dos problemas resolve-se nos três primeiros.

1. O servidor está mesmo no ar? Na app, o estado tem de ser «No ar» (verde), não «A arrancar». Na primeira vez pode demorar alguns minutos.
2. A mesma versão do jogo. Se o servidor está na Build 42 (ramo public), os amigos também; o ramo vê-se no Início da app.
3. Os mesmos mods. Na Rede, copia o código do modpack e manda-o aos amigos. Eles colam-no em Verificar o meu jogo (na app deles) e veem o que falta.
4. Password e whitelist. Por defeito o servidor só aceita quem sabe a password. O convite pode incluí-la (com aviso).
5. Firewall do Windows. A Rede mostra «Feito» no passo da firewall? Se não, carrega em «Criar regra…».
6. Router. Segue o guia acima. Amigos na mesma casa usam o IP local; de fora usam o IP público.
7. Vê os Registos. Na app, Registos › Erros mostra o que o servidor disse quando o amigo tentou entrar.

Juntar mods do Workshop

1. Em Mods, cola o link de um mod do Workshop (ou só o número) e carrega em Adicionar. Uma coleção inteira entra pela página Workshop › Importar coleção.
2. A app encontra os Mod IDs de cada item e junta as dependências que já estão descarregadas, pela ordem certa. Se um item tiver vários mods, escolhes quais.
3. Os mods em falta descarregam-se com Mais ações › Descarregar os que faltam, ou subscreves no Workshop do jogo.
4. Carrega em Verificar tudo: aponta IDs errados, dependências em falta e mods de outra Build.
5. A ordem muda-se a arrastar (ou com Alt+↑/↓). Se algo ficar antes de uma dependência, a linha fica com aviso; Ordenar por dependências mostra o «antes → depois».
6. Quando aparecer o aviso «Há alterações no perfil que ainda não estão no .ini do servidor», carrega em Escrever no .ini… e reinicia o servidor.

Correu mal? Em Histórico dos mods repões a última lista que funcionou.

Opening ports on the router (port forwarding)

For friends to join over the Internet, your home router must let the server's traffic through to your PC. Project Zomboid uses UDP 16261 and 16262 (the defaults; the app's Network page shows your profile's ports).

1. In the app, open Network and copy this PC's local IP (something like 192.168.1.20).
2. Still on Network, press Create rule…. Windows asks once: it is the firewall rule, only for these ports and only on private networks.
3. Open your router's page in the browser (usually 192.168.1.1 or 192.168.0.1; it is on a label on the router) and sign in with the router's password.
4. Look for Port forwarding, NAT or Virtual servers.
5. Create a rule for UDP 16261 and another for UDP 16262, both pointing to the local IP from step 1.
6. Save. Friends join with your public IP (on Network, "Show my public IP") and port 16261.

Can't open ports?

Some providers use CGNAT (your router's public IP is shared) and port forwarding cannot work. Alternative: a virtual network VPN (for example Radmin VPN or Hamachi). You and your friends join the same virtual network and connect to the VPN IP. The app does not install any of this for you.

Never open the RCON port on the router. The app keeps RCON off and writes UPnP=false, so the server never opens ports by itself.

Friends can't get in

Check in this order; most problems are solved in the first three.

1. Is the server really on the air? In the app the state must be "On the air" (green), not "Starting". The first start can take a few minutes.
2. Same game version. If the server is on Build 42 (public branch), your friends must be too; the branch is shown on the app's Home.
3. Same mods. On Network, copy the modpack code and send it to your friends. They paste it into Check my game (in their app) and see what is missing.
4. Password and whitelist. By default the server only lets in people who know the password. The invite can include it (with a warning).
5. Windows Firewall. Does Network show "Done" for the firewall step? If not, press "Create rule…".
6. Router. Follow the guide above. Friends in the same home use the local IP; from outside, the public IP.
7. Look at Logs. In the app, Logs › Errors shows what the server said when your friend tried to join.

Adding Workshop mods

1. In Mods, paste a Workshop mod link (or just its number) and press Add. A whole collection goes in through Workshop › Import collection.
2. The app finds each item's Mod IDs and adds the dependencies already downloaded, in the right order. If an item has several mods, you choose which.
3. Missing mods download with More actions › Download missing, or subscribe in the game's Workshop.
4. Press Check everything: it points out wrong IDs, missing dependencies and mods for another Build.
5. Drag to change the order (or Alt+↑/↓). If something loads before a dependency, the row gets a warning; Sort by dependencies shows the "before → after".
6. When the notice "The profile has changes that are not in the server .ini yet" appears, press Write to .ini… and restart the server.

Something broke? Mod history restores the last list that worked.