Store moderation notes about users.

The ModNotes cog implements the storage of records for use by moderators in the course of their duty, and as a tool of communication between moderators. It allows arbitrary text records to be recorded, alongside with the author and timestamp, associated to various community users.

1. notes (note)

Access a user’s moderation logs.

Usage: .[notes|note] <user> [page]

Parameters

<user>
@user. The user for whom to retrieve moderation notes. This can be an @mention, a Discord ID (numerical only), or a KazTron ID (starts with *).
[page]
number. Optional. The page number to show, if there are more than 1 page of notes. Default: last page (latest notes)

Details

10 notes are shown per page. This is partly due to Discord message length limits, and partly to avoid too large a data dump in a single request.

Members
Moderators, Administrators.
Channels
Mod channels.

Examples

  • .notes @User#1234
  • .notes 330178495568436157 3

1.1. notes add (a)

Add a new note.

Usage: .notes [add|a] <user> <type_> <note_contents>

Parameters

<user>
@user. User. See notes.
<type_>
string. Type of record. One of:
  • note: Miscellaneous note
  • good: Positive contributions
  • watch: Behaviours to monitor
  • int: Moderator intervention
  • warn: Formal warning
  • temp: Temporary ban (enforced by bot)
  • perma: Permanent ban (not auto-enforced)
  • appeal: Formal appeal received, decisions, etc.
<note_contents>
string. Complex field of the form: [timestamp="timespec"] [expires="timespec"] <contents>
[timestamp|starts|start|time]
timespec. Optional. Set the note’s time (e.g. of an incident). The timespec is “smart”, and can accept a date/time (3 Dec 2017 5PM - default timezone is UTC), or relative times (10 minutes ago, in 2 days, now). For relative times, make sure to use the keywords ago or in, or the result might not be as expected. Quotation marks required. Do not use days of the week (e.g. Monday). Default: now
[expires|expire|ends|end]
timespec. Optional. Set when a note expires. Affects tempbans and the notes watches function, otherwise is a remark for moderators. See above for timespec formats. Default: never
<contents>
string. The note text to store.

Details

Attachments in the same message as the command are saved to the note.

Members
Moderators, Administrators.
Channels
Mod channels.

Examples

  • .notes add @BlitheringIdiot#1234 perma Repeated plagiarism. - Create a permanent ban record with no expiry date.
  • .notes add @BlitheringIdiot#1234 temp expires="in 7 days" Insulted @JaneDoe#0422 - Create a temp ban record that expires in 7 days.
  • .notes add @CalmPerson#4187 good timestamp="2 hours ago" Helped keep an argument in check - Create a record for an incident 2 hours ago.

1.2. notes expires (x, expire)

Change the expiration time of an existing note.

Usage: .notes [expires|x|expire] <note_id> [timespec=now]

Parameters

<note_id>
number. The ID of the note to edit. See notes.
[timespec]
timespec. Optional. The time that the note will expire. Format is the same as notes add (but quotation marks not required). Default: now

Details

Members
Moderators, Administrators.
Channels
Mod channels.

Examples

  • .notes expires 122 tomorrow - Change the expiration time of note
  • .notes expires 138 2018-01-24 - Change the expiration time of note

1.3. notes rem (r, remove)

Remove an existing note.

Usage: .notes [rem|r|remove] <note_id>

Parameters

<note_id>
number. The ID of the note to remove. See notes.

Details

To prevent accidental data deletion, the removed note can be viewed and restored by admin users.

Members
Moderators, Administrators.
Channels
Mod channels.

Example

  • .notes rem 122 - Remove note number 122.

1.4. notes watches (watch)

Show all watches currently in effect (i.e. all watch, int and warn records that are not expired).

Usage: .notes [watches|watch] [page]

Parameters

[page]
number. Optional. The page number to show, if there are more than 1 page of notes. Default: last page (latest notes)

Details

10 notes are shown per page. This is partly due to Discord message length limits, and partly to avoid too large a data dump in a single request.

Members
Moderators, Administrators.
Channels
Mod channels.

1.5. notes temps (temp)

Show all tempbans currently in effect (i.e. non-expired temp records).

