about summary refs log tree commit diff stats
path: root/README.md
blob: 1fbbc2f8b4b07e4d7e9eb3335a95d1f46546bf4c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# Lingo Archipelago Tracker
[Archipelago](https://archipelago.gg) is an open-source project that supports randomizing a number of different games and combining them into one cooperative experience. Items from each game are hidden in other games. For more information about Archipelago, you can look at their website. For more information about playing the game Lingo with Archipelago, see [lingo-archipelago](https://code.fourisland.com/lingo-archipelago/about/).

This app is a tool that helps you keep track of your game state when playing Lingo as a part of an Archipelago multiworld. It shows a map of the world that, when connected to an Archipelago server, automatically updates to show you what areas you have access to and what locations can be checked / have already been checked. It supports all modes of play: door shuffle, color shuffle, and painting shuffle.

## Download

Releases of the tracker can be found [on the releases page](https://code.fourisland.com/lingo-ap-tracker/about/CHANGELOG.md).

## Acknowledgments

* Brenton Wildes: Created Lingo, and drew some of the images used in the tracker.
* Kinrah: Made the subway map image.
* art0007i: Contributed to the display of the subway map.

## Building

To build the app:

1. Clone the repository including submodules: `git clone --recursive https://code.fourisland.com/lingo-ap-tracker`
2. Put [LL1.yaml from archipelago](https://github.com/ArchipelagoMW/Archipelago/raw/main/worlds/lingo/data/LL1.yaml) in ./assets
3. Put [ids.yaml from archipelago](https://github.com/ArchipelagoMW/Archipelago/raw/main/worlds/lingo/data/ids.yaml) in ./assets
4. Configure the project: `cmake --preset=lingo-ap-tracker-preset`
5. Build the application in debug mode: `cmake --build --preset=lingo-ap-tracker-preset`
6. (Optional) Build the application in release mode: `cmake --build --preset=x64-release-preset`

LL1.yaml and ids.yaml sometimes receive breaking changes that need to be kept in sync with the tracker. If the application crashes with an unknown error, try making sure that you are using the right versions of those files. In general, the main branch of the tracker will require config files from the latest Archipelago release. Branches may require config files from Archipelago main, or from pending pull requests.