Installation de mods pour Android

[Isaya]

Il y a quelques mois, Scott Brooks, un développeur de Beamdog a indiqué une méthode permettant de contourner l'impossibilité de modifier le fichier des textes du jeu pour iOS (dialog.tlk/dialogF.tlk). White Agnus (par ailleurs auteur du premier patch VF pour BG2EE) a signalé depuis sur le forum de BG1 NPC qu'elle fonctionnait également pour Android. Cette méthode, qui permet de proposer une version française partielle pour BG2EE sur Android, ouvre également la voie à l'utilisation de mods sur Android, bien au-delà des quelques mods de type Override (cf le guide des mods pour BGEE) qui étaient déjà accessibles.

Vous aurez besoin d'un ordinateur pour effectuer cette opération. Néanmoins vous n'aurez pas besoin de posséder le jeu sur ordinateur pour installer des mods.
Vous devez être en mesure d'accéder au contenu de votre tablette/téléphone depuis votre ordinateur. Pour cela il vous faudra peut-être installer un driver ou un logiciel fourni par le fabriquant de l'appareil. Par exemple, pour Sony, j'ai dû installer le logiciel Sony PC Companion, qui a installé les drivers nécessaires à accéder au contenu de la tablette.

Enfin il vous faut télécharger le programme centralfix.exe pour Windows mis à disposition par l'auteur.
L'auteur a également fourni le code source du programme, écrit en Go (langage créé par Google et disponible ici), pour permettre aux joueurs équipés d'un autre système d'exploitation de faire fonctionner le programme (néanmoins je ne peux pas fournir d'indications sur la façon de procéder pour Linux ou Mac OS X).
J'ai testé cette procédure sous Windows.


MISE EN GARDE

J'ai testé cette méthode avec la version bêta de BGEE mise à disposition par Beamdog pour des volontaires s'inscrivant auprès d'eux.
Je ne suis pas en mesure de garantir qu'elle fonctionne avec la version 1.3.2053 du jeu (dernier patch officiel).


Constitution de l'environnement pour installer des mods

Il n'existe pas de version de WeiDU pour Android, aussi c'est la raison pour laquelle il faut commencer par constituer, sur un ordinateur fonctionnant sous Windows, un environnement de jeu équivalent à celui d'un jeu installé sur l'ordinateur local à partir du jeu installé sur la tablette ou le téléphone Android.
Sachez que c'est normalement possible aussi sous Mac OS X ou Linux, moyennant l'installation du langage Go et l'exécution du programme centralfix à partir de ses sources, puisque c'est indispensable pour la dernière étape. Je ne suis pas en mesure de donner plus d'indications.
A partir de maintenant, j'utiliserai de façon générique le mot tablette pour désigner l'appareil sous Android.

• Connectez la tablette à votre ordinateur par le câble USB ; alternativement utilisez une méthode sans fil si vous savez comment faire
  Selon votre système d'exploitation, il vous faudra peut-être faire une opération pour qu'un nouveau lecteur apparaisse sur le bureau ou le poste de travail
• Avec l'explorateur, allez dans le lecteur apparu suite à la connexion
  Si plusieurs lecteurs apparaissent (c'est le cas entre la "mémoire interne" et d'éventuelles cartes SD, soit physiques, soit simulées), allez dans la partie "mémoire interne"
• Ensuite allez dans le dossier Android/obb/com.beamdog.baldursgateenhancededition
  Vous devriez trouver là deux fichiers portant une extension .obb :
  • main.2106.com.beamdog.baldursgateenhancededition
  • patch.2100.com.beamdog.baldursgateenhancededition
  Nota : pour la version bêta, les nombres après main et patch diffèrent d'une version à l'autre du jeu
• Sur le disque de votre ordinateur, créez un répertoire BGEE_Android (ou tout autre nom qui vous convient)
  • Linux : selon cette discussion sur le forum WeiDU, il vous faudrait utiliser un système de fichier non sensible à la casse pour installer le jeu lorsque vous avez l'intention d'utiliser des mods