Usage: .notes [temps|temp] [page]

Parameters

[page]
number. Optional. The page number to show, if there are more than 1 page of notes. Default: last page (latest notes)

Details

10 notes are shown per page. This is partly due to Discord message length limits, and partly to avoid too large a data dump in a single request.

Members
Moderators, Administrators.
Channels
Mod channels.

1.6. notes permas (perma)

Show all permanent bans currently in effect (i.e. non-expired perma records).

Usage: .notes [permas|perma] [page]

Parameters

[page]
number. Optional. The page number to show, if there are more than 1 page of notes. Default: last page (latest notes)

Details

10 notes are shown per page. This is partly due to Discord message length limits, and partly to avoid too large a data dump in a single request.

Members
Moderators, Administrators.
Channels
Mod channels.

1.7. notes name

Set the primary name for a user. This replaces the old name; to add aliases, use notes alias.

Usage: .notes name <user> <new_name>

Parameters

<user>
@user. The user to modify. See notes for user format.
<new_name>
string. The new primary name for the user. Max 32 characters, no newlines.

Details

Members
Moderators, Administrators.
Channels
Mod channels.

Example

  • .notes name @BlitheringIdiot#1234 Blathers

1.8. notes alias

Command group. Set or remove user’s aliases.

Usage: .notes alias <addrem> <user> <alias>

Parameters

<addrem>
add or rem. Whether to add or remove an alias.
<user>
@user. The user to modify. See notes for user format.
<alias>
string. The alias to add or remove. Max 32 characters, no newlines.

Details

Recommended usage:

  • Reddit usernames: /u/RedditUsername
  • IRC NickServ accounts: R:Nickname
  • Unregistered IRC users: nick!username@hostname masks
  • Known previous names or nicknames the user’s known by in the community.

For other Discord accounts, use notes group instead to group the accounts and their modnotes together.

Members
Moderators, Administrators.
Channels
Mod channels.

Example

  • .notes alias add @FireAlchemist#6543 The Flame Alchemist

1.9. notes group

Command group. Group accounts belonging to the same user.

A group identifiers different Discord accounts that are all considered to be the same individual. The notes command will show the user info and records for both simultaneously when either user account is looked up.

The users’ notes remain separate and can be removed from the group later.

Usage: .notes group

Details

Members
Moderators, Administrators.
Channels
Mod channels.

1.9.1. notes group add (a)

Group two users together.

If one user is already in a group, the other user is added to that group.

If both users are in separate groups, both groups are merged. This is irreversible.

See notes group for more information on grouping.

Usage: .notes group [add|a] <user1> <user2>

Parameters

<user1, user2>
@user. The users to group. See notes for user format.

Details

Members
Moderators, Administrators.
Channels
Mod channels.

Example

  • .notes group add @FireAlchemist#1234 @TinyMiniskirtEnthusiast#4444

1.9.2. notes group rem (r, remove)

Remove a user from the group.

See notes group for more information on grouping.

Usage: .notes group [rem|r|remove] <user>

Parameters

<user>
@user. The user to modify. See notes for user format.

Details

Members
Moderators, Administrators.
Channels
Mod channels.

Example

  • .notes group rem

1.10. notes removed

Show all removed notes, optionally filtered by user.

Usage: .notes removed <user> [page]

Parameters

<user>
@user. The user to filter by, or all. See notes for user format.
[page]
number. Optional. The page number to show, if there are more than 1 page of notes. Default: last page (latest notes)

Details

Members
Administrators.
Channels
Admin channels.

1.11. notes restore

Restore a removed note.

Usage: .notes restore <note_id>

Parameters

<note_id>
number. The ID of the note to remove. See notes.

Details

Members
Administrators.
Channels
Mod channels.

1.12. notes purge

Permanently destroy a removed note.

Usage: .notes purge <note_id>

Parameters

<note_id>
number. The ID of the note to remove. See notes.

Details

Members
Administrators.
Channels
Mod channels.

1.13. notes finduser

Deprecated as of version 2.2. Use whois.

Usage: .notes finduser

Details

Members
Moderators, Administrators.
Channels
Mod channels.