WCA Scrambles

The current official scramble programs is TNoodle-WCA-1.2.2. It generates high-quality scramble sequences for all the events of a competition at once.

Download the official scramble program:
TNoodle-WCA-1.2.2
Last official change: January 22nd, 2024

Important Notes for Delegates

• Official competitions must always use a current version of the official scramble program (see Regulation 4f).
• Delegates should download TNoodle to run it on a computer. They should not use TNoodle running on a public server (for security reasons).
• Delegates must save all scramble sequences generated for an official competition, and send them with the results (see the WCA Competition Requirements Policy).

Scramble Secrecy

• Always encrypt your scrambles in TNoodle with an unguessable password. The password must have nothing to do with the competition or personal data (name, birthdate) of any of the Delegates.
• If you are displaying scrambles on a digital device, only share [Competition Name] - Computer Display PDFs.zip.
• Make sure that only Delegates have access to any other files.
• If you are using a Delegate's computer, use the operating system to create a guest user account and share only the passcode-protected computer display PDFs with it.
• Give passcodes to scramblers when the corresponding groups begin but not any earlier. (In particular, do not give the passcodes for all the scramble sets in a round to scramblers at the beginning of that round.)
• Don't put someone else in charge of the passcodes unless absolutely necessary, and only give them the minimum amount of passcodes needed.
• Additional precautions are outlined in the Scramble Accountability Policy.

Detailed Instructions for TNoodle

TNoodle requires Java to be installed on your computer.

1. Run the https://github.com/thewca/tnoodle/releases/download/v1.2.2/TNoodle-WCA-1.2.2.jar file on your computer.
   It will open the page http://localhost:2014/scramble in your browser.
2. Enter the details for your competition (competition name, number of rounds for each event, details for each round).
   If you would like to password protect the file, enter a password.
3. Wait for the loading bar to finish and click the "Scramble!" button that appears.
   A .zip file will download in your browser.

Notes

• 4x4x4 scramble sequences may take a few minutes to initialize and generate. If you are generating 4x4x4 scramble sequences, be patient while the loading bar may appear to be stuck.
• TNoodle creates a tnoodle_resources folder with a few MB of files (mostly cached tables) in the same folder it is run.
  Keep this folder if you want to generate more 4x4x4 scramble sequences more quickly in the future, but feel free to delete it if you need to reclaim disk space.
• TNoodle performs scramble filtering according to regulation 4b3.

About TNoodle

TNoodle uses code developed or adapted by Jeremy Fleischman, Ryan Zheng, Clément Gallet, Shuang Chen, Bruce Norskog, and Lucas Garron. View the TNoodle project on GitHub to view the source, report an issue, or contribute to its development.

History of Official Releases

Old versions must not be used without permission from the WCA Board. These are provided in case you want to check the behaviour of an older version.

• TNoodle-0.7.4 (2013-01-01)
• TNoodle-0.7.5 (2013-02-26)
• TNoodle-0.7.8 (2013-04-26)
• TNoodle-0.7.12 (2013-10-01)
• TNoodle-WCA-0.8.0 (2014-01-13)
• TNoodle-WCA-0.8.1 (2014-01-14)
• TNoodle-WCA-0.8.2 (2014-01-28)
• TNoodle-WCA-0.8.4 (2014-02-10)
• TNoodle-WCA-0.9.0 (2015-03-30)
• TNoodle-WCA-0.10.0 (2015-06-30)
• TNoodle-WCA-0.11.1 (2016-04-04)
• TNoodle-WCA-0.11.3 (2016-10-17)
• TNoodle-WCA-0.11.5 (2016-12-12)
• TNoodle-WCA-0.12.0 (2017-09-25)
• TNoodle-WCA-0.13.1 (2018-01-29)
• TNoodle-WCA-0.13.2 (2018-02-03)
• TNoodle-WCA-0.13.3 (2018-02-05)
• TNoodle-WCA-0.13.4 (2018-07-02)
• TNoodle-WCA-0.13.5 (2018-10-08)
• TNoodle-WCA-0.14.0 (2018-12-03)
• TNoodle-WCA-0.15.0 (2019-07-14)
• TNoodle-WCA-0.15.1 (2020-01-01)
• TNoodle-WCA-1.0.1 (2020-08-17)
• TNoodle-WCA-1.1.0 (2021-04-19)
• TNoodle-WCA-1.1.1 (2021-07-07)
• TNoodle-WCA-1.1.2 (2021-07-07)
• TNoodle-WCA-1.1.3.1 (2024-01-22)
• TNoodle-WCA-1.2.0 (2023-12-31)
• TNoodle-WCA-1.2.1 (2024-01-02)
• TNoodle-WCA-1.2.2 (2024-01-22)