• Copiez les deux fichiers obb dans ce nouveau répertoire
• Sur le disque dur, renommez les fichiers copiés en changeant l'extension en .zip
• Extrayez dans le même répertoire (BGEE_Android) les deux fichiers zip obtenus, en commençant par le fichier main.2106.com.beamdog.baldursgateenhancededition.zip ; si votre outil crée un sous-répertoire pour chaque, déplacez leur contenu dans le dossier BGEE_Android
• Vous devriez obtenir le contenu suivant dans le répertoire BGEE_Android :
  • data
  • lang
  • movies
  • music
  • script
  • chitin.key
  en plus des deux fichiers zip.

Installation proprement dite des mods

L'objectif est de construire une structure de répertoires contenant uniquement les fichiers modifiés par l'installation des mods.

• Extrayez dans le répertoire BGEE_Android le contenu des archives des mods que vous souhaitez installer
• Windows (recommandé) : assurez-vous de mettre à jour l'exécutable setup-NOM_DU_MOD de ces mods par la version la plus récente de WeiDU, comme indiqué dans cette procédure
• Lancez l'installation des mods, dans l'ordre recommandé, en suivant les instructions propres au système d'exploitation de votre ordinateur
  • Windows : exécutez successivement les fichiers setup-NOM_DU_MOD.exe de chaque mod
  • Mac OS X : voici un guide détaillé (en anglais)
  • Linux : ouvrez un terminal dans le répertoire BGEE_Android et tapez successivement les commandes weinstall NOM_DU_MOD de chaque mod
• Attention : lorsque vous installerez le premier mod, WeiDU vous demandera dans quelle langue vous voulez pour le jeu. Prenez soin de choisir la langue que vous avez l'intention d'utiliser, cela a un impact sur le sous-répertoire de langue que WeiDU va modifier pour ajouter les textes venant des mods. Ce n'est pas le même choix que celui de votre traduction préférée d'un mod.

Création de l'archive de mods pour transfert vers Android

• Allez dans le répertoire lang/fr_FR depuis BGEE_Android
  Attention : il faut que cela corresponde au choix de langue pour le jeu effectué à l'étape précédente !
• Sélectionnez les fichiers dialog.tlk et dialogF.tlk, puis sélectionnez l'option Copier dans le presse-papier
• Créez un nouveau répertoire temporaire, par exemple Arbo_pour_Android
• Créez dans ce répertoire une arborescence lang/fr_FR
• Collez dans Arbo_pour_Android/lang/fr_FR les fichiers mis dans le presse-papier
• Copiez le répertoire override depuis BGEE_Android vers Arbo_pour_Android
• Lancez votre programme d'archivage zip habituel (7-Zip, WinZip, ...)
• Par glisser-déposer ou toute autre méthode équivalente, ajoutez depuis le répertoire Arbo_pour_Android les répertoires lang et override à l'archive
• Dans les options de création de l'archive de votre programme d'archivage, veillez à indiquer qu'il ne faut pas appliquer de compression
  Par exemple, avec 7-Zip (Windows), il faut préciser Format de l'archive : zip et Niveau de compression : Aucune.
• Créez l'archive et donnez-lui un nom tel que Mods.zip
• Copiez le programme centralfix.exe dans le même répertoire que l'archive créée, Mods.zip
• Ouvrez une invite de commande et placez-vous dans le répertoire où l'archive a été créée
  Nota : sous Windows 7 et plus, il suffit de sélectionner le dossier dans l'explorateur, de maintenir appuyée la touche Maj et de cliquer sur le bouton droit de la souris pour faire apparaître une option "Ouvrir une fenêtre de commandes ici", qu'il suffit de choisir
• Tapez la commande

  Code : Tout sélectionner

  centralfix Mods.zip

  Elle prépare l'archive afin qu'elle soit reconnue par BGEE/BG2EE (et très probablement IWDEE) comme un contenu complémentaire pour le jeu.

Nota : j'ai décrit l'étape concernant centralfix uniquement pour Windows car je n'ai aucune expérience avec Go et l'utilisation de Mac OS X ou Linux.


Transfert de l'archive de mods vers Android

• Copiez l'archive Mods.zip ainsi obtenue sur la tablette en la plaçant dans le répertoire Android/data/com.beamdog.baldursgateenhancededition/files
  Attention, ce n'est pas le même qu'au début.

Remarques sur le contenu à inclure dans l'archive des mods

