Warning: Hydrogen now it's a closed-source project and this repository will no longer be updated.
Open-source Dungeon Master helper with useful features and a music player for your sessions.
Manage RPG campaigns and role-play characters inside Discord without downloading external tools. You can create campaigns, sheet models, register notes, schedule sessions, generate loot and encounters, play music on voice chats, and many other features with Hydrogen!
Whether you are using a public instance or your own, please consider donating to support Hydrogen's development. You can donate through Nashira Deer's PayPal or GitHub Sponsor.
Warning: The public instance of Hydrogen will end on 30 April 2024 at 15:00.
If you are interested in a public instance of Hydrogen, you can add our official instance, hosted by Nashira Deer, to your Discord server, by clicking here.
Only the methods listed below are officially supported and tested by Nashira Deer. We don't recommend using any other alternatives to build Hydrogen, as it isn't developed to support them.
You can build Hydrogen using docker build -t hydrogen:latest . in a terminal with Docker (Podman not supported) installed and running, after the build is completed, you will have a Docker image ready for use, named "hydrogen:latest".
If you don't want to build your own image, you can use our prebuilt image found on Docker Hub. To run it, you can see our example using Docker Compose.
There are two ways to configure Hydrogen, using the config file or environment variables, remembering that the environment variable is only used if the equivalent field isn't present on the config file.
Hydrogen doesn't create the config file, so you need to download the example from here.
When starting, Hydrogen searches for the config file in $XDG_CONFIG_HOME/hydrogen/config.toml (/etc/hydrogen/config.toml when $XDG_CONFIG_HOME is not set) on UNIX-like platforms or %APPDATA%\Hydrogen\Config.toml (C:\ProgramData\Hydrogen\Config.toml when %APPDATA is not set) on Windows, you can change the path using the command line argument --config-file [path] or the environment variable HYDROGEN_CONFIG_FILE (the environment variable is only considered if the command line argument is not set).
- HYDROGEN_DISCORD_TOKEN: Sets the token that will be used to access Discord. (required)
- HYDROGEN_LAVALINK: Set the list of Lavalink nodes that can be used, read more below. (required)
- HYDROGEN_DEFAULT_LANGUAGE: Sets a new default language to Hydrogen. (optional)
- HYDROGEN_LANGUAGE_PATH: Sets the path where the Hydrogen translation files can be found. (optional)
- HYDROGEN_FORCE_ROLL: Force enables the auto-roll from messages. (optional)
You can see our example using Docker Compose.
value = single-node *(";" single-node)
single-node = host "," password ["," tls]
host = ip ":" port
tls = "true" / "enabled" / "on"
Hydrogen is a project by Nashira Deer, licensed under GNU General Public License v3.