This tool hasn't been created yet. This is the specification.
TTS Mod Transloader uploads assets from any Tabletop Simulator mod to your Google Drive account and creates a corresponding savefile. This guarantees you can always play a mod with your friends, even if the original files get taken down, without needing to manually share files.
TTS Mod Transloader is a simple command line application, but will get a UI if there is enough demand.
All of the mod's assets must be downloaded to your computer for TTS Mod Transloader to work properly. This can be achieved two ways:
The easiest way to download a mod's files is to use the awesome TTS Mod Backup tool made by Froghut.
Steps:
- Search for the mod you want to transload (in the left window pane).
- Right click the mod and select Download.
- The mod will highlight green when all files are finished downloading. If any files are cannot be downloaded, the mod will remain highlighted red. As a last resort, try loading the mod in Tabletop Simulator. Sometimes TTS can download files which TTS Mod Backup can't.
Alternatively, you can open the mod in Tabletop Simulator, then pull objects out of all the bags and wait for assets to load. This method is not preferred because it is labor intensive and easy to miss items.
tts-mod-transloader
[--save-file PATH] | Absolute or relative path to the Tabletop Simulator JSON save file on your computer.
[--google-drive-folder PATH] | Absolute path in Google Drive where the assets and savefile will be uploaded. If any part of the path doesn't exists, the folders will be created.
[--continue-with-missing-assets] | If set, the program will not abort if it encounters an asset file that is missing from your computer. In this case, the savefile will point to the original URL for this asset.
Example:
./tts-mod-transloader \
--save-file "C:\Users\kevin-d-omara\Documents\My Games\Tabletop Simulator\Saves\TS_Save_57.json" \
--google-drive-folder "My Drive/Tabletop Simulator/Hosted Mods/Cool Mod Name/"
Install Python 3.6.
Install IntelliJ Community Edition w/ these plugins:
Set up the project's Python SDK:
- Create a Python virtual environment for the project:
- Project Structure > Platform Settings > SDK > + > Python SDK > New environment
- Install these packages to the virtualenv:
- Project Structure > Platform Settings > SDK > Python 3.6 (Heroes-System-Image-Cropper) > Packages > +
pytest
(4.5.0)PyInstaller
(3.4)PyDrive
(1.3.1)attrs
(19.1.0)
- Select the Project SDK:
- Project Structure > Project Settings > Project > Project SDK: > Python 3.6 (Heroes-System-Image-Cropper)
- Apply
Follow these steps in order to run the program through IntelliJ:
- Open
src/tts_mod_transloader/main.py
. - Right click anywhere within the file and select Run 'main'.
- At the top right, select the dropdown titled main and click Edit Configurations....
- In Parameters: enter TODO. The paths are relative and start from the working directory
src/tts_mod_transloader
.
To run commands like pytest
and pyinstaller
you need to activate the virtual environment.
- Open a terminal at the root of the project
Heroes-System-Image-Cropper/
- Run
venv/Scripts/activate
This must be done each time you open IntelliJ.
- Activate Venv
- Run
pytest
See also: https://docs.pytest.org/en/latest/
- Activate venv
- Run:
pyinstaller src/image_cropper/main.py --name heroes-system-image-cropper --onefile
See also: https://pyinstaller.readthedocs.io/en/stable/usage.html
https://medium.com/@annissouames99/how-to-upload-files-automatically-to-drive-with-python-ee19bb13dda https://github.com/eigengrau/tts-backup