Guia de fontes de plugins do Dalamud

Como adicionar um repositório personalizado de plugins do Dalamud com segurança

Use a URL exata publicada pelo autor do plugin, confira quem controla essa fonte e depois adicione e ative o endereço nas configurações do Dalamud. A presença de um plugin no instalador do jogo não certifica o publicador, o comportamento ou a compatibilidade do plugin e não representa aprovação da Square Enix.

Resposta rápida

Inicie o FFXIV pelo XIVLauncher e espere o Dalamud carregar. No chat, digite /xlsettings, abra a área Experimental e procure Custom Plugin Repositories. Cole a URL exata do manifesto indicada na documentação atual do publicador, use o controle para adicionar, confirme que a fonte está ativada e salve. Depois abra /xlplugins, procure o plugin pelo nome, leia as observações e instale-o nessa janela.

Se não puder confirmar quem controla a URL ou por que ela exige uma fonte separada, não a adicione.

Um jogador compara uma fonte independente de um publicador de plugins com um diretório mantido pelo projeto antes de instalar um plugin.
Ilustração conceitual: conferir quem mantém uma fonte não certifica sua segurança nem compatibilidade.

Ilustração conceitual

Uma fonte personalizada tem seu próprio publicador

Um repositório é uma fonte de publicação que informa ao Dalamud quais plugins e dados de versão um publicador oferece. A fonte pode ser mantida por um autor de plugin ou por um projeto comunitário. Ela é diferente do diretório padrão administrado pelo projeto Dalamud, mesmo quando as duas fontes aparecem no mesmo instalador.

Repositório personalizado, diretório padrão ou versão de teste?

Escolha o caminho que corresponde às instruções do autor. A maioria dos jogadores deve começar pesquisando no diretório padrão do /xlplugins. Um repositório personalizado é indicado quando um publicador específico documenta uma fonte adicional. Builds experimentais são outro caminho e não significam a mesma coisa que adicionar um repositório. Um build local é voltado ao desenvolvimento de plugins, não à instalação comum.

Escolha a fonte antes de mudar as configurações

Fonte O que significa Primeira verificação
Diretório padrão A lista normal dentro do jogo, publicada pelo fluxo do projeto Dalamud. Pesquise no /xlplugins e leia as notas atuais do plugin.
Repositório personalizado Uma fonte adicional mantida por um autor ou projeto comunitário. Confirme o responsável e a URL exata do manifesto na documentação atual.
Build experimental Uma versão ou canal de teste que pode estar incompleto ou instável. Ative somente a opção de teste documentada para uma necessidade específica.
Arquivo de plugin baixado Um arquivo obtido fora do caminho normal do instalador. Não use um espelho desconhecido de DLL como atalho para configurar um repositório.

Confira o publicador antes de adicionar a URL

A URL de um repositório personalizado é um dado fornecido por outra parte. Faça a verificação antes de abrir as configurações, mantendo a documentação do publicador à vista.

  • Encontre a URL na documentação atual do autor ou na página de lançamentos do responsável pelo repositório, não em uma republicação sem atribuição.
  • Compare o nome do publicador, do projeto e do responsável pelo repositório entre as instruções e a página da fonte. Pare se os nomes ou domínios não coincidirem.
  • Copie a URL completa exatamente. Não tente consertar um link quebrado adivinhando um nome de arquivo, trocando o domínio ou removendo parte do caminho.
  • Leia o que o plugin faz, quais dados ou recursos locais acessa, quais dependências exige e quais notas de compatibilidade o publicador forneceu.
  • Confira se o projeto ainda é mantido e onde relata problemas. Um repositório pode estar desatualizado mesmo que a URL continue abrindo.
  • Anote a fonte e o plugin que adicionou para reconhecer a mudança se a lista ficar confusa depois.

Adicione um repositório personalizado e instale um plugin

  1. 1. Confirme que o Dalamud está funcionando. Inicie o FFXIV pelo XIVLauncher como de costume. Entre no jogo e espere a interface do Dalamud carregar por completo antes de tentar /xlsettings. Se o comando não estiver disponível, verifique primeiro a inicialização do launcher ou do Dalamud.
  2. 2. Abra a área de configurações documentada. Digite /xlsettings no chat e selecione Experimental. Procure o campo Custom Plugin Repositories. Os rótulos podem mudar; siga a interface atual e as instruções do publicador em vez de confiar em uma captura antiga.
  3. 3. Adicione e ative a URL do publicador. Cole a URL verificada, use o controle de adição ao lado do campo e confirme que a nova fonte está ativada. Se a janela indicar um endereço inválido ou um aviso que você não entende, não contorne o problema com outro espelho.
  4. 4. Salve e encontre o plugin desejado. Salve e feche as configurações e abra /xlplugins. Pesquise o nome exato informado pelo autor. Confira o publicador, a descrição, as dependências e as notas de compatibilidade antes de selecionar Install.
  5. 5. Faça uma alteração e observe o resultado. Instale apenas o plugin pretendido e siga qualquer instrução de reinicialização do Dalamud ou do autor. Anote o que mudou. Se surgir outro problema, você saberá qual fonte e plugin estavam envolvidos.
Um fluxo conceitual de quatro partes confere um publicador, adiciona um link de repositório, ativa a fonte e instala um plugin.
Fluxo conceitual: os símbolos explicam a ordem, não uma interface oficial nem uma certificação de segurança.

Sequência de configuração

Mantenha o processo curto e reversível

