Burger Shop 2 Multiworld Setup Guide

Required Software

Burger Shop 2 (Steam)
Archipelago 0.6.7 or later

Currently, only Windows is supported.

Optional Software

Universal Tracker — adds a Tracker tab to the client showing which levels are currently in logic based on your received items. Install by placing tracker.apworld in the custom_worlds/ folder alongside burger_shop_2.apworld.

Installation

1. Install the Archipelago world

Place burger_shop_2.apworld in the custom_worlds/ folder inside your Archipelago installation directory and restart the Archipelago launcher if it is already open.

2. Install the game data package

Extract the provided zip file and copy the archipelago folder and the properties folder directly into your Burger Shop 2 installation directory (the folder containing BurgerShop2.exe). To find this folder, right-click Burger Shop 2 in your Steam library, select Properties, go to the Installed Files tab, then click Browse. The result should look like:

Burger Shop 2/
├── archipelago/
│   └── levels/
│       ├── Game.xml.orig
│       ├── Breakfast_*.xml.orig
│       ├── Order_*.xml.orig
│       ├── Dinner_*.xml.orig
│       └── ... (remaining order files)
├── properties/
│   └── params_user.xml
└── BurgerShop2.exe

Joining a Multiworld Game

If you have not already launched Burger Shop 2 on your computer, launch it then close it. This will create the directory that contains your save file information.
Open the Archipelago Launcher and click Burger Shop 2 Client, or run BurgerShop2Client.exe directly.
Connect to your server by typing in the client console:
```
/connect <host>:<port>
```
Enter your slot name and password when prompted.
Launch the game using /launch in the client console, or start it manually.
Choose the Archipelago profile. The client creates and manages it for you once you connect.

Options

Option	Default	Description
Five Star Mode	On	Level checks require all 5 stars; off means any completion counts
Starter Recipes	Off	Adds one random item from each of eight starter pools to your starting inventory
Bonus Recipes	On	Replaces filler items with bonus recipes not in the base game
Start with Lollipops	On	Lollipops added to starting inventory (recommended with Five Star Mode)
Start with BurgerBot	Off	BurgerBot added to starting inventory
Customer Slots	Vanilla	Forces levels to use a specified number of customer slots
Character Randomization	Vanilla	Randomizes the characters in each level

Troubleshooting

The client cannot find my Burger Shop 2 installation. Add the following to host.yaml in your Archipelago directory:

burger_shop_2_settings:
  game_install_path: "C:/Program Files (x86)/Steam/steamapps/common/Burger Shop 2"

The client says the Archipelago profile belongs to a previous session. The game is still open on the profile from an earlier seed, so the client cannot reset it. Close the game (or use /restart) and it will be laid down fresh for the current one.

Recipe changes are not showing up mid-level. The game reads updated order files when a level starts. Finish the current level or return to the map screen to see newly unlocked recipes take effect.