Skip to content
All integrations
Official Steam capsule artwork

COMMUNITY INTEGRATION

YARGArchipelago randomizer mod

Unlock a rhythm-game setlist through the multiworld. Each ordinary song awards three checks, while song unlocks, Gems and optional instrument items lead to a final goal song.

Maintained by energymaster22 and contributors

GAME MECHANICS

Explore game mechanics

Browse possible checks, rewards and settings. What appears in your game depends on your World options.

Source catalog Release YARG APWorld 1.3.0 with YARGAPClient 1.0.1World 1.3.0

The release registers 1,443 check IDs across 481 songs in 41 setlists. Each ordinary selected song has three location IDs, and the client sends all three when that song ends; the World defines no distinct gameplay criteria for the three slots. The randomly selected goal song has no ordinary song checks. Counts are source-derived and not a generated seed.

Browse the gameplay families that can send checks to your multiworld.

1,443 APWorld location IDs: three song-end checks per song entry; a seed selects ordinary songs and reserves one selected song for its goal.Default tags mark the 113 songs in YARG Official Setlist as eligible before random selection. A default seed samples 10 songs, reserves one for the goal and creates 27 checks for the other nine; only 27 are generated in one default seed, though 339 catalogued checks are eligible across different seeds.

106 — Frostbitt · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

106 — Frostbitt · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

106 — Frostbitt · Song end check 3

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

1nput This 2 Y0ur Spine — Camellia · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

1nput This 2 Y0ur Spine — Camellia · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

1nput This 2 Y0ur Spine — Camellia · Song end check 3

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

322 — Creo · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

322 — Creo · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

322 — Creo · Song end check 3

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

A Visitant (feat. Victor Borba) — RO1 · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

A Visitant (feat. Victor Borba) — RO1 · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

A Visitant (feat. Victor Borba) — RO1 · Song end check 3

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

About the Author — The Sterns · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

About the Author — The Sterns · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

About the Author — The Sterns · Song end check 3

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

The Afterparty — Portraits of Tracy · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

The Afterparty — Portraits of Tracy · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

The Afterparty — Portraits of Tracy · Song end check 3

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

Al Gore Rhythm — Blight Town · Song end check 1

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

Al Gore Rhythm — Blight Town · Song end check 2

Default

One of the three checks the YARG client sends together when this eligible song ends.

YARG Official Setlist

Playing with others

One YARGAPClient slot exchanges rewards with other Archipelago games. Instrument shuffle can count the required instrument in a local band; this does not establish online shared-song co-op.

Known scope and limitations

  • Use APWorld 1.3.0 with YARGAPClient 1.0.1. Both release pages request the other component’s 1.x series; the World requires Archipelago 0.6.7 or newer. The ordinary YARG application alone is not the AP client. Windows was the distribution examined; Linux and macOS downloads exist, but their runtime was not tested here.
  • Install the official setlist through YARC Launcher and download the AP client separately. Install yarg.apworld, create your options, generate and host a room, then scan the required charts in YARGAPClient. Open its Archipelago menu and enter host, port and slot; leave Game ID blank for the base YARG World. If songs are missing, use the maintainer’s folder-discovery and rescan steps.
  • The default selects ten songs from the official setlist: nine ordinary songs award three checks each, for 27 checks, and one song is the goal. You start with one song unlocked, then receive song unlocks, five required Gems and Star Power bonuses. Version 1.3.0 adds Classical Keys Pack 3 and Children’s Keys Pack 3 to the available catalog. Setlist metadata in the World does not include the music or charts; install only content you are entitled to use.
  • Instrument shuffle is optional and requires at least two selected instruments with enough compatible charts. It can reject a randomly selected subset even if the larger library has compatible songs. The client requires the goal song, Gems and its assigned instrument, then completion of the song. The World’s completion predicate drops that instrument requirement and does not require a song-clear event, so it is not an exact representation of the client’s goal trigger.
  • Keep the client connected while finishing a song: disconnected completions are not held in a persistent sending queue, so replay the song after reconnecting. Star Power bonuses received outside a song do not provide a later stored bonus. Restart the client before switching rooms because instrument allowances are retained in a process-wide set. Goal transmission and transient-bonus replay have no persistent recovery ledger.
  • The connection cache stores the room password and the journal can include it; avoid reusing sensitive credentials or sharing unredacted logs/cache files. Use an explicit WSS address where supported: a bare address can fall back to WS, and the saved host/port does not preserve the scheme. DeathLink defaults off and offers instant-fail or recoverable one-hit modes. EnergyLink is on by default and contributes song score to the shared energy pool.
  • The sixteen World Python modules match the tagged source; remaining differences concern tutorial/manifest packaging. Critical client behavior was also read from the Windows assembly. World source is MIT and client source LGPL-3.0-or-later, but complete distributed notices remain undocumented. The World’s ten test functions are APQuest examples, not YARG rule tests; inherited audio tests do not establish AP reconnect or delivery coverage.

This integration is maintained independently of Panludia. Downloads are provided by its maintainer. Contact the maintainer through the linked repository or support channels.