Dans la procédure ci-dessus, les fichiers dialog.tlk/dialogF.tlk et le répertoire override sont le strict minimum à inclure dans l'archive. Cela devrait correspondre au besoin de la plupart des mods.
En fonction des mods, il vous faudra peut-être ajouter d'autres éléments à l'archive :

• pour un mod qui construit des fichiers bif, il faudra créer dans Arbo_pour_Android un répertoire data dans lequel vous recopierez les fichiers bif créés par le mod dans BGEE_Android/data
• pour un mod qui ajoute des musiques (souvent les mods de PNJ), il faudra créer dans Arbo_pour_Android un répertoire music dans lequel vous recopierez les fichiers et répertoires ajoutés par le mod dans BGEE_Android/music
• pour un mod qui ajoute des scripts, tels que BPSeries, il faudra créer dans Arbo_pour_Android un répertoire scripts dans lequel vous recopierez les fichiers modifiés ou ajoutés par le mod dans BGEE_Android/scripts

Nota : cette liste n'est pas exhaustive.
De façon générale, utilisez la capacité à classer les fichiers par date dans les différents répertoires du jeu afin de repérer les fichiers ajoutés ou modifiés par les mods et construisez la même arborescence de répertoires et fichiers dans le répertoire Arbo_pour_Android.
Il faudra alors également inclure tous ces fichiers dans l'archive Mods.zip.

Il n'est pas nécessaire de transférer sur la tablette les répertoires des mods créés à l'extraction des archives, le jeu n'en a pas besoin pour fonctionner. Par contre vous avez intérêt à conserver le répertoire BGEE_Android intact afin de pouvoir mettre à jour, supprimer ou ajouter des mods pendant votre partie. En cas d'évolution de votre installation de mods, vous devrez répéter les opérations de création de l'archive de mods pour Android, de modification de l'archive par centralfix.exe et de transfert sur la tablette.

Précisons que le jeu accepte plusieurs archives constituées de la manière indiquée. Je n'ai cherché à déterminer si le jeu avait un ordre particulier pour les charger. Je suggère d'éviter des conflits dans le contenu des archives si vous souhaitez exploiter cette faculté.
Dans mon cas d'essai, j'avais constitué une archive composée des fichiers permettant de récupérer partiellement les voix en français (contenu identique à celui proposé pour les ordinateurs dans cette discussion) et une archive de mods (comprenant le répertoire override et les fichiers lang/fr_FR/dialog.tlk).


Exemple

Cette méthode m'a permis d'installer les mods BG1 NPC (avec ses musiques), BG1 UB, Finch et Thalantyr Item Updgrade pour BGEE. Bien que je n'ai pas suffisamment avancé dans la partie pour vérifier beaucoup de choses, je peux néanmoins confirmer que le contenu des mods est bien pris en compte : la rencontre avec Finch à Châteausuif a bien eu lieu dans une partie créée avec un personnage prétiré.



BG2EE

Les fichiers obb se trouvent dans le répertoire Android/obb/com.beamdog.baldursgateIIenhancededition et s'appellent (pour la version bêta) :

• main.226.com.beamdog.baldursgateIIenhancededition.obb
• patch.220.com.beamdog.baldursgateIIenhancededition.obb

L'archive de mods doit transférée dans le répertoire Android/data/com.beamdog.baldursgateIIenhancededition/files

J'ai employé cette méthode pour constituer une archive de traduction partielle en français. Ce n'est pas à proprement parler un mod mais, à la base, c'est la même chose puisqu'il ajoute un fichier dialog.tlk au jeu. Bien que je l'ai testé avec la version bêta, j'ai eu confirmation par un autre joueur que l'archive fonctionnait avec la version courante non bêta (1.3.2064).


IWDEE

Sur le forum de Beamdog, Kamigoroshi a confirmé que cette méthode fonctionnait pour Icewind Dale Enhanced Edition et a fourni quelques informations plus précises. Les fichiers obb se nomment :

• main.406.com.beamdog.icewinddale.obb
• patch.400.com.beamdog.icewinddale.obb

En principe ils devraient se trouver dans le répertoire Android/obb/com.beamdog.icewinddale, si Beamdog a suivi la même logique de nom que pour l'arborescence data (cf ci-après).
L'archive de mods doit être transférée dans le répertoire Android/data/com.beamdog.icewinddale/files

[Isaya]