A sequência útil é conferir o publicador, copiar a URL exata, ativar a fonte, revisar o plugin e instalar apenas um. Cada passo responde a uma pergunta diferente: quem publica a fonte, se o endereço está correto, se o Dalamud consegue lê-lo e se o plugin atende à sua necessidade.

Se o plugin não aparecer depois de salvar, não adicione vários endereços adivinhados. Confira primeiro o estado da fonte e as instruções atuais; depois veja os casos de solução de problemas abaixo.

Desative uma fonte e desinstale um plugin separadamente

Se não quiser mais usar um repositório, abra /xlsettings novamente e volte à lista de fontes personalizadas. Use os controles atuais para desativar ou remover a fonte e salve. Removê-la muda onde o Dalamud procura listagens; isso não necessariamente desinstala um plugin que já foi instalado por ela.

Abra /xlplugins e confira os plugins instalados separadamente. Se não quiser mais um deles, use o controle de desinstalação ou desativação do instalador. Siga as notas atuais do publicador se o plugin guardar configurações ou pedir uma reinicialização. Não apague pastas por tentativa e erro nem remova dados de outros plugins primeiro.

Se quiser apenas descobrir se a fonte causou um problema, desative uma fonte ou um plugin de cada vez e anote o resultado. Uma alteração pequena e reversível traz pistas mais claras do que remover todos os plugins ou redefinir o launcher inteiro.

Se o repositório ou o plugin não aparecer

O que você vê O que conferir primeiro Próximo passo
A URL é recusada Compare cada caractere com as instruções atuais do publicador. Peça o endereço atual ao mantenedor; não adivinhe outro.
A fonte aparece, mas está desativada Confira o estado dela em /xlsettings. Ative somente a fonte verificada, salve e abra /xlplugins novamente.
A fonte está ativa, mas vazia Confira o estado, o acesso à rede e os avisos atuais do publicador. Aguarde ou fale com o mantenedor se o manifesto ou serviço estiver indisponível.
Um plugin está faltando Pesquise o nome exato e compare com as notas atuais do autor. Confirme que o plugin ainda usa esse repositório e atende à sua configuração.
O plugin não carrega Confira a compatibilidade, as dependências e o primeiro erro informado. Desative o plugin e siga as instruções mantidas antes de instalá-lo de novo.
Um diretório de plugins mantido pelo projeto e um repositório de um publicador independente aparecem como fontes distintas para o instalador do jogo.
Ilustração conceitual: dois publicadores podem fornecer o mesmo instalador sem compartilhar revisão nem aprovação.

Limite entre as fontes

Um instalador compartilhado não significa o mesmo publicador

O diretório padrão e um repositório independente podem fornecer listagens ao instalador do jogo, mas não precisam compartilhar responsável, revisão, práticas de lançamento ou suporte. Mantenha o nome do publicador associado à fonte que está avaliando.

Esta ilustração mostra fluxos de publicação separados que chegam ao mesmo instalador. Ela não é uma classificação, recomendação ou afirmação de que houve uma auditoria de segurança. O diretório oficial do Dalamud informa que os plugins são instalados dentro do jogo; não baixe arquivos de plugin manualmente apenas porque existe um repositório.

Limites, privacidade e considerações sobre a conta

Adicionar uma fonte apenas torna suas publicações disponíveis para descoberta. Isso não prova que um plugin seja seguro, compatível com a versão atual do jogo, mantido ou aprovado pelo editor do jogo. Antes de instalar, confira quem mantém o projeto, sua documentação, o comportamento do plugin, as permissões ou os dados descritos pelo autor e as notas de compatibilidade atuais.

Use as instruções oficiais do projeto para seguir o fluxo de instalação compatível e consulte as regras atuais do jogo e do serviço por conta própria. Uma página de repositório, um rótulo de código aberto ou uma instalação bem-sucedida não são autorização da Square Enix e não garantem nada sobre sua conta. Nunca compartilhe senhas, códigos de uso único ou registros sem ocultar informações ao pedir ajuda para um plugin de terceiros.

O que é um repositório personalizado de plugins do Dalamud?

É uma fonte adicional mantida por um autor ou projeto comunitário. O Dalamud pode mostrar suas publicações junto do diretório padrão, mas cada fonte tem seu próprio publicador e seus próprios processos de revisão.

Onde adiciono a URL de um repositório personalizado?

No jogo, abra /xlsettings, selecione a área Experimental e use Custom Plugin Repositories. Cole o endereço exato do publicador, adicione e ative a fonte, salve e depois procure o plugin em /xlplugins.

Posso usar qualquer URL de repositório que encontrar na internet?

Não. Verifique o responsável pelo projeto e a URL atual na documentação do próprio mantenedor. Não cole links sem atribuição nem adivinhe o endereço de um manifesto a partir do nome de um arquivo.

Aparecer no /xlplugins significa que um plugin é seguro ou oficial?

Não. A presença indica que o instalador consegue ler uma listagem dessa fonte. Isso não é uma auditoria de segurança, garantia de compatibilidade nem aprovação do Dalamud ou da Square Enix.

Remover um repositório desinstala os plugins dele?

Não necessariamente. Remova ou desative a fonte em /xlsettings e confira os plugins já instalados separadamente em /xlplugins. Desinstale-os ou desative-os por lá se necessário.

Por que meu repositório personalizado está vazio ou indisponível?

A URL pode estar desatualizada, o manifesto do publicador pode estar fora do ar, a fonte pode estar desativada ou o plugin pode ter mudado de lugar. Confira as instruções e o estado atuais antes de alterar o endereço.