From 6a0c91322c8c69a3d22aa2d269235748842b9936 Mon Sep 17 00:00:00 2001 From: Chris Wilson Date: Wed, 23 Sep 2020 18:47:04 -0400 Subject: [PATCH] Tutorial updates for Website. Added French tutorial by Coxla. --- WebHostLib/static/assets/tutorial.js | 1 + .../static/assets/tutorial/tutorial_en.md | 47 +---- .../static/assets/tutorial/tutorial_fr.md | 183 ++++++++++++++++++ 3 files changed, 194 insertions(+), 37 deletions(-) create mode 100644 WebHostLib/static/assets/tutorial/tutorial_fr.md diff --git a/WebHostLib/static/assets/tutorial.js b/WebHostLib/static/assets/tutorial.js index 60f0641f..b38e9527 100644 --- a/WebHostLib/static/assets/tutorial.js +++ b/WebHostLib/static/assets/tutorial.js @@ -1,6 +1,7 @@ const availableLanguages = { en: 'English', es: 'Español', + fr: 'Français', }; window.addEventListener('load', () => { diff --git a/WebHostLib/static/assets/tutorial/tutorial_en.md b/WebHostLib/static/assets/tutorial/tutorial_en.md index ccc19295..51fc766b 100644 --- a/WebHostLib/static/assets/tutorial/tutorial_en.md +++ b/WebHostLib/static/assets/tutorial/tutorial_en.md @@ -50,48 +50,21 @@ each player to enjoy an experience customized for their taste, and different pla can all have different options. ### Where do I get a YAML file? -A basic YAML file is available in the directory where you installed the MultiWorld Utilities. It is within -the players folder and is called `easy.yaml` +The [PlayerSettings](/player-settings) page on the website allows you to configure your personal settings +and download a `yaml` file. You may configure up to three presets on this page. ### Your YAML file is weighted -Throughout your YAML file, you will see many options which look similar to this: -```yaml -map_shuffle: - on: 5 - off: 15 -``` -In the above example, imagine the generator creates a bucket labelled "map_shuffle", and places a folded -piece of paper into the bucket for each sub-option. Here, there are twenty pieces of paper in the bucket: -five for "on" and fifteen for "off". When the generator is deciding whether or not to turn on map shuffle -for your game, it reaches into this bucket and pulls out a piece of paper at random. In this example, -you are much more likely to have map shuffle turned off. If you never want an option to be chosen, simply -set its value to zero. +The Player Settings page has many options which are primarily represented with sliders. This allows you to +choose how likely certain options are to occur relative to other options within a category. -### Configuring your YAML file -Before you begin configuring your YAML file, there are two things you must do. -1. Set your `name`. This is what will appear as you send and receive items (if you play MultiWorld games). -2. Rename the file to something meaningful. +For example, imagine the generator creates a bucket labelled "Map Shuffle", and places folded pieces of paper +into the bucket for each sub-option. Also imagine your chosen value for "On" is 20 and your value for "Off" is 40. -Once those are complete, feel free to adjust the options within the file to fit your desired randomizer -experience. The options are commented to explain their effects on the game. +In this example, sixth pieces of paper are put into the bucket. Twenty for "On" and forty for "Off". When the +generator is deciding whether or not to turn on map shuffle for your game, it reaches into this bucket and pulls +out a piece of paper at random. In this example, you are much more likely to have map shuffle turned off. -### ROM Options -At the bottom of your YAML file, you will find a set of ROM options. These control various aesthetic changes -which do not affect gameplay. These options are also weighted, in case you want to be surprised by the color -of your hearts or by the silliness of your overworld palette. - -If you would like to add a sprite to the list, simply include its name and give it a weight like so: -```yaml -rom: - sprite: # Enter the name of your preferred sprite and weight it appropriately - random: 0 - randomonhit: 0 - link: 1 - vegeta: 3 - rottytops: 5 - rocko: 5 - luigi: 3 -``` +If you never want an option to be chosen, simply set its value to zero. ### Verifying your YAML file If you would like to validate your YAML file to make sure it works, you may do so on the diff --git a/WebHostLib/static/assets/tutorial/tutorial_fr.md b/WebHostLib/static/assets/tutorial/tutorial_fr.md new file mode 100644 index 00000000..3f1a8ef1 --- /dev/null +++ b/WebHostLib/static/assets/tutorial/tutorial_fr.md @@ -0,0 +1,183 @@ +# Guide d'installation du MultiWorld de A Link to the Past Randomizer + +
+ +
+ +## Logiciels requis +- [Utilitaires du MultiWorld](https://github.com/Berserker66/MultiWorld-Utilities/releases) +- [QUsb2Snes](https://github.com/Skarsnik/QUsb2snes/releases) (Inclus dans les utilitaires précédents) +- Une solution logicielle ou matérielle capable de charger et de jouer des fichiers ROM de SNES + - Un émulateur capable d'éxécuter des scripts Lua + ([snes9x Multitroid](https://drive.google.com/drive/folders/1_ej-pwWtCAHYXIrvs5Hro16A1s9Hi3Jz), + [BizHawk](http://tasvideos.org/BizHawk.html)) + - Un SD2SNES, [FXPak Pro](https://krikzz.com/store/home/54-fxpak-pro.html), ou une autre solution matérielle compatible +- Le fichier ROM de la v1.0 japonaise, sûrement nommé `Zelda no Densetsu - Kamigami no Triforce (Japan).sfc` + +## Procédure d'installation + +### Installation sur Windows +1. Téléchargez et installez les utilitaires du MultiWorld à l'aide du lien au-dessus, faites attention à bien installer la version la plus récente. +**Le fichier se situe dans la section "assets" en bas des informations de version**. Si vous voulez jouer des parties classiques de multiworld, +vous voudrez télécharger `Setup.BerserkerMultiWorld.exe` + - Si vous voulez jouer à la version alternative avec le mélangeur de portes dans les donjons, vous voudrez télécharger le fichier `Setup.BerserkerMultiWorld.Doors.exe`. + - Durant le processus d'installation, il vous sera demandé de localiser votre ROM v1.0 japonaise. Si vous avez déjà installé le logiciel + auparavant et qu'il s'agit simplement d'une mise à jour, la localisation de la ROM originale ne sera pas requise. + - Il vous sera peut-être également demandé d'installer Microsoft Visual C++. Si vous le possédez déjà (possiblement parce qu'un + jeu Steam l'a déjà installé), l'installateur ne reproposera pas de l'installer. + +2. Si vous utilisez un émulateur, vous devriez assigner votre émulateur capable d'éxécuter des scripts Lua comme programme +par défaut pour ouvrir vos ROMs. + 1. Extrayez votre dossier d'émulateur sur votre Bureau, ou quelque part dont vous vous souviendrez. + 2. Faites un clic droit sur un fichier ROM et sélectionnez **Ouvrir avec...** + 3. Cochez la case à côté de **Toujours utiliser cette application pour ouvrir les fichiers .sfc** + 4. Descendez jusqu'en bas de la liste et sélectionnez **Rechercher une autre application sur ce PC** + 5. Naviguez dans les dossiers jusqu'au fichier `.exe` de votre émulateur et choisissez **Ouvrir**. Ce fichier devrait + se trouver dans le dossier que vous avez extrait à la première étape. + +### Installation sur Mac +- Des volontaires sont recherchés pour remplir cette section ! Contactez **Farrak Kilhn** sur Discord si vous voulez aider. + +## Configurer son fichier YAML + +### Qu'est-ce qu'un fichier YAML et pourquoi en ai-je besoin ? +Votre fichier YAML contient un ensemble d'options de configuration qui fournissent au générateur des informations +sur comment il devrait générer votre seed. Chaque joueur d'un multiwolrd devra fournir son propre fichier YAML. Cela permet à chaque +joueur d'apprécier une expérience customisée selon ses goûts, et les différents joueurs d'un même multiworld peuvent avoir différentes options. + +### Où est-ce que j'obtiens un fichier YAML ? +Un fichier YAML de base est disponible dans le dossier où les utilitaires du MultiWorld sont installés. Il est situé dans le dossier +`players` et se nomme `easy.yaml` + +### Votre fichier YAML est pondéré +Tout au long du fichier YAML, vous verrez plusieurs options semblables à celle-ci : +```yaml +map_shuffle: + on: 5 + off: 15 +``` +Dans l'exemple précédent, imaginez que le générateur crée un seau étiqueté "map_shuffle", et qu'il place un morceau de papier pour chaque sous-option. +Ici, il y a vingt papiers dans le seau : cinq pour l'option "on" et quinze "off". Quand le générateur décide s'il doit activer ou non le mélangeur de cartes pour +votre partie, il tire aléatoirement un papier dans le seau. Dans cet exemple, il y a de plus grandes chances d'avoir le mélange de cartes désactivé. +S'il y a une option dont vous ne voulez jamais, mettez simplement sa valeur à zéro. + +### Configurer son fichier YAML +Avant d'entamer la configuration de votre fichier YAML, il y a deux choses à faire. +1. Paramétrer son nom (option `name`). C'est ce qu'il s'affichera lorsque vous enverrez et recevrez des objets. +2. Renommez le fichier en quelque chose de plus parlant. + +Une fois cela fait, vous pouvez modifier librement les poids des options pour qu'ils correspondent le mieux à l'expérience +de randomiseur que vous recherchez. Il y a des commentaires décrivant les effets de chaque option en jeu. + +### Options de la ROM +En bas de votre fichier YAML, vous trouverez quelques options concernant la ROM. Elles contrôlent divers changements esthétiques +qui n'affectent pas le gameplay. Ces options sont également pondérées, au cas où vous voudriez être surpris par la couleur de vos coeurs +ou par la curiosité de votre palette dans l'overworld. + +Si vous voulez ajouter un sprite à la liste, il suffit d'inclure son nom et de lui associer un poids comme dans l'exemple suivant : +```yaml +rom: + sprite: # Enter the name of your preferred sprite and weight it appropriately + random: 0 + randomonhit: 0 + link: 1 + vegeta: 3 + rottytops: 5 + rocko: 5 + luigi: 3 +``` + +### Vérifier son fichier YAML +Si vous voulez valider votre fichier YAML pour être sûr qu'il fonctionne, vous pouvez le vérifier sur la page du +[Validateur de YAML](/mysterycheck). + +## Générer une partie pour un joueur +1. Aller sur la [page du générateur](/generate) et téléversez votre fichier YAML. +2. Il vous sera alors présenté une page d'informations sur la seed, où vous pourrez télécharger votre patch. +3. Double-cliquez sur le patch et l'émulateur devrait se lancer automatiquement avec la seed. Etant donné que le client +n'est pas requis pour les parties à un joueur, vous pouvez le fermer ainsi que l'interface Web (WebUI). + +## Rejoindre un MultiWorld + +### Obtenir son patch et créer sa ROM +Quand vous rejoignez un multiworld, il vous sera demandé de fournir votre fichier YAML à celui qui héberge la partie +ou s'occupe de la génération. Une fois cela fait, l'hôte vous fournira soit un lien pour télécharger votre patch, soit un fichier `.zip` contenant +les patchs de tous les joueurs. Votre patch devrait avoir l'extension `.bmbp`. + +Placez votre patch sur votre bureau ou dans un dossier simple d'accès, et double-cliquez dessus. Cela devrait lancer automatiquement +le client, et devrait créer la ROM dans le même dossier que votre patch. + +### Se connecter au client + +#### Avec un émulateur +Quand le client se lance automatiquement, QUsb2Snes devrait se lancer automatiquement également en arrière-plan. +Si c'est la première fois qu'il démarre, il vous sera peut-être demandé de l'autoriser à communiquer +à travers le pare-feu Windows. + +##### snes9x Multitroid +1. Chargez votre ROM si ce n'est pas déjà fait. +2. Cliquez sur le menu "File" et survolez l'option **Lua Scripting** +3. Cliquez alors sur **New Lua Script Window...** +4. Dans la nouvelle fenêtre, sélectionnez **Browse...** +5. Dirigez vous vers le dossier où vous avez extrait snes9x Multitroid, allez dans le dossier `lua`, puis choisissez `multibridge.lua` +6. Remarquez qu'un nom vous a été assigné, et que l'interface Web affiche "SNES Device: Connected", avec ce même nom dans le coin en haut à gauche. + +##### BizHawk +1. Assurez vous d'avoir le coeur BSNES chargé. Cela est possible en cliquant sur le menu "Tools" de BizHawk et suivant ces options de menu : + `Config --> Cores --> SNES --> BSNES` + Une fois le coeur changé, vous devez redémarrer BizHawk. +2. Chargez votre ROM si ce n'est pas déjà fait. +3. Cliquez sur le menu "Tools" et cliquez sur **Lua Console** +4. Cliquez sur le bouton pour ouvrir un nouveau script Lua. +5. Dirigez vous vers le dossier d'installation des utilitaires du MultiWorld, puis dans les dossiers suivants : + `QUsb2Snes/Qusb2Snes/LuaBridge` +6. Sélectionnez `luabridge.lua` et cliquez sur "Open". +7. Remarquez qu'un nom vous a été assigné, et que l'interface Web affiche "SNES Device: Connected", avec ce même nom dans le coin en haut à gauche. + +#### Avec une solution matérielle +Ce guide suppose que vous avez télchargé le bon micro-logiciel pour votre appareil. Si ce n'est pas déjà le cas, faites le maintenant. +Les utilisateurs de SD2SNES et de FXPak Pro peuvent télécharger le micro-logiciel approprié +[ici](https://github.com/RedGuyyyy/sd2snes/releases). Pour les autres solutions, de l'aide peut être trouvée +[sur cette page](http://usb2snes.com/#supported-platforms). + +**Pour vous connecter avec une solution matérielle vous devez utiliser une ancienne version de QUsb2Snes +([v0.7.16](https://github.com/Skarsnik/QUsb2snes/releases/tag/v0.7.16)).** +Les versions postérieures brisent la compatibilité avec le multiworld. + +1. Fermez votre émulateur, qui s'est potentiellement lancé automatiquement. +2. Fermez QUsb2Snes, qui s'est lancé automatiquement avec le client. +3. Lancez la version appropriée de QUsb2Snes (v0.7.16). +4. Lancer votre console et chargez la ROM. +5. Remarquez que l'interface Web affiche "SNES Device: Connected", avec le nom de votre appareil. + +### Se connecter au MultiServer +Le patch qui a lancé le client devrait vous avoir connecté automatiquement au MultiServer. +Il y a cependant quelques cas où cela peut ne pas se produire, notamment si le multiworld est hébergé sur ce site, mais a été généré ailleurs. +Si l'interface Web affiche "Server Status: Not Connected", demandez simplement à l'hôte l'adresse du serveur, +et copiez/collez la dans le champ "Server" puis appuyez sur Entrée. + +Le client essaiera de vous reconnecter à la nouvelle adresse du serveur, et devrait mentionner "Server +Status: Connected". Si le client ne se connecte pas après quelques instants, il faudra peut-être rafraîchir la page de l'interface Web. + +### Jouer au jeu +Une fois que l'interface Web affiche que la SNES et le serveur sont connectés, vous êtes prêt à jouer. Félicitations +pour avoir rejoint un multiworld ! + +## Héberger un MultiWorld +La méthode recommandée pour héberger une partie est d'utiliser le service d'hébergement fourni par +[le site](https://berserkermulti.world/generate). Le processus est relativement simple : + +1. Récupérez les fichiers YAML des joueurs. +2. Créez une archive zip contenant ces fichiers YAML. +3. Téléversez l'archive zip sur le lien au-dessus. +4. Attendez un moment que les seed soient générées. +5. Lorsque les seeds sont générées, vous serez redirigé vers une page d'informations. +6. Cliquez sur "Create New Room". Cela vous amènera à la page du serveur. Fournissez le lien de cette page aux autres joueurs + afin qu'ils puissent récupérer leurs patchs. + **Note:** Les patchs fournis sur cette page permettront aux joueurs de se connecteur automatiquement au serveur, + tandis que ceux de la page "Seed Info" non. +7. Remarquez qu'un lien vers le traqueur du MultiWorld est en haut de la page de la salle. Vous devriez également fournir ce lien aux joueurs + pour qu'ils puissent la progression de la partie. N'importe quel personne voulant observer devrait avoir accès à ce lien. +8. Une fois que tous les joueurs ont rejoint, vous pouvez commencer à jouer. \ No newline at end of file