Randopolis
Menu

Premiers pas avec Archipelago

Ce guide explique comment installer Archipelago, préparer une partie multimonde, l’héberger et s’y connecter. Les étapes propres à chaque jeu figurent dans les guides d’installation.

Installer Archipelago

Téléchargez la dernière version publique d’Archipelago. Sous Windows, ouvrez l’installateur et sélectionnez les composants nécessaires au jeu choisi.

  • ArchipelagoLauncher permet d’ouvrir les outils et les clients installés.
  • Le générateur prépare la répartition des objets et les fichiers nécessaires aux joueurs.
  • Le serveur permet d’héberger la partie sur votre ordinateur. Si d’autres joueurs doivent s’y connecter depuis Internet, rendez le port du serveur accessible. Le port Archipelago par défaut est 38281.
  • Chaque joueur utilise le client prévu pour son jeu. Suivez le guide du jeu pour savoir lequel installer et comment le lancer.

Préparer les fichiers YAML

Un fichier YAML définit le jeu, le nom du joueur et ses réglages. Dans le catalogue, ouvrez les options du jeu choisi, configurez la partie et exportez le fichier YAML. Pour obtenir des modèles depuis le lanceur Archipelago, utilisez Generate Template Options. Ils seront enregistrés dans Players/Templates.

Il faut un fichier YAML par monde. Plusieurs personnes qui partagent le même monde en coopération utilisent le même fichier. Si chacune joue dans son propre monde, chacune fournit un fichier. Les noms des joueurs doivent être uniques au sein de la partie. Vous pouvez vérifier les fichiers YAML avant de lancer la génération.

Générer une partie

Sur Randopolis

Pour une partie solo, ouvrez les options du jeu dans le catalogue, choisissez vos réglages et cliquez sur le bouton de génération en bas de la page. Vous pouvez aussi envoyer un YAML existant pour choisir les réglages d’hébergement.

Pour un multimonde, rassemblez les YAML des joueurs. Ouvrez la page de génération, choisissez les réglages du serveur et envoyez les fichiers, séparément ou dans une archive ZIP. Le formulaire indique la procédure pour le mode course. Les parties qui dépassent la limite de joueurs du serveur doivent être générées en local.

Une fois la génération terminée, la page de la graine affiche la date de création, le nombre de joueurs, le spoiler s’il existe et les salles créées à partir de cette graine.

Sur votre ordinateur

Placez les fichiers YAML directement dans le dossier Players de votre installation Archipelago, sans les compresser. Sous Windows, l’installation se trouve souvent dans C:\ProgramData\Archipelago. Lancez ArchipelagoGenerate.exe ou choisissez Generate dans le lanceur.

Le générateur place une archive telle que AP_XXXXX.zip dans le dossier output. Elle contient les données du multimonde, les fichiers des joueurs et le spoiler si vous avez choisi d’en générer un. Certains jeux ont besoin de la ROM originale pour créer les fichiers de patch. Le générateur vous demande où se trouve cette ROM la première fois.

Pour modifier des réglages comme le mode course, le mot de passe, l’envoi des objets restants ou le plando, utilisez Open host.yaml dans le lanceur. Ajustez les réglages avant de générer, car ils sont enregistrés dans le fichier .archipelago. Si vous voulez conserver vos modifications lors d’une réinstallation, vous pouvez les garder dans options.yaml.

Jouer avec des mondes personnalisés

Le lanceur Archipelago peut installer un monde personnalisé à partir d’un fichier .apworld. Cliquez sur Install APWorld puis sélectionnez le fichier. Vous pouvez aussi le déposer sur le lanceur ou, sous Windows, double-cliquer dessus. Utilisez des mondes provenant de sources de confiance, car un APWorld peut exécuter du code sur votre ordinateur.

Générez ces parties en local, puis importez l’archive pour les héberger sur Randopolis. Si vous remplacez un monde déjà inclus dans Archipelago, déplacez l’original de lib/worlds vers un dossier de sauvegarde avant de lancer le jeu avec la version située dans custom_worlds. Pour revenir à l’original, restaurez-le dans lib/worlds et retirez la version personnalisée. Cette procédure ne s’applique pas à la version Linux AppImage.

Héberger une partie

Sur Randopolis

Sur la page de la graine, créez une salle puis partagez son URL avec vos amis. La salle affiche l’adresse du serveur, le port, les noms de connexion des joueurs et leurs fichiers de jeu. Si le suivi est activé, vous y trouverez aussi les liens correspondants.

Pour héberger une partie générée sur votre ordinateur, importez l’archive de sortie ou le fichier .archipelago, puis créez une salle sur la page de la graine.

Une salle inactive est mise en pause après le délai indiqué sur sa page. La progression est sauvegardée. Pour reprendre, ouvrez de nouveau la page de la salle. Le créateur peut retrouver ses salles dans Mon contenu et accéder à leur console. Le code de session permet de restaurer l’accès si les cookies ont été effacés. Gardez ce code secret.

Sur votre ordinateur

Ouvrez ArchipelagoServer.exe et sélectionnez le fichier .archipelago ou l’archive de sortie. Sous Windows, vous pouvez aussi ouvrir le fichier .archipelago directement si le type de fichier est associé au serveur.

Se connecter à la partie

Suivez les instructions du guide de votre jeu. Certains fichiers de jeu contiennent déjà les paramètres de connexion. Si le client vous les demande, prenez-les sur la page de la salle.

  • Serveur ou Host Name correspond au domaine ou à l’adresse IP de l’hôte. Pour un serveur sur votre propre ordinateur, vous pouvez utiliser localhost.
  • Port correspond au numéro après le caractère :. Si le client n’a qu’un champ d’adresse, saisissez adresse:port. Le port d’une salle en ligne est indiqué sur sa page.
  • Nom de joueur ou Slot Name correspond au nom du fichier YAML au moment de la génération. Respectez les majuscules et les minuscules.
  • Mot de passe correspond au mot de passe défini par l’hôte. Laissez ce champ vide si la salle n’en utilise pas.

Si votre client accepte des commandes, la syntaxe de connexion est /connect adresse:port. Consultez le guide des commandes pour les autres commandes.