Dungeondice
This is a discord bot that aims to become a feature-rich yet easy to use option for rolling dice for TTRPG's online. I aim to keep the logic of the bot detached from discord integration. So the python package is re-usable in other places.
Features
- Roll dice in a discord channel
- Roll privately, either telling others you rolled or not. To simulate the feeling of hearing your DM's dice go behind a screen
- Supports both discord slashcommands for features like ephemeral messages, or regular !commands that feel more responsive
- Roll multiple sets in one go
2x2d20 - Add hints to your dice
d10(piercing)+d8(poison) - Add hints to your complete roll
d8(poison) For damage - Create complex rolls like
2x2d20(poison)+d8(piercing)-4to get two total results
---------------------------------
2d20(poison)+d8(piercing)-4
Total: 35
Details: [[16, 17]33poison, [6]6piercing, [4]4]
---------------------------------
---------------------------------
2d20(poison)+d8(piercing)-4
Total: 19
Details: [[10, 11]21poison, [2]2piercing, [4]4]
---------------------------------
Installation
$ pip install dungeondice
$ DISCORD_TOKEN="$TOKEN" dungeondice
Usage
Run the bot, see the .help command for more details.
Roadmap/TODO
- Start using discord views for nicer layout?
- Templating of rolls per player/discord channel
Metadata
Release files for dungeondice 1.3.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dungeondice-1.3.4.tar.gz | 30.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dungeondice-1.3.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 50.6 kB
Release files / dungeondice-1.3.4.tar.gz
| Download URL | dungeondice-1.3.4.tar.gz |
|---|---|
| Size | 30.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6ef322c88039e5e8f497c95a63c98c3d7f1700df59e79fdd36ee17a8e0fce1f2
|
|
BLAKE2b-256 checksum How to use checksums |
ce34642805fc7c12675c01a169e72bb751e14f72b5e4de665e1644794b89f1cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 11, 2026.
Transparency logRelease files / dungeondice-1.3.4-py3-none-any.whl
| Download URL | dungeondice-1.3.4-py3-none-any.whl |
|---|---|
| Size | 20.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6805c0010ea98268c5a8fa8e92f856aa7ed307d952c8612c12f5f421fcc158bd
|
|
BLAKE2b-256 checksum How to use checksums |
e1da2be21dbf5e9e9bcfddac8d1faa4b23810f80b4a687e1d10cb6af4dd3df28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 11, 2026.
Transparency log