A plugin for Strange Eons 3 that generates a JSON file and card images for import into Tabletop Simulator

Go to file

Adam Goldsmith 31a367e5fa Remove feature in README that is not actually released yet		2022-01-06 13:58:25 -05:00
resources/ttsdeck	Move js into subfolder for namespacing	2022-01-04 17:39:21 -05: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	Move js into subfolder for namespacing	2022-01-04 17:39:21 -05: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.