Plutonium allows you to rapidly import D&D 5e content into your games, such as items, classes, and creatures. Both core and homebrew content are supported for importing.
5eTools, Plutonium, and Better20 are intended as an easily-accessible digital reference for products you already own. Please ensure you only access content in accordance with your local laws. Also keep in mind, that this wiki, is for the site code and plutonium module, and that Tercept (owner of this wiki) personally has no direct affiliation with 5e.Tools (the website and its operations).
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:
This is Plutonium’s primary feature: importing 5eTools-compatible content into your world. Plutonium can prepare and fill out almost any type of content, from creatures to tables. However, before we go any further, let’s first quickly cover some important information.
With the introduction of the D&D 5e 2024/2025 rule set, otherwise known as D&D 5.5e or One D&D, many Dungeon Masters are preferring to use the 2014 ruleset instead. Starting with Foundry’s DND v4.X system version the 2024 rules were implemented and made the default. Plutonium followed suit with it’s v2 release. Both the Foundry D&D system and the Plutonium Module allow you to prefer the 2014 ruleset, with Plutinum’s default setting to follow the System Setting.
In the settings menu, select Configure Settings. In the left-hand navigation pane select Dungeons & Dragons Fifth Edition, and then change the Rules Version to Legacy Rules (2014).
As a Dungeon Master you may want to prohibit content from being available to your players. This can be done from Plutonium’s World Content Blocklist tool which can be accessed from any directory, and clicking Plutonium’s 💼 button.
You will be prompted with the Source Selection Window. Select which sources you would like to block content from. Anything published by the Wizards of the Coast will be contained in the “5eTools” selection. Click the confirm button.
You will be shown the Blocklist. From here, you can block whole sources, categories under that source, or specific entries in the source. The example below is the blocklist which blocks all 2024 content as of 9 January 2025.
This was achieved by selecting each book under the “Source” drop down field and then clicking the “Add to Blocklist” button.
When importing classes with that blocklist enabled the default classes and subclasses look now like the following image:
With multiple worlds or games, it may be beneficial to export your blocklist and import it in a new world to save the trouble of re-selecting each source again. This can be done on the blocklist page under the Source dropdown selection. A json file will be downloaded if you choose export. A file browser will open if you choose import for you to upload an existing blocklist from your system.
Below is the contents of the content-blocklist.json
file which blocks the 2024 D&D 5e ruleset. You can copy this and save it as a json file on your system if you wish to use this in your worlds.
{
"fileType": "content-blocklist",
"moduleVersion": "2.2.3",
"blocklist": [
{
"displayName": "*",
"hash": "*",
"category": "*",
"source": "XDMG"
},
{
"displayName": "*",
"hash": "*",
"category": "*",
"source": "XScreen"
},
{
"displayName": "*",
"hash": "*",
"category": "*",
"source": "XMM"
},
{
"displayName": "*",
"hash": "*",
"category": "*",
"source": "XPHB"
}
]
}
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.
Navigate to one of the following directories:
Click the ‘Plutonium Import’ button near the top to open the import wizard.
Once everything is set up correctly, you are ready to open the Importer using the button on the bottom-right. To find the content you want, use the search bar or the filters; both are at the top. If something looks missing, pay attention to the filters—it’s possible that some are hidden by default! These filters work like the ones on the 5eTools site.
You can preview the statblock in the Importer using the ➕ button. Once you’ve found your statblock, either select its checkbox on the left (to import many at once or for further configuration), or press the ▶ button to import immediately with no additional configuration.
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.
Importing directly into an actor is always the preferred method when customising player characters. Dragging from a directory or compendium should be generally avoided where possible.
Use the three-dot menu button at the top of a character sheet to access the ‘Plutonium import’ button. The procedure is otherwise more or less identical to the one described above.
Rivet is a browser extension for Firefox and Chrome (may work with other Chromium-based browsers too!) that allows you to send statblocks from 5eTools directly to Foundry, bypassing the Import Wizard and its associated hassle.
When Rivet is enabled, you’ll see the ‘Transfer via Rivet’ icon on 5eTools statblocks. When clicked, it will transfer that content into your world. It can alternatively import directly onto a specific actor, which you can configure in Plutonium’s Config Editor.
Rivet source code is included with every plutonium installation and can be found at the root folder of the plutonium module
Rivet can only transfer content if you have both 5eTools and Foundry open in the same browser.
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.
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
The Art Repo is now largely defunct due to multiple factors, some of which outside anyone’s control. Using it is no longer recommended.
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)
Blue only includes
Red excludes
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:
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.
This allows you to move several items at a time into and from various locations in the folders.
This tool allows for rapid modification of permissions in bulk.
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.
This allows you to filter and target the entries in a folder to select and remove entries in bulk.
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.
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
This feature reduces the render times for some animations created from the UI. This feature is part of the Config Editor’s UI section.
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.
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
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.
Plutonium adds support for evaluating basic dice/roll expressions in active effect changes, allowing for changes of the form [email protected]
.
Note that this feature is disabled in favour of Dynamic Active Effect’s (DAE) equivalent if DAE is installed and active.
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.
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.
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
This removes content rapidly. (Useful for when you need to troubleshoot the importing)
This feature allows embedding 5eTools links inside of Journal Entries which then can be used to quickly import those objects.
This feature allows for generating and importing loot from encounters.
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.
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
This is an experimental feature that automatically rolls all the items of a correctly formatted multiattack action from a creature.
Plutonium allows you to define the tab it appears within in the browser. Setting it be the name of the currently active screen.
The Popout button allows the player/GM the ability to open a new browser window for the Actor’s sheet.
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
Plutonium Import will now be named simply Import
In the Import Wizard; 5etools will now be named SRD
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.
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.
Plutonium includes sufficient data by default to satisfy the degree of automation that the core system uses. For instance, a spell should automatically have its saving throw type, DC, and damage included. However, if you want a richer and more complex degree of automation, you will to turn to modules. One of the most popular modules offering this is Midi-QoL.
Using an additional module, Plutonium Addon: Automation (PAA), Plutonium can import content with automation data attached to properly interface with several modules in the ‘Midi-QoL ecosystem’. This allows you to correctly handle temporary bonuses, reoccurring effects, conditional effects, and more.
Since Midi-QoL is an ‘advanced’ module, PAA is not directly advertised to prevent users from overwhelming themselves. To learn about PAA, first install Midi-QoL and its dependencies, and activate them along with Plutonium in your world. You will receive a chat message with further information—be sure to read it before progressing further!
Midi-QoL is a very powerful module, but it can be complicated and opaque to a new user. Ensure that you’re comfortable with Foundry’s basics before throwing yourself at it, and be prepared to expend a bit of effort on your first set-up.
Also be sure you then understand Midi-QoL’s basics before installing other interfacing modules! In general, it’s better to take the time to learn once than deal with an ongoing struggle due to uncertainty—read a module’s description and
README
file before use.
PAA contains relatively few automations in itself. For maximum effectiveness, consider using one or more of its integrations.
The Charactermancer 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.
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
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
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).
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
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
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
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
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
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.
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 can’t see the polymorpher in the three-dot menu, check the following setting: Game Settings > System settings > Allow Polymorphing.
From there choose the options of how the transformation will occur: