This page is still under construction
¶ Plutonium: Features
Plutonium allows you to rapidly bring your D&D 5e’s content into your games, such as items, classes and creatures. Both Homebrew and 5e Core content are supported for importing.
As always if you do not legally possess the content, you should not use it. Obey your local laws.
For those familiar with betteR20 for Roll20, Plutonium can be considered a “version 2.0,” containing almost all of the same features, plus plenty more. Some key differences are:
-
Importing directly to character sheets (“Actors” in Foundry nomenclature) is streamlined, and recommended over importing to the directory. This can be considered equivalent to the “Temporary Import” option in betteR20. To-Actor importers can be accessed directly from the menu button in an actor sheet’s header.
-
There is no direct one-to-one equivalent of the “Module Importer/Exporter” from betteR20; adventures and books can be imported, and come with their attached creatures/spells/items/etc., but wall and lighting data is not provided. This is primarily due to a lack of official adventure/book content officially available for Foundry, when compared to Roll20. As an alternative, you may consider kakaroto’s R20Converter, which can be used to transfer Roll20 games (including those imported by betteR20) to Foundry.
¶ Misc Features
Plutonium offers a variety of features for all of its users, which may even be used with non-dnd5e systems. Below is a list of some of those features and how they work.
Note that many of these features are gated behind Plutonium-specific configuration options. Generally, the more disruptive/opinionated changes are disabled by default
¶ Art Repository
The Art Repo is a collection of gaming images for use inside the game. Contains Tokens, Cards, Maps, Map Assets, Portraits, Texture, Effects and other elements When the features loads the items are clustered into “sets” groups of art associated by a specific artist which can be used inside Foundry directly.
This is community supported repository and the developer, nor host of this wiki, can assist in adding or removing content
This feature requires server side modification of the backend (see the installation guide)
- Click upon the Palette icon
- choose to click Browse Repo
- The left hand panel filters by topic
-
Blue only includes -
Red excludes - The Right side panel will list sets of images that correspond to the requirements.
- Click on one of the collections to the right and it will open to the other images
You may want to INVERT your search as the meta-tagging for the images is partial; so several entries will not have their Type/Style/Terrain/etc defined so marking multiple things red may return more results you wouldn’t see when only searching a key tag field.
Once you’ve defined your search, the screen on the right will update with sets including thumbnails.
Choose one of the following options:
-
Add the entire set to the Library -
Download the image set to the local device. -
or you may click upon the set and see individual entries
You have a couple of choices on how to import the image/set from within the Browser:
- Journal (the starting image for a new entry in the journal)
- Scene (a background image for a new scene whose dimensions will mirror that image)
- Token (a token on the map which you may or may not choose to link to an actor sheet)
- Tile (a map asset, either a map tile as is seen with geomorphic tiles, or elements such as rocks/trees/bones that help create ambiance in the tool; or elements for DM’s to Hide (ie a “S” marker to help denote secret doors; “T” for traps; or room numbers to help identify rooms to their journal entries)
After choosing which one you want to use, click and drag that do the desktop (you should see a transparent version of the image drag with you); it will then (after a moment) appear on the desktop
note: for Scenes, when you click and drag it will prompt the creation of a new scene and then move your point of view to that new scene to finish its setup.
¶ Bulk Move
This allows you to move several items at a time into and from various locations in the folders.
¶ Bulk Ownership Editor
This tool allows for rapid modification of permissions in bulk.
¶ Chat Merge
This makes the chat entries (if from the same speaker) not include the heading for their name so that the chat log isn’t so clogged by unnecessary/redundant elements.
¶ Collection Cleaner
This allows you to filter and target the entries in a folder to select and remove entries in bulk.
¶ Compact Mode
Plutonium can modify the UI for the site to reduce the size of elements in the various components so that more appear in the screen at time.
¶ Config Editor
This allows you to remove duplicate content that can often occur from importing or when pulling compendium for/from games and modules.
Click up on the Settings Cog Icon when Plutonium is activated
The configuration window will appear
From the window choose from the left side various features to modify
¶ Config Fast Animation
This feature reduces the render times for some animations created from the UI. This feature is part of the Config Editor’s UI section.
¶ Data Source Selector
This feature allows Gamemasters to limit the sources of where they and/or their players can import content from (whitelisting). It works on the granularity of “files,” and all the data for those entity types are in big files containing every source. If you want to filter it down, you’ll need to use the blocklist (see World Content Blocklist)
Once the setting is applied in the Config Editor you can find the Data Source selector in the folder tool kit.
¶ Directory Deduplicator
This allows you to remove duplicate content that can often occur from importing or when pulling compendium for/from games and modules.
Click on the Tool list Icon
- From the Tool Menu choose Directory Deduplicator
- Click up on the Tool list (OpenTools Icon.png) Icon
- The Directory Deduplicator will pull up a list of items with the same name when opened.
- Either select items manually to delete, or use the filter to select what you wish to delete.
- Click delete at the bottom of the list, or click prune empty folders to do just that.
When using the filter, it is possible to delete separate entities with the same name. (e.g. a journal containing an item named “glowing longsword” with the item’s statistics, and a player handout named “glowing longsword” containing art.) It is recommended you not use this method if you are unsure if you have any items like the example above.
¶ Extended Active Effects Change Syntax
Plutonium adds support for evaluating basic dice/roll expressions in active effect changes, allowing for changes of the form +@abilities.cha.mod.
Note that this feature is disabled in favour of Dynamic Active Effect’s (DAE) equivalent if DAE is installed and active.
¶ Extended Active Effects Configuration UI
A search function is added for active effect keys, and a “priority” field is added, which allows the exact ordering of AE appliaction to be controlled.
Note that this feature is disabled in favour of Dynamic Active Effect’s (DAE) equivalent if DAE is installed and active.
¶ Extended Roll Data
Plutonium adds a @srd5e namespace to roll data, containing (among other things) the following attributes for use in dice rolls/etc.
# `@srd5e.userchar`, as a reference to the current user's character
@srd5e.userchar.name
@srd5e.userchar.id
# ID of the current user
@srd5e.user.id
# `documentName` is the lowercase alpha-numeric-only name of the current document.
# E.g. when rolling a "+1 Longsword" this will be "1longsword".
# The value of this key is always `1`. This allows for expressions of the form: `+(@srd5e.name.eldritchblast * @abilities.cha.mod)`
@srd5e.name.<documentName>
Plutonium also adds an @items key to actor roll data, which (similar to @classes for a player character) contains keys of the form @items.longsword.* for each of the actor’s owned items.
¶ Fix ESC Key
This feature slightly impacts the key bind for the Escape key.
This changes the Escape bind to being (in order)
-
De-select (active input field) -
De-select Canvas Element -
Close context menus -
Close individual windows (From most recently active to oldest) order -
Toggle the Main Menu
¶ Journal Cleaner
This removes content rapidly. (Useful for when you need to troubleshoot the importing)
¶ Journal Embed
This feature allows embedding 5eTools links inside of Journal Entries which then can be used to quickly import those objects.
¶ Loot Generator
This feature allows for generating and importing loot from encounters.
¶ Mass Spell Prepare Tool
The mass spell preparer is a tool to rapidly alter the known/prepared spells for a player, which is much faster than going spell by spell to select or remove what is prepared.
- Click upon the Tooks Icon atop the Actor sheet
- Then choose Prepared Mass Spell Toggler a window will open with the spells known by the character
- A Window will open which you can then select or unselect each spell.
¶ Metric Converter
Plutonium Supports non-imperial measurements when importing content, specifically Monsters, and Items
There are two areas that need to be modified for full metric conversion within the Config Editor
- Import Items -> Convert Item Weight to Metric (eventually ranges)
- Import Spells -> Convert Spell Ranges to Metric
¶ Multiattack Roller
This is an experimental feature that automatically rolls all the items of a correctly formatted multiattack action from a creature.
¶ How to configure it
- Click up on the Settings Cog Icon when Plutonium is activated
- Enable from the Auto-Roll Multiattacks
- Click Save
¶ How to use it
- Go to the Actor’s sheet that has Multiattack
- Clicking upon Multiattack and it will expand
- Click Roll to have it roll all the attacks
¶ Name Browser Tab
Plutonium allows you to define the tab it appears within in the browser. Setting it be the name of the currently active screen.
- Click up on the Settings Cog Icon when Plutonium is activated
- This will open the Config Editor
- Choose the UI section
- From the window, you are able to choose from the left side various features to modify.
- Click upon the Named Browser Tab After Active Scene
- Optional: Set a Suffix for the Name for the tab. The Prefix will be separated by a Foundry-styled bullet character.
¶ Sheet Popout
The Popout button allows the player/GM the ability to open a new browser window for the Actor’s sheet.
¶ Streamer Mode
Streamer mode minimized and reduces the presence of Plutonium. So that your games will not have 5eTools or Plutonium naming on its features. (In helping keep compliance for you to not publicize or advertise the tool)
Click up on the Plutonium Settings Icon to open the config editor
- From the left side, choose the UI
- From the right pane, choose to enable/disable Streamer Mode.
- Refresh the app/browser.
Plutonium Import will now be named simply Import
In the Import Wizard; 5etools will now be named SRD
.webp)
.webp)
¶ Token Missing Health
The feature allows players to see “damage dealt” to 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.
- Right mouse click upon the token;
- Updating the health field, either with a new value; (ie 30) or with a modification (ie +10 or -15)
¶ World Content Blocklist
Blacklist specific classes, feats, races, backgrounds, spells, etc… from various sources. Best used to filter out DND content you do not have legal access to use to prevent you and your players from utilizing that content.
¶ dnd5e-specific Features
These features are best used when running the dnd5e system.
¶ Charactermancer
Note that this is a Patron-only feature.
From the Actor/Character Sheet choose the menu button and then the Charactermancer feature.
A panel of possible sources to pull from opens up to select which sources you own and wish to use.
Choose the sources you plan to use (since build 10 you can use the Homebrew Sources as well (see Homebrew for how to create your own classes; races; feats; items; etc)
Click Confirm and then the Charactermancer Menu will open.
From there choose a tab and progress (Class; Race; Abilities; Background; Starting Equipment or Equipment Shop; Spells; and Feats). At anytime you can Finalize your character and have Charactermancer update your sheet.
¶ Class
Choose a class and subclass from the pull list. (click the filter button to limit options as needed)
After which your class’s specific features may require some choices on skills which you can do there, the details of the class are shown there for you to review before proceeding
Click Next to Proceed
¶ Race
Click to open and select from the pull list which Race/Subrace you wish to use. (click the filter button to limit options as needed)
The Race and its specific information will be presented.
Click Next to Proceed
¶ Abilities
Choose Abilities.
Three options will appear to the left of the charactermancer window, choose from which method you’d like to use (this wiki will not cover the methodologies in any depth, refer to the rules for explanations around each).
- Roll Have the system roll stats which you then assign.
- Standard Array You assign the Matrix
- Point Buy
- Manual
This system does not limit people from making mistakes. (IE you can “overspend” or change the point buy initial pool of value of the charactersheets). The DM will still need to approve and review sheets. It also doesn’t lock you into a specific set of rules. DM oversight is still suggested.
Click Next to Proceed
¶ Background
Click to open and select from the pull list which Background you wish to view/use.
You can then check the options for the background (for Languages, Skills)
Additionally, the characteristics can be chosen or rolled.
Click Next to Proceed
¶ Starting Equipment
Atop this page it gives the option to either roll for staring gold (which will move you to the Equipment Shop) or Manual entry of Gold - which will again move to the Equipment Shop.
Otherwise, each option will have an A, B (sometimes C,D…) option with a button next to it
Click Next to Proceed
¶ Equipment Shop
Your character may have some money. If so the Equipment Shop lists ALL THE ITEMS with costs.
Which is very nice, clicking upon the arrow will add the item to the shopping cart, where you can increment the number of them you’re purchasing, decrease their number or just remove them.
JUST BECAUSE ITS ON THE LIST DOES NOT MEAN YOUR DM WILL ALLOW YOU TO BUY IT/THEM
Note the item, its source and then Check with your DM for permission.
Click Next to Proceed
¶ Spells
If your character has spells, you now can choose which ones from your available spell options, and as many as your class allows for that class/level/background (or feat)
Click the spell you want to learn/prepare and once your available memorization/slots are filled you will no longer be able to choose additional spells.
Click Next to Proceed
¶ Feats
Choose a feat from the list, if the feat grants the choice between learning or increasing proficiency between different skills, or between enhancing attributes. You will be prompted to make a choice.
Review your choices and click Finalize to fillout the charactersheet.
¶ Polymorpher
The polymorphing tool technically isn’t a Plutonium feature, but rather is a QoL/UX improvement for a the polymorphing feature built into DnD5e.
The Polymorphing Icon will appear either in the header row or (if Compact Journal is enabled) in the menu.
If you are not seeing, or getting it, you’ll want to go to settings page, into the Configuration Game Settings; System settings; and choose to enable the Allow Polymorphing
¶ How to change shape
- On the character sheet click the tools and chose polymorpher.
- From the menu select the source(s) to chose the shape from
- Choose the Specific Creature
- The Transforming Actor dialog box will open
From there choose the options of how the transformation will occur:
- Wildshape (the Actor gets the physical characteristics, but not the mental and keeps skills and class abilities)
- Polymorpoh (Poof! they’re now a mirror of that creature)
- Custom - this is self explainatory
¶ How to revert
- When you need to, open the Actor’s sheet.
- A top the sheet - chose << Restore Transformation.
- The original actor will be restored.
¶ Importing
Some people want to import all the content into their D&D 5e game as soon as they get Plutonium. This is not recommended for the following reasons:
🔸 Plutonium’s data is all local. There is no need to import it all ‘just in case’—once you install the module, all the data is there. Images are not, but you can easily preload them all from within Plutonium’s config menu.
🔸 Once data is imported into your game, it becomes stagnant. However, Plutonium’s data is constantly being improved: it gets typo fixes and new features with each update.
🔸 If you import character data directly to the sheet (
3-dot menu button at the top) rather than from a compendium, Plutonium has much more data to feed from and as such has its own workflow. This lets you choose things such as proficiencies, starting inventory, features, subclasses, etc.
🔸 If you import a great number of entries (+1500) directly into your game, this might cause higher loading times to everyone in it. Try to import only the content that you will soon use, or, if you definitely need the content in the game now (e.g. for interactions with other modules), it’s recommended that you use compendiums instead. Plutonium lets you import directly into them.
¶ Importing into a World
From the Tabletop you’ll want to make sure you are in one of the following:
- Actors
- Items
- Journal Entries
- Tables
Click the Plutonium Import button to bring up the Import Wizard.
- Choose Importer - Pick the type of content you want to import.
- Choose Source - Select the source of the content you want to import. They are coded by these symbols:
- WoTC content; Core Rules; Supplements; Unearthed Arcana; Official AL (Extra Life) content; or from Offical WoTC Stream
- These are the custom solutions; a specific direct link URL; or local compatible JSON file.
- Homebrew content maintained at the Homebrew Repository
There can be a lot of content there, so there is a copy of the Filter system to help find a source.
-
Configure and Import - If you chose the "
Custom URL" option as a source, here’s where you would link the file you want to import from.Folder Path: Determines the folder in which the content will end up in. By default it will create a folder, but you can change its name, add deeper folderization, or choose an existing folder.
Once everything is set up correctly, you are ready to open the Importer. To find the content you want, either use the search bar, or change the filters at the top. These filters work like the ones on the 5eTools site, so for more information check the Filters page.
¶ Importing into an Actor
An “Actor” in FoundryVTT is a character sheet. It could be a player character sheet, non-player character sheet, or a vehicle sheet. Importing to any of them occurs the same way. You can import class levels, subclass features, other options and features, items, spells, and more.
If you import character data directly to the sheet rather than from a compendium, Plutonium has much more data to feed from and as such has its own workflow. This lets you choose things such as proficiencies, starting inventory, features, subclasses, etc.
Keep in mind any player with “Owner” sheet permission can access this importer
- Open the Actor sheet to which you want to import into.
- Select your sources and apply any filters.
- - WoTC content; Core Rules; Supplements; Unearthed Arcana; Official AL (Extra Life) content; or from Offical WoTC Stream
- - These are the custom solutions; a specific direct link URL; or local compatible JSON file.
- - Homebrew content maintained at the Homebrew Repository
-
Configure and Import: If you chose the “Custom URL” option as a source, here’s where you would enter the direct link to the file which you want to import. You can also choose if the Wizard stays open once you open the importer proper.
-
Open Importer
¶ Importing Class Levels
¶ Importing Items
¶ Importing Spells
¶ Importing Races
¶ Importing Feats
¶ Importing with Rivet
Rivet is an extension for use on Chrome (and chromium-based browser) or Firefox; it use it you’ll need to install Rivet.
Rivet requires you to have Foundry Open in the same browser on a different tab than 5etool’s session.
When Rivet is active you’ll see the Transfer via Rivet icon hich when clicked will transfer the active content into Foundry’s Journal; or in a specific Actor, setup in the Config Editor.
¶ Import Tables
¶ Equipment Shop
¶ Compendiums
The data in a world is loaded for every player as soon as the game is loaded. This can be troublesome for people with slow internet connections if there’s much data involved, Compendiums are the solution for this. They are collections of data that you can pull from whenever you want, but they are not part of the “system” data until they are called forth - thus, easing the load for everyone involved. To import data into a Compendium, make sure there is a compendium, unlocked, and available of the appropriate type. If this is not the case … well, that error will tell you.
¶ Quick Insert
This requires a third party module called Quick Insert, which can be found here: https://foundryvtt.com/packages/quick-insert
Plutonium is compatible with the Quick Insert module. For more information on how to use the module and feature, visit the Quick Insert module page. This feature is a great substitute over importing into compendiums.