To invite the bot to your server, use this link. Catalogger’s prefix is cl!
or lg!
.
A list of all commands can be shown with cl!help commands
.
The easiest way to set up basic logging is through the dashboard! Naming invites and the watchlist can only be done with commands, though.
To start logging events, use the command cl!setchannel
with a comma-separated list of events.
- For example: cl!setchannel message_update,message_delete
To disable logging for an event, use cl!setchannel
with the --clear
flag.
- For example, cl!setchannel --clear message_update
will stop logging the message update event.
To ignore events from a channel, use cl!ignorechannel
in that channel.
To stop ignoring the channel, run the command again.
Invites are logged by default (although the bot needs both “Manage Server” and “Manage Channels” for it to work).
You can give invites names, to track where people are coming from.
To do this, use the cl!invites name
command with the invite code and the name you want to give to the invite.
You can use cl!invites
to list all of the server’s invites.
You might want to redirect message update/delete events from some channels to specific log channels (for example, NSFW channels).
You can do this with the cl!redirect
command, for example: cl!redirect #the-void #autodelete-log
.
Note: there must be a default log channel for the event for redirecting to work.
Note 2: you can remove a redirect by replacing the second channel link in the redirect command with clear
.
You can use the cl!watchlist
command (and its cl!watchlist add
and cl!watchlist remove
subcommands) to manage your server’s user watchlist.
This can be used to notify mods of potentially suspicious members (re)joining the server.
Users on the watchlist will have a note attached to their join notification.
If the bot stops logging an event, try the cl!permcheck
command;
if that’s all clear, but the bot still isn’t logging, try the cl!clearcache
command.
If it’s still not working, feel free to join the support server and ask there!
To delete all of your server’s data, use the cl!cleardata
command.
This will reset your server’s configuration, and delete all cached messages.
This process is irreversible.
The following events are implemented:
MESSAGE_DELETE
: deleted messages, both normal and PluralKit messagesMESSAGE_DELETE_BULK
: bulk message deletionsMESSAGE_UPDATE
: edited messagesGUILD_MEMBER_ADD
: new member joiningGUILD_MEMBER_REMOVE
: member leavingINVITE_CREATE
: created invitesINVITE_DELETE
: deleted invitesGUILD_BAN_ADD
: banned usersGUILD_BAN_REMOVE
: unbanned usersGUILD_MEMBER_UPDATE
: role updatesGUILD_MEMBER_NICK_UPDATE
: username/nickname updatesCHANNEL_CREATE
: channel creationsCHANNEL_UPDATE
: channel updatesCHANNEL_DELETE
: channel deletionsGUILD_ROLE_CREATE
: role creationsGUILD_ROLE_UPDATE
: role updatesGUILD_ROLE_DELETE
: role deletionsGUILD_UPDATE
: server updates, such as name and icon changesThe following events are not yet implemented:
GUILD_EMOJIS_UPDATE
: changes to a server’s custom emotes