Types of Files
The following file types are acceptable for your uploaded files on Astral TableTop.
JPG or PNG
WAV, OGG, FLAC
Image Resolution (DPI/PPI)
DPI = “dots per inch”
PPI = “pixels per inch”
Astral TableTop assets must be set to between 70 and 150 DPI or PPI.
Dimensions and Format
The acceptable size (width and height) and format of your assets are outlined below.
280 pixels by 280 pixels, in JPG or PNG format.
A token at this size can be up to 4 x 4 map squares on your VTT (or perhaps slightly larger) without any issues, and it will still look good if someone zooms in to look closely at it.
Make sure the token fills the square as intended. For example, a token for a human character might be slightly larger within its square than a halfling or gnome token might be; meanwhile, an orc or bugbear might be slightly larger than the human within its square.
Particularly for PNG images, you might also want your token image to feature a drop-shadow or an outline to make it easier to distinguish from the background.
70 pixels x 70 pixels per grid square in JPG format.
Small Maps or “Battle Maps”
Battle maps show relatively small rooms or areas, generally for use in token-based skirmish combat games. Such maps are usually laid out on a square or hex grid, often depicted at 5 feet per square.
Example: A map of a 40-ft. by 40-ft. room, using a 5-foot grid, is 8 squares by 8 squares. The whole map should be 560 x 560 pixels (i.e., 8 x 70 by 8 x 70).
A bigger map, whether one showing a large battle area or a bigger geographical region (like an entire town or dungeon layer, or even a world map) might still be laid out using squares or hexes. However, the scale will be larger than that of a battle map.
Regardless, the 70 x 70 pixel standard still applies per square (even if actual grid squares aren’t visible on the map).
Note: For maps larger than about 3000 x 3000 pixels, you might provide the full map to users, but also offer the whole thing pulled apart into smaller sections (see “Map Tiles”) that can then be pieced back together as needed by the user in Astral. Doing so will improve performance on VTT, while maintaining the integrity of the map image.
Map tiles are uniform pieces of larger maps that can be put together to create a larger whole. They are usually created with standard edges that align with multiple sides of other tiles so that they can be put together in a wide variety of shapes or permutations.
When creating map tiles, be sure the tiles line up correctly without any odd overlap or gaps.
Map Dressing and Decorations
70 X 70 pixels per grid square in JPG format.
Use PNG file format if the object needs a transparent background, such as a piece of furniture to be placed onto a larger map.
For items pre-designed to fit on a specific map, be sure the items line up correctly, especially if they are larger in size than one map square (such as a 1 x 2 or 2 x 2 table).
The maximum file size for any product or image is 25 MB.
If you hit the size limit, check whether your title is a JPG; if it’s not, try making it into one, as that should reduce its file size. If it is already a JPG, or if you can’t make it into one, you may need to reduce the image size, detail, or resolution.
Alternately, if your too-large file is a map, try splitting it into smaller Map Tiles, as noted above.
Product and File Naming
The name of your product can be whatever you like, but it should be descriptive of the product’s content. You want prospective customers both to be able to find your title easily and also to have a clear sense of what it contains.
While you can name your product what you like, when giving it a file name, you should err on the side of simple and descriptive over catchy and entertaining. For example, while your image might be listed on the store as “A Wicked Cool Gargoyle,” you should be simpler and more straightforward with its file name, essentially a brief description of the asset using alphanumeric characters, underscores, and dashes: In this case, use something like “ash-grey_gargoyle”.
You can also include keywords as part of the file name to help describe and identify the item. If you do, the keywords should be wrapped in square braces and separated by commas, with no spaces. Thus, you might name your file “ash-grey_gargoyle[stone,statue,gargoyle].jpg”.
In general, when using comma-separated keywords, you should use the following order, as they apply:
quantity > quality > size > age or time period > shape > color > nature or material > proper name, purpose, or other qualifier
You don’t need to include all of these descriptors, of course, and you generally won’t: Just a few keywords will suffice in most cases. You can also include more than one of the same type of descriptor if necessary. Again, just try not to make the names too long. A few keywords and descriptors should be plenty.
Here are some more examples of possible file names to give you a better idea about how to use keywords effectively.
Tags are very useful, improving a user’s chances of finding your items in their searches. When uploading your titles, you should take a moment to add a few tags to your titles.
Like keywords, tags are descriptive words that identify your item as being of a certain type, such as a “chair” or a “goblin.” In general, including at least one general or generic keyword is always a good idea, regardless of whether you include one or more specific ones: Users will tend to default to common names or terms to find things more often than not, so they can browse through the options available to them.
Below are a few more examples of good tagging:
- For a token image of a goblin holding a bow, you might include the following tags: enemy, goblinoid, goblin, archer, bow, shortbow.
- For an image of a dark brown, broken wooden chair, you might include the following: furniture, chair, broken, wood, brown.
- For a battle map of a crumbling tower summit reached by ancient stone stairs, you could try tower, stairs, summit, floor.
- For a map of the interior of a modern police station: station, office, precinct, modern, police, officer.
If the item is specific to a particular game system, level, genre, or setting, you might add that information as a tag as well.