SM64 Practice Script (very barebones!)

Getting Started - Basic (.exe)

(Windows) Download the latest .exe from Releases on the right sidebar, and then run it. If SmartScreen shows a warning about untrusted software, this can be ignored. Keep in mind that .exe versions of this will have the weighting and star choice per category hard locked, since this script doesn't currently have a built in feature to edit weighting/choice of stars.

Getting Started - Advanced (.py)

Otherwise, if you want to edit the script (e.g. fine tuning the weighting of the stars to your specific needs, swapping out stars in certain categories), or are using a different operating system, you can find the Python script itself included with each release. You can also use the 'sm64.py' file that will recieve commits between releases. The steps below are based on the file being named this, here is how to run it from scratch:

NOTE: This script doesn't work with Python 3.12+ (as of March 7th 2024).

Download the Python 3.11.6 version best suited for your OS here, if you don't currently have it installed: https://www.python.org/downloads/release/python-3116/

Next, follow the instructions listed below for your OS. Keep in mind this is assuming that Python is installed in PATH, and that py commands will point to Python 3.11.6.

Windows:

Open command prompt (cmd.exe)
Enter this exact command: py -m pip install colorama pick py-getch
Download the 'sm64.py' script, and navigate to the folder it downloaded to
Run the 'sm64.py' script

Linux:

Open your terminal
Enter this exact command: pip3 install colorama pick py-getch
Download the 'sm64.py' script, and navigate to the folder it downloaded to
Change the properties of the 'sm64.py' so it can be executed
Run the 'sm64.py' script

Changelog

Version 0.2:

- Implemented route functionality through the new 'stage.json' file
- Added 'MISC' option to home menu
- Simplified code

Version 0.1.1:

- Fixed 70 Star related bugs and adjusted weighting
- Laid out initial idea for Routes section
- Changed 120 Star to carpetless and 100c + cannon (until further implementation of the Routes feature)

Version 0.1:

- Created the script! Basic menu, supports all main categories and commonly used operating systems

Thanks to these people to support/inspiration:

- wermi (for help/teaching me Python related stuff!)
- tayyip (for continued moral support)
- !whichstar command from SM64 discord
- Zombie (random star webapp)
- Usamune (random stage per category function)
- Artemis (for implementing v0.2)

Artemis6425/SM64Prac