Source officielle
Vérifiez xivdev/Penumbra et son README.
Guide des mods runtime FFXIV
Guide Penumbra FF14 : installer, configurer et résoudre les problèmes
Penumbra est un plugin Dalamud qui charge des fichiers de mods FFXIV compatibles à l’exécution, sans remplacer les fichiers d’origine du jeu. La méthode la plus sûre consiste à passer par le dépôt personnalisé de plugins documenté par le projet, et non à décompresser manuellement une archive ZIP de publication.
Réponse rapide : installez via Dalamud, pas avec un fichier ZIP
Ouvrez XIVLauncher, entrez en jeu, lancez /xlsettings et ajoutez l’URL repo.json officielle de Penumbra dans la section des dépôts personnalisés de plugins expérimentaux. Installez ensuite Penumbra depuis /xlplugins afin que Dalamud gère les mises à jour.
Le README officiel déconseille explicitement de décompresser manuellement une archive ZIP de publication dans devPlugins. Les copies manuelles peuvent passer à côté des notifications de mise à jour et entrer en conflit avec l’installation gérée par le dépôt.
Vérification de fraîcheur au 22 juillet 2026 : la dernière publication GitHub est testing_1.7.0.2, mise en ligne le 20 juillet 2026. Ce guide ne propose pas le ZIP comme appel au téléchargement, car le README maintenu recommande la méthode par dépôt.
Guide des mods runtime FFXIV
Identifier le projet officiel Penumbra
Voici l’icône stockée dans le dépôt xivdev/Penumbra. Servez-vous du propriétaire du dépôt, du README, du suivi des tickets et de l’adresse repo.json pour vérifier le projet, au lieu de faire confiance à un hébergeur de fichiers au nom similaire.
Penumbra est un logiciel communautaire, pas une fonctionnalité officielle de Square Enix. Son fonctionnement à l’exécution évite d’écraser définitivement les archives du jeu, mais n’élimine pas les risques liés au compte, à la confidentialité, à la compatibilité ou à la source des mods.
Comment installer Penumbra dans FFXIV
- Commencez avec XIVLauncher officiel et Dalamud. Installez XIVLauncher depuis la page de publication Goatcorp, lancez FFXIV et vérifiez que /xlplugins ouvre bien l’installateur de plugins Dalamud.
- Ouvrez les paramètres de Dalamud. Exécutez /xlsettings et ouvrez l’onglet Experimental. Évitez de modifier des options expérimentales sans rapport avec votre objectif.
- Ajoutez l’URL du dépôt officiel. Collez https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json dans la liste des dépôts personnalisés de plugins, utilisez le bouton plus, puis enregistrez et fermez.
- Installez depuis Available Plugins. Ouvrez /xlplugins, trouvez Penumbra dans Available Plugins, vérifiez sa fiche, puis installez-le depuis le gestionnaire de plugins.
- Choisissez un dossier de mods dédié. Utilisez un dossier situé hors des répertoires protégés de Windows ou des dossiers programme de FFXIV. Gardez assez d’espace libre et ne pointez pas Penumbra vers le dossier d’installation du jeu.
- Testez un mod à la fois. Importez un seul mod fiable, activez-le pour une collection limitée, changez de zone ou rouvrez la fenêtre concernée, puis confirmez le résultat avant d’en ajouter d’autres.
Flux d’installation pris en charge
La méthode par dépôt clarifie davantage la gestion, les mises à jour et le retour arrière qu’un dossier de plugin copié manuellement.
Dépôt Dalamud
Ajoutez le repo.json officiel dans /xlsettings.
Gestionnaire de plugins
Installez et mettez à jour via /xlplugins.
Test contrôlé
Activez un mod fiable et vérifiez les conflits.
XIVLauncher + Dalamud + Penumbra
Où se situe Penumbra dans la chaîne de lancement
XIVLauncher démarre FFXIV et initialise Dalamud ; Penumbra est ensuite installé et géré comme plugin Dalamud. Vous n’avez pas besoin d’un lanceur séparé, d’un pack d’injection ou d’un exécutable du jeu modifié pour utiliser la configuration Penumbra prise en charge.
La capture d’écran est un visuel officiel Goatcorp pour XIVLauncher, et non une capture des paramètres de Penumbra. Elle illustre la couche de lanceur visible côté utilisateur afin d’éviter de confondre le plugin avec un client de jeu autonome.
Problèmes fréquents avec Penumbra et premier contrôle sûr
| Problème | Cause probable | Premier contrôle |
|---|---|---|
| Penumbra n’apparaît pas dans /xlplugins | L’URL du dépôt n’a pas été enregistrée ou Dalamud n’a pas encore actualisé | Rouvrez /xlsettings, vérifiez l’URL repo.json exacte, enregistrez, puis actualisez la liste des plugins |
| Plugins indisponibles après une mise à jour du jeu | La compatibilité de Dalamud est temporairement bloquée pour la nouvelle version de FFXIV | Attendez les mises à jour maintenues ; ne forcez pas d’anciens binaires de plugins dans le jeu |
| Un mod n’apparaît pas | L’affectation de collection, la priorité ou le chemin de fichier ne correspondent pas au personnage actuel | Vérifiez la collection active et utilisez les outils de conflits de Penumbra avant de réinstaller |
| Textures ou modèles mélangés | Deux mods activés remplacent les mêmes fichiers | Inspectez les conflits et placez le mod voulu plus haut dans la priorité |
| Chargements longs ou forte utilisation du disque | Bibliothèque de mods trop volumineuse, croissance du cache ou stockage lent | Désactivez les ajouts récents, vérifiez les chemins du cache et gardez le dossier de mods sur un stockage local sain |
| Comportement de plugin en double | Une copie manuelle dans devPlugins entre en conflit avec l’installation par dépôt | Supprimez la copie manuelle et conservez uniquement l’installation via le gestionnaire de plugins |
Dépanner sans endommager l’installation du jeu
Désactivez d’abord le mod le plus récent, puis testez avec le même personnage, la même collection, la même zone et le même équipement. Modifier plusieurs variables à la fois rend un conflit plus difficile à isoler.
Ne supprimez pas les archives de FFXIV, ne remplacez pas les exécutables du jeu, ne désactivez pas l’antivirus globalement et ne téléchargez pas de bundles de plugins repackagés. Penumbra est conçu pour garder les fichiers de mods séparés de l’installation d’origine ; conservez cette séparation.
Après un correctif majeur de FFXIV, Dalamud et les plugins peuvent rester indisponibles jusqu’à la fin du travail de compatibilité. Un message d’indisponibilité temporaire ne prouve pas que votre installation est cassée. Consultez les canaux officiels maintenus et attendez au lieu de forcer d’anciennes versions.
Limites liées au compte, au contenu et à la confidentialité
XIVLauncher, Dalamud, Penumbra et les mods sont des outils tiers. Square Enix ne fournit aucun support pour eux, et aucun guide ne peut garantir la sécurité du compte. Utilisez le client officiel du jeu si vous avez besoin de la solution la moins risquée.
N’importez que des fichiers de mods provenant de sources que vous comprenez. Évitez les archives qui incluent des exécutables, des demandes d’identifiants, de larges exclusions de sécurité ou une propriété peu claire. Respectez les autorisations des créateurs et n’utilisez pas de modifications visuelles pour imiter du contenu officiel.
Penumbra est-il la même chose que Dalamud ?
Non. Dalamud est le framework de plugins chargé via XIVLauncher ; Penumbra est un plugin qui gère les remplacements de mods à l’exécution.
Dois-je télécharger Penumbra.zip depuis GitHub Releases ?
Pas pour une installation normale. Le README officiel recommande d’ajouter l’URL repo.json et d’installer via Dalamud afin que les mises à jour soient gérées automatiquement.
Pourquoi les plugins FFXIV sont-ils indisponibles après une mise à jour du jeu ?
Dalamud peut désactiver temporairement les plugins pendant la vérification de compatibilité. Attendez les mises à jour maintenues et évitez de forcer un ancien binaire.
Où doit se trouver le dossier de mods Penumbra ?
Utilisez un dossier dédié en écriture, hors de l’installation de FFXIV et des dossiers système protégés, sur un stockage local avec suffisamment d’espace libre.
Comment corriger deux mods qui modifient le même fichier ?
Utilisez les informations de conflits de Penumbra et les priorités de collection. Ne laissez actif que le remplacement voulu, ou placez-le au-dessus du mod concurrent.
Penumbra est-il sûr ?
C’est un logiciel communautaire ouvert avec un dépôt officiel, mais cela reste un outil tiers et les fichiers de mods ajoutent des risques distincts liés à la source, à la confidentialité, à la compatibilité et aux règles du compte.