User Tools

Site Tools


multiworld

This is about beta content!

This article or section is about one or more features from an upcoming release of Jets of Time. The information presented is still subject to change. The content on this page should be re-verified once it has been released.

Multiworld

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.

What is Multiworld?

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

  1. A lua enabled emulator or hardware

Installation Instructions

  1. Install the latest Archipelago release using their installer from the link above
  2. 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

Multiworld seeds can only be generated from the multiworld web generator. Note that all seeds generated from that URL are multiworld compatible - No special flags needed. You must provide a player name on the main options page.

  1. Generate a seed on the multiworld web generator
  2. Download the ROM from the seed page
  3. Download the yaml file from the seed page
  4. Provide the yaml file to whoever is generating the multiworld game
  5. Use the associated ROM when paying the multiworld game

Note: The yaml and ROM are a pair. Each time you want to play a new multiworld you will need to generate a new seed on the web generator and use the provided yaml. This differs from most other Archipelago games where you can reuse the same yaml between games.

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.

Joining a Multiworld Game

These steps will guide you through the process of joining a multiworld game.

  1. Generate a seed from the multiworld generator website and download you ROM and yaml
  2. 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.

  1. Run ArchipelagoSNIClient.exe (located in your Archipelago install folder). This should automatically launch SNI.
  2. Enter the address:port into the “Server” field at the top of the client and click “Connect”
  3. You should see a message that it is connected to the server but no ROM is detected.
  4. Open your ROM in an emulator with lua support
  5. Runthe SNI Connector.lua script through your emulator (<Archipelago install folder>\SNI\lua\x86\Connector.lua)
  6. 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.

  1. Gather all player yaml files into a folder
  2. Open a PowerShell window in your Archipelago install folder
  3. 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 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.

  1. Run the generate steps above and make note of the output folder
  2. Open a PowerShell window in your Archipelago install folder
  3. 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.

Known Issues/Limitations

  1. Items will not be delivered on the overworld.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
multiworld.txt · Last modified: 2023/06/04 12:44 by anguirel