A ceux qui voudraient essayer sans avoir à suivre toute cette procédure, en particulier pour la version 1.3.2053 de BGEE, je propose temporairement l'archive que j'ai essayée avec succès de mon côté. Vous pouvez alors commencer à l'étape "Transfert".
Il vous faudra quitter le jeu et le relancer (sur ma tablette, le jeu reste souvent présent dans la liste des programmes en mémoire, je le supprime de la liste afin d'être sûr de repartir de zéro).
Si le jeu se plante au démarrage alors qu'il fonctionnait avant, effacez l'archive. Cela signifie peut-être que votre version n'accepte pas cette capacité (si vous avez la version 1.3.2053).
Pour vérifier que les mods sont reconnus, commencez une partie et allez à proximité des chanteurs de Châteausuif, comme sur la capture ci-dessus. Finch devrait apparaître. Dans le cas contraire, cela montre que le jeu ne les a pas pris en compte.

[Isaya]

Sur le forum de Beamdog, Kamigoroshi a confirmé que la méthode fonctionne également pour Icewind Dale Enhanced Edition. J'ai ajouté les informations qu'il a fournies à propos des fichiers et des emplacements concernés pour ce jeu.

[Mystré]

Bonjour Isaya,*

J'ai bien suivi a la lettre ta procédure pour installer des mods sur BGEE sur Android (j'utilise un Samsung Galaxy S7 Edge).
Cependant, cela ne fonctionne pas.. enfin, pas tt a fait. Déjà, quand je respecte a la lettre la procédure, lorsque j'essaye d'ouvrir l'appli, elle crash aussitôt.. donc ne s'ouvre meme pas..*
Je me suis rendu compte que c'était le fait qu'il y ait un fichier zippé dedans. J'ai donc copié tout les dossiers (Et ne sachant pas lesquels il faut, lesquels sont inutiles, je les ai tous pris) directement de BGEE_android sur mon téléphone.. (oui 10h pr que ca se fasse..). Résultat cela fonctionne MAIS tout les ajouts de textes sont remplacés par "Invalid:xxxxx". Donc j'ai bien accès à tt les changements qui ne touchent pas aux textes, mais pour tt les nouveaux textes (nouveaux sorts, kits de perso, nouveaux objets, nouvelles discussions, etc...) j'ai juste "invalid:xxxxx". J'ai bien installé les mods dans l'ordre d'installation requis.. donc je ne comprends pas..
Aurais-tu une idée de comment procéder pr que je puisse y arriver?

[Isaya]

Bonjour Mystré,

Peux-tu préciser la version du jeu que tu as sur ton téléphone, s'il te plaît ?

