Guide du joueur – Archipelago pour The Escapists 2

Ce guide explique comment installer le mod, créer sa partie Archipelago et jouer. Pour compiler le mod vous-même, voir le README.

Le mod est en développement. Il a été testé en jeu sur un serveur Archipelago local ; la connexion à un serveur public comme archipelago.gg n'a pas encore été vérifiée (voir Dépannage).

Sommaire

1. Ce qu'il faut
2. Installer le mod dans le jeu
3. Installer l'APWorld
4. Créer son YAML
5. Générer et héberger la partie
6. Se connecter en jeu
7. Jouer
8. Dépannage
9. Désinstaller

1. Ce qu'il faut

• The Escapists 2 sur PC (Steam).
• Archipelago 0.6.7 ou plus récent : github.com/ArchipelagoMW/Archipelago/releases.
• BepInEx 5.4.23, version x86 : github.com/BepInEx/BepInEx/releases, fichier BepInEx_win_x86_5.4.23.x.zip. The Escapists 2 est un jeu 32 bits : la version x64 de BepInEx ne se charge pas.

• Les fichiers du mod, sur la page Releases de ce dépôt :

  • TE2Archipelago : le dossier du plugin (4 fichiers .dll) ;
  • the_escapists_2.apworld : la définition du jeu pour Archipelago.

  Si aucune version n'est encore publiée, le README explique comment les produire.

2. Installer le mod dans le jeu

1. Ouvrez le dossier du jeu : dans Steam, clic droit sur The Escapists 2 → Gérer → Parcourir les fichiers locaux. Il contient TheEscapists2.exe.
2. Décompressez l'archive BepInEx x86 dans ce dossier. Vous devez obtenir, à côté de TheEscapists2.exe : winhttp.dll, doorstop_config.ini et un dossier BepInEx.
3. Lancez le jeu une fois, attendez le menu principal, puis quittez. BepInEx crée alors ses sous-dossiers (BepInEx/plugins, BepInEx/config) et un journal BepInEx/LogOutput.log.
4. Copiez le dossier TE2Archipelago dans BepInEx/plugins/. Résultat : BepInEx/plugins/TE2Archipelago/TE2Archipelago.dll (+ 3 autres .dll).
5. Relancez le jeu. En haut à droite de l'écran doit apparaître « AP : déconnecté [F10] » : le mod est chargé.

3. Installer l'APWorld

Seule la personne qui génère la partie a besoin de l'APWorld. Les joueurs qui se connectent n'en ont pas besoin.

• Double-cliquez sur the_escapists_2.apworld : le lanceur Archipelago propose de l'installer ;
• ou copiez-le à la main dans le dossier custom_worlds d'Archipelago (sous Windows, par défaut : C:\ProgramData\Archipelago\custom_worlds).

Relancez ensuite le lanceur Archipelago. The Escapists 2 apparaît dans la liste des jeux de l'outil Options Creator.

4. Créer son YAML

Le YAML décrit votre partie. Vous pouvez le créer avec l'Options Creator du lanceur Archipelago, ou partir de cet exemple :

name: MonPseudo            # nom du slot : à retaper à l'identique dans le jeu
game: The Escapists 2
description: Ma partie The Escapists 2

The Escapists 2:
  # Prisons incluses dans la partie
  center_perks: true
  rattlesnake_springs: true
  kapow_camp: false
  hmp_offshore: false
  fort_tundra: false
  area_17: false
  uss_anomaly: false
  cougar_creek_railroad: true
  hms_orca: false
  air_force_con: false

  # Stats : un check tous les N points d'entraînement, et chaque objet Progressive relève le plafond de N
  strength_step: 10
  stamina_step: 10
  intellect_step: 10

  # Pourcentage d'objets de remplissage remplacés par des pièges
  trap_chance: 5

  # Condition de victoire
  goal: different_prisons
  unique_escapes_required: 4
  prisons_required: 2
  multiplayer_escapes: false

Toutes les options

