Dashboard

This page details information on how to customize your profile, create your own server store, and much more. The dashboard can be accessed here.

# My Servers

This page is split up into two categories, "Your Managed Servers" and "Your Other Servers". Servers are categorized based on your permissions in those servers.

### Managed Servers

A server is listed as a "Managed Server" if you meet one of the following conditions:

* You are the owner of the server.
* You have a role which gives you administrative powers.
* You have a role designated as a Bot Manager.

If the condition is met, you will be able to access the Modules and Settings pages which will allow you to configure various server settings.

### Other Servers

A server is listed as a "Other Server" by being in a server with Tatsu. You will not be able to access the Modules and Settings pages unless you meet the necessary conditions mentioned above.

## Main

In the main tab which opens immediately after choosing the server, the user can edit the rank card and the wallet, and view their server inventory and server rankings. To modify the rank card, the user only needs to use the "edit card" button, which allows them to switch the rank card to the classic Tatsu version 2 design and equip accolades which they have in their inventory. The user can also use a background they have in their inventory or upload a custom one if they are a supporter. The wallet may be similarly customized.

## Reward Store

The reward store allows the user to purchase various server rewards such as role items, accolades and custom items using server currencies. These rewards need to be set up by a server manager first.

## Modules

From here a server manager can modify and set up all of Tatsu's interactions with the server, from server items to logs and role management.

## Rewards & Store

This module allows the server manager to set up the points system, the server store, rewards and leveled roles.

### Score, Points & Rep

In this section the manager can set up custom loyalty points and server score. Both may be customized using the following parameters:

* Name: the name of the points or score. For example, setting the name of the points to Tatsucoin will make Tatsu display them as such.
* Emoji icon: the emoji used alongside the points or score - these will appear wherever these values are mentioned.
* Range: the amount of points or score which is gained by the user sending a message. If the lowest and highest numbers are not the same, the user will randomly receive an amount between them.
* Cooldown: the amount of time it takes for Tatsu to not give the user points or score after their message in seconds. By default, if a user sends a message and earns their points and score, they will not be able to earn any more until two minutes after.
* Blocked roles: the roles selected here will be incapable of receiving points or score.
* Blocked channels: these channels are excluded from giving anyone points or score. Messages will not earn the users anything. A good option for channels with bot spam or other spammable content.
* Logs: Tatsu will log any manual points or score additions so you can keep track of them.

In addition, the "Global XP / Credits: Blocked Channels" option to turn off the gain of both local points and score as well as global XP and credits.

### Rewards Store

This section allows the server manager to view and most importantly add server rewards for the rewards store. Below the list of the rewards, the user may use the button to add an item, although the item needs to first have been made using the item creator.

The dashboard then prompts the manager to choose the reward item's type from one of the three server item types: accolades, server roles and custom items. Upon choosing either of the options, a prompt appears for selecting the item, naming it and entering a description. In the third and last step the reward cost in the server's currency, quantity of the reward available and a unique key ID for the reward as well as an image must be provided. Setting the quantity of the item to -1 will make an infinite amount available for purchase. The manager may then finalize the item and it will be available on the rewards store.

### Leveled Roles

This section lets the server manager set up leveled roles; roles based on the amount of server score the users have. Upon reaching the required amount, the role will be rewarded to the user. The manager may define various parameters:

* Role reward settings: allows changing whether Tatsu will remove the previous leveled role of the user in return for the new one or if it will allow them to stack together.
* Adding leveled roles: allows creating new leveled roles by choosing a role and the required amount of score to receive it.
* Role earn message: the message which will appear when the user receives the role. This message may be a combination of plain text as well as an embed which may be previewed using the embed creator.

### Item Creator

Allows the user to create server items to be put on the rewards store. These items may be of three types: accolades, server roles and custom items. Accolades are local versions of badges which will appear on users' rank cards. Server roles are items which award the user with a role. Custom items can represent anything.

To create an item, the user first needs to choose the type. The user then needs to input various item properties:

* Name: the name of the item.
* ID: a unique ID to identify the item. Has to be in lowercase and uses underscores. For example, a\_custom\_id.
* Description: a description for the item.
* Role: the role associated with the item. **For role items only.**
* Discord emoji: the discord emoji associated with the item which will serve as it's icon. It may be any default emoji or a custom server emoji.

The user may then save the item and the item will be created and ready to use.

### Command List

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The command may also be disabled or whitelisted on some channels. Whitelisting disables all commands on all channels except for certain channels or roles which are allowed. The following commands are available:

* `t!dailies`
* `t!points`
* `t!wallet`
* `t!inventory`
* `t!shop`
* `t!item`
* `t!leveledroles`
* `t!exchange`
* `t!quests`
* `t!trade`

## Reaction / Self Roles

This module allows the manager to set up reaction and server join roles as well as self roles.

### Reaction Roles

Reaction roles are roles which may be gained by using a reaction on a message. The manager may choose an existing message by providing its message ID or create a new message using Tatsu's embed creator to have the reactions on. Message ID may be found using Discord's developer mode. After adding the message, if it wasn't a preexisting one Tatsu will send the message and the manage roles button may be used to add a role and its associated reaction emoji.

### Server Join Roles

