Remember to NOT mention Plutonium in any public FoundryVTT space, such as their Discord server. This also includes hosting providers such as The Forge.
Plutonium support will only be available in the 5etools Discord server
Here you will find instructions to install Plutonium in FoundryVTT. Manifest URL will be sufficient for most installs, but for hosting services that block it you can use the Manuall install.
Be aware that Plutonium (normally) works with the latest STABLE FoundryVTT release, not ALPHA or BETA. As a general rule, make sure your D&D5e system is up to date as well, unless it has been released very recently. To know the exact compatible versions, check the #plutonium-general
pins in the 5etools Discord server.
You may also want to install Rivet for quick importing directly from 5eTools webpages.
Using FoundryVTT’s native way of installing modules is the fastest and easiest.
module.json
link.If everything went correctly, you should see Plutonium in the Add-ons listing. Remember to activate the module once inside the game.
Finally, if you want to use the Art Repository function inside the game, make sure you have Modified the Backend.
C:\Users\<You>\Appdata\Local\FoundryVTT\Data\modules\plutonium
directoryYou can also paste this into the Explorer address bar
%localappdata%/FoundryVTT
to open into the directory quickly.
Or right mouse click on the FoundryVTT’s icon on the taskbar and choose Browse User Data
$foundryDATAdir/Data/modules/
Users ▸ Username ▸ Library ▸ Application Support ▸FoundryVTT ▸ Data ▸ modules
...Data\modules\plutonium
and NOT ...Data\modules\Plutonium
(it is case sensitive) and isn’t nested under a subdirectory.You have successfully installed Plutonium. Remember to activate the module once inside the game.
Finally, if you want to use the Art Repository function inside the game, make sure you have Modified the Backend.
Backend modification requires you to have direct access to Foundry installation files.
This means that if you are using any partnered hosting provider, such as The Forge/FoundryServer/etc., you will NOT be able to do it.
What this does
The modification allows Plutonium to copy files you select to your server, bypassing certain restrictions FoundryVTT has. This addresse some errors from attempting to use the Art Repo, Importing Packages, and issues with Foundry’s included app Electron.
For more information, see the [Backend FAQ])/Plutonium/Plutonium_FAQ#backend)
Copy the plutonium-backend.mjs
file from FoundryVTT\Data\modules\plutonium\server\v9
directory of your installed Plutonium Module, depending on your Operating System:
%appdata%\..\Local\Programs\FoundryVTT\resources\app
Program Files\FoundryVTT\resources\app
/home/$USER/.local/share/FoundryVTT/resources/app
/home/$USER/FoundryVTT/resources/app
/local/FoundryVTT/resources/app
Additionally you can find a linux-only community created bash-script to automate the backend installation here.
This script is provided with no support or assistance; please ensure you have backup of your data.
\Applications
▸ click Show Package Contents
> Resources
> app
> main.mjs
find / -name main.mjs
main.mjs
Locate the main.mjs
file in your installation - it should be in the same folder you copied the plutonium-backend.mjs
file to.
Make a copy of the main.mjs
file, name it backupmain.mjs
If you do not modify the
main.mjs
file correctly, Foundry will crash on startup.
You can delete the modifiedmain.mjs
and renamebackupmain.mjs
tomain.mjs
(If you you made the backup copy), or another way to fix this is to uninstall and reinstall Foundry as a whole.
Open the main.mjs
as an adminstrator and locate the following lines at the end of the file:
init.default({
args: process.argv,
root: root,
messages: startupMessages,
debug: isDebug
})
})();
Select it all, and paste the following instead
await init.default({
args: process.argv,
root: root,
messages: startupMessages,
debug: isDebug
});
(await import("./plutonium-backend.mjs")).Plutonium.init();
})();
Now, make sure you restart the server/close and reopen the Foundry app.
Manifest URL installation may not work.
Some Foundry hosting providers have blocked the Manifest URL install of Plutonium. You will have to manually install the module, using each provider’s feature to do so.
FOR FORGE ▸