Commands

Learn about some of the utility commands SajuukBot has, which don't fall under any other category.

SajuukBot has several utility commands that don't fit within any specific category. While most of them are expected to be used by moderators, they are "one off" commands which are not specifically used for moderation, though some may be.

This page largely documents all these commands in one single place. In time, these may be moved to more appropriate locations if they're found to fit more within an existing section.

Configuration

This section of configuration is a root key, which means it should not be indented and in line with the basic settings like levels, prefix and the like. Please see the full basic configuration for more details on how it should be formatted.

utilities:
  enabled: false
  commands:
    announce:
      enabled: false
      level: 100
    avatar:
      enabled: false
      level: 100
    charinfo:
      enabled: true
      level: 50
    get ids:
      enabled: false
      level: 50
    help:
      enabled: true
      level: 50
    info:
      enabled: false
      level: 50
    jumbo:
      enabled: false
      level: 50
    lock:
      enabled: false
      level: 100
    logs:
      enabled: false
      level: 100
    ping:
      enabled: false
      level: 100
    quote:
      enabled: false
      level: 100
    search:
      enabled: false
      level: 100
    server:
      enabled: false
      level: 100
    slowmode:
      enabled: false
      level: 50
    userinfo:
      enabled: false
      level: 50
    uptime:
      enabled: false
      level: 100
    voice:
      enabled: false
      level: 50

Commands

Only commands which take arguments that are not very obvious (based on the description of the command) will be mentioned in the syntax and examples section after the table.

Every command follows the exact same formatting:

• A key called enabled determining if the command is enabled or not.

• A key called level, determining the minimum level required to use the command

At the root of the utilities key is an enabled key, which globally controls the commands assigned to this module. If the root key is false, then no command will operate, regardless of whether an individual command is enabled.

All commands below are standalone and are not part of any command group.

Command	Description
!announce	Posts a user-written message to a channel with a role mention. The role name must be surrounded with quote marks if it contains a space, otherwise use its Role ID.
!avatar	Returns the avatar of the invoking member, or someone else, if specified.
!charinfo	Returns all the specific unicode characters that are within the input string. This is useful if you think characters may be non-Latin variants of them (eg a Cyrillic "e" instead of a Latin "e").
!get ids	Retrieves the User IDs from modlog messages for use in mass-action bot commands.
!info	Shows information about a member or a user.
!jumbo	Sends a joined image of up to five emoji, either defaults or custom uploads.
!lock !unlock	Locks or unlocks a channel. This removes the Send Messsages and Add Reactions permissions in the channel, if possible.
!logs	Toggles the modlog channel on or off. You only need to use this if you are temporarily "muting" the modlogs to perform hidden commands that you don't want logged, but note the "muting" is global to every modlog message.
!ping	Tells you the current latency and ping response time to Discord.
!quote	Posts a message that quotes the provided Message ID. You must have permission to view the channel in question where the ID is for.
!server	Shows information about the server, including limits, member counts and so on.
!slowmode	Changes the slowmode setting in the channel if users do not have Manage Channel permissions. The timestamp argument may either be a regular timestamp (as per tempmute commands) or just a number expressed in seconds. The highest value is currently a value expressing 6 hours.
!uptime	Tells you how long the bot has been online and connected for. It will show globally seen messages, as well as how many messages are attributed to the invoking guild.
!userinfo	Shows information about the invoking user. Basically an alias of !info but doesn't require being able to look up others enabled.
!voice	Shows information about a voice or stage channel.

Syntax and Examples

Below are the syntax requirements of the above commands, along with an example to show how it works.

Syntax	Examples
!announce ROLE MESSAGE	!announce Episodes This is a message for all Episodes role users!
!avatar MEMBER/USER	!avatar @SajuukBot#2980 !avatar 161815653387468800 !avatar [no argument returns your own]
!charinfo TEXT	!charinfo my input here
!get_ids TEXT !uid TEXT	!get_ids SajuukBot#2980 (161815653387468800) has joined the server
!info MEMBER/USER !userinfo	!info @SajuukBot#2980 !info 161815653387468800 !info SajuukBot !userinfo [alias for yourself]
!jumbo EMOTES	!jumbo :lul: :D :smile:
!lock REASON !unlock REASON	!lock this channel has been flooded in spammers, cleaning up now. !unlock the spammers have been removed, carry on.
!logs STATE	!logs hush or !logs unhush
!ping	No arguments.
!quote MESSAGE_ID	!quote 12345678912345678
!server	No arguments.
!slowmode TIME REASON	!slowmode 10 slow down !slowmode 10s slow down !slowmode 0 no slow down
!uptime	No arguments.
!voice CHANNEL	!voice My Voice Channel !voice 900319022837563392

!voice

!voice CHANNEL
!voice Some Voice Channel
!voice 757247619385917537