Commands

This page lists every command for OnlyOneMessage. Instead of the regular help command, this page shows a more detailed version of each command, explaining its function, what it does, etc.

Use the right side of this documentation to jump to commands.

Main Commands

The most important commands for OnlyOneMessage.

---

/setup

Setup OnlyOneMessage for your server. This command also is used to repair its changes. This process is automatic and should be finished within 10 seconds.

What OnlyOneMessage will do:

• Creates a channel named #onlyonemessage and changes topic

• Create roles: OnlyOneMessageBlacklist, OnlyOneMessageWhitelist

• Create database data - OnlyOneMessage will store your Server ID, Server Name, and the #onlyonemessage channel ID

• Sends a message in #onlyonemessage

Essential Permissions:

• Add Reactions: OnlyOneMessage will be able to react with every message set in the OnlyOneMessage channel. - ⛈️ The user has been blacklisted successfully. - 😇 The user is whitelisted, therefore they cannot be blacklisted. - ❌ An error occurred. See message.

Member permissions needed: Manage Channels, Manage Roles

Bot permissions needed: Manage Channels, Manage Roles, Manage Threads

---

/remove

Undo changes OnlyOneMessage has done to your server. This process is automatic and should be finished within 10 seconds.

What OnlyOneMessage will do:

• Removes the set OnlyOneMessage channel, if it exists

• Removes OnlyOneMessageBlacklist and OnlyOneMessageWhitelist roles, if they exist

• Removes server from all databases

Since OnlyOneMessage does not store role information, if the 2 roles are renamed, the bot cannot interact with it. The OnlyOneMessage channel is an exception, as its ID is stored in its database.

Member permissions needed: Manage Channels, Manage Roles

Bot permissions needed: Manage Channels, Manage Roles

---

Essential Commands

Essential commands will be listed here.

---

/essential config

This command lets you configure OnlyOneMessage to your liking. As of v1.2, there is only 2 options to configure. More might be added when updates are released.

• Message Deletion Options

  • Configure if people can be unblacklisted if they delete their message. Their blacklist role will automatically be removed upon deletion.

• Logging Options

  • Set up a channel for OnlyOneMessage to log in. Selecting 'None' disables logging. The bot will only monitor from the set channel. OnlyOneMessage logs: - Message deletions - Whitelists - Unwhitelists - Blacklists - Unblacklists

This command completely relies on database changes. Therefore, the bot does not need any permissions.

Member permissions needed: Manage Channels, Manage Roles

---

/essential modify

Modify a member's blacklist or whitelist roles. This command applies to logging.

• Modify Choices

  • Add Whitelist Role

  • Remove Whitelist Role

  • Remove Blacklist Role

Formerly /essential whitelist, unwhitelist, unblacklist on v1.2

Member permissions needed: Manage Roles Bot permissions needed: Manage Roles

---

Miscellaneous Commands

Misc. commands will be listed here.

---

/misc invite

Sends a link to invite OnlyOneMessage or the Trello.

---

/misc feedback

Send feedback to the developers of OnlyOneMessage. Your feedback will be sent to the development Discord for review.

Formerly /misc bugreport and /misc suggest on v1.2

Abuse of these commands can result in a ban from using them!

---

/misc stats

Shows basic statistics of OnlyOneMessage.

• /stats shows:

  • Version - The current version of OnlyOneMessage

  • Bot Uptime - The total uptime of OnlyOneMessage

  • Bot Startup Time - When the bot was first started

  • Global Messages - Blacklisted and Whitelisted messages combined

  • Global Blacklisted Messages - Messages that were blacklisted

  • Global Whitelisted Messages - Messages that were whitelisted

  • Global Servers - Every server OnlyOneMessage is in

  • Global Members - Every member in every server OnlyOneMessage is in

  • CPU Usage - The CPU Usage of the server.

  • Memory Usage - The memory usage of the server.

  • Disk Space - The storage of the server

  • Guild Shard - What shard your server is in

  • Total Shards - The count of every shard OnlyOneMessage has

  • Python version

  • Discord.py version

Shards are separate instances of your bot running in parallel to handle large-scale server loads by distributing servers across multiple processes.