Différences entre versions de « Modding:Installer SMAPI sur Windows »

De Stardew Valley Wiki
Sauter à la navigation Sauter à la recherche
Ligne 50 : Ligne 50 :
  
 
==Désinstaller SMAPI ==
 
==Désinstaller SMAPI ==
# Exécutez à nouveau [[#Install SMAPI|run the installer]] mais choisissez ''uninstall'' pour supprimer SMAPI. (Ne s’applique pas à l’Xbox app.)
+
# Exécutez à nouveau [[#Install SMAPI|run the installer]] mais choisissez ''Désinstaller'' pour supprimer SMAPI. (Ne s’applique pas à l’Xbox app.)
 
# Si vous avez [[#Configurer votre profil|configurer Steam ou GOG Galaxy]] pour lancer SMAPI, annulez vos modifications:
 
# Si vous avez [[#Configurer votre profil|configurer Steam ou GOG Galaxy]] pour lancer SMAPI, annulez vos modifications:
#* '''Steam:''' dans votre bibliothèque Steam faites un clic-droit sur ''Stardew Valley'', puis ''Propriétés > General > Option de lancement'', et supprimer le contenu de la zone de texte. Désormais, le logiciel original se lancera depuis Steam.
+
#* '''Steam:''' dans votre bibliothèque Steam faites un clic-droit sur ''Stardew Valley'', puis ''Propriétés > Géneral > Option de lancement'', et supprimer le contenu de la zone de texte. Désormais, le logiciel original se lancera depuis Steam.
 
#* '''GOG Galaxy:''' dans votre bibliothèque GOG Galaxy: cliquer sur Stardew Valley, puis sur ''settings icon'' près du bouton 'Play', cliquer sur ''Manage installation > Configure'', et décocher la case ''Custom executables / arguments''.
 
#* '''GOG Galaxy:''' dans votre bibliothèque GOG Galaxy: cliquer sur Stardew Valley, puis sur ''settings icon'' près du bouton 'Play', cliquer sur ''Manage installation > Configure'', et décocher la case ''Custom executables / arguments''.
 +
#* '''Xbox app:'''
 +
## Suivez les instructions[[#Xbox app|d'installation sur l'Xbox app]] pour ouvrir votre dossier jeu;
 +
## renommer {{executable name|Stardew Valley}} en {{executable name|StardewModdingAPI}};
 +
## remplacer {{executable name|StardewModding Valley original}} (ou le nom que vous avez choisi en installant SMAPI) par {{executable name|Stardew Valley}}.
  
===Xbox app===
+
(Si vous voulez jouer sans mods temporairement, vous pouvez simplement lancer {{executable name|Stardew Valley}} ou renommer votre dossier <samp>Mods</samp> à la place. Ne s’applique pas à l’Xbox app.)
{{Traduire}}
 
Mods work with the Xbox app, but there's a few extra steps.
 
 
 
; Before you install SMAPI&#x3A;
 
:# Open the Stardew Valley section in the Xbox app.
 
:# Click the ''... > Manage'' button:<br />[[File:Modding - Enable SMAPI in Xbox app 1.png|thumb|none]]
 
:# Click the ''Files'' tab and then ''Browse'' to open your game folder:<br />[[File:Modding - Enable SMAPI in Xbox app 3.png|thumb|none]]
 
:# Open the ''Stardew Valley'' > ''Content'' folder. You should see a lot of files with names like <samp>api-ms-win-core-*</samp>:<br />[[File:Modding - Enable SMAPI in Xbox app 4.png|thumb|none]]
 
:# Copy the full path from the address bar at the top.
 
 
 
; Run the SMAPI installer&#x3A;
 
:# [[#Install SMAPI|Run the SMAPI installer]] like usual, but:
 
:#* Download the installer to somewhere that's not the game directory (like your downloads folder).
 
:#* When it asks where to install, enter the path you copied from the previous step.
 
 
 
; After you install SMAPI&#x3A;
 
:# In your game folder:
 
:## rename {{executable name|Stardew Valley}} to another name such as {{executable name|Stardew Valley original}};
 
:## make a copy of {{executable name|StardewModdingAPI}} and name the copy {{executable name|Stardew Valley}}.
 
 
 
That's it! Now just launch the game through the Xbox app to play with mods. '''Note that when the game updates, you'll need to redo the last two sections.'''
 
  
 
==Mettre à jour SMAPI==
 
==Mettre à jour SMAPI==

Version du 7 août 2023 à 06:06

Guide Joueur pour l'utilisation des mods SMAPI mascot.png

