Differences

This shows you the differences between two versions of the page.

--- multiworld [2023/04/23 13:52] – anguirel
+++ multiworld [2023/06/04 12:44] (current) – anguirel
@@ Line 3: / Line 3: @@
 ====== Multiworld ======
-Jets of Time supports multiworld through Archipelago.  This feature is currently in extremely early beta testing.
+Jets of Time supports multiworld through Archipelago.  This feature is currently in beta testing.  As such, it is not part of the default Archipelago install.  Follow the instructions below to add Jets of Time to an existing Archipelago installation and get started playing.
-Key items are shuffled across the various worlds, all other locations will contain items for your own world.
+===== What is Multiworld? =====
-===== What you will need =====
+Multiworld is a multiplayer experience where each runner plays their own seed, but can find items for another player in their world. These other worlds could be Jets of Time, or even a number of other games supported by the platform.  It is a cooperative experience where players work together to find each other's progression so that everyone can beat their games.
+===== What Gets Shuffled and where? =====
+All key item locations and all chronosanity chests become a new placeholder item named "APItem". When you receive an APItem, the multiworld client/server will detect that you checked a location and send the appropriate item to the receiving player.
+In standard game mode, only the normal key item locations will contain progression items.  All other chests can contain useful or "junk fill" items, like gear, consumables, ammo, non-essential powerups, etc.  This is to ensure that players running standard mode who may not be familiar with all of the chronosanity chest locations cannot block another player in the multiworld by accidentally missing a chest that contains a progression item.
+===== What You Will Need to Play =====
   - [[https://github.com/ArchipelagoMW/Archipelago/releases|Archipelago software]]
@@ Line 17: / Line 25: @@
   - Install the latest Archipelago release using their installer from the link above
-  - Copy the ctjot.apworld file into the Archipelago worlds directory (Default on Windows is C:\ProgramData\Archipelago\lib\worlds\)
+  - Copy the ctjot.apworld file into the Archipelago worlds folder (Default on Windows is C:\ProgramData\Archipelago\lib\worlds\)
+Note:  The default path is ProgramData, not Program Files.  If the apworld file is installed in the wrong folder then the client will not recognize Jets of Time ROMs.
 ===== Generating a Jets of Time Seed =====
@@ Line 34: / Line 45: @@
 Your CTJoT yaml will not work on the main Archipelago site.  Games must be generated using the offline generator.  If the game is being hosted by another player then they will also need the ctjot.apworld file to generate and host.
-=====  Generating a multiworld game =====
+=====  Joining a Multiworld Game =====
+These steps will guide you through the process of joining a multiworld game.
+  - Generate a seed from the multiworld generator website and download you ROM and yaml
+  - Send your yaml file to the person generating/hosting the multiworld game
+After the game is ready, the host will give you an address/port to use when connecting.
+  - Run ArchipelagoSNIClient.exe (located in your Archipelago install folder).  This should automatically launch SNI.
+  - Enter the address:port into the "Server" field at the top of the client and click "Connect"
+  - You should see a message that it is connected to the server but no ROM is detected.
+  - Open your ROM in an emulator with lua support
+  - Runthe SNI Connector.lua script through your emulator (<Archipelago install folder>\SNI\lua\x86\Connector.lua)
+  - The client should now recognize the ROM and connect you to your server slot
+If there are no errors in the client, you are now good to start playing your multiworld CTJoT game.
+If SNI did not launch automatically then you can run it manually from <Archipelago install folder>\SNI\sni.exe.
+=====  Generating a Multiworld Game =====
+You must have already installed the ctjot.apworld file to generate a multiworld game.
+  - Gather all player yaml files into a folder
+  - Open a PowerShell window in your Archipelago install folder
+  - Run the following command:
+  ArchipelagoGenerate.exe --player_files_path path_to_your_yaml_folder --outputpath folder_where_you_want_the_output
+This will create a multiworld game with all of the players' worlds.  The file in your specified output folder can be used to host this multiworld.
+=====  Hosting a Multiworld Game on Archipelago =====
+Once you have generated a game, you can use the main Archipelago site to host it for you.
+Browse to [[https://archipelago.gg/uploads|The Archipelago uploads page]] and upload the file created by the generator in the previous section.
+This will bring you to another page where you can create a room.  Once created, send that room link to the other runners and they can join as normal.
+=====  Hosting a Multiworld Game Yourself =====
+Games can be hosted locally using the ArchipelagoServer.exe program.
+  - Run the generate steps above and make note of the output folder
+  - Open a PowerShell window in your Archipelago install folder
+  - Run the following command:
+  ArchipelagoServer.exe path_to_generator_output_file
+NOTE: You will need to make sure that port forwarding is set up correctly on your router if you want other people to join a multiworld game that you are hosting.
-You must have already installed the ctjot.apworld file to generate a game.
 ===== Known Issues/Limitations =====
   - Items will not be delivered on the overworld.
-  - Items can be delivered in many, but not all locations. If you see on the client that you received an item but it isn't being deliverd, it probably means the map you are on does not support item delivery.  Keep playing and you'll get it eventually.
+  - Items can be delivered in many, but not all locations. If you see on the client that you received an item but it isn't being delivered, it probably means the map you are on does not support item delivery.  Keep playing and you'll get it eventually.
   - If you receive an item while in the middle of a cutscene, do not move.  Receiving an item can return control to the player at unintended times, and moving where the game doesn't expect you to be can cause problems with cutscenes.
+  - When finding an APItem for yourself, sometimes the client can send the item before the treasure text shows up from the chest.  This will cause the treasure chest text to say that you received the item itself rather than the APItem, followed by the client delivering the item.  This looks a little funny, but the item is only actually received once.
+  - If you receive an item while standing on a save point, pressing A will cause the save menu to open instead of closing the text box, causing the player to get stuck on the save point.  If this happens, hold a direction away from the save point and tap A for one frame.

Chrono Trigger: Jets of Time

User Tools

Site Tools

Differences

Page Tools