A major reliability and safety-focused update with a simpler CLI, local testing, and improved scheduled-run behavior.
Highlights
- Added a simpler interactive
easyCLI workflow. - Safe simulation is now the default—no Minecraft account, VPS, proxy, or live token is needed to test the program.
- Added local integration testing with a fake Minecraft API.
- Added support for loading multiple bearer tokens from
tokens.txt. - Added support for loading proxies from
proxies.txt. - Added GitHub Actions testing on Windows and Linux with Python 3.10 and 3.12.
Reliability improvements
- Fixed long scheduled waits: the countdown now reports progress every five minutes, then every minute during the final hour, and every second during the final minute.
- Clock synchronization refreshes periodically while waiting for a drop.
- If external clock sources are unavailable, the program continues using the local system clock.
- Token checks, connection pre-warming, process-priority setup, and GC changes now happen shortly before the claim window instead of hours early.
- Process-priority failures are handled as non-fatal warnings.
- Fixed and covered the long-wait behavior reported in #3.
Testing
- 60 automated tests covering CLI behavior, configuration, time parsing, scheduling, token handling, proxy handling, notifications, and local request integration.
- All GitHub Actions checks pass on Windows and Linux.
Breaking changes
- Python 3.10 or newer is required.
- The old menu-based workflow has been replaced by the CLI and
easyworkflow. - Tokens and proxies should be stored in
tokens.txtandproxies.txtrather than committed configuration files.
Notes
Bearer tokens are not automatically refreshed. Make sure a configured token will still be valid when the live claim window begins.
Use live functionality only where permitted and respect Minecraft service limits and account restrictions.