Refunct for Archipelago

⚠️ New and quite untested ⚠️

How does it work, what are items and locations?

• You will have to unlock every cluster of platforms (that normally rise by pressing a button).
• Starting from v0.1.0, you also have to find your abilities to swim, ledge grab, wall kick and jump on jumppads!
• Location checks are making platforms grassy by jumping on 'em (200+ locations).
• Your goal is to collect enough grass and go to the final platform (adjustable via yaml, shown in-game).

Completely new to Archipelago?

Maybe this helps.

Here's how to play Refunct in Archipelago.

The 1️⃣, 2️⃣, 3️⃣, 4️⃣ order is very important, also when you login again later.

• You need to own the original game Refunct (via Steam for example).
• Download the practice-windows.zip from the release. Unzip the contents into any folder.
• Do the usual Archipelago custom games things: get your yaml and apworld from the release, generate and host.
• Open a notepad (etc) and write your creditionals like this: archipelago.gg:38281,PlayerName
• Copy those credentials (CTRL-C).
• 1️⃣ Open Refunct.
• 2️⃣ Once it's loaded, double-click refunct-tas.exe (note: it may crash, just try again a couple of times, or check troubleshooting at the very bottom).
• 3️⃣ Click New Game (back-up your save if you want).
• 4️⃣ After a short lag, you'll see "Press 'm' to open the menu" top-left. Navigate to Archipelago, paste your credentials (CTRL-V) and press enter to login.
• After closing the menu (escape), you should now see "Connected to Archipelago" and much more. You're good to go!
• Red buttons don't do anything in this randomizer.

AP help

• Softlocked or wanna continue a game? (Close Refunct) and follow 1️⃣2️⃣3️⃣4️⃣.
• Can't login? If on Windows: more information is in the log file, located at C:\Users\yourname\AppData\Local\Temp\refunct-tas.log

Other stuff

• Buttons and platforms underneath buttons are not checks. (Red) buttons don't do anything.
• Universal Tracker can help you to figure out which platforms are accessible. The mini-map should help!
• You should be able to quit a game and continue it later, just follow the steps again. Make sure to "New game" before logging into AP.
• The final cluster in the game won't appear and will stay underwater for now (the final button is weird).

Below text is the text of the original read me for the Refunct TaS Tool

Refunct TaS Tool

This project is a tool enabling Tool assisted Speedruns in the game Refunct.

Building

Refunct-tas is supported on Linux and Windows.

Linux

Make sure to have rust installed e.g. via rustup. Execute make. This will create the directory build/linux/ containing refunct-tas, librtil.so and some rebo script files.

Windows

Make sure to have Rust installed with rustup and installed the latest stable-i686-pc-windows-msvc. Execute the file make.bat either with a double-click, or preferably in cmd. It will create a directory build\practice-windows\ containing refunct-tas.exe, rtil.dll, Cargo.toml and some rebo script files.

Running

Refunct must already be running before executing these steps.

Linux

On Linux LD_PRELOAD is used to inject the refunct tas runtime library (rtil) into the process. This can be done in Steam in Library → Right click on Refunct → Properties → Set Launch Options... . There, specify LD_PRELOAD=/absolute/path/to/build/linux/librtil.so %command%.

To run the default practice functionality, execute refunct-tas, which will run main.re by default.
To run your own rebo script file, execute refunct-tas <file>.

Windows

To run the default practice functionality, double-click on refunct-tas.exe, which will run main.re by default. To run your own rebo script file, open cmd (e.g. with Win+R → cmd → Enter) and cd into the directory containing the TAS tool files (e.g. with cd C:\Users\User\refunct-tas\). There, execute refunct-tas.exe <file> to run that rebo script file.

Writing Script Files

Script files are written in the rebo programming language. The tool exposes an API which can be used by scripts to change different things within Refunct. The exposed API can be seen in rebo_init.rs. You can find all code of the practice functionality in the tool directory.

Troubleshooting

• thread 'main' panicked at 'Failed to decode config: Error: Your config file is invalid and couldn't be parsed correctly. Please make sure to correctly configure it.
• thread 'main' panicked at 'called Result::unwrap() on an Err value [...] "Connection Refused": The tool couldn't connect to the game. Please make sure that Refunct is started before running the tool. On Linux also make sure that you configured LD_PRELOAD correctly.
• thread 'main' panicked at 'Cannot get pid of Refunct: Error { kind: NotFound, message: "program not found" }': WMIC (Windows Management Instrumentation Command-Line) either doesn't exist or its directory isn't in PATH. To put it in path, run control sysdm.cpl,,3 in Run (WIN+R) -> Environment Variables -> [Under "User variables for (user)] -> Double click "Path". Add this entry to it: %SystemRoot%\System32\Wbem. Start the tool, and it should work.
• Refunct crashes with (or without) FATAL ERROR: On Windows this can happen from time to time when you start the tool. Try restarting Refunct and the tool. If the game continues to FATAL ERROR after multiple tries (2-3 should be enough), try to change your ingame FPS to a fixed value (e.g. 60 FPS) and try again 2-3 times. If it continues to crash, it could be due to multiple causes:
  1. You are not using the latest version of Refunct. Please verify your game files with Steam: Library → Right Click on Refunct → Properties → Local Files → Verify Integrity of Game Files...
  2. It could mean that I was too lazy to update all pointers to the latest version of Refunct. Currently refunct-tas is updated for Refunct BuildID 1964685. You can find your BuildID in Steam: Library → Right Click on Refunct → Properties → Local Files → bottom left
• Refunct / the TAS tool crashes and the file refunct-tas.exe disappears: Refunct-tas uses library injection, which some antivirus programs see as malicious action. Therefore your antivirus might have stopped execution and moves the executable into quarantine. Redownload the zip file and either whitelist refunct-tas.exe or disable it while you are using the TAS tool.
• I got EAC banned: No, you didn't. Refunct does not come with EAC. Period.

If your issue is not mentioned in this section, or you couldn't resolve it, please contact me and provide the file %temp%/refunct-tas.log as well as all output of the tool on the command line. Either open an issue here or tag me (oberien) on the Refunct Speedrunners Discord Guild.