Avec la version 1.3.2070, l'expérience a montré qu'il y avait quelques types de données qu'il ne fallait pas mettre dans une archive zip traitée avec centralfix. Cela concerne en particulier les fichiers de type image : bam, mos, pvrz notamment. Par conséquent, de façon générale, il vaut mieux ne mettre que les arborescences lang et music dans l'archive zip et copier le répertoire override directement dans le répertoire Android/.../files.
Pour cette copie, il est sans doute préférable (pour gagner beaucoup de temps) de faire un fichier zip (celui-ci peut être fait avec compression, puisqu'il ne sert que pour le transfert), de le transférer dans le répertoire et d'extraire le fichier zip sous Android.
Néanmoins, à ma connaissance, les types de fichier concernés n'interviennent pas dès le lancement du jeu, il y a donc peu de chance que ce soit la cause du crash. Ce n'est pas vrai si tu as installé un mod qui modifie l'interface graphique du jeu. Précise si c'est le cas.

Si tu as la version 2.5 bêta, cela ne fonctionne pas, d'après les retours sur le forum Beamdog. Quelqu'un a établi une procédure à jour, mais un peu plus compliquée et uniquement en anglais, pour contourner un problème de la version 2.5 de BG2EE et IWDEE quant à l'utilisation (ou plutôt la non-utilisation) du dialog.tlk présent dans l'archive zip passée au crible de centralfix, ce qui conduit à un phénomène semblable à celui que tu as signalé pour le cas où tu avais extrait le contenu de l'archive (des Invalid:xxxx). La méthode proposée permet de contourner le problème, mais elle ne fonctionne pas avec BGEE 2.5 bêta.
Dans ce cas, il vaudrait mieux attendre la sortie probablement imminente de la version finale (mais sans doute avec le même bug que BG2EE, mais probablement avec le même moyen de contournement).

[Mystré]

Bonjour Isaya,

Tout d'abord merci pour la reponse extremement rapide :-).

Ma version de BGEE est la 1.3. Je prends rarement d'application en version beta.

Normalement, je n'avais aucun mod qui touchait a l'interface graphique. A ma connaissance, aucun d'entre eux ne le faisait. C'etait des mods de type PNJ, kits, quete, amelioration du jeu (tweak, etc..).

J'ai justement tout transferer sans meme que les fichiers soient zippés.. cela ne devrait il pas mieux fonctionner justement, ou il faut absolument que les fichiers lang et music soient zippé?

[Isaya]

A priori, le jeu sait reconnaître directement les fichiers dans les dossiers override, portraits et quelques autres. Par contre, pour les dossiers lang et music, il faut forcément passer par un fichier zip sans compression et traité par centralfix.

Avec la version 1.3, la méthode recommandée issue de l'expérience des joueurs diffère légèrement de ce que j'ai proposé dans le guide. Pour éviter les problèmes liés à certains formats de fichiers, il s'agit d'apporter une variante dans la phase de création de l'archive. Il ne faut pas inclure le répertoire override au moment de faire l'archive que j'ai appelée Mods.zip et qu'il faut traiter avec centralfix.
Pour le répertoire override, il suffit de faire une archive zip standard, disons override.zip, qui contient le répertoire override et tous ses fichiers. Cette archive doit être copiée au même endroit que Mods.zip, dans Android/.../files (cf. le guide pour le chemin exact).
Ensuite il faudrait s'assurer que le répertoire override dans Android/.../files n'existe pas ou qu'il est vide. Autrement, il faut effacer son contenu (sinon il y aura un fort risque d'interférence entre le contenu actuel et les fichiers ajoutés par les mods).
Enfin il faut extraire cette archive override.zip, à partir du gestionnaire de fichiers du téléphone : si nécessaire le répertoire override devrait être créé dans Android/.../files.
Pour finir, déplace ou efface le fichier override.zip afin qu'il n'interfère pas.

Attention : comme, sous Android, le jeu ne s'arrête pas vraiment quand tu le quittes, il faut que tu t'assures qu'il n'apparaît plus dans les applications en cours (typiquement via le bouton de droite). Android est parfois lent à la détente à propos des fichiers copiés depuis un ordinateur. Il vaudra peut-être mieux que tu redémarres le téléphone pour vérifier que cela fonctionne bien.

[Mystré]

Je vais essayer tout ca et te tiens au courant rapidement si cela a marché ou non. Et quelle methode j'ai du suivre. Encore merci pour l'aide! :-)

[Mystré]

Je viens d'essayer! Cela fonctionne!! Merci beaucoup!!!
Alors, j'ai donc mis les fichiers "lang" et "music" dans un fichier zip Mods.zip (que j'ai configuré avec le centralfix).
Ce fichier Mods.zip, je l'ai tt simplement copié dans le dossier files de mon telephone.

Concernant le fichier override. Je l'ai donc zippé, copié dans le files de mon telephone, dézipper via l'application RAR (tres facile d'utilisation). Un fois le dossier override normal installé dans le fichier files, j'ai supprimé le dossier override.zip (sa presence empecher tjrs le lancement du jeu).
Cela fonctionne tres bien pr le moment.

Petite question cependant, je n'ai pas telecharger que le fichier override... de peur qu'un autre dossier soit necessaire, j'ai egalement copié de la meme facon les dossiers/fichiers suivants :
-bg1npc
-bg1npcmusic
-bg1ub
-bgqe
-DarkHorizonsBGee
-data
-Derats_kits
-inclined-macro
-movies
-scripts
-SirinesCall
-soa
-thalan
-Worldmap
-chitin.key

Dois-je les laisser? Puis je les supprimé sans craintes que le jeu bugue a un moment ou un autre?

[Isaya]

Bonne nouvelle !

Parmi l'ensemble que tu cites, data, movies, scripts et chitin.key sont des répertoires et des fichiers du jeu, pour certains très gros (data). Sauf cas particulier, il ne sert à rien de la copier dans le répertoire Android/.../files. Ils sont déjà présent dans les fichiers obb. Il n'est pas exclus que certains mods ajoutent des fichiers dans movies et scripts, auquel cas il faut effectivement copier une partie de leur contenu. Je ne sais pas te dire si les mods de ta liste le font. Le plus simple est de vérifier les dates de modification des fichiers dans les dossiers movies, music et scripts. Seuls ceux ayant des dates et heures correspondant au moment où tu as installé les mods, autrement dit plus récents que tous les fichiers d'origine (regarde sur l'ordinateur et non le téléphone). Tu peux laisser de côté les autres fichiers : ils sont déjà présents dans le jeu.

