{"id":19858705,"url":"https://github.com/DLvalentine/fate","last_synced_at":"2025-05-02T02:31:10.349Z","repository":{"id":51416786,"uuid":"171916701","full_name":"DLvalentine/fate","owner":"DLvalentine","description":"A dice roller bot for discord with GM mode!","archived":false,"fork":false,"pushed_at":"2021-05-12T00:31:44.000Z","size":61,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-12T14:26:04.076Z","etag":null,"topics":["dice","dice-roller","discord","discord-bot","dnd","dnd-tools","javascript","pathfinder","pathfinder-game","pathfinder-rpg","pathfinder-tools"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DLvalentine.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}},"created_at":"2019-02-21T17:39:55.000Z","updated_at":"2021-02-14T23:20:30.000Z","dependencies_parsed_at":"2022-09-25T04:20:20.746Z","dependency_job_id":null,"html_url":"https://github.com/DLvalentine/fate","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLvalentine%2Ffate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLvalentine%2Ffate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLvalentine%2Ffate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLvalentine%2Ffate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DLvalentine","download_url":"https://codeload.github.com/DLvalentine/fate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251972475,"owners_count":21673612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["dice","dice-roller","discord","discord-bot","dnd","dnd-tools","javascript","pathfinder","pathfinder-game","pathfinder-rpg","pathfinder-tools"],"created_at":"2024-11-12T14:24:17.060Z","updated_at":"2025-05-02T02:31:10.021Z","avatar_url":"https://github.com/DLvalentine.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# fate\nA dice roller bot for discord! \n\n### Adding fate to your Discord Server\n[Click here to do that.](https://discordapp.com/api/oauth2/authorize?client_id=548192715129749544\u0026permissions=7168\u0026scope=bot)\n\nI run this on a little raspberry pi out of my basement... so... if there's a ton of traffic I imagine it won't be pretty. Maybe one day I'll move it to AWS or something.\n\n`NOTE`: My pi running Fate died a while back, so consider the above link dead for now. I'll probably spin it back up soon™\n\n### So you forked it? Now what?\nYou can create an app/bot via [Discord for Developers](https://discordapp.com/developers/applications/)\n\nfate (or, I guess your new fork) requires [NodeJS](https://nodejs.org/) to run. All other dependences can be installed via npm once you have NodeJS installed.\n\nBe sure to open `auth.json` and include the secret token that Discord will use to login as that bot. You can also include specific channels on your server in `channels.json` to be able to send messages strictly to a specificed channel.\n\n1. clone/download repo\n2. `cd` to directory*\n3. `npm install`\n4. `node fate.js` \n\n\\* 2.5 See above note for updating `auth.json` and (optionally) `channels.json`\n\n~ let fate (or your fork!) decide ~\n\n# Contributing\nSeeing as you'd need to create your own app/bot to make changes, feel free to re-release this as your own flavor of a dice roller. They're a dime a dozen, anyway. MIT license, so just gimmie a shoutout and I'm happy. \n\nBut if you'd like to improve this project, make a PR :) I'm happy to accept changes.\n\n# Commands\n`!fate` : Print the commands.... y'know. This.\n\n`!r [argument]` : Given a dice string, like `3d6`, roll a specified number of dice of a type. No need to include `1` for single die. You can add bonuses or penalties with `-` and `+` after the quantity/type string.\n\n`!gr [argument]` : the same as `!r`, but will be whispered to the author for a \"hidden\" roll. Typically used for GMs\n\n`!srd` : Posts a link to the online SRD for Pathfinder.... maybe one day configurable to go to other SRDs\n\n`!e [argument]` : Sends a formatted \"ENCOUNTER\" text block to the log, in order to help break up text between encounters in your server\n\n`!g [argument]` : The same as `!e` , but for \"GRANTED\" - as in, granting items or experience\n\n`!motd` : Will repeat the Message of the Day, as configured in `motd.txt`\n\n## Examples \n`!r d20`: roll 1 d20.\n\n`!r 2d20`: roll 2 d20s.\n\n`!r 1d6+2`: roll 1d6, adding a bonus of 2.\n\nAnd so on. It works similar to the Roll20 Dice Roll system.\n\nDepending on your argument, it will return the expected messages, complete with a reference to who rolled!\n\n![example output](https://raw.githubusercontent.com/DLvalentine/fate/master/example.JPG)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDLvalentine%2Ffate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDLvalentine%2Ffate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDLvalentine%2Ffate/lists"}