These roles are awarded to a user upon joining the server. Similar to its command alternative, the manager only needs to choose the role and the bot will start adding it to every new user when they join.

### Self Roles

These roles can be acquired by users who wish to have them using the selfroles command. The command may also be disabled and set up in this section.

## Notifications & Logs

This module is responsible for the bot's logging functionality as well as welcome and goodbye messages.

### Greeting Messages

The manager can use this section to set up messages which will be sent when a user joins or leaves. The dashboard will then bring up the message and embed creator.

### Kick & Ban Logs

This section is responsible for setting up custom kick and ban logs. The user may create the message using the embed creator and select a channel. A default, simplified version can be enabled using the notify command.

### Voice Channel Logs

This section is responsible for setting up custom logs for users joining, leaving or changing to another voice channel. A default, simplified version can be enabled using the notify command.

### User Join / Leave

This section is responsible for setting up custom logs for users joining or leaving the server. A default, simplified version can be enabled using the notify command.

## Games & Social

This module is responsible for managing game-related and social commands.

### Social

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The following commands are available:

* `t!rank`
* `t!profile`
* `t!reputation`
* `t!top`
* `t!played`
* `t!badges`
* `t!background`
* `t!beautiful`
* `t!giveaway`
* `t!house`
* `t!setcountry`
* `t!settag`

### Games

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The following commands are available:

* `t!tatsugotchi`
* `t!fishy`
* `t!slots`
* `t!cookie`
* `t!support`

## Core Commands

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The following commands are available:

* `t!help`
* `t!ping`
* `t!invite`
* `t!upvote`

## Fun Commands

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The following commands are available:

* `t!8ball`
* `t!ratewaifu`
* `t!catfacts`
* `t!dogfacts`
* `t!coin`
* `t!dice`
* `t!dog`
* `t!cat`
* `t!choose`
* `t!fortune`

## Utilities

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The following commands are available:

* `t!avatar`
* `t!channel`
* `t!color`
* `t!info`
* `t!math`
* `t!remindme`
* `t!role`
* `t!server`
* `t!shard`
* `t!usage`
* `t!emoji`

## Search & Info

A list of the commands under this module which may be disabled or enabled, or upon entering the settings be allowed or blocked by various roles. The following commands are available:

* `t!anime`
* `t!urban`
* `t!wiki`
* `t!youtube`
* `t!weather`
* `t!image`

## Settings

This allows the manager to manage basic Tatsu settings for the server, including the normal and admin prefixes, Tatsu's default timezone, the server's website and description, and the server role used to permit management of the bot through the dashboard.

# The Shops

The user can view and purchase all global items in this tab, using either tokens or credits as the currency. The user may filter the items based on the following parameters:

* Tatsugotchi: all Tatsugotchi related items, such as sitters, capsules and food.
* Housing: various houses, furniture and furnishings which may be placed using the housing command.
* Profile backgrounds: backgrounds which can be equipped on your profile card.
* Rank backgrounds: backgrounds which can be equipped on your rank card.
* Level backgrounds: backgrounds which can be equipped on your level-up card.
* Wallet backgrounds: backgrounds which can be equipped on your wallet card.

Upon clicking on the purchase button with either currency, the user is prompted to confirm the purchase. Note that due to the trading system being implemented, a user can purchase and own duplicates of items. The items can then be found in the user's inventory.

# My Profile

This tab allows the user to manage their personal profile.

## View Profile

The view profile tab allows the user to change their profile and level-up backgrounds as well as view their personal buffs and the global rankings. You can also check your meeko character and customize it, as well as connect a Solana/Ethereum Wallet To edit the profile card, the user only needs to use the "edit card" button, which allows them to switch the profile to the classic Tatsu version 2 design, equip badges which they have in their inventory, set their title and info and use a background they have in their inventory or upload a custom one if they are a supporter. The level-up card may be similarly customized.

## Pet & Housing

This tab allows you to customize your active pet and pets in daycare. By selecting a pet, you can add cosmetics and change its status card and name tag!

## Inventory

The inventory tab allows the user to manage all the items in their inventory. The user may filter out the items seen based on their type:

* Card Backgrounds: backgrounds for profile, level-up, rank and wallet cards.
* Badges: the various profile badges the user may have.
* Tags: profile tags which the user may have.
* Tatsugotchi: Tatsugotchi items such as capsules, potions and various other things.
* Housing: housing items such as furniture and furnishings as well as houses which the player owns.
* Fishing: fishing related items. Currently unused.
* Usables: items which can be used by using the inventory command.
* Boxes & Capsules: Tatsugotchi capsules which can be opened to receive a new Tatsugotchi and furniture boxes.

## Profile Settings

The user may change the country flag and tag currently shown on their profile here.

## Logout

Clicking on the last option log out, will log you out from the dashboard.

# Embed Creator

In various parts of the Tatsu dashboard the user is prompted to edit a message.

The user may create a rich embed, or a simple message.

## Placeholders

LEVELEDROLES - specific to leveledroles message fields.
 `<@&$ROLEID$>` | mentions the role | @Chicken Squad

VOICELOGS - specific to voice log message fields.
 `$OLDCHANNELID$` | displays switched channel ID | 658787490978725938