├── HOW_TO_INSTALL.md ├── PRIVACY.md └── README.md /HOW_TO_INSTALL.md: -------------------------------------------------------------------------------- 1 | # How to setup ServerStats 2 | Here is a step by step instruction, if you need more help after doing the steps you can join **[the support server here](https://discordapp.com/invite/vE8qKNV)**. 3 | Make sure that the bot has **Manage Channels, Read Text Channels & See Voice Channels and Connect** permissions, but if you didn't change the invite link or settings on the invite page it should be good. 4 | 5 | **Important** You can check if the bot has the right permissions by running the command `s/check`. 6 | 7 | **[You can also watch a instruction video here.](https://vimeo.com/316592316/b7bd1ea09b)** 8 | 9 | --- 10 | 11 | # TABLE OF CONTENTS 12 | 1. [STEP 1 (ADDING THE BOT)](#step-1-adding-the-bot) 13 | 2. [STEP 2 (START THE SETUP)](#step-2-start-the-setup) 14 | 3. [HOW TO CUSTOMIZE THE COUNTERS](#how-to-customize-the-counters) 15 | 16 | --- 17 | 18 | # Step 1 (Adding the bot) 19 | The first thing you have to do is add the bot to your server, use **[this link](https://discord.com/oauth2/authorize?client_id=458276816071950337&permissions=1068048&response_type=code&redirect_uri=https%3A%2F%2Fserverstatsbot.com%2Fsetup&scope=bot)** to add the bot. (You need to be logged in to Discord in your browser). 20 | 21 |  22 | 23 | * Step 1: Click on the dropdown to show a list of server. 24 | * Step 2: In the list select your server or the server you want to add the bot to. 25 | * Step 3: Click on the blue authorize button. 26 | * Step 4: Do the "I'm not a robot" thing. 27 | 28 | --- 29 | 30 | # Step 2 (Start the setup) 31 | After you have added the bot you need to set it up. 32 | 33 |  34 | 35 | * Step 1: Type in the chat: **s/setup** or **@ServerStats setup** and then the channel type you want (**voice** or **text**) (after the command you will get a message if there is a error or if the bot is done). 36 | 37 | --- 38 | 39 | # How to customize the counters 40 | ## Custom the counter text: 41 | You can change the counter text like normal just right click on the channel and click Edit Channel, keep in mind that there must be a number in the name (only the first number in the name will change). 42 | 43 | ## Disable or enable a counter: 44 | 45 | You can disable counters by just **deleting the counter** or use the **s/counter delete** command, you can get them back by using **s/reset** or **s/counter create** (you can see a full list of all the counters with this command `s/counter`) 46 | 47 | ## Change to text channels: 48 | 49 | You can also change the counter to a text channel (default is voice) just use this command **s/channel change**, keep in mind that there must be a number in the channel name. 50 | 51 | --- 52 | -------------------------------------------------------------------------------- /PRIVACY.md: -------------------------------------------------------------------------------- 1 | ## **PRIVACY NOTICE** 2 | ### Last updated: `August 9, 2020` 3 | #### Thank you for choosing to use my bot ServerStats (“we”, “our” and "us"). We think that privacy is one of the most important things, that's why will really commit in make our bot as transparent and privacy-friendly. We will **never** sell or share your data and we only collect data that is needed to make the bot work. If there are any terms in this privacy notice that you do not agree with, please discontinue the use of our bot and our services. 4 | 5 | #### This privacy notice applies to our bots (ServerStats#0197, ServerStatsBeta#3789, ServerStatsPremium#3256 and ServerStatsAlpha#6502) and our website (serverstatsbot.com). Our website does use Google Analytics, you can see there privacy policy [here](https://policies.google.com/technologies/partner-sites). 6 | 7 | --- 8 | 9 | ## **TABLE OF CONTENTS** 10 | 1. [WHAT INFORMATION DO WE COLLECT/STORE?](#1.-WHAT-INFORMATION-DO-WE-COLLECT/STORE?) 11 | 2. [HOW DO WE USE YOUR INFORMATION?](#2.-HOW-DO-WE-USE-YOUR-INFORMATION?) 12 | 3. [HOW CAN I SEE AND/OR DELETE STORE INFORMATION?](#3.-HOW-CAN-I-SEE-AND/OR-DELETE-STORE-INFORMATION?) 13 | 4. [WILL YOUR INFORMATION BE SHARED WITH ANYONE?](#4.-WILL-YOUR-INFORMATION-BE-SHARED-WITH-ANYONE?) 14 | 5. [HOW LONG DO WE KEEP YOUR INFORMATION?](#5.-HOW-LONG-DO-WE-KEEP-YOUR-INFORMATION?) 15 | 6. [DO WE MAKE UPDATES TO THIS POLICY?](#6.-DO-WE-MAKE-UPDATES-TO-THIS-POLICY?) 16 | 7. [HOW CAN YOU CONTACT US ABOUT THIS POLICY?](#7.-HOW-CAN-YOU-CONTACT-US-ABOUT-THIS-POLICY?) 17 | 18 | --- 19 | 20 | ## **1. WHAT INFORMATION DO WE COLLECT/STORE?** 21 | ### **A. NON-AUTOMATICALLY STORE DATA.** 22 | #### Most of the data that the bot uses is stored after running a command (so by user interaction), everything that is stored after running a command is used to make the bot work. The main function of our bot (counting channels) requires the bot to know with channel have to be updated. 23 | 24 | #### Currently the bot stores the following data after running some of the commands that is required to make the bot work (server ID, channel ID, custom welcome text, goal information and server settings like prefix and disabled commands). If you use the premium bot and are a Patreon it will also store data about you and this includes (user ID, donate tier, and activated servers in IDs). This is also all the data that can be deleted by you (the user). The last data that is stored after user interaction is vote data and this includes (user ID, total votes, and when you vote for the last time). 25 | 26 | #### There is also a part that can't be deleted and it's blacklisted data and this includes (user ID, reason, by, date and if you were informed). this data can only be deleted by a staff member and is only used to protect our bot. 27 | 28 | ### **B. AUTOMATICALLY STORED DATA.** 29 | #### There is some data that is collected and/or stored without you noticing it. This can be split into sections, preset data collection, and bot errors and logs. 30 | 31 | #### If you add the bot and the bot is online, it will already create a preset data collection. This means that the bot will already create a collection in the database for you. This is done because we assume that if you (the user) adds the bot you (the user) will also use the main function in our bot. To speed up the command like `s/setup`, `s/counter`, and other main functions we create a preset collection that only includes the server ID. 32 | 33 | #### The last part that the bot collects and stores are error logs, most of the time if you see an error message after running a command it's also logged in a log file. This log file could include the following (server ID, channel ID, command that was run). error logs are stored in a log file this means that there not stored in the database aside from all other data. 34 | 35 | --- 36 | 37 | ## **2. HOW DO WE USE YOUR INFORMATION?** 38 | #### All stored data is used to make the bot work. Without channel IDs our bot would have no way to find and update them. The additional vote data and only gets created when you vote, after that it's used to check if you have permissions to use additional counters. 39 | 40 | #### The logs that the bot makes are used to fix bugs and improve the bot. logs can also be used to work on future updates and changes. 41 | 42 | --- 43 | 44 | ## **3. HOW CAN I SEE AND/OR DELETE STORE INFORMATION?** 45 | ### **A. SEE WHAT IS STORED.** 46 | #### To make the bot as transparent as possible you can see everything that is stored about your server. It takes the full collection out of our database and sends it in the chat, you can do this by running the `s/data` command. The `s/data` command is locked behind permissions to make sure that only people that need the data can access it (if you run it in an open channel it's not our fault that everyone can see your data). 47 | 48 | #### Higher up staff may also have permissions to request and access data from you, this is never shared and is only used to give support. 49 | 50 | ### **B. DELETE WHAT IS STORED.** 51 | #### All data that has been stored (blacklist data not included) can be deleted and I also tried to make it as easy as possible. If you are using the normal bot you can delete the data in 4 ways (kicking and/or banning the bot, deleting the discord server, deleting your discord account or running the command `s/reset`). If you perform one of the actions mentioned it will permanently delete **ALL** data and there is no way to get your data back. 52 | 53 | #### If you're using the donator version of the bot you can still perform the actions mentioned above (the same actions as in the normal bot), this will **NOT** delete your donator data. If you want to remove your donator data you can stop the subscription or leave the support server (ServerStats Support), this will instantly delete all data. Not paying for the subscription will also result in the deletion of all your data. 54 | 55 | #### Deleted data will never be added back on request, if you lose your data because you perform an action that deletes your data it's really gone. if there is a fatal error in that database or there is a problem that messes up the data, a backup could be added back that could also include your data (you can still perform the same actions to get the data deleted). If the data has to be added back from a backup it will be mentioned first so you have time to get the data deleted again. 56 | 57 | --- 58 | 59 | ## **4. WILL YOUR INFORMATION BE SHARED WITH ANYONE?** 60 | #### No, we do not share any information and this will stay like that. It's still possible that someone sees the information if you (the user) run the `s/data` command and it's your (the person that runs the command) responsibility to run this command in a private channel. 61 | 62 | --- 63 | 64 | ## **5. HOW LONG DO WE KEEP YOUR INFORMATION?** 65 | ### **A. NORMAL USER AND SERVER DATA.** 66 | #### All user and server data is stored as long as you use the bot. After the data is deleted all data will still be stored in a backup. Current database backups are stored for around 1 month (ServerStatsBeta and ServerStatsAlpha do not make database backups). 67 | 68 | ### **B. ERRORS AND LOGS.** 69 | #### Most of the time error logs are stored until the problem related to the log has been fixed (so until a bot update). If you don't plan to use and/or stored the log it gets deleted on a full bot restart or full server restart (we can't give an estimated time). 70 | 71 | --- 72 | 73 | ## **6. DO WE MAKE UPDATES TO THIS POLICY?** 74 | #### Yes, as our products and function have changes it may also bring some data store changes with it. All future changes that may be made surrounding data will be added/removed here. If we change something in here then we will notify users (the user) through our support server (ServerStats Support) and you can also find the most recent version online (on our Github). If you don't receive a notification due to you not being in the support server then this is your own responsibility. 75 | 76 | --- 77 | 78 | ## **7. HOW CAN YOU CONTACT US ABOUT THIS POLICY?** 79 | #### You can always contact me directly through discord by DMing me (ZixeSea#1234) or joining the [support server](https://discord.com/invite/vE8qKNV) (ServerStats Support). You can also send an email to support@serverstatsbot.com (keep in mind that this could take some time to get a response). 80 | 81 | --- 82 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # ServerStats Bot 2 | This bot adds a unique way to show off your member counters, server stats, goals and welcomer messages in your server (fully customizable). 3 | 4 |  5 | 6 | **[ [BOT INVITE LINK](https://discord.com/oauth2/authorize?client_id=458276816071950337&permissions=1100816&response_type=code&redirect_uri=https%3A%2F%2Fserverstatsbot.com%2Fsetup&scope=bot) | [SUPPORT SERVER](https://discordapp.com/invite/vE8qKNV) | [INSTRUCTIONS VIDEO](https://vimeo.com/316592316/b7bd1ea09b) | [WEBSITE](https://serverstatsbot.com) ]** 7 | 8 | --- 9 | 10 | ## Bot Features 11 | * Fancy and unique counters! 12 | * Easy to setup, disable and customize. 13 | * Automatically updating counters **(with 10 min delay)**. 14 | * Can also show additional info. 15 | * Really good uptime and support. 16 | * Bot also has welcomer and goal support. 17 | 18 | ### Bot counters 19 | #### Main bot [15]: 20 | The main bot contains a good set of counters that set a nice base (you can even find some counters here that most other bots ask money for), here is a full list: **all**, **members**, **bots**, **channels**, **text**, **voice**, **categories**, **announcement**, **roles**, **role**, **emojis**, **static**, **animated**, **boosts** and **tier**. 21 | 22 | #### Premium bot [21]: 23 | The premium bot contains all the counters mentioned above and more, here is a full list: **all**, **members**, **bots**, **channels**, **text**, **voice**, **categories**, **announcement**, **roles**, **role**, **emojis**, **static**, **animated**, **boosts**, **tier**, **bans**, **connected**, **online**, **offline**, **status** and **streaming**. 24 | 25 | #### Additional options: 26 | Outside all the counters the bot also has options to create a **welcome channel** and **goal counter and channel**, it also contains other commands that show you info about the server, channels, roles and users (inside your server only). 27 | 28 | ### Bot permissions 29 | #### Sending messages [4]: 30 | * **Read messages** 31 | * **Send messages** 32 | * **Enbed links** 33 | * **Attach Files** 34 | 35 | #### Creating and updating counters [3]: 36 | * **Manage channels** 37 | * **View Channel** 38 | * **Connect** 39 | 40 | >***NOTE:*** If the bot doesn't work, doesn't respond or doesn't show up on the right side (in the members list) then 95% of the time it has something to do with permissions. Always check permissions in the server settings and channel you want to use it in. 41 | 42 | --- 43 | 44 | ## Important 45 | ### Current bots 46 | * **ServerStats#0197** ([458276816071950337](https://discord.com/oauth2/authorize?client_id=458276816071950337&permissions=1100816&response_type=code&redirect_uri=https%3A%2F%2Fserverstatsbot.com%2Fsetup&scope=bot)) 47 | * **ServerStatsBeta#3789** ([466612542832377877](https://discord.com/oauth2/authorize?client_id=466612542832377877&permissions=1100816&response_type=code&redirect_uri=https%3A%2F%2Fserverstatsbot.com%2Fsetup&scope=bot)) 48 | * **ServerStatsPremium#3256** ([697173663048269874](https://discord.com/oauth2/authorize?client_id=697173663048269874&permissions=1100828&response_type=code&redirect_uri=https%3A%2F%2Fserverstatsbot.com%2Fsetup&scope=bot)) 49 | * **ServerStatsAlpha#6502** ([619868280596856842](https://discord.com/oauth2/authorize?client_id=619868280596856842&permissions=1100828&response_type=code&redirect_uri=https%3A%2F%2Fserverstatsbot.com%2Fsetup&scope=bot)) 50 | 51 | >***NOTE:*** Here is a list of bots that are related to this project (any other bot is fake or a scam), always make sure you use an invite link from a trusted source. 52 | 53 | ### Additional info 54 | * ServerStats is made with the idea to make it free, so you will see a lot of things that are free in this bot but paid in other comparable bots (like changing the counter text). 55 | * **ServerStats requires some permissions**, If you don't give the bot the right permissions it won't work (you can check it by using `s/check`). 56 | * ServerStats is trusted by more then **1 million different** servers. 57 | * ServerStats is also accepted on multiple bot list websites, here are some examples: **[top.gg](https://top.gg/bot/458276816071950337)**, **[discord.bots.gg](https://discord.bots.gg/bots/458276816071950337)**, **[discord.boats](https://discord.boats/bot/458276816071950337)**, **[bots.ondiscord.xyz](https://bots.ondiscord.xyz/bots/458276816071950337)** and **[botsfordiscord.com](https://botsfordiscord.com/bot/458276816071950337)**. 58 | 59 | --- 60 | 61 | ## How is it build? 62 | ServerStats is built using JavaScript (Node.JS). The main modules that the bot uses are **Eris (modified)** and **Eris-Sharder (modified)**, the bot is also using some other modules like: **Axios** and **Mongoose**. 63 | 64 | At the time the bot itself and all code related to it is closed source, this means you can't access it in any way. 65 | The reason for this is to make it difficult if not impossible to make clones/copies of the bot or code (copies could be used in malicious ways). 66 | 67 | --- 68 | 69 | ## Database and data (MongoDB) 70 | Of course the bot needs the save some data but it only save data he really needs (this includes server and channel ids). 71 | You can also see all that has been saved about your server by using `s/data`, this sends an exact export of your servers collection of data. 72 | 73 | You can also easily delete the data by kicking or banning the bot or running the command `s/reset` (this means that after this you can't get your data back even if you kick the bot by accident). 74 | 75 | Only the devs can access the server where the database is running on so that means that only the devs can have full access to the complete database. 76 | 77 | --- 78 | 79 | ## Discord bot list sites 80 |