Skip to content
This repository has been archived by the owner on Sep 3, 2022. It is now read-only.

Latest commit

 

History

History
101 lines (91 loc) · 8.34 KB

README.md

File metadata and controls

101 lines (91 loc) · 8.34 KB

StarBot

⚠️Warning⚠️: This bot uses dictionaries as its "database". I've recently learned more about SQL, so I decided to rewrite my bot. Most likely this bot will no longer be maintained. You can find the new bot here.

StarBot is a free, advanced, and highly-customizable starboard bot. This documentation gives you a quick start to using the bot, as well as listing all the available commands. If you see a problem, please let me know. You can use the bots suggest command, or you can join the support server. My discord username is @CircuitSacul#5585.

Invite StarBot to your server

Join the support server

Bot Features:

  • Supports multiple starboards
  • Supports multiple normal and custom emojis for each starboard
  • Has default settings and per-starboard settings
  • Image-only channels
  • Auto-star channels
  • Server leaderboard
  • User stats
  • Completely free

(I plan to bring many more features, such as role awards, advanced whitelisting and blacklisting, etc. If you have any suggestions for what features you would like to see, you can use the suggest <suggestion> command.)

How to Read This:

Some things you should know before reading the docs:

  • Don't actually type <, >, [, ]
  • Words found inside of these symbols ([argument]] or <argument>) are called arguments.
  • Arguments inside square brackets ([argument]) are optional arguments. You can set them, but you don't have to.
  • Arguments inside <, > (<argument>) are required arguments. You must set these, and not doing so will cause an error
  • If you see multiple arguments inside of brackets ([channel_id|channel_name]), that means that you can set one or none of those arguments (never more than 1).
  • If you see multiple arguments inside of <, > (<seconds|hours>), that means you must set one of the arguments, no more, no less.
  • I added command aliases to make using the bot quicker. After each command, there is a description, example usage, as well as aliases.
    • commandName: Command description commandName <how> <to> <use> cn <h> <t> <u>

Here is an example command: Say you wanted to make the bot repeat the word "hello" 10 times. The command to do this is !repeat <word> [number_of_times=1]. You would type !repeat hello 10. Notice how one of the arguments is inside of the </>, while another is inside of the [/]? The ones inside the square brackets are optional arguments. They have a default value, so you don't always have to type it out. For example, typing !repeat hello would repeat the word 1 time, because the default value for number_of_times is 1. The other argument, inside of the </>, is a required argument. If you don't set it, it will raise an error.

Setup: