Guia de builds de teste do Dalamud

Como instalar plugins experimentais no Dalamud

Como instalar plugins experimentais no Dalamud com segurança: ative as builds de teste nas configurações do launcher e depois instale o plugin pela janela dentro do jogo. Não baixe uma DLL desconhecida nem cole uma URL de repositório só porque um resultado a chama de experimental.

Resposta rápida

Abra o XIVLauncher e digite /xlsettings no chat do FFXIV. Entre na seção Experimental, ative a opção que busca builds de teste de plugins, salve e abra /xlplugins novamente. A listagem de teste aparece junto dos plugins normais quando um autor publica uma build.

Essa configuração altera quais builds o Dalamud pode mostrar; ela não torna um plugin oficial, seguro ou compatível com todo patch do FFXIV. Use-a como um caminho de teste controlado, não como substituto do diretório oficial.

Ilustração conceitual de uma tela de configurações de launcher com símbolo de plugin experimental ao lado de um jogo
Imagem conceitual: entrada dos plugins experimentais nas configurações. Não é uma captura real do XIVLauncher.

Imagem conceitual

Experimental é outro canal de build, não outro launcher

A distinção importante é entre launcher, Dalamud e build do plugin. O XIVLauncher inicia o fluxo compatível do FFXIV; o Dalamud fornece o framework; o autor decide se uma build é normal, de teste ou distribuída por outro repositório.

Se você só quer encontrar um plugin normal, comece pela janela padrão. Este guia serve para o caso específico em que um autor ou uma orientação de suporte informa que as builds de teste são necessárias.

Qual caminho de plugin você realmente quer usar?

O que você quer dizer Caminho recomendado O que observar
Plugin normal Pesquisar em /xlplugins Use a listagem atual e leia as notas do autor.
Build experimental ou de teste Ativar builds de teste em /xlsettings Pode haver bugs e quebra após um patch.
Repositório personalizado Seguir a documentação atual do autor Verifique a propriedade e nunca cole uma URL desconhecida.
Build local de desenvolvimento Seguir a documentação de desenvolvimento do Dalamud É um fluxo para desenvolvedores, não um atalho para jogadores.

Antes de ativar builds experimentais

Verifique o motivo primeiro. Uma build de teste pode validar uma correção, atender a um novo patch do FFXIV ou ser destinada a um pequeno grupo de testadores. Se a única instrução encontrada for um link de espelho desconhecido, pare e confirme o proprietário do projeto.

Faça uma mudança por vez. Anote o nome do plugin, o canal de build e o sintoma que você quer testar. Isso facilita desativar o item correto depois e evita que uma reinstalação ampla esconda a causa real.

Mantenha o caminho de recuperação disponível. Saiba abrir /xlsettings, desativar builds de teste, abrir /xlplugins e desativar ou remover o plugin. Não apague pastas aleatórias do FFXIV antes de identificar o problema.

Como ativar builds de teste de plugins

  1. Inicie o fluxo compatível. Abra o XIVLauncher como de costume e espere o Dalamud carregar. Não comece baixando um injetor ou uma DLL separada.
  2. Abra as configurações do Dalamud. Digite /xlsettings no chat. Se nada acontecer, confirme que o Dalamud carregou e que você está usando o launcher com suporte a plugins.
  3. Encontre a seção Experimental. Procure a configuração que busca builds de teste. O rótulo pode mudar com a interface atual, então leia a explicação em vez de depender de uma captura antiga.
  4. Ative e salve. Ative a opção somente para um plugin específico e por um motivo documentado. Salve e aguarde a atualização da lista.
  5. Instale um único item. Use /xlplugins, pesquise o plugin, leia as notas do autor e instale primeiro uma única build de teste. Reinicie o jogo apenas se o plugin ou o launcher pedir.
Fluxo conceitual em três etapas entre configurações do launcher, build experimental e recuperação
Imagem conceitual: configurações, build de teste e retorno formam um processo reversível.

Teste controlado

Trate o primeiro teste como uma mudança pequena e reversível

Um bom teste responde a uma pergunta limitada: essa build corrige o problema, funciona com o patch atual ou recupera uma função específica? Ele não deve virar motivo para ativar todas as fontes experimentais de uma vez.

Depois de instalar, jogue por uma sessão curta. Observe falhas na inicialização, interface ausente, erros repetidos, mudanças súbitas de desempenho ou um plugin que desaparece após uma atualização. Registre o primeiro sintoma em vez de adivinhar qual arquivo apagar.

Build experimental não é o mesmo que repositório personalizado

A opção de builds de teste e um repositório personalizado resolvem problemas diferentes. A primeira muda quais builds o fluxo de plugins pode buscar; o segundo adiciona uma fonte mantida por um autor ou projeto. Uma build local é outra coisa: serve para desenvolvimento e depuração.

