Welcome to Goat.
This documentation will help you get started with Goat, as well as configure his more advanced features.
A comprehensive set of guides is available here to help you get started with Goat's many features.
You will learn the basics including inviting Goat and ensuring he is able to manage your server, member welcoming, reaction roles and levelling.
You will additionally learn about the more advanced Goat features such as automatic role assignment, levelling roles, Goat Tickets, Private Voice Chat, Stream Monitor, Goat Starboard and message filters.
The documentation is split in to chapters.
Each chapter contains a number of topics.
Note that this documentation assumes that you are setting up a new Discord server.
If you are using an already established Discord server, you will need to adapt the provided instructions to suit your environment.
This chapter covers advanced Discord server configuration.
You will learn how to setup advanced Goat features such as automatic role assignment, levelling roles, starboard, private voice chat and tickets.
Select a topic to start.
Automatic Role Assignment
Automatic role assignment enables you to automatically add specific roles to members when they join your Discord server.
Automatic role assignment can add an additional layer of security to hardened servers by restricting new members until roles are manually removed by moderators.
The instructions below will help you configure automatic role assignment.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and open server settings.
navigate to the "Manage Roles" page.
Create as many new roles as you want to assign to new members.
For each new role you create, specify permissions as required for your configuration.
Right-click each new role and copy the id for later.
Save the changes and close.
You have now prepared your Discord server for automatic role assignment.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Goat to assign the roles to new members.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Member Management" button.
In the "Automatically Assign Roles" dropdown, select "Enable".
In the "Automatically Assigned Roles" field, paste the ids of the roles you want to automatically assign separated by a comma.
Click the "Save Settings" button to apply the changes.
You have now enabled automatic role assignment for your server.
Any new server members will receive the roles you specified. Note that existing members will not receive the configured roles.
Levelling Roles
Levelling roles enables you to reward members when they reach specified Goat levels.
You can use levelling roles as a way of publicising member experience or providing a tiered access system.
The instructions below will help you configure levelling roles.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and open server settings.
navigate to the "Manage Roles" page.
Create as many new roles as you want depending on your needs.
Specify role permissions as required for your configuration.
Right-click each new role and copy the id for later.
Save the changes and close.
You have now prepared your Discord server for levelling roles.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Goat to assign levelling roles.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Levelling System" button.
In the "Enable Levelling Roles" dropdown, select "Enable".
Specify your levelling roles exactly as directed in the "Levelling Roles" field.
Click the "Save Settings" button to apply the changes.
You have now enabled Goat levelling roles. Note that existing members will not automatically receive the levelling roles you define.
Goat Starboard
The Goat Starboard enables your members to star messages in your server by reacting with a dedicated emoji.
Starred messages are shown in a dedicated channel with a link to the original message and the number of current stars.
The instructions below will help you configure the Goat Starboard.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and create a new text channel in the "Welcome" category named "starboard" or similar.
Edit the "starboard" channel you just created and on the "Permissions" page, do the following:
Select the "@everyone" role and deny the "View Channel" permission
Add the "Members" role, allow the "View Channel" and "Read Message History" permissions and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Save the changes and close.
Now open your Discord server settings and navigate to the "Emoji" page.
Click the "Upload Emoji" button and browse for a suitable image to use, then give your new emoji a name.
Save the changes and close.
You have now prepared your Discord server for the Goat Starboard.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure the Goat Starboard.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Starboard" button.
In the "Enable Starboard" dropdown, select "Enable".
In the "Starboard Channel" dropdown, select the "starboard" channel you created earlier.
In the "Starboard Emoji" dropdown, select the emoji you created earlier.
If you want messages sent by bots to be able to be starred, in the "Star Bot Messages" dropdown, select "Enable".
Click the "Save Settings" button to apply the changes.
You have now enabled the Goat Starboard on your server.
Server Suggestions
Server Suggestions enables your members to post suggestions for your server using a Goat command.
Suggestions are posted to a dedicated channel for members to view.
The instructions below will help you configure Server Suggestions.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and create a new text channel in the "Administration" category named "suggestions" or similar.
Edit the "suggestions" channel you just created and on the "Permissions" page, do the following:
Select the "Admins" role and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Add the "Members" role, allow the "View Channel" and "Read Message History" permissions and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Optionally allow the "Add Message Reactions" permission on the "Members" role
Save the changes and close.
You have now prepared your Discord server for Server Suggestions.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Server Suggestions in Goat.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Server Suggestions" button.
In the "Enable Suggestions" dropdown, select "Enable".
In the "Suggestions Channel" dropdown, select the "suggestions" channel you created earlier.
If you want suggestions to be posted anonymously, in the "Anonymous Suggestions" dropdown, select "Enable".
Click the "Save Settings" button to apply the changes.
You have now enabled Server Suggestions on your server.
Server Advertising Service
The Server Advertising service provides advertisements for publically listed Discord servers.
You can use the Server Advertising service to advertise your own Discord servers to other servers.
The instructions below will help you configure the Server Advertising service.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and create a new text channel named "server-advertisements" or similar.
Edit the "server-advertisements" channel you just created and on the "Permissions" page, do the following:
Select the "@everyone" role and deny the "View Channel" permission
Add the "Members" role, allow the "View Channel" and "Read Message History" permissions and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Save the changes and close.
You have now prepared your Discord server for the Server Advertising service.
Goat Configuration
Now you have your Discord server prepared, you'll need to enable and configure the Server Advertising service.
Additionally, you will need to create a publically listed Goat Vanity Link.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Server Advertising" button.
In the "Enable Server Advertising" dropdown, select "Enable".
In the "Server Advertisements Channel" dropdown, select the channel you created when configuring your Discord server.
Click the "Save Settings" button to apply the changes.
If you want to advertise your own server, in Discord, locate your welcome channel.
Use the "/vanity create" command to create a new Goat Vanity Link, making sure to make the link public.
You have now enabled the Goat Server Advertising service.
Goat Private Voice Chat
Goat Private Voice Chat enables your members to conduct voice chats in a private, secure channel.
Members who create private voice channels can add and remove access for other members using a command.
The instructions below will help you configure Goat Private Voice Chat.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and create a new voice channel named "Create Private Voice" or similar.
Edit the "Create Private Voice" channel you just created and on the "Permissions" page, do the following:
Select the "@everyone" role and deny the "View Channel" permission
Add the "Members" role, allow the "View Channel" and "Connect" permissions and deny the "Speak", "Video", "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls" and "Read Message History" permissions
Save the changes and close.
Create a new channel category called "Private Voice Channels" or similar.
Edit the "Private Voice Channels" category you just created and on the "Permissions" page, do the following:
Select the "@everyone" role and deny the "View Channels" permission
Add the "Moderators" role and allow the "View Channels", "Read Message History", "Send Messages And Create Posts", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads", "Create Private Threads", "Connect", "Speak" and "Video" permissions
Save the changes and close.
You have now prepared your Discord server for Goat Private Voice Chat.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Goat Private Voice Chat.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Private Voice Chat" button.
In the "Enable Private Voice Chat" dropdown, select "Enable".
In the "Trigger Channel" dropdown, select the "Create Private Voice" channel you created earlier.
In the "Channel Category" dropdown, select the "Private Voice Channels" category you created earlier.
Click the "Save Settings" button to apply the changes.
You have now enabled Goat Private Voice Chat on your server.
Goat Tickets
Goat Tickets enables you to provide a professional and secure support experience to your members.
Members who create Goat Tickets can chat privately with your support staff and can close the ticket when the issue is resolved.
The instructions below will help you configure Goat Tickets.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and open server settings.
Navigate to the "Manage Roles" page.
Create a new role named "Support" or similar.
Save the changes and close.
Create a new channel in the "Administration" category called "ticket-notifications" or similar.
Edit the "ticket-notifications" channel you just created and on the "Permissions" page, do the following:
Add the "Support" role you created, allow the "View Channel" permission and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Save the changes and close.
Create two new channel categories called "Open Tickets" and "Archived Tickets" or similar.
Edit the "Open Tickets" category and on the permissions page, do the following:
Select the "@everyone" role and deny the "View Channels" permission
Add the "Support" role you created and allow the "View Channels", "Read Message History", "Send Messages And Create Posts", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads", "Create Private Threads", "Connect", "Speak" and "Video" permissions
Save the changes and close.
Repeat steps 9 and 10 for the "Archived Tickets" category.
Create a new channel called "get-support" or similar.
Edit the "get-support" channel you created earlier and on the "Permissions" page, do the following:
Add the "Members" role, allow the "View Channel" and "Read Message History" permissions and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Save the changes and close.
You have now prepared your Discord server for Goat Tickets.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Goat Tickets.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Goat Tickets" button.
In the "Enable Goat Tickets" dropdown, select "Enable."
In the "Ticket Notifications Channel" dropdown, select the "ticket-notifications" channel you created earlier.
In the "Ticket Responder Role" dropdown, select the "Support" role you created earlier."
In the "Open Tickets Category" dropdown, select the "Open Tickets" category you created earlier.
Optionally specify a custom ticket opening message in the provided field.
Optionally specify a custom ticket closure message in the provided field.
If you want Goat to use voice channels when members create tickets, in the "Use Voice Tickets" dropdown, select "Enable".
In the "Archive Closed Tickets" dropdown, select "Enable".
In the "Archived Tickets Category" dropdown, select the "Archived Tickets" category you created earlier.
If you want ticket creators to be able to access their tickets after they have been archived, in the "Archived Ticket Owner Access" dropdown, select "Enable".
Click the "Save Settings" button to apply the changes.
In Discord, switch to the "get-support" channel you created earlier and type "/tickets embed" to create an embedded message with a button to open a new ticket.
You have now enabled Goat Tickets on your server.
Goat Birthdays
Goat Birthdays enables you to reward your members when their birthday arrives.
A notification will be sent in your server for members who specify their birthday in their Goat Profile.
You can additionally reward members with a special birthday role which will be automatically removed when their birthday is over.
The instructions below will help you configure Goat Birthdays.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and create a new text channel in the "Welcome" category named "birthdays" or similar.
Edit the "birthdays" channel you just created and on the "Permissions" page, do the following:
Select the "@everyone" role and deny the "View Channel" permission
Add the "Members" role, allow the "View Channel" and "Read Message History" permissions and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Save the changes and close.
Now open your Discord server settings and navigate to the "Manage Roles" page.
Create a new role named "Birthdays" or similar.
Save the changes and close.
You have now prepared your Discord server for Goat Birthdays.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Goat Birthdays.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Goat Birthdays" button.
In the "Birthday Messages" dropdown, select "Enable".
In the "Birthday Messages Channel" dropdown, select the "birthdays" channel you created earlier.
Optionally specify a custom birthday message and image URL.
In the "Assign Birthday Role" dropdown, select "Enable".
In the "Birthday Role" dropdown, select the "Birthdays" role you created earlier.
Click the "Save Settings" button to apply the changes.
You have now enabled Goat Birthdays on your server.
Goat Vote Rewards
Goat Vote Rewards enables you to reward your members for voting for your Discord server on supported bot/server lists.
Members who vote for your server will be rewarded with a temporary role which will be automatically removed in 12 hours. Goat Vote Rewards requires a server listing on at least one bot/server list which supports webhooks.
The instructions below will help you configure Goat Vote Rewards.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and open server settings.
Navigate to the "Manage Roles" page.
Create a new role named "Server Voters" or similar.
Optionally create new roles to apply to members who achieve specific vote counts.
Save the changes and close.
Create a new channel in the "Welcome" category called "vote-notifications" or similar.
You have now prepared your Discord server for Goat Vote Rewards.
Goat Configuration
Now you have your Discord server prepared, you'll need to configure Goat Vote Rewards.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Vote Rewards" button.
In the "Enable Vote Rewards" dropdown, select "Enable".
In the "Vote Rewards Notifications Channel" dropdown, select the "vote-notifications" channel you created earlier.
In the "Vote Reward Role" dropdown, select the "Server Voters" role you created earlier.
If desired, specify a custom reward message and background image URL in the provided fields.
If you want your members to be reminded when they can next vote, in the "Enable Vote Reminders" dropdown, select "Enable".
If you created roles to apply to members who achieve specific vote counts, in the "Enable Achievement Roles" dropdown, select "Enable" and specify your vote counts and achievement roles exactly as directed.
If your bot lists support specifying a webhook password, in the "Webhook Authentication" dropdown, select "Enable" and specify a webhook password in the provided field.
In the "Webhook URL" field, select and copy the provided URL.
Click the "Save Settings" button to apply the changes.
Visit the bot/server lists on which you are registered and edit the entry.
Paste your webhook URL in the provided field, taking care to provide the webhook authentication password if required.
You have now enabled Goat Vote Rewards on your server.
Live Stream Monitor
With the Goat Stream Monitor service, you can monitor live streams for various streaming platforms.
Goat monitors specified users and sends notifications when they start streaming.
Notifications are sent to a designated channel and include useful information about live user and streams.
Goat currently supports monitoring Twitch and Kick streams.
The instructions below will help you configure the Stream Monitor service.
Discord Server Configuration
The first step is to configure your Discord server.
In Discord, locate the server you want to configure and create a new text channel named "live-streams" or similar.
Edit the "live-streams" channel you just created and on the "Permissions" page, do the following:
Select the "@everyone" role and deny the "View Channel" permission
Add the "Members" role, allow the "View Channel" and "Read Message History" permissions and deny the "Send Messages", "Send Messages In Threads", "Send TTS Messages", "Send Voice Messages", "Send Polls", "Create Public Threads" and "Create Private Threads" permissions
Save the changes and close.
You have now prepared your Discord server for live stream notifications.
Goat Configuration
Now you have your Discord server prepared, you'll need to enable and configure the Stream Monitor service.
Click the "Login With Discord" button at the top of the page and login using a Discord account with the "Manage Server" permission on the server you are configuring.
Once logged in, click the "Menu" button and click the "Dashboard" link.
In the list of available servers, select your Discord server by clicking the "Edit Settings" link.
In the list of categories, click the "Live Stream Monitor" button.
In the "Enable Goat Stream Monitor" dropdown, select "Enable".
In the "Stream Monitor Notifications Channel" dropdown, select the channel you created when configuring your Discord server.
If you want to monitor Twitch streams, in the "Enable Twitch Stream Monitor" dropdown, select "Enable"
In the "Monitored Twitch Users (Separated By Comma)" field, type the user login names of all the Twitch users you want Goat to monitor, separating each with a comma.
If you want to monitor Kick streams, in the "Enable Kick Stream Monitor" dropdown, select "Enable"
In the "Monitored Kick Users (Separated By Comma)" field, type the user login names of all the Twitch users you want Goat to monitor, separating each with a comma.
Click the "Save Settings" button to apply the changes.
You have now enabled the Goat Stream Monitor service.
