MedalBot Configs

MedalBot can be customized to fit your server's needs. Check out a list of configs you can use below. A config is like a setting which you customize for your server.

NOTE: You can always type a config command for more information in your Discord. For example: .commandprefix

Config Description Example
.antispamaction

This is the action to perform when a spammer is detected when antispam is set to true. By default it is warn, which means the owner will be mentioned and the user warned.

Alternatively, you can use:

mute to automatically mute the user in every text and voice channel

kick to automatically kick spammers

ban to automatically ban spammers

.antispamaction warn

.antispamaction mute

.antispamaction kick

.antispamaction ban

.antispam

When enabled, MedalBot will detect spammers who spams messages in one channel in a few seconds.

At first it will warn them to stop. If the spam continues, they will be punished with the antispam.action.

You can use the antispam.action config to set what action to perform when spammers are detected. Mods+ can bypass antispam filters.

.antispam true

.antispam false

.antispamlevel

The antispam level. By default it is 1. Increasing it will make MedalBot _more_ sensitive to spam - so be careful! It's recommended to be between 1-3.

.antispamlevel number

.autoassignrole

The name of the Role(s) to automatically assign to new members when they join. You can also specify multiple roles to auto assign.

For example:

.autoassignrole Member

This would automatically assign the Member role to new members.

.autoassignrole role

.blacklistchannelexception

The channel(s) to bypass blacklisted keyword filtering in. For example, if you blacklist discord.gg you can allow it to still be typed in a #self-promo channel.

By default it is default, which means no channels will bypass blacklist keyword filtering.

.blacklistchannelexception channel

.blacklist

Blacklist a keyword so whenever it shows up in chat, the bot automatically deletes the message. By default there are none, but a common usage of this is for disallowing Discord invites.

You can whitelist keywords using .whitelist to prevent your own invite links from being deleted, for example.

.blacklist text

.commandprefix

Sets the command prefix used to start commands with. By default it is ..

.commandprefix text

.disablecommand

Disable commands using this config. When you add a command to this list, MedalBot will ignore input for it in the server.

This only applies to MedalBot commands.

.disablecommand command

.djrequired

When enabled, the music bot requires the DJ role to use skipping, resetting, and stopping functions. By default it is true

.djrequired true

.djrequired false

.djrole

The name of the Role the server uses for the DJ role. By default it is DJ

You can add multiple roles to this list, and all will be given DJ privileges.

.djrole role

.grantablerole

The name of the Role(s) that can be granted/revoked using .grant [@Username] [role] and .grant [@Username] [role] commands (no brackets) (role managers only, see .rolemanager for more details). By default it is none.

You can add multiple roles to this list.

.grantablerole role

.guildpublicrole

The name of the Role(s) that are considered a "public" role. By default, it is default, which uses the @everyone role.

You can specify multiple roles to treat as public roles, for example:

.guildpublicrole PC .guildpublicrole Member

This would mark both the PC and Member roles as the lowest ranked role in the server that still has access to channels.

.guildpublicrole role

.socialenabled

When enabled, MedalBot will reward users with Social Points for actions like chatting, upvoting, and submitting content.

Users can build up their Medal Social and contribute to the Discord server's Community Ranking!

You can type .social for more information on how Medal Social works.

.socialenabled true

.socialenabled false

.modlogschannel

The mod logs channel. By default it is `#mod-logs`.

.modlogschannel channel

.modlogs

When enabled, MedalBot will log key actions like when a user joins, has a role added to them, or is banned to a channel named #mod-logs. By default it is true.

.modlogs true

.modlogs false

.musicautoleave

When enabled, the bot will automatically leave voice channels when no music is playing. By default it is false.

.musicautoleave true

.musicautoleave false

.musicchannel

The channel(s) to restrict music commands to. By default there are none, and music commands can be used in any channel.

.musicchannel channel

.musicprefix

The command prefix for music commands. By default it is m!

For example:

m!play I Feel Good

.musicprefix text

.musicrequestdelete

When this is set to true, music request messages like m!play will be automatically deleted after 10 seconds. By default it is false.

