View source for Adding extra image files to tokens

[[Category:Cookbook]]{{stub}}

This technique lets you add an arbitrary amount of image assets to a token by adding them directly to the token file outside of MapTool.

You can definitely do this any number of ways by examining the unzipped contents of an rptok file. Generally, you need to do four things to make this work:
<ul>
	<li>Token images named with a UUID and an extension in the rptok's /asset/ directory</li>
	<li>Matching text files named for the matching UUID (no extension) containing matching Asset XML</li>
	<li>XML Entries in /content.xml inside the imageAssetMap tag</li>
	<li>A property in /content.xml to expose your asset IDs in MapTool</li>
</ul>

<h2>Step by step instructions</h2>

<ol>
<li>Save space on your images by resizing to reasonable dimensions and using a tool like https://tinypng.com to compress them. Check for quality after compression.</li>
<li>Copy the following spreadsheet, remove the names/filetypes, and populate with a list of your additional images on each row. This spreadsheet generates XML and JSON for you, and a uuid() which generates UUIDs that will work. Remember to COMPLETELY clear the Image Name field before entering your images to force the UUID to regenerate: [https://docs.google.com/spreadsheets/d/1aYf9V1fc3TQhKtnWG74nJkck88vzMYcqq4lyO0oRURY/ Google Drive App Token Image Asset Generator]
</li><li>Add a property to your token to expose the images with a dummy JSON object. Include some unique dummy values so it is easy to find and edit within your token's XML data later. This code will work while impersonating your token:
<br><br>
<code>[setProperty("AttachedImageMap", json.set("{}", "##imageName", "##imageID"))]</code>
<br><br>
</li><li>Save your token to your harddrive. Make a second backup copy elsewhere, just in case.
</li><li>Unzip your token to a folder. This will be where you add your images, asset files, and edit the content.xml.
</li><li>Place your image(s) in the /assets/ directory of the token, naming them according to their UUID, e.g. "48a2a53444244b4681fd23d51aeb5d76.png".
</li><li>Create a text titled for each UUID (no extension) in the /assets/ directory. Each file should contain their associated 'Asset XML' content.
</li><li>Edit /content.xml in a text editor. 
</li><li>Add the 'XML' Entries in the imageAssetMap. You'll see at least one entry already for the token image, you can add it under that. 
<br><br>
<b>IMPORTANT</b>: Copy-pasting multi-line fields from Google Sheets can add double quotes around the pasted content. Remove those!!
<br><br>
</li><li>Search for your dummy JSON property value. Paste in the 'JSON' value to replace it. Your pasted content will not have HTML entity double quotes, but they will work fine in MapTool - no need to 'escape' the quotes.
</li><li>Open your .rptok file as an archive, and replace the contents with the contents of your unzipped folder. 
<br><br>
<b>IMPORTANT</b>: DO NOT Zip up your files up and rename the result with an .rptok extension - I have found it isn't reliable. Adding/Replacing files in an exported .rptok directly without unzipping works better.
<br><br>
</li><li>Test your token. Drag it onto a new map, and run this macro while impersonating the token:
<br><br> 
<code>[r, foreach(vImg, getProperty("AttachedImageMap"), ""): "<img src='asset://" + json.get(getProperty("AttachedImageMap"), vImg) + "' width=50>"]</code>
<br><br>
</li><li>Test your token again. Save the token to a new location, open a new campaign, drag the token to the map, and use the test script again. Sometimes new UUIDs are generated.
</ol>
You're done! Now you can access the UUIDs by grabbing their asset IDs by reference from your JSON token property.