adam/SE3-TTSDeck
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
A plugin for Strange Eons 3 that generates a JSON file and card images for import into Tabletop Simulator
38 Commits 1 Branch 0 Tags 68 KiB
JavaScript 100%
main
Go to file
Adam Goldsmith 5b74cfe4b1 Bump catalog ID
2024-09-22 13:22:27 -04:00
resources/ttsdeck Collapse some function arguments, for consistency 2024-09-22 13:21:43 -04:00
.gitignore Add .log/ to gitignore 2022-01-03 13:18:08 -05:00
.prettierrc.json Add and apply prettierrc 2022-01-03 13:15:22 -05:00
eons-plugin Bump catalog ID 2024-09-22 13:22:27 -04:00
LICENSE Add MIT license file 2022-01-01 22:42:19 -05:00
README.md Remove feature in README that is not actually released yet 2022-01-06 13:58:25 -05:00
seproject Initial Commit 2021-09-16 17:12:28 -04:00

README.md

SE3 Tabletop Simulator Deck Generator

This plugin for Strange Eons 3 allows you to generate images and corresponding "Saved Object" JSONs for decks which can be used in Tabletop Simulator.

Features

  • Creates correctly sized deck images for Tabletop Simulator, splitting into multiple pages when necessary.
  • Supports multiple copies of cards, without duplicating them in the image.
  • Creates a "Saved Object" JSON that joins all of the pages into a single deck, and assigns the name of the card.

Installation

Paste this URL into the top bar of the Plug-in Catalog in Strange Eons 3: https://dev.adamgoldsmith.name/se3plugins/. You should then be able to just select it from the list of available plugins. See the official docs for more details.

Alternatively, you can clone this repository and build/install the plugin following these instructions from the SE3 docs.

Usage

With the plugin installed, right click on a Deck task, then select "Generate TTS Deck" from the dropdown menu.

The plugin will create a JSON file with the same name as the Deck task, as well as a number of JPEG files. Copy/move/symlink the JSON file to the Saves/Saved Objects folder in your Tabletop Simulator Save Game Data. Do not move the jpg files; their paths are absolute and must be changed in the JSON file if you move them.

The absolute paths to deck images are written into the TTS json, so it will only work locally unless you upload the images, and correct the URLs in the JSON file. Alternatively, you should in theory be able to use the Upload All feature in Tabletop Simulator to upload them to the Steam Cloud, although I have not have any success with this.

The first time you run the plugin will take a very long time, but future runs will be faster as the cards' images will be cached.

Copies

This plugin supports the Copies File for indicating the number of copies of a card to create.

Limitations

This only supports decks of uniformly sized, single-sided cards (ie all with the same back). (Note that rotated cards do not count as being the same size for this purpose). The workaround for this is just to put each size/type of card into it's own deck.

The back image is taken from the first card in the deck.