Fonte oficial
Verifique xivdev/Penumbra e o README do projeto.
Guia de mods em runtime para FFXIV
Guia Penumbra FFXIV: instalar, configurar e resolver problemas
O Penumbra é um plugin do Dalamud que carrega arquivos de mod compatíveis do FFXIV em runtime, sem substituir os arquivos originais do jogo. A forma mais segura de configurar é pelo método de repositório personalizado documentado pelo projeto, e não extraindo manualmente um ZIP de release.
Resposta rápida: instale pelo Dalamud, não por arquivo ZIP
Abra o XIVLauncher, entre no jogo, execute /xlsettings e adicione a URL oficial repo.json do Penumbra na área de repositórios personalizados de plugins em Experimental. Depois, instale o Penumbra pelo /xlplugins para que o Dalamud gerencie as atualizações.
O README oficial alerta de forma explícita para não descompactar manualmente um ZIP de release dentro de devPlugins. Cópias manuais podem não receber avisos de atualização e ainda entrar em conflito com a instalação gerenciada pelo repositório.
Verificação de atualidade em 22 de julho de 2026: a release mais recente no GitHub é testing_1.7.0.2, publicada em 20 de julho de 2026. Este guia não oferece o ZIP como CTA de download porque o README mantido pelo projeto recomenda o método via repositório.
Guia de mods em runtime para FFXIV
Como identificar o projeto oficial do Penumbra
Este é o ícone armazenado no repositório xivdev/Penumbra. Use em conjunto o dono do repositório, o README, o rastreador de issues e o endereço repo.json para confirmar o projeto, em vez de confiar em um host de arquivos com nome parecido.
Penumbra é um software da comunidade, não um recurso oficial da Square Enix. A abordagem em runtime evita sobrescrever permanentemente os arquivos do jogo, mas não elimina riscos de política de conta, privacidade, compatibilidade ou origem dos mods.
Como instalar penumbra ff14 no FFXIV
- Comece com o XIVLauncher oficial e o Dalamud. Instale o XIVLauncher pela página de releases da Goatcorp, abra o FFXIV e confirme que /xlplugins abre o Instalador de Plugins do Dalamud.
- Abra as configurações do Dalamud. Execute /xlsettings e abra a aba Experimental. Evite alterar outras opções experimentais que não tenham relação com o Penumbra.
- Adicione a URL oficial do repositório. Cole https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json na lista de repositórios personalizados de plugins, use o botão de mais e depois salve e feche.
- Instale em Available Plugins. Abra /xlplugins, encontre Penumbra em Available Plugins, revise a listagem e faça a instalação pelo gerenciador de plugins.
- Escolha uma pasta dedicada para os mods. Use uma pasta fora de diretórios protegidos do Windows ou das pastas de programa do FFXIV. Mantenha espaço livre suficiente e não aponte o Penumbra para a pasta de instalação do jogo.
- Teste um mod por vez. Importe um único mod confiável, ative-o para uma coleção limitada, troque de área ou reabra a janela afetada e confirme o resultado antes de adicionar outros.
Fluxo de instalação compatível
A rota pelo repositório deixa origem, atualizações e rollback mais claros do que uma pasta de plugin copiada manualmente.
Repositório do Dalamud
Adicione o repo.json oficial em /xlsettings.
Gerenciador de plugins
Instale e atualize pelo /xlplugins.
Teste controlado
Ative um mod confiável e confira conflitos penumbra.
XIVLauncher + Dalamud + Penumbra
Onde o Penumbra entra na cadeia de inicialização
O XIVLauncher inicia o FFXIV e carrega o Dalamud; depois disso, o Penumbra é instalado e gerenciado como plugin do Dalamud. Você não precisa de launcher separado, pacote de injector nem executável modificado do jogo para usar a configuração compatível do Penumbra.
A captura é uma mídia oficial da Goatcorp para o XIVLauncher, não uma captura das configurações do Penumbra. Ela mostra a camada de launcher visível para o usuário para que o leitor não confunda o plugin com um cliente independente do jogo.
Problemas comuns do Penumbra e a primeira verificação segura
| Problema | Causa provável | Primeira verificação |
|---|---|---|
| Penumbra não aparece em /xlplugins | A URL do repositório não foi salva ou o Dalamud ainda não atualizou a lista | Abra novamente /xlsettings, confira a URL exata do repo.json, salve e atualize a lista de plugins |
| Plugins indisponíveis após uma atualização do jogo | A compatibilidade do Dalamud foi temporariamente bloqueada para a nova build do FFXIV | Aguarde as atualizações mantidas pelo projeto; não force binários antigos de plugins dentro do jogo |
| Um mod não aparece | A atribuição de coleção, a prioridade ou o caminho dos arquivos não correspondem ao personagem atual | Verifique a coleção ativa e use as ferramentas de conflitos do Penumbra antes de reinstalar |
| Texturas ou modelos aparecem misturados | Dois mods ativados substituem os mesmos arquivos | Inspecione os conflitos e mova o mod desejado para uma prioridade mais alta |
| Carregamento demorado ou uso elevado de disco | Biblioteca de mods grande demais, crescimento de cache ou armazenamento lento | Desative as adições mais recentes, revise os caminhos de cache e mantenha a pasta de mods em armazenamento local saudável |
| Comportamento duplicado do plugin | Uma cópia manual em devPlugins está em conflito com a instalação via repositório | Remova a cópia manual e mantenha apenas a instalação pelo gerenciador de plugins |
Resolva problemas sem danificar a instalação do jogo
Desative primeiro o mod mais recente e teste com o mesmo personagem, coleção, área e estado de equipamento. Mudar várias variáveis ao mesmo tempo torna mais difícil isolar um conflito.
Não apague arquivos do FFXIV, não substitua executáveis do jogo, não desative o antivírus globalmente e não baixe pacotes de plugins reempacotados. O Penumbra foi projetado para manter os arquivos de mods separados da instalação original; preserve esse limite.
Depois de um patch grande do FFXIV, o Dalamud e os plugins podem permanecer indisponíveis até o trabalho de compatibilidade ser concluído. Uma mensagem temporária de indisponibilidade não prova que sua instalação está quebrada. Consulte os canais mantidos pelo projeto e espere, em vez de forçar builds antigas.
Limites de conta, conteúdo e privacidade
XIVLauncher, Dalamud, Penumbra e mods são ferramentas de terceiros. A Square Enix não oferece suporte para elas, e nenhum guia pode garantir segurança de conta. Use o cliente oficial do jogo se você precisa do caminho de menor risco.
Importe arquivos de mod apenas de fontes que você entende. Evite pacotes que incluam executáveis, pedidos de credenciais, exclusões amplas de segurança ou autoria pouco clara. Respeite as permissões dos criadores e não use modificações visuais para se passar por conteúdo oficial.
Penumbra é a mesma coisa que Dalamud?
Não. O Dalamud é o framework de plugins carregado pelo XIVLauncher; o Penumbra é um plugin que gerencia substituições de mods em runtime.
Devo baixar Penumbra.zip no GitHub Releases?
Não para a configuração normal. O README oficial recomenda adicionar a URL repo.json e instalar pelo Dalamud para que as atualizações sejam gerenciadas automaticamente.
Por que os plugins do FFXIV ficam indisponíveis depois de uma atualização do jogo?
O Dalamud pode desativar temporariamente os plugins enquanto a compatibilidade é verificada. Aguarde atualizações mantidas pelo projeto e evite forçar um binário antigo.
Onde deve ficar a pasta de mods do Penumbra?
Use uma pasta dedicada com permissão de gravação fora da instalação do FFXIV e de pastas protegidas do sistema, em armazenamento local com espaço livre suficiente.
Como corrigir dois mods alterando o mesmo arquivo?
Use as informações de conflitos do Penumbra e as prioridades de coleção. Mantenha ativa apenas a substituição desejada ou mova esse mod acima do concorrente.
O Penumbra é seguro?
É um software aberto da comunidade com repositório oficial, mas continua sendo uma ferramenta de terceiros e os arquivos de mods trazem riscos separados de origem, privacidade, compatibilidade e política de conta.