ChanServ: Difference between revisions

Revision as of 19:35, 13 July 2022

This article covers the bot for the Rory Fanclub Discord Server. For the IRC service the name is based on, see ChanServ on Wikipedia

ChanServ is a Discord bot for the Rory Fanclub Discord server. Its code is open source on GitHub, and is programmed primarily by Chew.

Information

ChanServ is the main moderation and only admin bot on the server. Its commands, much like the server, are inspired by IRC. It utilizes Slash Commands, a recent addition to the Discord API, which means you run commands by typing / and all of the commands will show up. The slash command behavior is not unlike IRC; however, there are suggestions, which aren't present in most IRC clients.

Commands

ChanServ's commands are primarily based on IRC, in terms of arguments, command name, and permissions.

ChanServ commands
Command	Minimum Role	Permissions
`/admin [user]`	Owner	Marks a user as admin (+a).
`/halfop [user]`	Op	Marks a user as half-op (+h).
`/kick [user] (reason)`	Half-op	Kicks a user from the server with an optional specified reason.
`/mode [user] [mode]`	Admin	Changes a specified user's modes.
`/op [user]`	Admin	Marks a user as op (+o).
`/owner [user]`	Oper	Marks a user as owner (+q).
`/quote (user)`	Any	Returns a random quote, or a specific user's quote if specified.
`/randomcolor`	Any	Allows a user to change their role color. It has a cooldown of 1 hour.
`/rank`	Any	Much like `/umode`, but only shows your highest rank.
`/reason [case] [reason]`	Half-op	Changes the reason for a specific Audit Log entry.
`/shutdown`	Owner	Shuts down the bot.
`/topic [new topic]`	Half-op	Changes a channel's topic.
`/umode`	Any	Returns a list of your "user modes."
`/uwustats`	Any	Gathers the leaderboard of "uwus" in the #uwu channel.
`/voice [user]`	Half-op	Marks a user as voiced (+v).

History

ChanServ initially started as a bot written in Ruby using the discordrb API library and was initially private.^[1] It was left private because the code contained the bot token.^[2]

It was made public and was re-written in Java on September 29th, 2020.^[3]

References

↑ "base files" by Chew on GitHub
↑ [1] Message in #news regarding the repository's visibility.
↑ "Rewrite files" by Chew on GitHub

[1] "base files" by Chew on GitHub

[2] [1] Message in #news regarding the repository's visibility.

[3] "Rewrite files" by Chew on GitHub

[1]

[2]

[3]

@@ Line 16: / Line 16: @@
 ! Command !! Minimum Role !! Permissions
 |-
-| <code>/umode</code> || Any || Returns a list of your "user modes."
+| <code>/admin [user]</code> || Owner || Marks a user as admin (+a).
+|-
+| <code>/halfop [user]</code> || Op || Marks a user as half-op (+h).
 |-
-| <code>/rank</code> || Any || Much like <code>/umode</code>, but only shows your highest rank.
+| <code>/kick [user] (reason)</code> || Half-op || Kicks a user from the server with an optional specified reason.
 |-
-| <code>/randomcolor</code> || Any || Allows a user to change their role color. It has a cooldown of 1 hour.
+| <code>/mode [user] [mode]</code> || Admin || Changes a specified user's modes.
 |-
-| <code>/listcommunities</code> || Any || List communities for users to join. Also available in the #communities channel in the Information category.
+| <code>/op [user]</code> || Admin || Marks a user as op (+o).
 |-
-| <code>/join #channel</code> || Any || Joins a community channel.
+| <code>/owner [user] || Oper || Marks a user as owner (+q).
 |-
-| <code>/leave</code> || Any || Leaves a community channel. This must be run inside the community channel you wish to leave.
+| <code>/quote (user) || Any || Returns a random quote, or a specific user's quote if specified.
 |-
-| <code>/uwustats</code> || Any || Gathers the leaderboard of "uwus" in the #uwu channel.
+| <code>/randomcolor</code> || Any || Allows a user to change their role color. It has a cooldown of 1 hour.
 |-
-| <code>/voice @user</code> || Half-op || Marks a user as voiced (+v).
+| <code>/rank</code> || Any || Much like <code>/umode</code>, but only shows your highest rank.
 |-
 | <code>/reason [case] [reason] || Half-op || Changes the reason for a specific Audit Log entry.
 |-
-| <code>/kick [user] (reason)</code> || Half-op || Kicks a user from the server with an optional specified reason.
+| <code>/shutdown</code> || Owner || Shuts down the bot.
 |-
 | <code>/topic [new topic]</code> || Half-op || Changes a channel's topic.
+|-
+| <code>/umode</code> || Any || Returns a list of your "user modes."
+|-
+| <code>/uwustats</code> || Any || Gathers the leaderboard of "uwus" in the #uwu channel.
+|-
+| <code>/voice [user]</code> || Half-op || Marks a user as voiced (+v).
 |}
-There are additional commands to promote someone to a given rank, such as <code>/halfop</code>, <code>/op</code>, <code>/admin</code>, and <code>/owner</code>. All of these require the rank directly above or higher to operate (<code>/halfop</code> requires Op or above, for instance</code>. There is no <code>/oper</code> as a result.
 == History ==