English

Automatic Token Image

Automatic Token Image helps Game Masters quickly assign suitable images to NPC and monster tokens.

When you place a token on a scene, the module looks through your own image library and tries to find the most relevant picture automatically. It uses the actor or token name, the names of your files and folders, French and English aliases, the creature’s role, race, and D&D5e creature type.

How it works

You choose the folder containing your images, then the module indexes its contents.

For example, an image stored as:

Humanoid/Dwarf/Guard_Sword.webp

may be selected for an actor named Dwarf Guard or Garde nain.

The D&D5e creature type is used to improve the result. A humanoid will not normally receive an image clearly identified as an undead, beast, plant, dragon, or another incompatible creature type.

Roles, races and aliases

The module can recognize both roles and races.

For example:

• Garde nain looks for a dwarf guard.
• Mage elfe looks for an elven mage.
• Goblin Warrior looks for a goblin warrior.
• A generic name such as Warrior may use any compatible race available in the library.

French and English aliases are included, so your actors may use French names while your files use English names, or the other way around.

You can also add your own aliases in the module settings.

Variants and exclusions

When several suitable images are available, the module can choose a random variant and avoid recently used images.

This is useful when placing several similar creatures without giving them all the same appearance.

You can also exclude words such as spirit, ghost or spectral to avoid unwanted variants unless they are specifically requested.

[GIF — Place several Goblin Guard tokens and show different compatible images being selected.]

[IMAGE — Show the exclusion setting.]

Keep control when needed

Automatic image replacement can be enabled or disabled:

• for the whole world;
• for an individual token;
• on an actor’s prototype token.

This allows you to keep a manually selected image whenever you prefer.

Player characters

The module can ignore D&D5e player characters.

Tokens placed by players are intentionally left unchanged. Automatic image selection only runs when a token is created by a Game Master.

Main features

• Automatic image selection for NPC and monster tokens.
• Foundry VTT V14 and D&D5e support.
• Search through file names and folder names.
• French and English aliases.
• Role and race recognition.
• D&D5e creature-type filtering.
• Random image variants.
• Recently used image avoidance.
• Configurable exclusions.
• Image-library caching.
• Individual control for tokens and prototypes.
• Optional player-character exclusion.

Important information

Automatic Token Image does not include any token artwork or visual assets.

You must provide your own image library and make sure you have the necessary rights to use those files.

The source code is distributed under the MIT License.

Known limitations

• S3 storage is not currently supported.
• General plural lemmatization is not performed.
• Results depend on the names and organization of your files and folders.
• A missing or incorrect D&D5e creature type may reduce matching accuracy.

Compatibility

• Foundry Virtual Tabletop V14
• D&D5e system

Credits

Token artwork shown in the demonstration GIFs is used for demonstration purposes only and is not included with the module.

Demonstration tokens are provided by:

- Forgotten Adventures: https://www.forgotten-adventures.net
- 2-Minute Tabletop: https://2minutetabletop.com

Français

Automatic Token Image

Automatic Token Image aide les MJ à attribuer rapidement une image adaptée aux tokens de PNJ et de monstres.

Lorsque vous placez un token sur une scène, le module recherche automatiquement l’image la plus pertinente dans votre propre bibliothèque. Il utilise le nom de l’acteur ou du token, les noms des fichiers et des dossiers, les alias français et anglais, le rôle, la race et le type de créature renseigné dans D&D5e.

Fonctionnement

Vous choisissez simplement le dossier contenant vos images, puis le module en analyse le contenu.

Par exemple, une image enregistrée sous :

Humanoid/Dwarf/Guard_Sword.webp

peut être utilisée pour un acteur nommé Garde nain ou Dwarf Guard.

Le type de créature D&D5e est utilisé pour améliorer les résultats. Un humanoïde ne recevra normalement pas une image clairement identifiée comme mort-vivant, bête, plante, dragon ou autre catégorie incompatible.

Rôles, races et alias

Le module peut reconnaître à la fois le rôle et la race.

Par exemple :

• Garde nain recherche un garde nain.
• Mage elfe recherche un mage elfe.
• Guerrier gobelin recherche un guerrier gobelin.
• Un nom générique comme Guerrier peut utiliser n’importe quelle race compatible disponible dans la bibliothèque.

Des alias français et anglais sont inclus. Vos acteurs peuvent donc porter des noms français tandis que vos fichiers utilisent des noms anglais, ou inversement.

Vous pouvez également ajouter vos propres alias dans les paramètres du module.

Variantes et exclusions

Lorsque plusieurs images correspondent, le module peut choisir une variante aléatoire et éviter les images récemment utilisées.

C’est pratique pour placer plusieurs créatures similaires sans leur donner exactement la même apparence.

Vous pouvez également exclure certains mots, comme spirit, ghost ou spectral, afin d’éviter des variantes non désirées lorsqu’elles ne sont pas demandées.

Garder le contrôle

Le remplacement automatique peut être activé ou désactivé :

• pour l’ensemble du monde ;
• individuellement sur un token ;
• sur le prototype de token d’un acteur.

Vous pouvez ainsi conserver une image choisie manuellement lorsque vous le souhaitez.

Personnages joueurs

Le module peut ignorer les personnages joueurs D&D5e.

Les tokens placés par les joueurs restent volontairement inchangés. La recherche automatique est uniquement lancée lorsqu’un token est créé par un MJ.

Fonctionnalités principales

• Sélection automatique d’images pour les tokens de PNJ et de monstres.
• Compatibilité Foundry VTT V14 et D&D5e.
• Recherche dans les noms des fichiers et des dossiers.
• Alias français et anglais.
• Reconnaissance du rôle et de la race.
• Filtrage selon le type de créature D&D5e.
• Variantes aléatoires.
• Évitement des images récemment utilisées.
• Exclusions configurables.
• Mise en cache de la bibliothèque.
• Contrôle individuel sur les tokens et prototypes.
• Exclusion facultative des personnages joueurs.

Informations importantes

Automatic Token Image ne contient aucune image de token ni aucune autre ressource visuelle.

Vous devez fournir votre propre bibliothèque d’images et vous assurer que vous possédez les droits nécessaires pour utiliser ces fichiers.

Le code source est distribué sous licence MIT.

Limitations connues

• Le stockage S3 n’est pas encore pris en charge.
• Les pluriels ne font pas l’objet d’une lemmatisation générale.
• Les résultats dépendent des noms et de l’organisation des fichiers et dossiers.
• Un type de créature D&D5e absent ou incorrect peut réduire la précision.

Compatibilité

• Foundry Virtual Tabletop V14
• Système D&D5e

Credits

Les illustrations de tokens visibles dans les GIF de démonstration sont utilisées uniquement à des fins de présentation et ne sont pas incluses dans le module.

Les tokens de démonstration proviennent de :

- Forgotten Adventures : https://www.forgotten-adventures.net
- 2-Minute Tabletop : https://2minutetabletop.com