Cette page explique comment installer SMAPI sur Windows. SMAPI est un lanceur nécessaire à l'utilisation de mods dans Stardew Valley.

Installer SMAPI

  1. Lancer le jeu sans SMAPI au moins une fois (pour que le logiciel puisse être paramétré pour la première fois)
  2. Télécharger la dernière version de SMAPI.
  3. Extrayez le fichier .zip sur votre ordinateur (votre dossier Téléchargements fera l’affaire.)
  4. Double-cliquer sur install on Windows.bat¹, et suivez les instructions s’affichant sur votre écran.
  5. Concrètement, l’invite de commande qui devrait s’afficher va vous poser deux questions. Il est recommander de taper 1 puis sur la touche Entrée les deux fois.
  6. Si vous le souhaitez, vous pouvez configurer votre profil de jeu sur Steam ou GOG Galaxy.

¹ En revanche, si vous souhaitez installer manuellement SMAPI, suivez les instructions du fichier "Readme" mis à disposition par le créateur.

Configurer votre profil

Steam

Vous devez lancer SMAPI via Steam si vous voulez que la superposition Steam, les succès et le suivi du temps de jeu fonctionnent. (Si vous ne vous en souciez pas vous pouvez simplement lancer l'interface SMAPI via SMAPI mascot.png StardewModdingAPI.exe dans Modding:Guide_Joueur/Commencer#Trouver_votre_dossier_de_jeu pour jouer avec les mods.)

Voici comment le configuer:

  1. Gardez la fenêtre de l’installeur SMAPI ouverte.
    (Si vous l'avez déjà fermé, il suffit de le relancer. Il n'est pas nécessaire de le désinstaller puis de le ré-installer.)
  2. Copier le texte qui ressemble à ça dans la fenêtre du programme d'installation
    Modding - installing SMAPI on Windows - installer Steam text.png
    Faites en sorte de copier l’entièreté de la ligne, en incluant les guillemets " et la partie %command% .
    Pour la majorité des joueurs, le chemin d’accès final devrait ressembler à ça "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%
  3. Dans votre bibliothèque Steam, faites un clique-droit sur Stardew Valley et cliquez sur Propriétés:
    Modding - installing SMAPI on Windows - Steam 1.png
  4. Cliquez sur la zone de texte Option de lancement :
    Modding - installing SMAPI on Windows - Steam 2.png
  5. Remplacez tout ce qui se trouve dans la zone de texte par le texte que vous avez copié à partir du programme d'installation. Pour coller du texte, cliquez dans la zone et appuyez sur CTRL et V.
    Faites en sorte de coller l’entièreté de la ligne, en incluant les guillemets " et la partie %command% .
  6. À partir de maintenant, il suffit de lancer le jeu via Steam pour lancer SMAPI avec la superposition Steam et les succès.

GOG Galaxy

Vous devez lancer SMAPI via GOG Galaxy si vous voulez que le suivi du temps de jeu fonctionnent. (Si vous ne vous en souciez pas vous pouvez simplement lancer l'interface SMAPI via SMAPI mascot.png StardewModdingAPI.exe dans Trouver votre dossier de jeu pour jouer avec les mods.)

Voici comment le configurer :

  1. Ouvrez Notepad et coller le texte suivant : start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"
    (Si votre jeu est installé dans un autre dossier, remplacez le chemin d'accès dans la commande ci-dessus.)
  2. Cliquer sur Fichier puis Enregistrer sous.
    Save batch script.png
  3. Dans la fenêtre Enregistrer sous qui apparaît : naviguez jusqu'à votre dossier de jeu Stardew Valley, changez Type en Tous les fichiers, changez le nom du fichier en start.bat, et cliquez sur Enregistrer.
    Choose batch extension.png
    Name batch script.png
  4. Dans le client GOG Galaxy, cliquez sur Stardew Valley > settings icon > Manage installation > Configure.
    Gog galaxy configure.png
  5. Dans le menu qui apparaît, activez la case à cocher "Custom executables / arguments".
  6. Cliquez sur
    Gog galaxy add exectuable.png
  7. Choisissez start.bat dans la fenêtre qui apparaît et cliquer sur Open.
    Select batch file.png
  8. Activez le bouton radio Default Executable sous la section File 2 que vous venez d’ajouter et cliquez sur OK.
    Gog galaxy select default executable.png

A partir de maintenant, vous pouvez lancer Stardew Valley via GOG Galaxy, la console SMAPI ainsi que le jeu se chargeront comme prévu !

Mettre à jour SMAPI

Il suffit d’installer la nouvelle version ! Le programme d'installation nettoiera automatiquement les versions précédentes. (Vous n'avez pas besoin de configurer à nouveau Steam ou GOG Galaxy).

Désinstaller SMAPI

  1. Exécutez à nouveau run the installer mais choisissez Désinstaller pour supprimer SMAPI. (Ne s’applique pas à l’Xbox app.)
  2. Si vous avez configurer Steam ou GOG Galaxy pour lancer SMAPI, annulez vos modifications:
    • Steam: dans votre bibliothèque Steam faites un clic-droit sur Stardew Valley, puis Propriétés > Géneral > Option de lancement, et supprimer le contenu de la zone de texte. Désormais, le logiciel original se lancera depuis Steam.
    • GOG Galaxy: dans votre bibliothèque GOG Galaxy: cliquer sur Stardew Valley, puis sur settings icon près du bouton 'Play', cliquer sur Manage installation > Configure, et décocher la case Custom executables / arguments.
    • Xbox app:
    1. Suivez les instructionsd'installation sur l'Xbox app pour ouvrir votre dossier jeu;
    2. renommer Stardew Valley executable icon.png Stardew Valley.exe en SMAPI mascot.png StardewModdingAPI.exe;
    3. remplacer StardewModding Valley original.exe (ou le nom que vous avez choisi en installant SMAPI) par Stardew Valley executable icon.png Stardew Valley.exe.

(Si vous voulez jouer sans mods temporairement, vous pouvez simplement lancer Stardew Valley executable icon.png Stardew Valley.exe ou renommer votre dossier Mods à la place. Ne s’applique pas à l’Xbox app.)

Mettre à jour SMAPI

Il suffit d’installer la nouvelle version ! Le programme d'installation nettoiera automatiquement les versions précédentes. (Vous n'avez pas besoin de configurer à nouveau Steam ou GOG Galaxy).

Désinstaller SMAPI

  1. Exécutez à nouveau le programme d'installation mais choisissez Désinstaller pour supprimer SMAPI. (Ne s’applique pas à l’Xbox app.)
  2. Si vous avez configurer Steam ou GOG Galaxy pour lancer SMAPI, annulez vos modifications:
    • Steam: dans votre bibliothèque Steam faites un clic-droit sur Stardew Valley, puis Propriétés > Géneral > Option de lancement, et supprimer le contenu de la zone de texte. Désormais, le logiciel original se lancera depuis Steam.
    • GOG Galaxy: dans votre bibliothèque GOG Galaxy: cliquer sur Stardew Valley, puis sur settings icon près du bouton 'Play', cliquer sur Manage installation > Configure, et décocher la case Custom executables / arguments.
    • Xbox app:
    1. Suivez les instructions d'installation sur l'Xbox app pour ouvrir votre dossier jeu;
    2. renommer Stardew Valley executable icon.png Stardew Valley.exe en SMAPI mascot.png StardewModdingAPI.exe;
    3. remplacer StardewModding Valley original.exe (ou le nom que vous avez choisi en installant SMAPI) par Stardew Valley executable icon.png Stardew Valley.exe.

(Si vous voulez jouer sans mods temporairement, vous pouvez simplement lancer Stardew Valley executable icon.png Stardew Valley.exe ou renommer votre dossier Mods à la place. Ne s’applique pas à l’Xbox app.)

Résolution de problèmes

"Oups, nous n'avons pas trouvé le jeu automatiquement".

Si vous utilisez le Game Pass, les autorisations du dossier de jeu causeront probablement des problèmes si vous essayez de faire cela. Toutefois, si le programme d'installation affiche ce message, vous pouvez l'aider à trouver le dossier du jeu. Pour ce faire, procédez comme suit :

  1. Quitter le programme d’installation.
  2. Trouvez votre dossier de jeu.
  3. Déplacez le dossier du programme d'installation dans le dossier du jeu. (Assurez-vous de déplacer le dossier entier, pas seulement les fichiers qu'il contient !)
  4. Exécutez à nouveau le programme d'installation et il devrait détecter automatiquement le dossier du jeu.

Vous pouvez supprimer le dossier d'installation en toute sécurité une fois ces étapes réalisées.

Je n'arrive pas à trouver un fichier en particulier mentionné dans le guide !

Windows masque les extensions de fichiers par défaut. Pour les faire apparaître, il suffit de cocher l'option dans l'explorateur de fichiers.

Select the View tab, and then check "File Name Extensions

Si vous utilisez Windows 11, référez-vous plutôt à cette capture d'écran:

Problèmes rencontrés avec SMAPI ou les mods

Voir la page de résolution de problème pour de l’aide (en anglais) après installation.