This page is still under construction
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.
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 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 +@abilities.cha.mod
.
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.
These features are best used when running the dnd5e system.
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.
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 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
From there choose the options of how the transformation will occur:
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.
From the Tabletop you’ll want to make sure you are in one of the following:
Click the Plutonium Import button to bring up the Import Wizard.
- 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.
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
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
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.
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.
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.