Luckyrun

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:

1. Install OpenShot (LiamGaming-OpenShot) and BepInEx
2. Drop LuckyShotSpeedrun.dll into BepInEx/plugins

Usage: Open the Mod Menu (F1) to configure and control the timer.

speedrun.com setup (OAuth)

1. 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).
2. Enter Client ID and Client Secret into the mod settings and press "Authenticate speedrun.com (OAuth)". Complete the browser flow.
3. Set Game ID and Category ID in the mod settings (use the IDs from the speedrun.com URLs).
4. 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.