Home

Contents

Bot category commands

These are commands that directly control the bot.
They cannot be disabled with the +toggle command.

+hello

"makes me say my hello message"

Simple starting command. This just makes 42 send her hello message. This could be used for testing if the bot is awake.

+about

"makes me DM you some information about me"

This command makes 42 DM you what language she is written in, what version she is in, and who created her.
It also sends an invite to Kiwi Hangout.

+join

"makes me link my invite page"

This command just links to 42's invite link

+help

"makes me tell you my functions"

This command is 42's in-Discord help command. It can be used to get a comprehensive list of almost all of her commands.
It can also be used to get detailed help on a particular topic or search for commands.
This is also the source for all the quoted summaries of commands.

Usage:
+help 'command name'
Fetches the long-help of a specific command.
<user> +help info
<42> Help for `+info`
  `+info` makes me tell you a whole bunch of cool stats and info
  `+info [user 'username']` gets info about yourself or another user
  `+info server` gets info about the server
  ...
+help 'category name'
Fetches the short-help of every command in a category.
<user> +help Information
<42> Information - Tools for telling you things
  `+perms` gets your channel permissions
  `+msgcount` makes me generate a list of authors in this channel
  `+avy` lets me get the avatar of a user
  ...

+tutorial [Server Owner]

"makes me teach you about my basic functionality"

This starts up 42's interactive introduction, consisting of ~10 messages that can be viewed with reactions.
It outlines a lot of the basic commands.
If she is ignored for too long, she will automatically end the tutorial with the outro message.

Usage:
+tutorial Starts the interactive tutorial.

+alias [Bot Admin]

"changes my alt call character"

This command allows a different character or string to be used to call a command.
However it does not remove using + as a call character.

You cannot use call characters that use spaces.

Usage:
+alias 'call'
Changes the alias for the entire server
<user> +alias 'pls'
<42> I have changed this servers alias to `pls` (`plshelp`, `plstag`, `plsalias`)
+alias +
Removes the alias from the server
<user> +alias +
<42> I have removed the alias for this server.

+faq

"makes me answer some of your questions"

This command just makes 42 PM you a page of frequently asked questions.
The questions that are sent and more can also be found here.

+toggle [Bot Admin]

"lets me disable commands"

Toggle allows server admins to selectively enable and disable commands.
By default, all commands are enabled and must be toggled off where required.
Commands that have been disabled can still be used by moderators and can still be queried in +help, however, a [Disabled by server] tag will be applied to the help message.

Commands that have been disabled will yield a message telling the user what happened when they try to use it.

You cannot toggle commands that are catagorised as "Bot" commands.

Usage:
+toggle 'command'
Disables or enables individual commands
<user> +toggle choose
<42> I have disabled that command
<user> +help choose
<42> Help for +choose [5/10s] [Disabled by server]
  `+choose` makes me pick from a list of options
  `+choose 'optn1' 'optn2' [...]`
+toggle 'category'
Disables or enables all the commands in a set
<user> +toggle Fun
<42> I have disabled 16 commands:
  ayy, coins, sync, ...
+toggle list
Lists all commands that have been disabled
<user> +toggle list
<42> Disabled commands:
  Fun: ayy, coins, sync, ...
  RNG: choose

+botban [Bot Mod]

"makes me ignore any commands from a user"

This allows botmods to stop problematic users from being able to access the bot, but only on your server.
Botbanned users still have access to the +check command and any automatic responses.

There is a way that a user can be globally botbanned, but only the developers have access to that command.

Botbanned users who attempt to use a command will be met with a message telling them about the botban.
This message will only be sent at maximum once every minute to prevent botbanned users from message spamming, however this will not prevent them from spamming the command failure logs in the modlog.

Usage:
+botban 'user' User is the member to botban.
<mod> +botban user
<42> I have botbanned that user. They will no longer be able to use my commands.
<user> +tag
<42> I cannot run this command as you have been botbanned on this server.
<user> +tag
<user> +tag

+botunban [Bot Mod]

"makes me remove a botban on a user"

This allows botmods to undo botbans on users.

Usage:
+botunban 'user' User is the member to botban.
<mod> +botunban user
<42> I have unbanned that member.
<user> +tag
<42> You asked me about tags, but didn't tell me what to do. Use `+help tag`

+cleanup [Bot Mod]

"removes my own messages and if possible my command calls too"

This makes the bot scan all the messages sent in the channel and delete any that she has sent.
If she has the Manage Messages permission, she will also remove any messages that start with the call character.

Due to the way that bulk deleting works, you cannot cleanup messages over 2 weeks old, and if the bot does not have Manage Messages, she will have to delete messages one by one which may take up to 20 seconds.

Usage:
+cleanup ['limit'] Limit is how many messages will be scanned, not how many will be deleted. If it is not supplied, then it defaults to 100.

+check [Always] [2/2m]

"makes me tell you what bot permissions you have"
Permission: [Always] This command is ignored by botbans but has a relatively strict ratelimit to compensate.

This command makes 42 query all of her main permission checks and tell the user what they have.
This command uses a codeblock language called diff which changes the colour of a line based on what it starts with.
  • Yellow lines (that start with a +) means a permission the user has
  • Red lines (that start with a -) means a permission the user does not have
Usage:
+check ['member']
Member is who to check. If no-one is given, then it defaults to the caller
<user> +check
<42> Permissions for user
  - server owner  : owner of server
  + server admin  : members with Manage Roles
  - server manager: members with Manage Server
  ...
  - buds          : squas' close friends

+echo [Bot Mod]

"makes me repeat a message"

Just a simple dud command that makes 42 re-send the contents of a message.

Usage:
+echo 'content'

+status

"adds or checks custom statuses"

Patreon supporters have the ability to create custom messages to add to 42's status cycle, so this command is how they do that.

Usage
+status
Posts the full status cycle.
+status check 'user'
Checks a user's custom status.
User is the person to check.
+status add 'type' 'content'
Adds a custom status.
Type is one of "playing", "watching" or "listening"
Content is up to 5 words. Rules/Guidelines

Owner only commands.

These are commands in this category that can only be used by squaswin and are only displayed here as a display of transparency.

  • +eval executes arbitrary lines of code, usually for debug reasons.
  • +traceback fetches the full stacktrace of the last eval command that went wrong.
  • +source pastes the contents of a given method into the chat.
  • +reload reloads all the language files in the bot.
  • +backlog recalls the last 100 actions taken by the bot, such as commands posted or announcement cycles.
  • +powermod forcibly gives a member in an arbitrary server the Bot Admin permission.
  • +config updates the bots friends list, blocked members and blocked servers.
  • +uplink connects 2 channels together, relaying messages between them.

"Wait wait wait wait, +backlog? Are you spying on us?!"
Absolutely not. All backlog stores is a channel, a username and the root command, not full commands.
When this command is normally used, it is to check for large amounts of identical commands being spammed by single users or servers.

"Also powermods? Isn't that a bit breaking?"
Yes, but it is also almost never used. When I see spammers either in the on-screen logs or the backlogs, I can either uplink to the channel and tell them to cool it with the spam, or if I have a trusted member in Kiwi Hangout from that server, I can powermod them and ask them to do my bidding directly.
Don't forget that the Bot Admin permission only allows users to botban, cleanup and toggle, so no real damage could be done.

Return to top.