.musicrequestdelete true

.musicrequestdelete false

.quietchannel

When a channel is set to be a quiet channel, MedalBot will never speak in it.

.quietchannel channel

.restrictcommands

Restrict commands to specified roles. Only the roles in this list will be allowed to use commands.

This only applies to MedalBot commands.

.restrictcommands role

.rolemanager

The name of the Role(s) that can use the .grant [@Username] [role] and .revoke [@Username] [role] commands (no brackets). By default it is none.

You can add multiple roles to this list, and all will have role-granting abilities.

.rolemanager role

.selfrole

The name of the Role(s) that members can assign to themselves.

For example:

.selfrole PC

This would allow them to assign the PC role to themselves by typing .iam PC.

.selfrole role

.slowchannel

When a channel is set to be a slow channel, MedalBot will force members to wait 30 (by default) seconds between each message.

You can specify the time to wait between messages using the .slowrate config.

.slowchannel channel

.slowrate

The number of seconds to wait between messages for slow channels (see .slowchannel).

.slowrate number

.suggestionchannel

The text channel to treat as the suggestions channel by default it is default, which means none. When this is set, the channel you set will require messages to be sent using the .suggest [suggestion] command. All suggestions will automatically be marked with :white_check_mark: and :x: so users can vote on suggestions.

.suggestionchannel channel

.welcomemessagechannel

When a welcome message is set, the message will be posted to the channel specified in this config. By default, it will use your public channel (usually #general).

To send welcome messages only in private messages to new users, you can type .welcomemessagechannel PM.

.welcomemessagechannel channel

.welcomemessage

When a welcome message is set, the message will be posted in the channel set in the welcome.message.channel config. By default, it will use your public channel.

To include the person's username that just joined in your message, you can use %username% where you want to use their name.

To send welcome messages only in private messages to new users, you can type .welcomemessagechannel PM.

To disable welcome messages completely, you can type .welcomemessage -reset

.welcomemessage text

.whitelist

Whitelist a keyword so whenever it shows up in chat, the bot allows it even if some/all of it is blacklisted.

.whitelist text

.clipdetectionchannel

The channel(s) to automatically detect clips in when users include them in their messages. By default it listens in #clips-videos, #clips, and #videos.

.clipdetectionchannel channel

.clipdetection

When set to true, MedalBot will automatically detect clips when users include them in messages and PM them asking if they want to upload it to Medal. This will only apply to channels specified using the clip.detection.channel config.

.clipdetection true

.clipdetection false

.broadcastupdatechannel

The channel to broadcast updates to when MedalBot updates. By default it is your default channel - the first channel which your public role (usually `@everyone`) can access.

.broadcastupdatechannel text

.broadcastupdate

When set to true, MedalBot will automatically broadcast updates to the public channel when updates go live (with server owner's permission).

.broadcastupdate true

.broadcastupdate false

.defaultgame

The default game category to use globally. Set it to none to require users to specify a category when using the .submit command, and to make .randomclip commands pull clips from a random game by default.

.defaultgame text

.disablehelpcommand

When set to true, MedalBot will ignore .help and will only listen to .medalhelp, .info, and .commands.

.disablehelpcommand true

.disablehelpcommand false

.ignoresocialchannel

The channel(s) to ignore social participation in. For example, if you don't want to reward social points for chatting in a private mod channel, you can type .ignoresocialchannel #mods.

.ignoresocialchannel channel

.medaloutlink

This is where users will be sent when they click the Medal profile's bio link in the Medal app.

.medaloutlink url

.socialupdateschannel

The channel to post level-up messages to for users participating in Medal Social. By default it is default, which will use the channel the user was talking in, or the default public channel. Type .social for more information about Medal Social.

.socialupdateschannel channel

.socialupdates

When set to true, MedalBot will automatically post social updates like level-ups to text channels. By default it is false and must be enabled.

If social.updates.channel is set then all updates will be posted there. By default, they will go to the channel the user is active in or the default public channel.

.socialupdates true

.socialupdates false