Guia do jogador

Como instalar e usar o V3X

Tudo o que um jogador precisa, na ordem em que vai precisar. Sem programação.

Antes de começar

Victoria 3 1.15.1 no Windows. O V3X é feito para essa versão. Em outra versão o instalador avisa antes.
Só para um jogador. Não use o V3X no multijogador (por quê, e como desligar por uma sessão).
Faça backup dos seus saves antes de experimentar algo novo. Eles ficam em Documentos\Paradox Interactive\Victoria 3\save games.
Deixe alguns GB livres no disco C:. Um autosave já falhou com Failed to write to disk quando o C: estava quase cheio.

Instalar

Baixe o V3X-Setup.exe na página de Releases. A versão também traz um checksum SHA-256 (SHA256SUMS.txt) se você quiser conferir o arquivo.
Se o SmartScreen do Windows ou o antivírus avisar, é porque o arquivo é novo e não assinado. Escolha Mais informações › Executar assim mesmo se confia na origem.
Feche o Victoria 3. O instalador não roda com o jogo aberto.
Dê dois cliques no V3X-Setup.exe. Ele acha o jogo pela Steam. Se não achar, pede a pasta: na Steam, botão direito em Victoria 3 › Gerenciar › Ver arquivos locais, e escolha essa pasta Victoria 3.
Confira se a janela mostra Game version: release/1.15.1 (supported) e clique em Install V3X.
Abra o jogo como sempre, pela Steam ou pelo launcher da Paradox.

Se o seu jogo estiver numa versão mais nova, o instalador avisa e só instala se você clicar em Install anyway. As partes se desligam sozinhas onde o código do jogo mudou, mas essa combinação nunca foi testada: esperar uma atualização do V3X é o mais seguro.

O que o instalador coloca no seu PC

Tudo vai para a pasta binaries do jogo. Sem administrador, sem alterar arquivos do jogo. A opção da Steam Verificar integridade dos arquivos não remove o V3X.

Arquivo	O que é
`binaries\version.dll`	O carregador do V3X. O Windows o carrega com o jogo; ele carrega os plugins.
`binaries\v3x\plugins\*.dll`	Os plugins: as partes do V3X.
`binaries\v3x\*.ini`	Configurações. Só são criadas se não existirem: o instalador nunca sobrescreve as suas.
`binaries\v3x\install_manifest.txt`	A lista dos arquivos instalados com checksums, usada para reparar e desinstalar.
`binaries\v3x\install.log`	O que o instalador fez.
`binaries\v3x\backup\version.dll`	Só se já havia um `version.dll` de outra ferramenta. Ele volta no lugar ao desinstalar.

Sem o instalador

O V3X está em pré-lançamento. Se a página de Releases ainda não tiver o V3X-Setup.exe, hoje o único caminho é a instalação de desenvolvedor: clonar o repositório dentro da pasta do jogo e rodar ./build.sh install, que coloca as mesmas duas coisas (version.dll e a pasta v3x) no lugar. Precisa de Python e Git Bash; o Getting started (em inglês) mostra o passo a passo.

A primeira abertura

Uma pequena janela V3X console abre ao lado do jogo e lista o que carregou: linhas do carregador, dos plugins e, em vermelho, qualquer parte que se recusou a carregar, com o motivo.

O botão de fechar foi removido de propósito: fechar uma janela de console fecharia o jogo junto. Para escondê-la, coloque a linha console=0 no começo de binaries\v3x\v3x.ini.

Se o jogo parecer congelar depois que você clicou na janela do console, aperte Esc: o Windows pausa um console enquanto há texto selecionado nele.

Ilustração da janela do console do V3X: linhas do carregador em ciano, linhas dos plugins em verde, uma falha em vermelho. — **Prancha I**Ilustração da janela do console, não é uma captura de tela. Do repositório do V3X (em inglês).

No menu principal aparece um botão V3X. Ele abre uma janela com uma caixa de seleção para cada parte do V3X. Desmarque para desligar, marque para ligar. A mudança é gravada no v3x.ini e vale na próxima vez que abrir o jogo.

Se algum mod seu substituir o menu principal, o botão pode não aparecer. Tudo continua funcionando pelo v3x.ini (seção 6). A janela do menu é uma das partes mais novas do V3X; se ela se comportar mal, use o arquivo ini e relate o problema.

Prancha IIIlustração da janela de plugins, não é uma captura de tela. Do repositório do V3X (em inglês).

O que vem ligado e desligado

O V3X é um conjunto de partes (plugins). O instalador liga as que corrigem ou protegem sem mudar o seu jogo, e instala as outras desligadas, para você experimentar.

