ClustertruckArchipelago randomizer mod

Playing with others

One single-player Clustertruck game per Archipelago slot. Different worlds exchange rewards while playing together or at different times with the room available; the integration does not add native shared-level co-op.

Known scope and limitations

• Install cluster_truck.apworld for generation and use BepInEx.zip for the bundled game installation. On Windows, extract that bundle into the game folder and install .NET Desktop Runtime 9. The mod starts its own local connection helper; no separate client window is required.
• The Linux guide additionally requires Mono and .NET 9, the Linux BepInEx 5.4.23.2 core and its documented launch-script changes. The maintainer excludes the Snap setup. Native macOS support is not established by the game's store platforms.
• APWorld 1.3.2 now rejects excluded start or goal stages, an identical start and goal, and too few remaining stages for the requested threshold. Use its supplied YAML and keep the paired mod files from this release; the mod itself still reports 1.3.1.
• The current trap-percentage code compares a 0–1 random value directly with the integer option. A positive percentage therefore selects a trap for its extra filler slot rather than applying the advertised probability. Do not interpret 25 as a verified 25% chance in this release.
• Reconnecting rebuilds received items, including temporary effects, rather than providing an exactly-once delivery guarantee for every filler or trap. Remain connected while clearing checks and revisit the level selection after reconnecting to confirm room progress.
• Back up local game progress before installing. The mod changes selected-ability preferences and suppresses normal Steam achievement and leaderboard handling. Fully close the game when switching between modded and ordinary play.
• An open report describes a crash when quitting while connected on an older 1.2.x build. Disconnect from the room before exiting; the report does not establish that the current release fixes it. Panludia has not independently run a complete campaign on this build.
• Connection settings store and display the room password in plain text. Keep configuration files and screenshots private. The proxy normally uses secure WebSockets; choose the host address supplied by the room owner.
• The World models completion from received level unlocks while the mod requires completed stages and then the selected finale. This review does not establish exact agreement between those conditions or reliable replay of a victory interrupted by disconnection.