Anitra
Anitra is a server-utilities Discord bot. Made to be simple to setup, flexible, and free!
Features
- An Auto-Roles Feature
- An Embed Builder
- A Suggestions Feature
- A Private Rooms Feature
- A Claimable-Roles Feature
What is this?
This is the documentation/guide for Anitra. It is meant to thourghly explain how to setup certain features, and what the terminologies of each feature means. Making it easier and less confusing as possible.
Auto Role
The Auto-Role feature is meant to assign a person a role when they join the server.
You are able to specify what role(s) should be assigned to bot accounts upon join, and to people upon join.
Note
Anitra requires the
Manage Rolespermission for this to work.Anitra also needs to be above the role(s) you would like to add to the Auto Role feature.
Examples
Bot Accounts
Let's say that we want bot accounts to recieve the test-bot role, we would have run /autorole add bot role: @test-bot, and this would happen whenever a bot joins:
User Accounts
Now let's say we wanted user accounts (people) to recieve the member role, we would then run /autorole add user role: @Member, which would then lead to this happen when ever a person joins:
Removing the role(s)
Removing the role(s) that you no longer want to be assigned is as simple as /autorole remove <user|bot> role: @role, and Anitra will no longer assign these role(s) to the user/bot accounts.
If you would like to know which role(s) you are able to remove, run /autorole list. This will show the list of role(s) that Anitra originally was suppose to assign, which will then allow you to remove the role(s) you desire.
Embed Builder
The embed builder feature allows you to create an embed with content of your choosing, as Discord users are unable to do this, and are not allowed to work around this as stated by Discord.
Note
Anitra requires the
Embed Linkspermission to do this.Anitra also requires the
Send Messagespermission in the channel where the embed should be posted
Setup
Firstly run /embed build. This will return buttons that will give you a form that you can fill in with the content you want.
An example of a finished embed:
Terminology
| Name | Meaning |
|---|---|
| Title | The big text at the top of the embed. |
| Author | Works like a title, except this allows you to add an icon/avatar next to it. |
| Description | The smaller (and more explanatory) text of the embed. |
| Colour | The hex colour to show on the left side of the embed. |
| Fields | Work like descriptions, except this allows to give headings (name) to your text (value). |
| Image | The larger image at the bottom of the embed, usually used for embeds. |
| Thumbnail | The smaller image on the top right of the embed. |
| Footer | The very small text at the bottom of the embed. |
Private Rooms
This feature allows server members to have their own personal voice channels, which they can of course add people into.
Note
Anitra requires the
Move MembersandManage Channelspermissions to do this.
Example
If we were to run /rooms setup as an administrator, it will create a voice channel named Create Private Room, unless you provide a name for it. Yes, it is customisable :)
Now, whenever someone joins that voice channel, a new one shall be created with the following format for the room's name: {member}'s room (Example: Sham's room). Which they can add people to if they would like.
Self-Claimable Button Roles
The Button Roles (or Self-Claimable Roles) feature allows server members to get roles that you (as an administrator) allow to be claimable.
Note
Anitra requires the
Manage Rolespermission for this to work.Anitra also needs to be above the roles you would like to add to the Button Roles feature.
Example of usage
Setup Embed Keywords
| Name | Meaning | Required? |
|---|---|---|
| Label | The word(s) to show on the button. | No |
| Style | The colour/color of the button. (Meanings under style types) | Yes |
| Emoji | The emoji to show on the button. | No |
Style Types
| Name | Meaning |
|---|---|
| Primary | Blurple |
| Secondary | Gray/Grey |
| Danger | Red |
| Success | Green |
Suggestions
This feature allows people to suggest features for your server, or service (depending on how you intend to use it).
Note
Anitra requires the
Send MessagesandEmbed Linkspermissions to do this. This includes every channel that has been enabled.
Setup
Firstly, you (as an administrator) need to setup a Pending channel, before doing anything else. This can be set up using the /suggestions configure channel type:Pending channel:#channel
Secondly, you have to actually enable the feature. This can be achieved by running /suggestions configure enabled:True.
After these are both configured, you will be able to enable other channels. Alternatively you could only enable the Pending channel only. People will still be able to submit suggestions using /suggest.
What does each channel mean?
Here is a detailed tabel explaining each channel type's purpose:
| Channel Type | Purpose | Required? |
|---|---|---|
| Approving | The channel to post suggestions that have been approved by administrators. | No |
| Pending | The channel to post suggestions that have been sent and are being reviewed by administrators. | Yes |
| Denied | The channel to post suggestions that have been denied by administrators. | No |
Decided that you no longer want to use this feature? No problem! Simply run /suggestions configure enabled:False to do this.
Managing Suggestions
Now that we've enabled suggestions, how do we actually manage them?
This can be achieved by running /suggestions <approve|deny> suggestion:ID reason:reason.
Some examples could be:
/suggestions approve suggestion:42 reason:This is indeed a great suggestion! We shall implement it right away./suggestions deny suggestion:70 reason:This is a good suggestion, however due to a Discord limitation, we are unable to achieve this.
Terms of Service and Privacy Policy
Last Update and Effective: December 28, 2022
This Terms of Serivce and Privacy Policy applies to the Discord Bot: Anitra#9270 (ID: 1043892494280175616)
Terms of Service
Usage Agreement
By inviting the bot and using its features (including but not limited to: commands, suggestion system, button roles), you agree to the below Terms of Service and Privacy Policy (the "Policy") of the bot.
You acknowledge that you have the right to freely use the bot on any Discord Server you share with the bot, you have the right to invite it to a server that you have "Manage Server" rights for and that this right may be revoked at any point in time with or without reason to be determined by PrimerNetwork.
Inviting the bot may collect certain and specific data as defined in the Policy. The intended usage of this data is for the core functions of the bot including but not limited to: command handling, guild specific settings, the Suggestions System, Button Roles, Private Rooms and Automatically Assigned Roles.
Intended Age
Anitra may not be used by any person or persons under the specified minimal age defined in Discord's Terms of Service. Usege of this bot while under this specified age will result in a violation of these terms and will result in blacklisting from all PrimerNetwork Bots as well as removal and blacklists from any and all servers owned by the person or persons.
Affiliation
Anitra is not affiliated with, supported or made by Discord Inc. Any direct connection with Discord or any of its Trademark objects is purely coincidental. PrimerNetwork does not claim to have the copyright ownership of any and all Discord Assets, trademarks or intellectual property.
Liability
PrimerNetwork may not be made liable for individuals breaking these Terms at any given time. PrimerNetwork has faith in the person or persons using the bot to be truthful about their information and misuing the bot or the Services provided by Discord in any malicious way.
Updates to the Policy and Rights of PrimerNetwork
PrimerNetwork reserves the right to update these terms at our discretion, giving you a 1 (one) week (7 days) period to opt out of these terms if you do not agree with the changes. You may opt out by removing Anitra from any server you have the rights for.
Privacy Policy
Data Collection and Usage of Data
Anitra collects data to maintain the features provided in the bot's service. Below is a list of the data we collect and how it is used:
- Guild/Server IDs:
- The Guild/Server ID is used to maintain and use the settings and features users enable within the server. This includes features like Button Roles, Auto Roles, Private Rooms and Suggestions as well as our error logging.
- Channel IDs:
- Channel IDs are used to send data within a specific channel. For suggestions, any suggestion made by a user is sent to the specified channel. For button roles, this is to store the channel that the button roles message is tied to. For logging purposes (such as error logs), this data is used to tell us more about the error in occurred.
- User IDs:
- Anitra uses User IDs to ensure the bot is able to function properly and not get confused with what user is performing what action.
Shared Information
PrimerNetwork does not share any of the information stored within our database with any other entity outside of Discord Inc. Any information stored is secured and only accessable by PrimerNetwork.
Contact
If you have questions or concerns with any of the terms stated above, you may contact PrimerNetwork via our Email: privacy@primernetwork.net
To have your data removed, please contact data-removal@primernetwork.net