Luckyrun
Speedrun timer for Lucky Shot. Auto-start, pause on menu, on-screen timer and saveable settings. Built on OpenShot API.
| Last updated | 11 hours ago |
| Total downloads | 0 |
| Total rating | 0 |
| Categories | Mods Tools |
| Dependency string | LiamGaming-Luckyrun-0.2.2 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2305
LiamGaming-OpenShot
A core library and API for Lucky Shot modding. Provides a Mod Menu, Developer Console, unified GameEvents, AudioAPI, InputAPI, and Asset Registries.
Preferred version: 1.2.0README
Luckyrun
A simple Thunderstore mod that provides an on-screen speedrun timer for Lucky Shot. Features:
- Auto-start options (first shot / scene load / spawner start)
- Pause on Mod Menu (F1)
- On-screen display and Mod Menu settings (saved via OpenShot SaveAPI)
- speedrun.com integration (OAuth + manual token fallback)
- Set-Seed support (include seed in submission comment)
Installation:
- Install OpenShot (LiamGaming-OpenShot) and BepInEx
- Drop LuckyShotSpeedrun.dll into BepInEx/plugins
Usage: Open the Mod Menu (F1) to configure and control the timer.
speedrun.com setup (OAuth)
- If speedrun.com supports developer apps: register an app on speedrun.com and set Redirect URI to http://localhost:4567/callback/ (or set a different port in settings).
- Enter Client ID and Client Secret into the mod settings and press "Authenticate speedrun.com (OAuth)". Complete the browser flow.
- Set Game ID and Category ID in the mod settings (use the IDs from the speedrun.com URLs).
- Optionally enable "Auto Submit" to send runs automatically at run end.
Manual token fallback:
- If app registration is not available, create or obtain a personal API token on speedrun.com (if supported) and paste it into the "Manual token" field in the mod settings. The mod will use this token to submit runs.
Notes & privacy:
- Tokens are stored locally via OpenShot SaveAPI (plaintext in the game config folder). Keep them private.
- If speedrun.com changes API requirements, submissions may fail; check logs for details.
