Skip to content

Latest commit

History

History
63 lines (50 loc) 路 1.77 KB

README.md

File metadata and controls

63 lines (50 loc) 路 1.77 KB

thebiggame/rolebot

A simple discord bot written in Go.

rolebot is responsible for the creation and assignment of special "team" roles to those who request them. This helps massively when you want to mention an entire team quickly and easily (or give them their own chat channel!).

Install

Install Go

go get github.com/thebiggame/rolebot
go install github.com/thebiggame/rolebot

(Installs to ~/go/bin/)

Running

You will need a bot token from the Discord developers site

Usage:

Via docker:

docker run -d --restart=always --name teambot thebiggame/rolebot /app/main -chan <channel> -token <token>

Or local install:

~$ rolebot
Usage of rolebot:
  -chan name
    	Channel name to use (default "roles")
  -char string
        Command character to prefix all commands with (default "!")
  -token token
    	Bot token (required)
  -user_maxroles int
        The maximum number of teams a User is allowed to join (default 5)
  -v	Verbose logging

Example:

rolebot -token YOURTOKENHERE
2018/03/18 18:09:18 Running on servers:
2018/03/18 18:09:18 	test (272429559406919681)
2018/03/18 18:09:18 channel name: roles
2018/03/18 18:09:18 Join URL:
2018/03/18 18:09:18 https://discordapp.com/api/oauth2/authorize?scope=bot&permissions=268446720&client_id=(removed)
2018/03/18 18:09:18 Bot running as (removed). CTRL-C to exit.

paste the link into a web browser to add the bot to your discord server (you will need the Manage Server permission)

Command Usage

Register

Usage: !jointeam (team name)

Command only works in a channel named roles (or other supplied with -c). It can be used by anyone. Example:

jointeam iBUYJEFFS