Load images from:

• Your local computer (you sure have a great collection already)
• A URL (which is publicly accessible, and not using CORS)
• From D&DBeyond
• Already exists on Foundry server
• Pasting
• Drag and drop

Overlay this image by adding layers on top or beneath it. Think of it as putting sheets of paper on top of each other, each having a different cut out, therefore showing parts of the layers beneath it and covering other areas. You can achieve this effect by using images that are transparent in certain areas and opaque on others.

• Asmodeah Overview

Rotate, flip, scale, and moving the image around!

Unlock the layer by pressing the lock symbol and the layer is ready for transformation:

Move your mouse over the image, and

• drag to translate the image to any position you like
• scroll your mouse wheel to zoom in and out of the image
• hold shift and scroll your mouse wheel to rotate the image to your liking
• flip press the flip button to flip your image

Re-order your layers by using the arrow buttons up and down.

Once you're done layering your token, you will probably want to have a mask. This is usually a round token border frame and you want everything overflowing this frame to be transparent/removed.

Hit the mask button on the layer that should define the contour of your image apply this mask to every layer on your token, stamping each layer according to your frame.

This does not work for every image! For every token that fails, you can provide a custom mask by creating it in the graphic editor of your choice, and upload it to Tokenizer. Then use that as the mask for your token. Create a transparent image and paint everything you want to be opaque later with black / white / green, whatever but not transparent.

Click the Okay button to save the token to the Foundry VTT server.

You need to have the right permission to upload things onto the Foundry VTT server. GMs and Assistants do have the required permission by default, but regular Players don't.

Ask your GM to check the player settings (hit ESC, then select Configure Players from the appearing menu). Every player that will use the Tokenizer requires the Trusted Player permission.

You can "shift click" on the avatar to open the regular file picker instead. Uf you

Two things are required for Tokenizer to being able so save a token.

1. The Foundry VTT server needs to allow the Trusted Players to upload images to the server. Check this setting in the Game Settings, you will find the setting Allow Trusted Players Upload at the top, please check that.

2. You will need to check the setting Upload directory in the Tokenizer section of the Game Settings. Make sure that Foundry can write to this directory, this is best achieved through creating it in the filepicker.

Many sites implement a protocol called CORS to help protect users from malicious attacks. Some examples of the errors you get back are in issue #26.

If you want to load images from one of these sites you can use your own proxy.

This image-proxy is a good starting point.

Get the proxy running then open your web browser development console (F12) in a Foundry session and run:

game.settings.set("vtta-tokenizer", "proxy", 'http://localhost:4001/%URL%?access_token=MY_SECRET_ACCESS_TOKEN');
game.settings.set("vtta-tokenizer", "force-proxy", true);

Replace the http://localhost:4001 with your proxy end point, and the MY_SECRET_ACCESS_TOKEN with your chosen access token.

• This is a good starter pack
• There are some different colour variations here
• You could convert some of the frames from TokenTool using GIMP
• There are some nice frames here and this is also a module in Foundry. If this module is active tokenizer will load the frames into the frame view by default. You can disable this in Tokenizer settings.

This work under these folders is licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.

This is a sample of frames available from OMFG, and plenty more are available.

You can support the OMFG on KoFi and Patreon.

You can call Tokenizer by using Tokenizer.launch(options, callback) or Tokenizer.tokenizeActor(actor).

Options can consist of:

{
  name: "Testy McTestFace",
  type: "pc",
  avatarFilename: "uploads/tokenspc/testy_mctestface.Avatar.webp?1626284544960",
  tokenFilename: "uploads/tokenspc/testy_mctestface.Token.webp?1626284544960",
  targetFolder: "[data] uploads/tokens/my-special-folder",
  disposition: 1,
  nameSuffix: "any-string",
}

Only name is required, the others will use Tokenizer defaults.

The targetFolder can override the default save folder.

The nameSuffix will add this to the token name as a suffix.

As well as any other object you wish to be passed back to the callback function.

e.g.

let tokenizerOptions = {
  name: "test",
  avatarFilename: "uploads/example/example_avatar_image.png",
  targetFolder: "[data] uploads/tokens/special",
  usefulString: "Useful data"
};

window.Tokenizer.launch(tokenizerOptions, (response) => {console.log(response)});

When the OK button is pressed it will return the following to the function (which in this case prints it to the console):

{
  name: "test",
  avatarFilename: "uploads/tokens/special/test.Avatar.webp",
  targetFolder: "[data] uploads/tokens/special",
  tokenFilename: "uploads/tokens/special/test.Token.webp",
  usefulString: "Useful data"
}

This is useful if you want to generate tokens for use outside of the regular actors.

If you want to tokenize just a scene token then you need to call tokenizeSceneToken passing in a doc with an actor and token object:

const dragon = canvas.scene.tokens.find(t => t.name === "Adult Black Dragon");
window.Tokenizer.tokenizeSceneToken({ token: dragon, actor: dragon.actor });

This applies the default frame to the current token image.

Call it using window.Tokenizer.autoToken passing in an Actor as the only variable.

let actor = game.actors.getName("TEST");
await window.Tokenizer.autoToken(actor);

This will apply the token, upload the image and update the actor.

You can pass in override options in an options map as the second argument:

await window.Tokenizer.autoToken(actor, { nameSuffix: "-name-suffix" });