Se um guia pedir para adicionar um repositório, confirme que a URL vem da documentação atual ou do repositório do autor. Verifique o proprietário, o estado do projeto e o que ele publica. Um trecho do buscador, uma mensagem copiada do Discord ou uma página de hospedagem de arquivos não é evidência suficiente.

Não apresente um repositório personalizado como infraestrutura oficial do Dalamud. Comece pelo diretório oficial e use outra fonte somente quando o autor explicar claramente por que ela é necessária.

Checklist de segurança para plugins experimentais do Dalamud

Faça esta verificação antes e depois do primeiro teste.

  • Confirme o nome do plugin, autor, proprietário do repositório e motivo da build de teste.
  • Prefira o fluxo atual de plugins do Dalamud/XIVLauncher a um download de DLL avulso.
  • Ative uma única fonte ou um plugin de teste por vez.
  • Mantenha o diretório normal de plugins e os passos de recuperação do launcher.
  • Leia as notas de atualização depois de um patch do FFXIV antes de assumir compatibilidade.
  • Não compartilhe senhas, OTPs ou logs completos do launcher ao pedir ajuda.
  • Ferramentas e plugins de terceiros podem envolver riscos de conta e dos Termos de Serviço.

O que fazer quando a opção ou o plugin não aparece

Primeiro confirme se o Dalamud terminou de carregar e se o jogo acabou de receber um patch. A disponibilidade pode mudar durante manutenção ou enquanto o autor atualiza uma build. Uma listagem ausente não prova que você precisa de um espelho de download.

Se a configuração aparece, mas o plugin não está listado, volte à documentação atual do autor e confirme nome, versão do jogo e fonte. Se a própria configuração não existe, use o suporte oficial em vez de copiar um arquivo antigo de um fórum.

No Steam Deck ou no Linux desktop, respeite a separação de plataforma: use o guia de Steam Deck/Linux para configurar o launcher e aplique esta lógica de builds de teste somente depois que o fluxo normal de plugins estiver funcionando.

Ilustração conceitual de desativar um plugin problemático, voltar ao estado limpo e revisar logs abstratos
Imagem conceitual: desative o plugin suspeito e registre o primeiro erro antes de decidir.

Recuperação

Desative primeiro, registre o primeiro erro e só então decida

Se FFXIV ou Dalamud ficar instável, desative o último plugin experimental e desligue a opção de builds de teste quando ela não for mais necessária. Abra a janela normal de plugins e teste sem adicionar outra variável.

Se o problema continuar, separe sintomas do launcher, cliente do jogo, patch e plugin. Os guias de troubleshooting existentes cobrem crashes, erros de versão de boot e falhas de arquivos de patch; escolha a página correspondente ao primeiro ponto que falhou.

Limite dos Termos de Serviço do FFXIV

Um plugin experimental ou de terceiros não se torna oficial ou livre de riscos só porque aparece em uma lista de teste. As regras da Square Enix, o risco da conta e o comportamento do plugin são questões separadas. Evite ferramentas que automatizam ações, expõem dados de conta ou pedem para contornar controles de segurança.

Este guia explica o caminho das configurações e hábitos de diagnóstico cuidadosos. Ele não garante que um plugin seja permitido, estável, privado ou compatível com um patch específico.

Um plugin experimental é igual a um plugin de repositório personalizado?

Não. A opção de teste muda quais builds o fluxo compatível pode mostrar; um repositório personalizado adiciona outra fonte. Verifique cada fonte separadamente e não trate um repositório personalizado como infraestrutura oficial.

Onde fica a configuração de plugins experimentais?

Abra /xlsettings depois que o Dalamud carregar e procure a seção Experimental ou a opção de builds de teste. Os rótulos podem mudar, então use a interface atual.

Posso baixar diretamente uma DLL experimental?

Não é o padrão seguro. Prefira o fluxo atual de plugins e a fonte documentada pelo autor. Não execute um arquivo de um espelho desconhecido só porque o nome parece correto.

Por que o plugin experimental não aparece?

O autor pode ter retirado a build, o plugin pode não suportar o patch atual ou o Dalamud ainda não atualizou a lista. Confira a documentação atual antes de alterar arquivos.

Como desligo plugins experimentais?

Desative a opção em /xlsettings, salve e use /xlplugins para desativar ou remover o plugin. Depois teste o fluxo normal.

A opção de teste torna o plugin seguro ou permitido?

Não. Ela apenas muda o canal de build exibido. Estabilidade, privacidade, risco da conta e Termos de Serviço exigem avaliação separada.