{"id":15576075,"url":"https://github.com/chronos-tachyon/rolebot","last_synced_at":"2026-05-16T08:40:16.388Z","repository":{"id":47610505,"uuid":"104811952","full_name":"chronos-tachyon/rolebot","owner":"chronos-tachyon","description":"A bot for user-assigned chat roles in Discord.","archived":false,"fork":false,"pushed_at":"2021-08-22T02:58:35.000Z","size":42,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-03T20:51:56.826Z","etag":null,"topics":["bot","discord","discord-bot"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/chronos-tachyon.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":"2017-09-25T23:25:07.000Z","updated_at":"2024-12-27T15:21:18.000Z","dependencies_parsed_at":"2022-09-08T05:10:56.346Z","dependency_job_id":null,"html_url":"https://github.com/chronos-tachyon/rolebot","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chronos-tachyon%2Frolebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chronos-tachyon%2Frolebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chronos-tachyon%2Frolebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chronos-tachyon%2Frolebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chronos-tachyon","download_url":"https://codeload.github.com/chronos-tachyon/rolebot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246152560,"owners_count":20731801,"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":["bot","discord","discord-bot"],"created_at":"2024-10-02T18:41:45.154Z","updated_at":"2026-05-16T08:40:16.332Z","avatar_url":"https://github.com/chronos-tachyon.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RoleBot\nA bot for user-assigned chat roles in Discord.\n\n## For users\n### Using RoleBot\n\nFirst, make sure you're in the right channel. There is probably a channel\ncalled `#botspam`.  Any bot commands you type should be entered there.\n\nTo give yourself the role \"foo\", type `.iam foo`.\n\nIf you decide you don't want the role \"foo\" anymore, type `.iamnot foo`.\n\n## For server owners\n### Adding RoleBot to your server\n\nIf you want RoleBot and you trust me to keep it running, then all you need to\ndo is this:\n\n* Visit https://discordapp.com/oauth2/authorize?client_id=362058035167887361\u0026scope=bot\n\n* Select your server and click Authorize to invite the bot\n\n* Create a role for RoleBot, enable the \"Manage Roles\" permission, and place\n  the role higher in the list than any role that RoleBot should hand out\n\n* Give RoleBot the role that you created\n\n### Setting up RoleBot for your server\n\nWhen the bot is first added to the server, it will only accept admin commands\nfrom the server owner. The server owner can indicate that other users and\nroles are \"trusted\", meaning that they can also issue admin commands.\n\nTo only accept commands on a channel named \"botspam\", type `.chan botspam`.\n\nTo trust a user named \"alice\", type `.trust alice`.\n\nIf you change your mind about trusting user \"alice\", type `.notrust alice`.\n\nTo trust any user in the role \"mods\", type `.rtrust mods`.\n\nIf you change your mind about trusting anyone with the \"mods\" role, type\n`.nortrust mods`.\n\nTo allow regular users to give themselves role \"foo\", type `.auto foo`.\n\nTo lock down the \"foo\" role, type `.noauto foo`.\n\n## For developers and advanced server owners\n### Running your own RoleBot under Linux\n\nFirst, if you don't already have it, install Go:\n\n```sh\nmkdir -p ~/tmp\ncd ~/tmp\ncurl -O https://dl.google.com/go/go1.10.linux-amd64.tar.gz\ntar xzf go1.10.linux-amd64.tar.gz\nmv go ~/goroot\necho 'export GOPATH=\"${HOME}/go\"' \u003e\u003e~/.bashrc\necho 'export GOROOT=\"${HOME}/goroot\"' \u003e\u003e~/.bashrc\necho 'export PATH=\"${GOPATH}/bin:${GOROOT}/bin:${PATH}\"' \u003e\u003e~/.bashrc\n. ~/.bashrc\n```\n\nNext, install the vgo tool:\n\n```sh\ngo get -u golang.org/x/vgo\n```\n\nNow it's time to download, build, and install Rolebot:\n\n```sh\ngit clone https://github.com/chronos-tachyon/rolebot.git ~/rolebot\ncd ~/rolebot\n./build.sh\nsudo ./rolebot.install.sh\n```\n\nThe install script will prompt you to obtain a Bot User token.  You will\nneed to visit [https://discordapp.com/developers/applications/me][apps]\nand create a Discord App for your bot, at which point you'll be able to\nobtain the secret token for the bot account.\n\nFinally, add your bot to some servers!  First, go back to\n[the apps page][apps], click through to your app, and copy the Client ID.\n(It's at the top of the page.)  Second, add the bot to your server by\nvisiting `https://discordapp.com/oauth2/authorize?client_id=\u003cid\u003e\u0026scope=bot`\nand granting access to the server.\n\nLastly, you will need to grant the bot some limited moderator powers.  Bot\npermissions on the server work just like people permissions.\n\n[apps]: https://discordapp.com/developers/applications/me\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchronos-tachyon%2Frolebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchronos-tachyon%2Frolebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchronos-tachyon%2Frolebot/lists"}