O que o instalador deixa ligado e desligado
Parte	O que faz por você	Depois de instalar
`mod_menu`	O botão V3X no menu principal, com uma caixa de seleção para cada parte.	ligado
`keep_history`	Mantém os gráficos de PIB, população e outros de um país que você deixa de jogar; países da IA são registrados com a mesma frequência que o seu (a cada 28 dias).	ligado
`mem_tuner`	Ajusta o uso de memória do jogo, devolve memória depois dos carregamentos, guarda uma reserva de emergência de 128 MB e explica no log um erro de falta de memória.	ligado
`frame_pacer`	O limite de quadros dorme em vez de manter um núcleo a 100 %; menos quadros quando pausado, parado, em segundo plano ou minimizado.	ligado
`cpu_sched`	Em processadores com núcleos de desempenho e de eficiência, mantém a thread principal do jogo nos núcleos de desempenho. Não faz nada nos outros.	ligado
`crash_logger`	Escreve o `crash.log` quando algo dá errado: o arquivo para enviar junto com um relato de erro.	ligado
`ironman_console`	Libera o console no modo ironman (o multijogador continua bloqueado). Desligue se as conquistas importam para você.	ligado
`gfx_driver`	Pede ao driver de vídeo que não crie threads próprias. O efeito nos quadros por segundo ainda não foi medido.	ligado
`log_filter`	Remove linhas repetidas e ruidosas dos logs do motor.	ligado
`fast_load`	Mede o carregamento e avisa as outras partes quando um carregamento começa e termina.	ligado
`content_packs`	Permite que arquivos em `binaries\v3x\content_packs\` substituam arquivos do jogo sem um mod. Necessário para o botão V3X.	ligado
`lazy_mesh`	Carrega no início os modelos 3D que o seu jogo usa e o resto no primeiro uso: de 37,5 s para 6,7 s no PC do autor.	desligado
`loc_fallback`	Preenche com o texto em inglês do mod as linhas que faltam no seu idioma.	desligado
`enhance`	No modo debug, salva no formato comprimido normal: de 156 MB para 26 MB por autosave.	desligado
`console_plus`	Completar com Tab no console: tags de países, estados, leis.	desligado
`asset_stream`	Força o streaming de texturas do próprio jogo (todas as predefinições de qualidade o desligam).	desligado
`sim_opt`	Diagnóstico da simulação. A opção de throttle altera a simulação: faça backup dos saves antes.	desligado

Fonte: docs/install.md e o catálogo de plugins (em inglês).

Mudar as partes à mão

Abra binaries\v3x\v3x.ini no Bloco de Notas. Embaixo de [plugins], escreva o nome da parte com =0 para desligar ou =1 para ligar:

[plugins]
ironman_console=0
loc_fallback=1

Uma parte que não aparece na lista é carregada. 0 quer dizer "não carregar".
As mudanças valem na próxima abertura do jogo.
Comentários ficam numa linha só deles, começando com ;. Um comentário depois de um valor vira parte do valor: lazy_mesh = 0 ; teste não desliga o lazy_mesh.
Cada parte pode ter o seu próprio arquivo, binaries\v3x\<parte>.ini. São opcionais; todas as opções estão aqui (em inglês).

Conquistas, ironman, multijogador

Conquistas. O V3X não mexe no código das conquistas nem na posse de DLCs e não desbloqueia nada. Uma parte ligada por padrão, ironman_console, libera o console no ironman. Se as conquistas importam para você, coloque ironman_console=0 e deixe desligadas as partes que mudam a simulação (o throttle do sim_opt).

Multijogador. Não use o V3X online: os outros jogadores estariam rodando um código diferente, e as partes que mudam a simulação dessincronizariam a partida. Antes de uma sessão multijogador, renomeie binaries\version.dll para version.dll.off e depois renomeie de volta. Ou desinstale.

Atualizar, reparar, desinstalar

Rode o V3X-Setup.exe de novo (um mais novo, para atualizar):

Repair / update V3X copia de volta qualquer arquivo do V3X que esteja faltando ou danificado, ou os troca pela versão nova. As suas configurações ficam.
Uninstall V3X remove exatamente os arquivos que o instalador colocou e devolve um version.dll que já existia antes. Logs, relatórios e configurações que você mudou ficam em binaries\v3x\; marque Also delete logs, reports and settings para apagar essa pasta também.

Perdeu o instalador? Apague binaries\version.dll e a pasta binaries\v3x. A desinstalação é só isso.

Quando o próprio Victoria 3 atualiza, as partes cujo código do motor mudou se desligam sozinhas até o V3X ser atualizado. Elas avisam em binaries\v3x\v3x.log.

Quando algo dá errado

Problema	O que fazer
O instalador diz "Victoria 3 is running"	Feche o jogo (procure `victoria3.exe` no Gerenciador de Tarefas) e rode o instalador de novo.
"Victoria 3 was not found automatically"	Escolha a pasta `Victoria 3`, a que tem a pasta `binaries` dentro.
"This setup file is damaged"	Baixe de novo. O arquivo é conferido antes de qualquer coisa ser gravada.
"could not write … is it in use?"	Feche o jogo e qualquer programa que possa estar usando o arquivo, e rode Repair.
O jogo não abre ou fecha logo de cara	Renomeie `binaries\version.dll` para abrir sem o V3X. Se resolver, desligue as partes uma a uma no `v3x.ini` para achar a causa, ou desinstale.
Falta de memória no Novo Jogo	Se o `v3x.log` disser `Windows commit limit is exhausted`, aumente o arquivo de paginação do Windows (gerenciado pelo sistema, ou 16 GB ou mais).
Um save falha com "Failed to write to disk"	Libere vários GB no disco C:. O arquivo de paginação também cresce nesse disco.
Uma parte não faz nada depois de uma atualização do jogo	Esperado: ela se desligou porque o código do jogo mudou. Aguarde uma atualização do V3X.

Relatar um problema

Antes de abrir o jogo de novo, copie estes arquivos para outro lugar, porque a próxima abertura os sobrescreve:

binaries\v3x\v3x.log, crash.log, crash.prev.log e install.log. Se aparecer v3x.<número>.log, o relator de erros do jogo estava segurando o v3x.log: envie esse.
Os logs do próprio jogo: Documentos\Paradox Interactive\Victoria 3\logs\.

Detalhes técnicos, para quem for ler o seu relato: Troubleshooting (em inglês).