Cette remarque s'applique aussi pour le contenu du répertoire music que tu as inclus dans l'archive Mods.zip : il ne faut y inclure que les fichiers modifiés ou ajoutés, les autres prennent de la place pour rien.

Comme je l'ai indiqué dans la partie "Remarques sur le contenu à inclure dans l'archive des mods", il n'est pas utile de transférer sur tablette les dossiers créés lors de l'extraction des mods. Tu peux donc effacer sur la tablette :

• bg1npc
• bg1npcmusic
• bg1ub
• bgqe
• DarkHorizonsBGee
• Derats_kits
• SirinesCall
• soa
• thalan

ainsi sans doute que inclined-macro et Worldmap, qui sont sans doute créés par un des mods.

[Mystré]

Ok merci. Je vais donc supprimé les dossiers des mods vraiment inutiles. Et laisser les autres pr le moment... tant que mon tel ne me demande de faire de la place, cela ne dérange pas je pense
Encore un énorme merci pour la réactivité! Beamdog devrait te rémunérer pour le service après vente que tu assures à leur place aussi bien en francais qu'en anglais

[Mystré]

Bonjour à tous! Et bonjour Isaya surtout!
Voila, j'ai fini BGEE sur mobile avec les mods que j'ai ajouté. Dans l'ensemble, tout s'est bien passé. Le jeu ne crashait qu'à 2 endroits :
- La zone du phare. Au début, dès que je rentrais dans la zone. Puis, en essayant d'y accéder par une autre partie (est, sud..), dès que je mettais l'écran sur la partie de la plage, cela crashait également. J'ai réussi tt de même à finir la zone et ses quêtes en sauvegardant tt les 2 pas.. fastidieux mais j'y suis arrivé.
- Dynahéir. J'ai pu la recruter sans problème, avoir les intéractions, récupérer son journal. Puis plus rien ne se déclenchait (alors qu'elle devait avoir une quête après ca..). Bref, n'en ayant pas besoin dans mon équipe, je l'ai laissé à Brasamical. Puis quand j'ai voulu la reprendre pour la déplacer à Baldur's Gate, le jeu crashait dès qu'elle rejoignait mon équipe..

Mais rien de vraiment dérangeant au final.
Maintenant voila, BGEE est finie mais pas l'aventure! Je voudrais donc enchaîner avec Siege of Dragonspear. J'ai suivi la même méthode (à la différence qu'il n'y a pas de langue FR.. just US...). Le jeu fonctionne bien, pas de crash lors de l'incantation d'un sort.. mais les text invalid sont de retour...
Pour SoD je n'ai surtt besoin que du DUKP pour récupérer mon précheur et du tweak pour enlever les limites d'XP, etc...
As-tu une idée à me proposer?.

En même temps que j'écris, je viens de me rendre compte que j'ai perdu ma sauvegarde finale... -_- (je l'avais copié sur mon ordi, mais je ne sais pas pourquoi, le fichier s'est copié vide &#128557 . Donc il va falloir que je recommence tout pour faire une continuité du jeu avec le même perso... De +, mntnt quand je retélécharge BGEE, la version 2.5 se met automatiquement... et je crois que tu avais parlé d'un bug avec cette version...
Bref, je vais rééssayer de tt réinstaller avec BGEE.. (sauf peut être sirene's call qui etait peut etre a l'origine du crash dans la zone du phare...).

Edit : je viens de tester... en respectant la meme procedure.. les textes n'apparaissent donc pas.. une suggestion?

Edit 2 : j'ai essaye le changement du patch.obb expliqué en anglais dont tu as donné le lien.. sans mods, en essayant le jeu normal, ca crash au lancement d'un sort... des idées pr pouvoir modder le jeu?...