¶ Configuration
Plutonium allows you to configure the details of how different entities are imported.
There are 3 ways to open the settings:
- You can go into your Game Settings > Configure Settings > Module Settings, and after you’ve found Plutonium in the list of modules click the Open Config Editor button.
- You can click the cogs
icon next to Plutonium Import in any of the directories where it is available.
.webp)
- You can click the cogs icon at the bottom right of the Plutonium Import Wizard, which will open the settings of that specific importer.
Once the Config Editor is open you can configure the different aspects of importing using any of the following tabs.
¶ Actors
TODO: Add description
¶ Standard
- Refresh Sheets using
@srd5e.usercharwhen Updating Player Character (default: true) - Player only. If enabled, when you update your character, the sheets of other actors you control which use@srd5e.userchar. ...attributes will be automatically refreshed to reflect any changes made to your character. If disabled, you may notice alagbetween updating your character and seeing the changes reflected in other sheets (a refresh can be forced manually by editing any field on the other sheet, or refreshing your browser tab).
¶ Hacks
- Auto-Roll Multiattacks (default: false) - Attempt to detect and automatically roll components of a creature’s
Multiattacksheet item on activation. - Support Variables in Active Effect Values (default: true) - Allows the use of roll syntax, and notably variables (such as
@abilities.dex.mod), in active effect values.
¶ Art Browser
TODO: Add description
¶ Standard
- Drag-Drop Images As (default: Tokens) - The type of canvas object that should be created when drag-dropping images from the art browser to the canvas.
Possible options are:- Tokens
- Tiles
- Journal notes
- Scenes
- Tile/Scene Scaling (default: 1) - A factor by which to scale placed tiles, and by which to scale scene backgrounds.
- Scene Padding - The amount of scene padding to apply when creating a scene.
- Scene Background Color (default: #222222) - The background color to apply when creating a scene.
- Scene Token Vision (default: true) - Whether or not token vision should be enabled for a created scene.
- Scene Fog Exploration (default: true) - Whether or not fog exploration should be enabled for a created scene.
- Add Scenes to Navigation (default: false) - Whether or not a created scene should be added to the navigation bar.
- Generate Scene Thumbnails (default: true) - Whether or not a thumbnail should be generated for a created scene. Note that this greatly slows down the scene creation process.
- Convert Scene Grid Distances to Metric (default: false) - Whether or not scene grid distances should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres; 1 mile ≈ 1.6 kilometres).
- Token Size (default: Medium or smaller) - The default size of placed tokens.
Possible options are:- Medium or smaller
- Large
- Huge
- Gargantuan or larger
- Activate Scenes on Creation (default: true) - If enabled, a scene will be activated upon creation (by drag-dropping an image to the canvas).
- Display Scene Sheets on Creation (default: true) - If enabled, the
sheet(i.e., configuration UI) for a scene will be shown upon creation (by drag-dropping an image to the canvas). - User Art Directory (default: assets/art) - The sub-directory of the
User Datadirectory where downloaded images and image packs will be saved. - Add Button To (default: Token scene controls; Tile scene controls; Note scene controls; Scene controls) - The place(s) where the Art Browser button should be visible.
Possible options are:- Token scene controls
- Tile scene controls
- Note scene controls
- Scene controls
- Image Saving Mode (default: Default) - How images should be saved to the server. If
Defaultis selected, an imported image will only be saved if it cannot be referenced via URL. IfAlwaysis selected, an imported image will be saved to the server, regardless of whether or not it can be referenced via URL. IfNeveris selected, an imported image will only be referenced by URL; if it cannot be referenced via URL, the import will fail. Note that saving images requires the Plutonium backend mod to be installed.
Possible options are:- Default
- Always
- Never
¶ Data Sources
TODO: Add description
¶ Standard
- Enable Data Source Filtering (default: false) - Whether or not
data sources(e.g. those displayed in the Import Wizard) are filtered down to only those chosen in theWorld Data Source Selectorapplication. - Force Select All for Players (default: false) - Whether or not all available
data sources(e.g. those displayed in the Import Wizard) are forcibly selected for players. Note that this can seriously degrade performance for players if data source filtering is not also enabled. - Force Select All for GMs (default: false) - Whether or not all available
data sources(e.g. those displayed in the Import Wizard) are forcibly selected for GMs. Note that this can seriously degrade performance for GMs if data source filtering is not also enabled.
¶ Equipment Shop
TODO: Add description
¶ Standard
- Price Multiplier (default: 1) - A factor by which the prices in the equipment shop are multiplied.
- Class Starting Gold - A starting gold amount to use instead of a class’s starting gold, when using the equipment shop during class creation.
- Minimum Permission Level (default: None) -
Equipment Shopbutton will be hidden for any user with a role less than the chosen role.
Possible options are:- None
- Player
- Trusted
- Assistant
- Gamemaster
- Cheater (Disable Feature)
¶ Import
TODO: Add description
¶ Standard
- Add Source to Names (default: false) - If the source of each imported entry (e.g.
MMfor Monster Manual) should be appended to the name of the entry. - Add Page Numbers to Sources (default: false) - If the page number (where available) of each imported entry should be appended to the
sourcefield of the entry. - Render Links as
@tags (default: true) - If links found in description text should be rendered as Plutonium-specific @tag syntax, e.g. a link togoblinwould be rendered as@creature[goblin|mm]. (By default, a link to the 5etools page will be rendered instead.) - Disable 5etools Links (default: false) - Prevents links to other 5etools content from being added to the text of imported 5etools content.
- Render Dice as Plain Text (default: false) - Forces dice expressions, usually rendered as
[[/r XdY + Z ...]], to be rendered as plain text when importing 5etools content. - Duplicate Handling Mode (default: None) - Determines what action is taken when importing duplicate content to a directory or compendium. An entity is considered a duplicate if and only if its name and source match an existing entity. Note that this does not function when importing to actor sheets.
Possible options are:- None: No deduplication is done.
- Skip duplicates: If a duplicate is found for a would-be imported entity, that entity is not imported.
- Update existing: If a duplicate is found for a would-be import entity, the existing entity is updated.
- Minimum Permission Level for Import (default: None) -
Importbuttons will be hidden for any user with a role less than the chosen role.
Possible options are:- None
- Player
- Trusted
- Assistant
- Gamemaster
- Cheater (Disable Feature)
- Use Importer when Drag-Dropping Items to Actors (default: Prompt) - Some Foundry items (backgrounds, races, spells, items, etc.), when imported via Plutonium and later drag-dropped to an actor sheet, have special handling allowing for greater functionality (such as populating skills and features). This allows you to control whether or not that special handling is used, rather than the baseline Foundry drag-drop. Note that if you modify an item, the changes will not be reflected in the version imported to the sheet by Plutonium.
Possible options are:- Never
- Prompt
- Always
- Treat
Save HalvesAdditional Attack Damage asOther Formula(default: false) - This moves extra attack damage rolls (for example, the poison damage done by a Giant Spider’s bite) to theOther Formuladice field, which can improve compatibility with some modules. - Prefer Metric Distance/Speed (Where Available) (default: false) - If enabled, metric distance/speed units will be preferred, where the importer supports them. Enabling this option effectively overrides all other metric distance/speed options, causing the importer to treat each as though it was enabled.
- Prefer Metric Weight (Where Available) (default: false) - If enabled, metric weight units will be preferred, where the importer supports them. Enabling this option effectively overrides all other metric weight options, causing the importer to treat each as though it was enabled.
- Show Variants/Versions (default: true) - If variants/versions of base entries should be shown in list views (with grayed-out names).
- Save Imported Images to Server (default: false) - If images referenced in imported content should be saved to your server files, rather than referenced from an external server.
- Save Imported Tokens to Server (default: true) - If tokens for imported actors should be saved to your server files, rather than referenced from an external server.
- Image/Token Directory (default: assets/srd5e) - The sub-directory of the
User Datadirectory where imported images/tokens will be saved to when using theSave Imported Images to Serveroption or theSave Imported Tokens to Serveroption. If theUse Local Imagesoption is enabled, images will be loaded from this directory by default. - Prefer Foundry/System Images (default: false) - If enabled, portraits for actors and images for items will be sourced from built-in compendiums first, then Plutonium second. If disabled, portraits/images will be sourced from Plutonium first, then built-in compendiums second.
- Prefer Foundry/System Tokens (default: false) - If enabled, tokens will be sourced from built-in compendiums first, then Plutonium second. If disabled, tokens will be sourced from Plutonium first, then built-in compendiums second.
- Load Local Homebrew (default: false) - If enabled, the directory specified by the
Local Homebrew Directoryoption will be read, and its contents added to the list of available sources. - Local Homebrew Directory (default: assets/homebrew) - The sub-directory of the
User Datadirectory from which homebrew should be automatically loaded if theLoad Local Homebrewoption is enabled. - Use
index.jsonfor Local Homebrew (default: false) - If, rather than read the local homebrew directory directly, anindex.jsonfile should be read when loading local homebrew. This file should be of the form: {toImport: [ … list of filenames … ]}. Note that this is required if players do not haveUse File Browserpermissions. - Additional Homebrew Files - Homebrew files which should be automatically loaded and added to the list of available sources.
¶ Advanced
- Hidden Importers - Importers which should not be shown in the Import Wizard UI.
Possible options are:- Actions
- Adventures
- Background Features
- Backgrounds
- Books
- Character Creation Options
- Class & Subclass Features
- Classes & Subclasses
- Conditions & Diseases
- Creature Features
- Creatures
- Cults & Supernatural Boons
- Deities
- Feats
- Hazards
- Items
- Languages
- Maps
- Objects
- Optional & Variant Rules
- Other Options & Features
- Psionics
- Race & Subrace Features
- Races & Subraces
- Recipes
- Spells
- Supernatural Gifts & Rewards
- Tables
- Traps
- Vehicle Upgrades
- Vehicles
- Base Site URL - The root server URL from which to load data and source images, and to link in rendered text. Note that, where possible, the module will use its own built-in data files, rather than call out to a remote server.
- Avoid Loading Local Data (default: false) - If enabled, any data which would normally be loaded from the module’s local copies is instead loaded from the sites URL (which may be customised by editing the
Base Site Urlconfig option). - Avoid Loading Homebrew Indexes on Startup (default: false) - If enabled, homebrew repository indexes won’t be loaded during initial module load. This will effectively prevent any homebrew sources from appearing in source listings. Note that these indexes are loaded in the background/asynchronously during normal operation, so should not negatively impact game load times, unless you have a particularly terrible internet connection.
- Use Local Images (default: false) - If enabled, images will be sourced from the
Image/Token Directorydirectory, defined above. - Use Strict Entity Matching (default: false) - If enabled, any Plutonium feature which searches for existing data (for example, the class importer attempting to find existing class levels in a given class) will match by name and source. If disabled, only name is used.
- Base Homebrew Repository URL - The root GitHub repository URL from which to load data and source images, and to link in rendered text, when importing homebrew content. URLs should be of the form
https://raw.githubusercontent.com/[username]/[repository name]/master. - Temp Folder Name (default: Temp) - The name of a temporary folder created/deleted by some operations. Note that the importer will delete this folder regardless of its contents, as anything contained within it is assumed to be a temporary entity created by the importer.
¶ Import (Actions)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported action.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported actions.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported actions.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a action’s text will be imported as item description.
¶ Import (Adventures)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported adventure.
Possible options are:- None
- Limited
- Observer
- Owner
- Add Sort Order Prefix to Journal Entry Names (default: true) - If imported journal entries should be prefixed with a sorting-friendly identifier, to avoid directory sorting from re-ordering them.
- Text Splitting Mode (default: By chapter) - Which strategy to use when splitting text into journal entries.
Possible options are:- By chapter
- By contents
- By heading
- Link Journals as Embeds (default: true) - If enabled, and the
Enable Journal EmbedsJournal Entries Config option is also enabled, links between sections will be rendered as embedded journal entries, rather than simple links. - Use Modded Package Installer (default: false) - If the modded Plutonium backend is installed, adventure packages (modules/worlds) will be installed, automatically, using the mod, rather than providing you with a list of links to copy-paste into Foundry’s
Setup. - Package Index URL (default: https://raw.githubusercontent.com/DMsGuild201/Foundry_Resources/master/worlds/index.json) - The URL of the index file from which world/module package metadata is loaded.
¶ Import (Background Features)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported background feature.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Backgrounds)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported background.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Advanced
- Additional Data Compendiums (Backgrounds) (default: dnd5e.backgrounds) - A comma-separated list of compendiums that the background importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Additional Data Compendiums (Features) (default: dnd5e.backgrounds) - A comma-separated list of compendiums that the background importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported backgrounds.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported backgrounds.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a background’s text will be imported as item description.
¶ Import (Books)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported book.
Possible options are:- None
- Limited
- Observer
- Owner
- Add Sort Order Prefix to Journal Entry Names (default: true) - If imported journal entries should be prefixed with a sorting-friendly identifier, to avoid directory sorting from re-ordering them.
- Text Splitting Mode (default: By chapter) - Which strategy to use when splitting text into journal entries.
Possible options are:- By chapter
- By contents
- By heading
- Link Journals as Embeds (default: true) - If enabled, and the
Enable Journal EmbedsJournal Entries Config option is also enabled, links between sections will be rendered as embedded journal entries, rather than simple links.
¶ Import (Char. Creation Options)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported character creation option.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not character creation option speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported character creation options.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported character creation options.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a character creation option’s text will be imported as item description.
¶ Import (Class & Sub Features)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported class/subclass feature.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not class/subclass feature speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported class features.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported class features.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a class/subclass feature’s text will be imported as item description.
¶ Import (Classes)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported class or subclass.
Possible options are:- None
- Limited
- Observer
- Owner
- Add Unarmed Strike (default: false) - If enabled, importing a class to an actor will create an
Unarmed Strikeweapon, unless one already exists. - Import Class Table to Description (default: true) - If enabled, a class’s table will be imported as part of the class item’s description.
- Add
Level UpButton to Character Sheets (default: true) - If enabled, aLevel Upbutton will be displayed in the top-right corner of a character’s sheet (assuming the default dnd5e sheet is used). - Set Minimum Actor XP on Class Import (default: false) - If enabled, during class import, actor XP will be set to the minimum XP value required for the actor’s new level, if the actor’s current XP is insufficient for them to reach their new level.
¶ Hacks
- Suppress Advancements During Drop Flow (default: true) - If enabled, dropping a Plutonium-imported class/subclass to a sheet will briefly disable the default advancement workflow, potentially allowing Plutonium’s importer to run instead.
¶ Advanced
- Prefer legacy
Level UpButton (default: true) - If disabled, theLevel Upbutton will attempt to open the Charactermancer, a Patron-only feature which requires you to log in. If enabled, a dialogue of options will be presented, via which the Class Importer can be directly invoked. - Additional Data Compendiums (Classes) (default: dnd5e.classes) - A comma-separated list of compendiums that the class importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Additional Data Compendiums (Subclasses) (default: dnd5e.subclasses) - A comma-separated list of compendiums that the class importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Additional Data Compendiums (Features) (default: dnd5e.classfeatures) - A comma-separated list of compendiums that the class importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported class.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported class.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a class’s text will be imported as item description.
- Subclass Default Image Fallback (default: true) - If enabled, when importing a subclass which has no well-defined image, use a default image based on class. If disabled, a generic black and white image will be used as a fallback instead.
¶ Import (Conditions & Diseases)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported condition/diseases.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported conditions/diseases.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported conditions/diseases.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a condition/disease’s text will be imported as item description.
¶ Import (Creatures)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported creature.
Possible options are:- None
- Limited
- Observer
- Owner
- Import Fluff to Biography (default: true) - If enabled, any fluff text which is available for a creature will be imported into that creature’s biography.
- Include Fluff Image in Biography (default: false) - If enabled, any fluff image which is available for a creature will be imported into that creature’s biography.
- Include Variants in Biography (default: true) - If enabled, any inset variant boxes associated with a creature will be imported into that creature’s biography.
- Import Variants as Features (default: false) - If enabled, any inset variant boxes associated with a creature will be imported into that creature’s features.
SecretAttack Descriptions (default: false) - If enabled, creature attack descriptions will be wrapped inSecretblocks, which are not shown when rolling.- Token Name Display Mode (default: Owner Hover) - The default Display Name mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Disposition (default: Hostile) - The default Token Disposition mode for imported tokens.
Possible options are:- Use game setting
- Hostile
- Neutral
- Friendly
- Token Lock Rotation (default: Allow importer to set) - The default Lock Rotation mode for imported tokens.
Possible options are:- Use game setting
- Allow importer to set
- Enable Token Vision (default: Enabled) - Enable vision for tokens.
Possible options are:- Use game setting
- Disabled
- Enabled
- Token Dim Vision Distance (default: Allow importer to set) - How token Dim Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Vision Distance (default: Allow importer to set) - How token Bright Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Sight Angle (default: Allow importer to set) - How token Sight Angle (Degrees) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Dim Light Radius (default: Allow importer to set) - How token Dim Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Light Radius (default: Allow importer to set) - How token Bright Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Emission Angle (default: Allow importer to set) - How token Light Emission (Angle) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Color (default: Allow importer to set) - How token Light Color should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Intensity (default: Allow importer to set) - How token Color Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Type (default: Allow importer to set) - How token Light Animation Type should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Speed (default: Allow importer to set) - How token Light Animation Speed should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Intensity (default: Allow importer to set) - How token Light Animation Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bar Display Mode (default: Owner) - The default Display Bars mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Bar 1 Attribute (default: attributes.hp) - The default token bar 1 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Bar 2 Attribute - The default token bar 2 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Scale - The default token scale for imported tokens.
- Convert Token Vision Ranges to Metric (default: false) - Whether or not token vision range units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
- Item Weight & Value Scaling (default: No scaling) - The method by which to scale the weights and values of non-standard-sizes items carried by creatures.
Possible options are:- No scaling
Bardingscaling (multiplicative): Based on the rules for calculating the weight and cost of barding, as presented in the Player’s Handbook (p. 155).Gurt's Greataxescaling (exponential): Based on the giant-size greateaxe of the same name found in Storm King’s Thunder (p. 234).
- Convert Speeds to Metric (default: false) - Whether or not creature speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
- Spellcasting Primary Trait Selection Method (default: Highest spell count) - The method by which a primary spellcasting trait (i.e., the spellcasting trait used to set spellcasting ability, spell DC, and spell attack bonus) is selected if a creature has multiple spellcasting traits with associated ability scores.
Possible options are:- Highest spell count: Use whichever spellcasting trait has the most spells listed.
- Highest ability score: Use whichever spellcasting trait has the highest associated ability score. Note that this may prefer innate spellcasting traits over spellcasting class levels.
- Add Tag Suffixes to Names - Add tags to an imported creature’s name, to allow easier searching (especially within compendiums).
Possible options are:- Add [CR] tag
- Add [type] tag
- Add [type (with tags)] tag
- MLD: Add Audio as Sound Effect (default: false) - If, when the Monk’s Little Details module is active, an imported creature should have its sound effect set, where an audio clip is available (for official data, this will usually be an audio clip of the creature’s name being pronounced).
¶ Advanced
- Additional Data Compendiums (default: dnd5e.monsters) - A comma-separated list of compendiums that the Creature Importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Additional Data Compendiums (Features) (default: dnd5e.monsterfeatures) - A comma-separated list of compendiums that the Creature Importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Use Token Image as Portrait (default: false) - If enabled, a creature’s token image will be preferred over its portrait image when populating its sheet portrait during import.
- Use Static AC Values (default: false) - If enabled, creature AC will be imported as a static number (rather than relying on the sheet’s formula calculation), and creature armor will be imported as unequipped.
- Use Custom Natural Armor Formula (default: false) - If enabled, creatures with natural armor will have their armor formula broken down as
@attributes.ac.armor + @attributes.ac.dex + <naturalBonus>, allowing any later Dexterity score changes to be reflected in the creatures AC.
¶ Import (Cults & Supernatural Boons)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported cult/boon.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported cults/boons.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported cults/boons.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a cult/boon’s text will be imported as item description.
¶ Import (Deities)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported deity.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Feats)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported feat.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not feat speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported feats.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported feats.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a feat’s text will be imported as item description.
¶ Import (Gifts & Rewards)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported supernatural gift/reward.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not gift/reward speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported gift/rewards.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported gift/rewards.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a supernatural gift/reward’s text will be imported as item description.
¶ Import (Hazards)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported hazard.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Items)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported item.
Possible options are:- None
- Limited
- Observer
- Owner
- Populate Active Effects (default: true) - If items should have active effects created during import.
- Convert Item Ranges to Metric (default: false) - Whether or not item range units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
- Convert Item Weights to Metric (default: false) - Whether or not item weight units should be converted to an approximate metric equivalent (1 pound ≈ 0.5 kilograms).
- Inventory Stacking Mode (default: Sometimes Stack (e.g. consumables, throwables)) - If imported items should
stackwith existing items when imported to an actor’s inventory. If stacking is allowed, the importer will check for an existing item when importing an item to an actor’s sheet. If the item already exists, the importer will increase the quantity of that item in the actor’s inventory, rather than create a new copy of the item in the actor’s inventory.
Possible options are:- Never Stack
- Sometimes Stack (e.g. consumables, throwables)
- Always Stack
- Import Packs to Actors as Constituent Items (default: true) - If
packitems (explorer’s pack, dungeoneer’s pack) should be broken down and imported as their constituent items when importing to an actor’s items. - Import Item Stacks to Actors as Constituent Items (default: false) - If an item which is formed of multiple constituent items of the same type, such as
Bag of Ball Bearings (1,000), should be split up into its constituent items (aBall Bearingitem with its sheet quantity set to 1,000, in this example). - Throwing Items (default: Handaxe; Javelin; Light Hammer; Dart; Net) - A list of items which are imported with their usage set to deplete their own quantity when used.
- Attunement Type for Attunable Items (default: Attunement required) - The attunement type to use when importing an item which can be attuned.
Possible options are:- None
- Attunement required
- Attuned
- Include Damage, Properties, Rarity, and Attunement in Description (default: false) - If enabled, an imported item’s description will include text generated from its rarity, attunement requirements, damage, and other properties.
¶ Advanced
- Additional Data Compendiums (default: dnd5e.items, dnd5e.tradegoods) - A comma-separated list of compendiums that the Item Importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Replacement Data Compendiums - A comma-separated list of compendiums that the Item Importer will attempt to pull items from, rather than using the data Plutonium would otherwise generate. This is useful when the Item Importer is used by other importers, e.g. when the Creature Importer is adding items to newly-created actors.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported items.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported items.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, an item’s text will be imported as item description.
¶ Import (Languages)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported language.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Maps)
TODO: Add description
¶ Standard
- Scene Padding - The amount of scene padding to apply when creating a scene.
- Scene Background Color (default: #222222) - The background color to apply when creating a scene.
- Scene Token Vision (default: true) - Whether or not token vision should be enabled for a created scene.
- Scene Fog Exploration (default: true) - Whether or not fog exploration should be enabled for a created scene.
- Add Scenes to Navigation (default: false) - Whether or not a created scene should be added to the navigation bar.
- Generate Scene Thumbnails (default: true) - Whether or not a thumbnail should be generated for a created scene. Note that this greatly slows down the scene creation process.
- Convert Scene Grid Distances to Metric (default: false) - Whether or not scene grid distances should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres; 1 mile ≈ 1.6 kilometres).
¶ Import (Objects)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported object.
Possible options are:- None
- Limited
- Observer
- Owner
- Token Name Display Mode (default: Owner Hover) - The default Display Name mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Disposition (default: Hostile) - The default Token Disposition mode for imported tokens.
Possible options are:- Use game setting
- Hostile
- Neutral
- Friendly
- Token Lock Rotation (default: Allow importer to set) - The default Lock Rotation mode for imported tokens.
Possible options are:- Use game setting
- Allow importer to set
- Enable Token Vision (default: Enabled) - Enable vision for tokens.
Possible options are:- Use game setting
- Disabled
- Enabled
- Token Dim Vision Distance (default: Allow importer to set) - How token Dim Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Vision Distance (default: Allow importer to set) - How token Bright Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Sight Angle (default: Allow importer to set) - How token Sight Angle (Degrees) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Dim Light Radius (default: Allow importer to set) - How token Dim Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Light Radius (default: Allow importer to set) - How token Bright Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Emission Angle (default: Allow importer to set) - How token Light Emission (Angle) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Color (default: Allow importer to set) - How token Light Color should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Intensity (default: Allow importer to set) - How token Color Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Type (default: Allow importer to set) - How token Light Animation Type should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Speed (default: Allow importer to set) - How token Light Animation Speed should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Intensity (default: Allow importer to set) - How token Light Animation Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bar Display Mode (default: Owner) - The default Display Bars mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Bar 1 Attribute (default: attributes.hp) - The default token bar 1 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Bar 2 Attribute - The default token bar 2 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Scale - The default token scale for imported tokens.
- Convert Token Vision Ranges to Metric (default: false) - Whether or not token vision range units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
- Convert Speeds to Metric (default: false) - Whether or not object speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Import (Options & Features)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported option/feature.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not optional feature speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Additional Data Compendiums (default: dnd5e.classfeatures) - A comma-separated list of compendiums that the optional feature importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported optional features.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported optional features.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, an optional feature’s text will be imported as item description.
¶ Import (Psionics)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported psionic.
Possible options are:- None
- Limited
- Observer
- Owner
- Psi Points Resource - The resource consumed by psionics.
Possible options are:- resources.primary
- resources.secondary
- resources.tertiary
Psi Pointssheet item- Custom (see below)
- Psi Points Custom Resource - The name of the custom resource to use if
Customis selected forPsi Points Resource, above. This supports modules that expand the number of available sheet resources, such as5e-Sheet Resources Plus(which adds e.g.resources.fourth,resources.fifth, …). - Import as Spells (default: false) - If enabled, psionics will be imported as spells, rather than features.
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported psionic.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported psionic.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a psionic’s text will be imported as item description.
¶ Import (Race Features)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported race feature.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Races)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported race.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not race speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Additional Data Compendiums (Races) (default: dnd5e.races) - A comma-separated list of compendiums that the race importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Additional Data Compendiums (Features) (default: dnd5e.races) - A comma-separated list of compendiums that the race importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported races.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported races.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a race’s text will be imported as item description.
¶ Import (Recipes)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported recipe.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Rules)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported rule.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Import (Spells)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported spell.
Possible options are:- None
- Limited
- Observer
- Owner
- Prepare Actor Spells (default: true) - Whether or not spells that are imported to actor sheets should be prepared by default.
- Prepare Spell Items (default: false) - Whether or not spells that are imported to the items directory should be prepared by default.
- Actor Spell Preparation Mode (default: Prepared) - The default spell preparation mode for spells imported to actor sheets.
Possible options are:- (None)
- Always Prepared
- Prepared
- Innate Spellcasting
- Pact Magic
- Auto-Detect Actor Spell Preparation Mode (default: true) - If enabled, the default spell preparation mode for spells imported to actor sheets (as defined by
Actor Spell Preparation Mode) may be automatically overridden, e.g.pact magicis automatically used when importing to a warlock. - Spell Item Preparation Mode (default: Prepared) - The default spell preparation mode for spells imported to the items directory.
Possible options are:- (None)
- Always Prepared
- Prepared
- Innate Spellcasting
- Pact Magic
- Use Spell Points (default: Disabled) - If enabled, imported spells which would use spell slots will instead be marked as
at willand set to consume an a sheet or feature resource. (TheSpell Pointsvariant rule can be found in the DMG, page 288.)
Possible options are:- Disabled
- Enabled
- Enabled, but Use 99 Slots: If enabled, an imported spells will retain its
Spell Preparation Modein addition to consuming aSpell Pointssheet/feature resource. This improves compatibility with many sheets and modules. To allowunlimitedspellcasting at each spell level, a character’s spell slots for each level will be set to 99.
- Spell Points Resource - The resource consumed by spells imported with
Use Spell Pointsenabled.
Possible options are:- resources.primary
- resources.secondary
- resources.tertiary
Spell Pointssheet item- Custom (see below)
- Spell Points Custom Resource - The name of the custom resource to use if
Customis selected forSpell Points Resource, above. This supports modules that expand the number of available sheet resources, such as5e-Sheet Resources Plus(which adds e.g.resources.fourth,resources.fifth, …). - Include Caster Classes in Spell Description (default: false) - If enabled, an imported spell’s description will include the list of classes which have the spell on their spell list.
- Convert Spell Ranges and Areas to Metric (default: false) - Whether or not spell range/area units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres; 1 mile ≈ 1.6 kilometres).
- Apply Class Filter when Opening on Actor (default: true) - If enabled, and the importer is opened from an actor, the spell list will be filtered according to that actor’s current class(es).
¶ Advanced
- Additional Data Compendiums (default: dnd5e.spells) - A comma-separated list of compendiums that the Spell Importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Replacement Data Compendiums - A comma-separated list of compendiums that the Spell Importer will attempt to pull spells from, rather than using the data Plutonium would otherwise generate. This is useful when the Spell Importer is used by other importers, e.g. when the Creature Importer is adding spells to newly-created actors.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported spells.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported spells.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a spell’s text will be imported as item description.
- School Default Image Fallback (default: true) - If enabled, when importing a spell which has no well-defined image, use a default image based on the school of the spell. If disabled, a generic black and white image will be used as a fallback instead.
- Use Spell Points (NPCs) (default: Disabled) - If enabled, a spell imported to an NPC which would use spell slots will instead be marked as
at willand set to consume an a sheet or feature resource. (TheSpell Pointsvariant rule can be found in the DMG, page 288.)
Possible options are:- Disabled
- Enabled
- Enabled, but Use 99 Slots: If enabled, imported spells will retain their
prepared/etc. types in addition to consuming aSpell Pointssheet/feature resource. This allows easier organisation of spells, and better compatibility with many modules. To allowunlimitedspellcasting at each spell level, a character’s spell slots for each level will be set to 99.
¶ Import (Table)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported table.
Possible options are:- None
- Limited
- Observer
- Owner
¶ Advanced
- Additional Data Compendiums (default: dnd5e.tables) - A comma-separated list of compendiums that the Table Importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
¶ Import (Traps)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported trap.
Possible options are:- None
- Limited
- Observer
- Owner
- Token Name Display Mode (default: Owner Hover) - The default Display Name mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Disposition (default: Hostile) - The default Token Disposition mode for imported tokens.
Possible options are:- Use game setting
- Hostile
- Neutral
- Friendly
- Token Lock Rotation (default: Allow importer to set) - The default Lock Rotation mode for imported tokens.
Possible options are:- Use game setting
- Allow importer to set
- Enable Token Vision (default: Enabled) - Enable vision for tokens.
Possible options are:- Use game setting
- Disabled
- Enabled
- Token Dim Vision Distance (default: Allow importer to set) - How token Dim Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Vision Distance (default: Allow importer to set) - How token Bright Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Sight Angle (default: Allow importer to set) - How token Sight Angle (Degrees) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Dim Light Radius (default: Allow importer to set) - How token Dim Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Light Radius (default: Allow importer to set) - How token Bright Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Emission Angle (default: Allow importer to set) - How token Light Emission (Angle) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Color (default: Allow importer to set) - How token Light Color should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Intensity (default: Allow importer to set) - How token Color Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Type (default: Allow importer to set) - How token Light Animation Type should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Speed (default: Allow importer to set) - How token Light Animation Speed should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Intensity (default: Allow importer to set) - How token Light Animation Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bar Display Mode (default: Owner) - The default Display Bars mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Bar 1 Attribute (default: attributes.hp) - The default token bar 1 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Bar 2 Attribute - The default token bar 2 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Scale - The default token scale for imported tokens.
- Convert Token Vision Ranges to Metric (default: false) - Whether or not token vision range units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Import (Vehicle Upgrades)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported vehicle upgrades.
Possible options are:- None
- Limited
- Observer
- Owner
- Convert Speeds to Metric (default: false) - Whether or not vehicle upgrade speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
¶ Advanced
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported vehicle upgrades.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported vehicle upgrades.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Import Text as Description (default: true) - If enabled, a vehicle upgrade’s text will be imported as item description.
¶ Import (Vehicles)
TODO: Add description
¶ Standard
- Default Permissions (default: None) - The default (i.e. used for all players unless a player-specific permission level is set) permissions for an imported vehicle.
Possible options are:- None
- Limited
- Observer
- Owner
- Token Name Display Mode (default: Owner Hover) - The default Display Name mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Disposition (default: Hostile) - The default Token Disposition mode for imported tokens.
Possible options are:- Use game setting
- Hostile
- Neutral
- Friendly
- Token Lock Rotation (default: Allow importer to set) - The default Lock Rotation mode for imported tokens.
Possible options are:- Use game setting
- Allow importer to set
- Enable Token Vision (default: Enabled) - Enable vision for tokens.
Possible options are:- Use game setting
- Disabled
- Enabled
- Token Dim Vision Distance (default: Allow importer to set) - How token Dim Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Vision Distance (default: Allow importer to set) - How token Bright Vision (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Sight Angle (default: Allow importer to set) - How token Sight Angle (Degrees) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Dim Light Radius (default: Allow importer to set) - How token Dim Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bright Light Radius (default: Allow importer to set) - How token Bright Light Radius (Distance) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Emission Angle (default: Allow importer to set) - How token Light Emission (Angle) should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Color (default: Allow importer to set) - How token Light Color should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Intensity (default: Allow importer to set) - How token Color Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Type (default: Allow importer to set) - How token Light Animation Type should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Speed (default: Allow importer to set) - How token Light Animation Speed should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Light Animation Intensity (default: Allow importer to set) - How token Light Animation Intensity should be set.
Possible options are:- Use game setting
- Allow importer to set
- Token Bar Display Mode (default: Owner) - The default Display Bars mode for imported tokens.
Possible options are:- Use game setting
- None
- Control
- Owner Hover
- Hover
- Owner
- Always
- Token Bar 1 Attribute (default: attributes.hp) - The default token bar 1 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Bar 2 Attribute - The default token bar 2 attribute for imported tokens.
- Use game setting
- Use one of many custom values
- Token Scale - The default token scale for imported tokens.
- Convert Token Vision Ranges to Metric (default: false) - Whether or not token vision range units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres).
- Convert Speeds to Metric (default: false) - Whether or not vehicle speed units should be converted to an approximate metric equivalent (5 feet ≈ 1.5 metres; 1 mile ≈ 1.6 kilometres).
- Import Fluff to Description (default: true) - If enabled, any fluff text which is available for a vehicle will be imported into that vehicle’s description.
- Include Fluff Image in Description (default: false) - If enabled, any fluff image which is available for a vehicle will be imported into that creature’s description.
¶ Advanced
- Additional Data Compendiums - A comma-separated list of compendiums that the vehicle importer will attempt to pull additional data (including art) from rather than use the default Plutonium icons.
- Use Token Image as Portrait (default: false) - If enabled, a vehicle’s token image will be preferred over its portrait image when populating its sheet portrait during import.
- Override Effect
DisabledValue (default: Allow importer to set) - If set, overrides theDisabledvalue present on any effects tied to imported vehicles.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
- Override Effect
TransferValue (default: Allow importer to set) - If set, overrides theTransfer to Actorvalue present on any effects tied to imported vehicles.
Possible options are:- Allow importer to set
- Set to
False - Set to
True
¶ Journal Entries
TODO: Add description
¶ Standard
- Enable URL Entries (default: false) - Add a
Set URLcontext menu option to journal entry directory items, allowing the contents of the journal item to be replaced with embedded web content (Google Doc, reference page, YouTube video, etc.). - Enable Journal Embeds (default: false) - Add custom syntax to journal entries, which allows other journal entries to be embedded. This syntax is similar to that used to link a journal entry; simply prepend
Embedto a content link. For example,@JournalEntry[Entry Name]would become@EmbedJournalEntry[Entry Name]. - Auto-Expand Journal Embeds (default: true) - If the
Enable Journal Embedsoption is enabled, this determines whether or not the embedded content is expanded by default.
¶ Miscellaneous
TODO: Add description
¶ Advanced
- Skip Backend Check (default: false) - Avoid sending a network request during module initialisation to check if the modded Plutonium backend is installed.
¶ Rivet
TODO: Add description
¶ Standard
- Target Actor - The ID of an actor to which Rivet content should be imported.
- Display Extension Detected (default: true) - Adds a
paper planeicon to the Foundryanvillogo in the top-left corner of the screen if Rivet is detected.
¶ Text and Tags
TODO: Add description
¶ Standard
- Enable Content @tag Links (default: true) - Add custom syntax to journal entries, which enables an approximation of 5etools @tag syntax. This syntax is of the form
@tagName[name|source|...]. For example,@creature[goblin]{goblins!}could be used to insert the linkgoblins!which, when clicked, would load a (temporary) Goblin actor via the importer. For a complete list of available tags, see the 5etools Renderer Demo page (https://5e.tools/renderdemo.html). - Enable Hover Popups for
@tagLinks (default: false) - If links rendered from @tag syntax should display popups when hovered. - Roll Items Linked by @ActorEmbeddedItem on Click (default: false) - If enabled, clicking a rendered @ActorEmbeddedItem tag will roll the linked embedded item. If disabled, clicking the tag will open the item’s sheet instead. Note that SHIFT-click will roll the linked embedded item in either case.
¶ Tokens
TODO: Add description
¶ Standard
- Display Missing Health (default: false) - This allows players to see
damage dealtto a token, without revealing the token’s total health. If enabled, each token’s missing health is displayed as a number in the bottom-right corner of the token. - Display Missing Health
WoundedThreshold (default: 0.5) - The health-loss threshold at which the Missing Health text turns red. - Missing Health Below Token (default: false) - If the Missing Health text should be displayed beneath a token, rather than as an overlay.
- Font Size Multiplier - A multiplier which is applied to token nameplate/tooltip font size, e.g. a value of
0.5will decrease token nameplate/tooltip font size by half. - Allow Text Wrap (default: Use Foundry default) - If enabled, token nameplate/tooltip text will wrap.
Possible options are:- Use Foundry default
- Disabled
- Enabled
- Text Wrap Max Width Multiplier - A multiplier which is applied to token nameplate/tooltip text wrapping maximum size, e.g. a value of
0.5will force token nameplates/tooltips to wrap at half their usual length. The base value to which this multiplier is applied is:2.5 × token width. - NPC HP Roll Mode (default: None) - Determines whether or not token HP, for NPC tokens which are not linked to their actor’s data, should be rolled upon token creation. If a mode other than
Noneis selected, and the token has a valid HP dice formula, the token will roll for HP. For example, a Goblin (7 HP; formula is 2d6) could be created with anywhere between 2 and 12 HP (inclusive).
Possible options are:- None: Do not roll NPC token health.
- Standard Roll
- GM Roll
- Blind Roll
- Self Roll
- Hidden Roll: Roll NPC token health, but do not post the result to chat.
- Minimum Value: Use the minimum possible roll value.
- Maximum Value: Use the maximum possible roll value.
- Disable Animations (default: false) - Disable token animations.
¶ Hacks
- Avoid Disabling Animations for Ruler Movement (default: true) - Suppresses the
Disable Animationsoption for a token being moved via ruler waypoints (i.e. when CTRL-dragging from a token and pressing SPACE). Note that dismissing the ruler during the move will end this suppression.
¶ Tools
TODO: Add description
¶ Standard
- Ignore Types When Deduplicating (default: false) - If enabled, the Collection Deduplicator will ignore entity types, treating e.g. a PC sheet and an NPC sheet with the same name as a set of duplicates.
- Minimum Permission Level for Polymorph Tool (default: None) - Actor
Polymorphbuttons will be hidden for any user with a role less than the chosen role.
Possible options are:- None
- Player
- Trusted
- Assistant
- Gamemaster
- Cheater (Disable Feature)
- Minimum Permission Level for Other Actor Tools (default: None) - Actor
Feature/Spell Cleaner,Prepared Spell Mass-Toggler,etc. buttons will be hidden for any user with a role less than the chosen role.
Possible options are:- None
- Player
- Trusted
- Assistant
- Gamemaster
- Cheater (Disable Feature)
- Minimum Permission Level for Other Table Tools (default: None) - Table
Row Cleanerbutton will be hidden for any user with a role less than the chosen role.
Possible options are:- None
- Player
- Trusted
- Assistant
- Gamemaster
- Cheater (Disable Feature)
¶ UI
TODO: Add description
¶ Standard
- Streamer Mode (default: false) - Remove identifiable 5etools/Plutonium references from the UI, and replaces them with
SRD Enhanced. - Enable Sheet Popout Buttons (default: true) - Add a
Popoutbutton to sheet headers, which opens the sheet as a popup browser window. - Compact Header Buttons (default: true) - Combine the Plutonium-specific header buttons into a single dropdown, and re-style other header buttons to match.
- Compact Directory Buttons (default: true) - Reduce the height of
Create X/Create Folderbuttons in the directory, to offset the additional space requirements of Plutonium’s UI. - Compact Chat (default: true) - Make various tweaks to the appearance of chat, in order to fit more on-screen. Hold down SHIFT while hovering over a message to expand it, revealing its header and delete button.
- Compact Scenes Directory (default: true) - Reduce the height of scene thumbnails in the Scenes Directory, to fit more on-screen.
- Compact Actors Directory (default: true) - Reduce the height of Actors Directory directory items, to fit more on-screen.
- Compact Items Directory (default: true) - Reduce the height of Items Directory directory items, to fit more on-screen.
- Compact Journal Entries (default: true) - Reduce the height of Journal Entries directory items, to fit more on-screen.
- Compact Rollable Tables (default: true) - Reduce the height of Rollable Tables directory items, to fit more on-screen.
- Compact Card Stacks (default: true) - Reduce the height of Card Stacks directory items, to fit more on-screen.
- Compact Macros (default: true) - Reduce the height of Macro directory items, to fit more on-screen.
- Hide Directory Buttons (default: false) - Hide the Plutonium directory buttons.
- Prepend Active Scene Name to Browser Tab Name (default: true) - Sets the browser tab name to be that of the currently-active scene.
- Tab Name Suffix - Requires the
Name Browser Tab After Active Sceneoption to be enabled. A custom name suffix to append to the scene name displayed in the tab (separated by a Foundry-style bullet character). - Display Detected Backend (default: true) - Adds a cool green hacker tint to the Foundry
anvillogo in the top-left corner of the screen if Plutonium’s backend is detected. - Enhance Active Effect Config UI (default: true) - Adds a list of potential active effect attribute keys to the Configure Active Effect window’s
Effectstab, and a field for configuring priority. - Add
Deleteto Navbar Scene Context Menu (default: true) - Adds aDeleteoption to the context menu found when right-clicking a scene in the navigation bar. Note that this does not include the currently-active scene.
¶ Hacks
- Fast Animations (default: false) - Increase the speed of various UI animations.
- Fix ESC Key (default: true) - Bind the
Escapekey to (in this order): de-select active input fields; de-select selected canvas elements; close context menus; close individual windows in most-recently-active-first order; toggle the main menu. - Add
Open Game MenuButton ifFix ESC KeyIs Enabled (default: true) - Add an alternateOpen Game Menubutton to the Settings tab if theFix ESC KeyConfig option is enabled. This allows you to quickly open the main menu without first having to close all open windows. - Fix Freehand Drawing Minimum Distance (default: true) - Reduce the minimum mouse movement distance required to start a freehand drawing.
- Render >3 Levels of Folder Nesting (default: true) - If enabled, Foundry’s default folder nesting limit (of 3) will be bypassed, for the purpose of rendering directories. Note that this does not necessarily allow you to create additionally-nested folders without using the game API.
- Wrap Long Folder Names (default: false) - Wrap long folder names over multiple lines, instead of clipping the name.
- Allow Popout Chaining (default: true) - Automatically pop out apps opened from within popped-out apps. If disabled, apps opened from within popped-out apps will appear in the main window, instead.
- Suppress
Missing Roll DataNotifications (default: true) - If enabled, notification warning messages of the formThe attribute <X> was not present in the provided roll data.will be suppressed, and logged as console warnings instead. - Minimize Actor/Item Re-Renders (default: false) - If enabled, actor/item sheet re-rendering will be skipped where possible. This may reduce UI flickering, and may reduce unexpected input deselection when tabbing or clicking through fields. It may also horribly break your game, and is not expected to work with anything except default dnd5e sheets. Use with caution.
- Default Resizeable Applications (default: false) - If enabled, applications will be resizeable by default. Note that specific applications may still override this.
¶ Advanced
- Hide GM-Only Config (default: true) - If enabled, a player viewing the config will see only the limited subset of settings they are allowed to modify. If disabled, a player viewing the config will see all settings, regardless of whether or not they can modify those settings.
- Disable Large Import Warning (default: false) - Disable the warning confirmation dialogue shown when importing a large number of entities.