This module will allow you to assign tokens to factions by using the token's disposition colors, the token actor's folder color, or defining your own custom replacement colors for token dispositions.
Artwork and assets kindly provided by and used with permission of Caeora. www.caeora.com
This is a keeping up to date of the idea of Voldemalort and is project Token Factions (original) wishing him all the best possible
NOTE: This module is under maintenance, I have no plans to update or add features. However, I will try to fix any bugs as possible. Any contribution is welcome.
Part of the code of this is module is inspired from the wonderful work done by kandashi with its Border-Control and Levels module. If you want to support more modules of this kind, I invite you to go and support his patreon.
NOTE: If you are a javascript developer and not a typescript developer, you can just use the javascript files under the dist folder
It's always easiest to install modules from the in game add-on browser.
To install this module manually:
- Inside the Foundry "Configuration and Setup" screen, click "Add-on Modules"
- Click "Install Module"
- In the "Manifest URL" field, paste the following url:
https://raw.githubusercontent.com/p4535992/foundryvtt-token-factions/master/src/module.json - Click 'Install' and wait for installation to complete
- Don't forget to enable the module in game using the "Manage Module" button
This module uses the libWrapper library for wrapping core methods. It is a hard dependency and it is recommended for the best experience and compatibility with other modules.
- The old "BLevel" frame style not work anymore, but i'll try for the feature to make more customizable faction image, there are already may options, but i don' have time for all the others. FOR NOW JUST USE THE FLAT SETTING
- With the fvtt 10 the border is now hidden behind the faction drawing
- A Token's Disposition
- An Actor's Folder Color
- A Custom Color Set For Token Disposition
This option uses the default Token Disposition color to render the token base and frame. Token Disposition can be seen on a token's Character tab. Tokens with actors controlled by players are colored in a fourth, distinct color.
This option uses the color of the folder a token's actor belongs in. A color of #000000, or the default color of a new actor folder, is treated as if there is no folder that will prevent a base and frame from being rendered for contained actor tokens.
This option reveals additional configuration options allowing you to customize colors associated with each token disposition.
Token frames (rings, square, hex) are layered above token graphics.
You can override this setting on a per-token basis on a token's Image tab if you use a mix of round and irregular tokens.
This option renders the frame in a flat color.
This option renders the frame in a beveled style typically seen surrounding round tokens.
This allows you to change the thickness of the rendered frame. The percentage is based on the width of a single grid unit, not the token width, so larger and smaller tokens will have a consistent frame size.
Setting this value to anything lower than 1 will allow the map background to be seen through the base. Setting this value to 0 will disable drawing the base entirely.
Setting this value to anything lower than 1 will allow the map background or token to be seen through the frame. Setting this value to 0 will disable drawing the frame entirely.
- Left click: You can enable/disable the faction style for single token with a new hud button
- Right click: Open a dialog for customize the border color
game.modules.get('token-factions').api.retrieveBorderFactionsColorFromToken(tokenIdOrName:string) ⇒ string
A method to retrieve the string color hex border of a token on the canvas founded by id or name
Returns: string
| Param | Type | Description | Default |
|---|---|---|---|
| tokenIdOrName | string |
The oken id or name (if founded) | #000000 |
async game.modules.get('token-factions').api.disableDrawBorderFactionsFromTokens(tokenIdsOrNames:string[]) ⇒ Promise<void>
A method to disable the draw border factions on a array of tokens on the canvas founded by id or name
Returns: Promise<void>
| Param | Type | Description | Default |
|---|---|---|---|
| tokenIdsOrNames | string[] |
The array of token ids or names (if founded) | undefined |
async game.modules.get('token-factions').api.disableDrawBorderFactionsFromToken(tokenIdOrName:string) ⇒ Promise<void>
A method to disable the draw border factions on a token founded by id or name
Returns: Promise<void>
| Param | Type | Description | Default |
|---|---|---|---|
| tokenIdOrName | string |
The token id or name (if founded) | undefined |
async game.modules.get('token-factions').api.enableDrawBorderFactionsFromTokens(tokenIdsOrNames:string[]) ⇒ Promise<void>
A method to enable the draw border factions on a array of tokens on the canvas founded by id or name
Returns: Promise<void>
| Param | Type | Description | Default |
|---|---|---|---|
| tokenIdsOrNames | string[] |
The array of token ids or names (if founded) | undefined |
async game.modules.get('token-factions').api.enableDrawBorderFactionsFromToken(tokenIdOrName:string) ⇒ Promise<void>
A method to enable the draw border factions on a token founded by id or name
Returns: Promise<void>
| Param | Type | Description | Default |
|---|---|---|---|
| tokenIdOrName | string |
The token id or name (if founded) | undefined |
npm installnpm installdev will let you develop you own code with hot reloading on the browser
npm run devbuild will build and set up a symlink between dist and your dataPath.
npm run buildbuild:watch will build and watch for changes, rebuilding automatically.
npm run build:watchprettier-format launch the prettier plugin based on the configuration here
npm run-script prettier-formatlint launch the eslint process based on the configuration here
npm run-script lintlint:fix launch the eslint process with the fix argument
npm run-script lint:fixprettier-format launch the prettier plugin based on the configuration here
npm run-script prettier-formatAny issues, bugs, or feature requests are always welcome to be reported directly to the Issue Tracker, or using the Bug Reporter Module.
This package is under an MIT license and the Foundry Virtual Tabletop Limited License Agreement for module development.
Thanks to anyone who helps me with this code! I appreciate the user community's feedback on this project!
- Token Factions (original) ty to Voldemalort
- Token Factions (fork) ty to erithtotl
- Border-Control ty to kandashi
- Ty to theripper93 for the module injectConfig