{"id":43878763,"url":"https://github.com/moussetc/mattermost-plugin-dice-roller","last_synced_at":"2026-02-06T15:08:14.352Z","repository":{"id":53906876,"uuid":"120093692","full_name":"moussetc/mattermost-plugin-dice-roller","owner":"moussetc","description":"A Mattermost plugin to add a slash command for in-chat dice rolling","archived":false,"fork":false,"pushed_at":"2025-05-04T13:33:51.000Z","size":296,"stargazers_count":14,"open_issues_count":5,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-04T13:36:52.812Z","etag":null,"topics":["go","mattermost-plugin"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moussetc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-02-03T13:30:27.000Z","updated_at":"2025-05-04T13:23:24.000Z","dependencies_parsed_at":"2024-06-19T02:07:25.426Z","dependency_job_id":null,"html_url":"https://github.com/moussetc/mattermost-plugin-dice-roller","commit_stats":{"total_commits":58,"total_committers":7,"mean_commits":8.285714285714286,"dds":0.5344827586206897,"last_synced_commit":"30a481938f6d52b6782ef7c2ec150c3214fc9417"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/moussetc/mattermost-plugin-dice-roller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moussetc%2Fmattermost-plugin-dice-roller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moussetc%2Fmattermost-plugin-dice-roller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moussetc%2Fmattermost-plugin-dice-roller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moussetc%2Fmattermost-plugin-dice-roller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moussetc","download_url":"https://codeload.github.com/moussetc/mattermost-plugin-dice-roller/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moussetc%2Fmattermost-plugin-dice-roller/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29165912,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T14:37:12.680Z","status":"ssl_error","status_checked_at":"2026-02-06T14:36:22.973Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","mattermost-plugin"],"created_at":"2026-02-06T15:08:13.573Z","updated_at":"2026-02-06T15:08:14.344Z","avatar_url":"https://github.com/moussetc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mattermost-plugin-dice-roller [![Build CI](https://github.com/moussetc/mattermost-plugin-dice-roller/actions/workflows/ci.yaml/badge.svg)](https://github.com/moussetc/mattermost-plugin-dice-roller/actions/workflows/ci.yaml)\n\n\n**Maintainer:** [@moussetc](https://github.com/moussetc)\n\nThis Mattermost plugin adds a `/roll` slash command to roll all kinds of virtual dice.\n\n## Examples\n- Use `/roll help` to show examples.\n- Use `/roll 20`, `/roll d20` or  `/roll 1D20` to roll a 20-sided die:\n\n![demo](doc/demo_20.png)\n\n- Use `/roll 5d6` to roll five 6-sided dice:\n\n![demo](doc/demo_5d6.png)\n\n- Use `/roll 5D6+3` to roll five 6-sided dice and add 3 to the result of each dice:\n\n![demo](doc/demo_5d6_dice_modifier.png)\n\n- Use `/roll 5D6 +3` (note the space) to roll five 6-sided dice and add 3 to the total:\n\n![demo](doc/demo_5d6_sum_modifier.png)\n\n- Combine different dice to roll at the same time: `/roll 5 d8 13D20` to roll one 5-sided die, one 8-sided die and thirteen 20-sided dice:\n\n![demo](doc/demo_many_dice.png)\n\n- **[Up to version 3.0.x]** Add `sum` at the end to sum results automatically: `/roll 5 d8 13D20 sum`. In later versions, the sum is always displayed without having to add `sum`.\n\n\n## Compatibility\n\nUse the following table to find the correct plugin version for your Mattermost server version:\n\n| Mattermost server | Plugin release | Incompatibility |\n| --- | --- | --- |\n| 7.10 and higher | v3.2.x+ | ℹ️ This version might be compatible down to 6.7 versions but has only been tested on 7.10+ |\n| 5.20 to 7.10 | v3.1.x+ | breaking plugin manifest change |\n| 5.12 to 5.19 | v3.0.x | breaking plugin API change |\n| 5.2 to 5.11 | v2.x.x | |\n| 4.6 to 5.1 | v1.x.x | |\n| below | *not supported* |  plugins can't create slash commands |\n\n## Installation and configuration\n\n\u003e [!TIP]\n\u003e This plugin was for a few years available in the official Mattermost marketplace, however the Mattermost team [decided to stop hosting community plugins in the marketplace](https://mattermost.atlassian.net/browse/MM-53030) in September 2023, so however you installed your current version, you will need to follow the manual installation steps below.\n\n1. Go to the [Releases page](https://github.com/moussetc/mattermost-plugin-dice-roller/releases) and download the `.tar.gz` package. Supported platforms are: Linux x64, Windows x64, Darwin x64, FreeBSD x64.\n2. Use the Mattermost `System Console \u003e Plugins Management \u003e Management` page to upload the `.tar.gz` package\n3. **Activate the plugin** in the `System Console \u003e Plugins Management \u003e Management` page\n\n### Configuration Notes in HA\n\nIf you are running Mattermost v5.11 or earlier in [High Availability mode](https://docs.mattermost.com/deployment/cluster.html), please review the following:\n\n1. To install the plugin, [use these documented steps](https://docs.mattermost.com/administration/plugins.html#plugin-uploads-in-high-availability-mode)\n2. Then, modify the config.json [using the standard doc steps](https://docs.mattermost.com/deployment/cluster.html#updating-configuration-changes-while-operating-continuously) to the following:\n```json\n \"PluginSettings\": {\n        // [...]\n        \"Plugins\": {\n            \"com.github.moussetc.mattermost.plugin.diceroller\": {\n            },\n        },\n        \"PluginStates\": {\n            // [...]\n            \"com.github.moussetc.mattermost.plugin.diceroller\": {\n                \"Enable\": true\n            },\n        }\n    }\n```\n\n\n## Development\n\nto build the plugin:\n```\nmake\n```\n\nThis will produce a single plugin file (with support for multiple architectures) for upload to your Mattermost server:\n\n```\ndist/com.example.my-plugin.tar.gz\n```\n\n### Deploying with Local Mode\n\nIf your Mattermost server is running locally, you can enable [local mode](https://docs.mattermost.com/administration/mmctl-cli-tool.html#local-mode) to streamline deploying your plugin. Edit your server configuration as follows:\n\n```json\n{\n    \"ServiceSettings\": {\n        ...\n        \"EnableLocalMode\": true,\n        \"LocalModeSocketLocation\": \"/var/tmp/mattermost_local.socket\"\n    },\n}\n```\n\nand then deploy your plugin:\n```\nmake deploy\n```\n\nYou may also customize the Unix socket path:\n```\nexport MM_LOCALSOCKETPATH=/var/tmp/alternate_local.socket\nmake deploy\n```\n\nIf developing a plugin with a webapp, watch for changes and deploy those automatically:\n```\nexport MM_SERVICESETTINGS_SITEURL=http://localhost:8065\nexport MM_ADMIN_TOKEN=j44acwd8obn78cdcx7koid4jkr\nmake watch\n```\n\n### Deploying with credentials\n\nAlternatively, you can authenticate with the server's API with credentials:\n```\nexport MM_SERVICESETTINGS_SITEURL=http://localhost:8065\nexport MM_ADMIN_USERNAME=admin\nexport MM_ADMIN_PASSWORD=password\nmake deploy\n```\n\nor with a [personal access token](https://docs.mattermost.com/developer/personal-access-tokens.html):\n```\nexport MM_SERVICESETTINGS_SITEURL=http://localhost:8065\nexport MM_ADMIN_TOKEN=j44acwd8obn78cdcx7koid4jkr\nmake deploy\n```\n\n## Credits\n- This plugin is based of the [Mattermost plugin starter template](https://github.com/mattermost/mattermost-plugin-starter-template)\n- This project uses a dice icon provided by [openclipart](https://openclipart.org/detail/94501/twentysided-dice) under the [Creative Commons Zero 1.0 Public Domain License](https://creativecommons.org/publicdomain/zero/1.0/).\n\n\n## How do I share feedback on this plugin?\n\nFeel free to create a GitHub issue or to contact me at `@cmousset` on the [community Mattermost instance](https://pre-release.mattermost.com/) to discuss.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoussetc%2Fmattermost-plugin-dice-roller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoussetc%2Fmattermost-plugin-dice-roller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoussetc%2Fmattermost-plugin-dice-roller/lists"}