Skip to content

Commit

Permalink
Merge pull request #84 from ChrisFeline/dev
Browse files Browse the repository at this point in the history
Change README structure.
  • Loading branch information
ChrisFeline authored Oct 16, 2024
2 parents 2cac600 + 0b418cf commit 408d822
Show file tree
Hide file tree
Showing 3 changed files with 77 additions and 85 deletions.
66 changes: 66 additions & 0 deletions Docs/FAQ.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# 📋 Frequently Asked Questions:

> ## How do I use this?
> 1. Download on the [<u>Latest Release</u>](https://github.com/ChrisFeline/ToNSaveManager/releases/latest), 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](https://github.com/ChrisFeline/ToNSaveManager/issues) here or you can join the [official Save Manager Discord Server](https://discord.gg/Anpm8d3fPD) and find me 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**.
> <details>
> <summary><b>Show Image</b></summary>
> <p> <img src="Resources/logging.png" height="420px" > </p>
> </details>
> ## Program is stuck on "Loading, please wait..."
> This problem is most likely caused when the program is trying to parse large log files created by VRChat.
> <br>You can check your VRChat logs by pressing `Windows Key` + `R`
> Then type `%APPDATA%\..\LocalLow\VRChat\VRChat` and click **Ok**.
> <br>If you see logs file with a storage size out of the ordinary, that might be the cause of your issue.
> ## 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.
> <details>
> <summary><b>Show Discord Screenshots</b></summary>
> <p> <img src="Resources/Webhook/screenshot_0.png" height="auto"> </p>
> <p> <img src="Resources/Webhook/screenshot_1.png" width="682px"> </p>
> <p> <img src="Resources/Webhook/screenshot_2.png" width="512px"> </p>
> </details>
> ## 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` <br>
> 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](https://github.com/ChrisFeline/ToNSaveManager/blob/a0d503b02fe25fde1b36ca9807756f1830c8e7a8/.github/workflows/dotnet-desktop.yml#L46C45-L46C45).

> ## 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.**
5 changes: 3 additions & 2 deletions Localization/CONTRIBUTE.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
> ## How to contribute with translations?
# 🌐 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](https://github.com/ChrisFeline/ToNSaveManager/tree/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`
Expand All @@ -8,6 +9,6 @@
> * 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.
> - Download the file [`en-US.json`](https://github.com/ChrisFeline/ToNSaveManager/blob/main/Localization/Language/en-US.json) from this repo.
> - Rename it to your local ISO language name. For example `ja-JP.json`
> - You can [contact me](#-contact) on discord and I'll review the changes.
91 changes: 8 additions & 83 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@

# [Download](https://github.com/ChrisFeline/ToNSaveManager/releases/latest/download/ToNSaveManager.zip "Use this link to download the latest version directly from GitHub.")

**[Discord Server](https://discord.gg/Anpm8d3fPD)
[VRChat Group](https://vrc.group/TONSM.0849)**<br>
### [Discord Server](https://discord.gg/Anpm8d3fPD)[VRChat Group](https://vrc.group/TONSM.0849)

[View Releases](https://github.com/ChrisFeline/ToNSaveManager/releases "Show a list of current and previous releases.")
[Saving Guide](https://terror.moe/save "HOW TO SAVE & LOAD FOR DUMMIES")
[How To Use](#-faq)
[FAQ](Docs/FAQ.md)
</div>

<p align="center">
Expand Down Expand Up @@ -53,9 +53,8 @@
- This window gives you a list of unlockables that you can check to track your progress. Just click on the things you already unlocked.

## OSC Documentation
[**Parameter Names & Types**](Docs/OSC/OSC_Parameters.md)

[**Round Type Values**](Docs/OSC/OSC_RoundType.md)
- [**Parameter Names & Types**](Docs/OSC/OSC_Parameters.md)
- [**Round Type Values**](Docs/OSC/OSC_RoundType.md)

<details><summary>OSC Troubleshooting</summary><p>
If your parameters are not being received properly... try resetting the OSC config.
Expand All @@ -66,6 +65,8 @@ If your parameters are not being received properly... try resetting the OSC conf
</p></details>

# 🌐 Available Translations
> Check [`Localization/CONTRIBUTE.md`](Localization/CONTRIBUTE.md) to help translate the Save Manager to your language.
| Language | Translator |
| -------- | ---------- |
| English | - |
Expand All @@ -76,86 +77,10 @@ If your parameters are not being received properly... try resetting the OSC conf
| Simplified Chinese | [github.com/Fallen-ice](https://github.com/Fallen-ice) |
| Italian | [github.com/TheIceDragonz](https://github.com/TheIceDragonz) |

# 📋 FAQ:

> ## How do I use this?
> 1. Download on the [<u>Latest Release</u>](https://github.com/ChrisFeline/ToNSaveManager/releases/latest), 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](https://github.com/ChrisFeline/ToNSaveManager/issues) here or you can join the [official Save Manager Discord Server](https://discord.gg/Anpm8d3fPD) and find me 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**.
> <details>
> <summary><b>Show Image</b></summary>
> <p> <img src="Resources/logging.png" height="420px" > </p>
> </details>
> ## 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.
> <details>
> <summary><b>Show Discord Screenshots</b></summary>
> <p> <img src="Resources/Webhook/screenshot_0.png" height="auto"> </p>
> <p> <img src="Resources/Webhook/screenshot_1.png" width="682px"> </p>
> <p> <img src="Resources/Webhook/screenshot_2.png" width="512px"> </p>
> </details>
> ## 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` <br>
> 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](https://github.com/ChrisFeline/ToNSaveManager/blob/a0d503b02fe25fde1b36ca9807756f1830c8e7a8/.github/workflows/dotnet-desktop.yml#L46C45-L46C45).

> ## 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](https://github.com/ChrisFeline/ToNSaveManager/tree/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`](https://github.com/ChrisFeline/ToNSaveManager/blob/main/Localization/Language/en-US.json) from this repo.
> - Rename it to your local ISO language name. For example `ja-JP.json`
> - You can [contact me](#-contact) on discord and I'll review the changes.
# 📫 Contact:
> ### Please do <u>NOT</u> message Beyond about suggestions or problems with this tool.
> You can report problems or suggestions under the [Issues](https://github.com/ChrisFeline/ToNSaveManager/issues) tab on this repo. Alternatively see contact information below.
# 📫 Contact:
> - **Discord:** [@Kittenji](https://discord.gg/Anpm8d3fPD)<br>
> - **VRChat:** [Kittenji](https://vrchat.com/home/user/usr_7ac745b8-e50e-4c9c-95e5-8e7e3bcde682)
> ## Say hi if you see me playing [Terrors of Nowhere](https://vrchat.com/home/world/wrld_a61cdabe-1218-4287-9ffc-2a4d1414e5bd)!
Expand Down

0 comments on commit 408d822

Please sign in to comment.