ChrisFeline / ToNSaveManager

Save tool and manager for VRChat world: Terrors of Nowhere
MIT License
45 stars 9 forks source link



App Icon

Terrors of Nowhere: Save Manager

Simple tool that will keep track of your Save Codes so you can play and recover your codes later if you forgot to make a backup. And saves your code history locally for later use.

Download

View ReleasesSaving GuideHow To UseEspañol

Preview

🛠️ Features & Clarifications

Settings Window

Right Click Menus

Objectives Window

OSC Documentation

Parameter Names & Types

Parameter Name | Type |
---------------|------|--------------------------
ToN_RoundType  | INT  | The current round type.
ToN_Terror1    | INT  | The current terror index.
ToN_Terror2    | INT  | The second terror index.
ToN_Terror3    | INT  | The third terror index.
ToN_OptedIn    | BOOL | Is the player opted-in at the lobby
ToN_Saboteur   | BOOL | Is the player currently the Saboteur

Round Type Values

 0  =  Unknown
 1  =  Classic
 2  =  Fog
 3  =  Punished
 4  =  Sabotage
 5  =  Cracked
 6  =  Bloodbath
 7  =  Midnight
 8  =  Alternate
 9  =  Mystic_Moon
10  =  Blood_Moon
11  =  Twilight
12  =  Solstice
13  =  RUN
14  =  Eight_Pages
15  =  Cold_Night

OSC Troubleshooting

If your parameters are not being received properly... try resetting the OSC config.

You can do this by opening your Radial menu, open OSC, then click Reset Config.

🌐 Available Translations

Language Translator
English -
Spanish -
Japanese github.com/nomlasvrc
twitter.com/nomlasvrc

📋 FAQ:

How do I use this?

  1. Download on the Latest Release, the compressed file called ToNSaveManager.zip.
  2. Extract the contents of the .zip file into a folder of your choice.
  3. Open ToNSaveManager.exe.
  4. Select the log date on the left, then click one of the saves in the right.
  5. Your code is now in the clipboard, go to VRChat and paste the code in the input field.

Where can I request a feature?

If you want to suggest new features or changes, you can open an Issue here or you can ping me on the official Toren Discord as @Kittenji

How does it work?

The world periodically saves a snapshot of your progress in the VRChat log files.

Initially, the program will scan your logs at %LOCALAPPDATA%Low\VRChat\VRChat and recover previous Save Codes in your logs. Then it will continue detecting new codes as you play.

Why is it not showing anything despite previously playing Terrors?

There's the possibility that you have logging disabled. You can enable it by opening your Quick Menu, go to settings, scroll all the way down and turn logging on.

Show Image

How to properly configure Automatic Discord Backup using Webhooks?

You can set a Discord webhook url to automatically upload your codes to a discord channel.

  • Just go to your preferred channel on your discord server.
  • Click Edit Channel and then go to Integrations.
  • Add a webhook integration to this channel. You can give it a name and a profile picture.
  • Copy the webhook url.
  • Open settings on the Save Manager app.
  • Enable Auto Discord Backup, you will see a text input popup.
  • Paste your webhook url in the text field.
  • Click save.

NOTE: If you want to test this functionality, you can right click on a save entry then click Backup. If everything is right, save will be uploaded to the discord channel.

Show Discord Screenshots

Why is the .exe so big? >100MB

The exe is bundled with the .NET runtime that it's required to run the program. Using a command line argument for dotnet publishing: --self-contained true -p:PublishSingleFile=true
This adds size to the file, but ensures that the program runs independently without relying on a previous .NET installation.

This is so people that download this program does not have to go download the .NET runtime framework themselves. And it's ready to run without any extra actions from the user.

The program is compiled from the source using Github actions, you can see the full arguments in the workflow file.

Is this against VRChats ToS?

  • Short Answer: No

This is an external tool that uses local plain text files that VRChat writes to the Local APPDATA folder. We are allowed to read these files since it does not modify or alter the game in any way. This is not a mod or a cheat.

How to contribute with translations?

NOTE: You can test your language file as you work by dragging the .json file into the Language box in the Settings window.

  • Fork clone the localization branch.
  • Create a copy of the en-US.json language file into /Localization/Language
  • Rename it to your local ISO language name. For example ja-JP.json
  • Translate the strings contained within this file into your target language.
  • Keep important string replacement tokens like: {0}, {1} or $$MAIN.SETTINGS$$ etc...
  • Create a pull request.
  • Do NOT create a pull request into the main branch.
  • Make sure the only edited file is the new added language .json file, any other contribution in the source code unrelated to this translation will be rejected.

    OR

  • Download the file en-US.json from this repo.
  • Rename it to your local ISO language name. For example ja-JP.json
  • You can contact me on discord and I'll review the changes.

Please do NOT message Beyond about suggestions or problems with this tool.

You can report problems or suggestions under the Issues tab on this repo. Alternatively see contact information below.

📫 Contact:

❤️ Support:

If you want to support the development of this tool you can Buy Me A Coffee ♥ on ko-fi.