ToNCodes

Intro

Terrors of Nowhere by Beyond is a VRChat world where you and other players try to survive different creatures for a period of time. Every win grants you a quantity of Enkephalin (Eph) and +1 Survival Point (SP). Exchange your Eph for tools to improve your odds and unlock new permanent items the more SP you have.

Your progress gets stored as codes that you can copy and paste whenever you want to restore your session (things that carry over: your Index, SP, stats and achievements). ToNCodes automates the process of storing those codes as they generate within VRChat's logs.

Since there was no available solutions for Linux, this started as a personal application to store all Terrors of Nowhere codes generated while playing. I'm not working on it with the intention to replace any existing solutions made for the public, it's mostly an excuse for me to mess with Python and because I believe having multiple choices is always good. You are welcome to use it if you please.

If you find any bugs or want to make suggestions, please open a new issue or let me know on Discord.

IMPORTANT WARNING

Caution

This tool is currently in alpha stages and in development, so expect instability and bugs. I'd suggest keeping backups of at least the Codes folder where all the xml files are inside the app's folder.

Archipelago

What is Archipelago? In summary, you and multiple people randomize different games (worlds) and all items get shuffled across all worlds. You might find someone's Zelda Triforce piece and someone might find your Speed coil.

Currently, this is a very early and unoptimized version to gather interest and opinions. There's a lot of work to do. The AP client isn't featured complete yet.

Note: We don't have direct access to the game and we can't lock your items, so you'll have to follow the tracker to know what you can and can't use.

At the start, all your items are locked, and they'll be randomized between all worlds.

Encountering a new place or a new terror will count as a check. Your victory condition is finding a certain number of Terrors, Alternates, Unbounds, Locations and Moons.

Getting started WIP

Currently working on:

• Making AP Client compatible with my current Websocket integration.
• Receive items from others
• Scrolling client log
• List of unlocked items

Notes

To run double click ToNCodes.bin (or ToNCodes.exe if on Windows).

Double click to copy a code.

Delete key to delete a code.

To update ToNCodes Unzip the new version and extract the contents inside your app's folder and replace the files. I'd recommend making a backup of the app's folder, just in case you may need to rollback.

If there's a new update ToNCodes will inform you of the new update once and you'll have a reminder on the title bar, this can be disabled in the "File > Options" menu.

Manual code insertion, under "File > Manual code insertion" you can manually add a code if needed.

tontrack.me, you can connect to their Live Tracker by pressing the "Live Tracker" button on the website. Make sure the "File > Options > Connect to tontrack.me" check is enabled (you'll need to restart ToNCodes for the change to take effect if it was disabled).

Discord webhook, you can create a webhook and add the url to "File > Options > Discord webhook" and any new codes will be send to the Discord channel that webhook was created in.

Change language in "File > Options > Language", a restart of ToNCodes is needed for the changes to take effect.

Change Themes in "File > Options > Themes", a restart of ToNCodes is needed for the changes to take effect.

To enable the DEBUG, in "File > Options", currently shows information of the on going round.

OSC, you can enable or disable OSC communication, change the port number and edit the name to which each OSC parameter gets the information sent to in "File > Options"

This current version was made under Python 3.13.02. If you want to run it, you can download the latest standalone release or if you have Python installed, you can clone the project and run ToNCodes.py.

Translations

ToNCodes as of version alpha-0.7.3 supports multi-language. After checking around I decided to use the same website VRChat uses for community translations Crowdin: https://crowdin.com/project/toncodes

If you want to collaborate with a specific language that's not listed currently, please let me know in this discussion link and I will add it.

To collaborate, just head to the link above, sign in, select the language you want to help with, select en.json and you'll be presented with a UI with every available text. Here's a link to our wiki with visual guides.

If you have any questions, please open a new discussion thread.

Advanced

This next section is only if you want to run the Python code instead of the binary.

The project requires tkinter and xclip (only if you're on Linux, xclip is not needed on Windows). On most Linux distributions, you can install it via package manager.

Debian systems:

sudo apt-get install python3-tk xclip

Red Hat systems:

sudo dnf install python3-tkinter xclip

Arch systems:

sudo pacman -S tk xclip

If xclip doesn't work in wayland sessions you may need xsel or wl-clipboard.

Make sure you also install all the requirements.txt

pip install -r requirements.txt

If you want to compile it into an standalone binary, you can use nuitka. When I compiled it for Windows, I used Python 3.12.9. At this moment in time, 3.13 is not supported by it.

pip install nuitka

Linux

python3 -m nuitka --standalone --follow-imports --onefile --enable-plugin=tk-inter --include-package=websockets ToNCodes.py

Windows

python -m nuitka --standalone --follow-imports --onefile --enable-plugin=tk-inter --include-package=websockets --windows-console-mode=disable ToNCodes.py

Credits

Author: MichelleDB - https://michelledb.com I have no direct relation with Terrors of Nowhere outside of being a fan and a Patreon supporter.

Terrors of Nowhere belongs to Beyond, https://www.patreon.com/c/beyondVR

Special thanks to Cinnosu for all their support, https://tontrack.me

Thanks MaraRizer and the community for creating and maintaining this neatly organized wiki, https://terror.moe

Shoutout to the Linux VR Adventures community: If you're on a Linux distro and want to set up your VR hardware, visit https://lvra.gitlab.io.

Current OSC paramater's standard naming scheme and values for Terrors of Nowhere by Kittenji, https://github.com/ChrisFeline/ToNSaveManager

Outside dependencies: pyperclip, screeninfo, cryptography, requests, websockets, python-osc, vdf