Il faut au moins une prison activée. Les nombres trop grands sont ramenés au maximum possible (nombre de prisons activées, nombre d'évasions existantes).

Conditions de victoire

Le périmètre et les évasions spéciales comptent toujours. Les évasions multijoueur ne comptent que si multiplayer_escapes: true ; elles demandent de jouer en coop à deux joueurs ou plus.

5. Générer et héberger la partie

1. Placez les YAML de tous les joueurs (tous jeux confondus) dans le dossier Players d'Archipelago.
2. Lancez Generate depuis le lanceur. Une archive AP_….zip apparaît dans le dossier output.
3. Hébergez-la :
   • en ligne : sur archipelago.gg, Host Game, envoyez l'archive ; la page de la room donne l'adresse à utiliser (par exemple archipelago.gg:38281) ;
   • en local : lancez Host (ArchipelagoServer) depuis le lanceur et choisissez l'archive ; l'adresse est localhost:38281 (ou l'IP de la machine pour les autres joueurs).

6. Se connecter en jeu

1. Lancez The Escapists 2. La fenêtre Archipelago s'affiche (touche F10 pour l'afficher ou la masquer).
2. Remplissez :
   • Serveur : l'adresse de la room, par exemple archipelago.gg:38281 ;
   • Slot : le name de votre YAML, exactement ;
   • Mot de passe : celui de la room, sinon laissez vide ;
   • DeathLink : cochez si vous voulez en profiter (voir plus bas).
3. Cliquez sur Se connecter. En haut à droite : « AP : connecté (MonPseudo) ».

Ces réglages sont enregistrés dans BepInEx/config/fr.archipelago.te2.cfg. Mettez ConnexionAuto = true dans ce fichier pour vous connecter automatiquement à chaque lancement.

7. Jouer

Les prisons

Vous commencez avec une prison débloquée au hasard parmi celles de votre YAML. Les autres restent verrouillées dans le menu Campagne (message « Archipelago : … Prison Unlock requis ») jusqu'à ce que vous receviez leur objet Prison Unlock. Les prisons absentes de la partie affichent « prison absente de ce seed ».

Les checks ne partent qu'en solo ou en coop (pas en Versus), et seulement depuis une prison débloquée. Les prisons hors Archipelago (DLC, tutoriel, prisons personnalisées) restent jouables mais n'envoient rien.

Ce qui envoie un check

Les bureaux sont numérotés selon leur position sur la carte (par étage, puis de haut en bas, puis de gauche à droite). Pour savoir où se trouve le bureau N, appuyez sur F8 dans la prison : le fichier BepInEx/config/TE2Archipelago/dump_desks_<prison>.txt liste chaque bureau avec sa position et son propriétaire.

Ce que vous recevez

Un objet reçu hors d'une prison, ou quand l'inventaire et le bureau sont pleins, attend : il arrive dès que vous êtes en prison avec une place libre. Chaque objet n'est livré qu'une fois, même si vous changez de prison.

Les stats

Chaque stat démarre à 30. L'entraînement fait monter une progression partagée entre toutes les prisons : c'est elle qui déclenche les checks de stats. Votre stat réelle vaut min(progression, 30 + objets Progressive reçus × step).

Exemple avec intellect_step: 10 et un seul Progressive Intellect : si vous lisez jusqu'à 70 de progression, vous validez les checks 40, 50, 60 et 70, mais votre Intellect réel reste plafonné à 40. Au prochain Progressive Intellect, il passe directement à 50.

Suivre la partie

• Les messages Archipelago s'affichent dans le fil de discussion du jeu, préfixés par [AP] : objets trouvés et reçus (avec l'expéditeur et la prison), pièges, évasions validées.
• La fenêtre F10 indique la progression vers l'objectif, les prisons débloquées, vos stats (progression / plafond) et les objets en attente. Son champ de texte envoie des commandes au serveur, par exemple !hint Blueprint: Fake Audio Equipment.

DeathLink

Option DeathLink cochée : quand vous êtes assommé, tous les joueurs DeathLink de la partie « meurent » ; quand l'un d'eux meurt, vous êtes assommé (seulement si vous êtes en prison).

Dépannage

Le fichier BepInEx/config/TE2Archipelago/slot_<seed>_<slot>.txt garde votre progression d'entraînement et les objets déjà livrés. Ne le supprimez pas en cours de partie : les objets ordinaires seraient livrés une seconde fois.

9. Désinstaller

Dans le dossier du jeu, supprimez winhttp.dll, doorstop_config.ini, .doorstop_version, changelog.txt et le dossier BepInEx. Le jeu redevient vanilla ; vos sauvegardes du jeu ne sont pas touchées.