User Tools

Site Tools


multiworld

This is an old revision of the document!


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 extremely early beta testing.

Key items are shuffled across the various worlds, all other locations will contain items for your own world.

What you will need

  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.

Note: I have not personally tested this.

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 deliverd, 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.
multiworld.1682259865.txt.gz · Last modified: 2023/04/23 14:24 by anguirel