How to setup T4 bot

Creating a badge

To make the bot working properly, you must create your first badge.

/create

After typed the command, the bot will give you the detailed modal to fill.

Detailed Modal

This section requires you to name the badge, it will show in member’s badges and server’s badge list.

This section will assign the emoji or text to the badge, it will be used for assigning that emoji/text beside the nickname.

Note: This can’t replace the role icon feature from Discord, it just only adds the emoji/text to the member’s nickname.

Give the description to announcement badge.

Default message:

{member_mention} obtained **{badge_name}**, and now has {member_badges_count} badges!

*This badge is owned by {badge_owners_count} members.*

Give a ping message to announcement badge.

Default message:

Hey, {member_mention}! You received a new badge!

Giving the badge to a member/role

Giving to a member

To reward member for achieving something, you can reward them a badge.

/give [badge] [role]

Giving to a role

You can make the bot given/taken the badge to a member automatically when they have/not have the specific role.

/give-to-role [badge] [role]

Advanced Giving commands

Giving to members in a role

You can make the bot given the badge to members who have the specific role.

/give-to-role-members [badge] [role]
  • Remember that this is one-time action, so the bot only gives the badge to members, not manage the badge.

After using command

After typed, the bot will show you the list of members whose nickname will be changed after applying. To accept, press👍.

Removing a badge

Removing from a member

To take a badge from member(s), you can use the remove command.

/give [badge] [member_1] <member_2> <member_3> <member_4> <member_5> <member_6> <member_7> <member_8> <member_9>

Removing from a role

You can make the bot not manage the badge to a member automatically when they have/lose the specific role anymore by using remove-from-role command.

/remove-from-role [badge] [role]

Advanced Removing commands

Removing from members in a role

You can make the bot not given the badge to members who have the specific role anymore by using remove-from-role-members command.

/remove-from-role-members [badge] [role]

Removing all badges from a member/role

If you want to remove all badges from a member/role, you can use /remove-all-from command.

/remove-all-from <member_or_role_id> <member>

Removing from the server (delete a badge)

If you don’t want to use the badge anymore, you can delete it by using server-remove-badge command.

/server-remove-badge [badge]

After using command

After typed, the bot will show you the list of members whose nickname will be changed after applying. To accept, press👍.

Adding role emoji to nickname

This is an extra feature that most of members want to use. This feature will add role emoji to member’s nickname.

This progress will be done automatically if you finished these:

  • Added the emoji or text in Nickname Emoji (or Text) textbox with /create command
  • Used /give-to-role command

If you forgot to add the emoji or text in Nickname Emoji (or Text) textbox, don’t worry, you can use edit badge command.

/edit [badge] <image> <new_name> <emoji_or_text> <from_status> <description> <ping_text>

Changing nickname format

Set nickname format

This tool helps you choose the style of nickname that you prefer to for your server.

/set-nick-format [format]

Set max emojis in nickname

If you want to choose how many emojis can show in the nickname, you can use set-nick-max command.

/set-nick-max [max_emojis]

After using command

After typed, the bot will show you the list of members whose nickname will be changed after applying. To accept, press👍.

And that’s all, hope you understand how to use T4 Bot through this quick tutorial. If you have any question, you can Leave a Reply below or ask in T4 Support Server. Thanks for using our bot, we’re appreciated about that! 💖

FAQ

Run the below command and you can see which condition is not fulfilled.

/check-member-tool

After running the command above, you can see the detailed embed below.

Check-member-tool embed

For each unfulfilled condition, you can see the explanation and solution in this table.

Condition: T4 has manage nicknames permission to change <user>‘s nickname.

This will let the bot change member’s nickname. Without this permission, role emoji feature doesn’t work properly.

Solution: give T4 bot the manage nicknames permission.

Condition: T4 has change nickname permission to change its own nickname.

This will allow the bot to test the nickname format before changing member’s nickname to make sure that it works properly.

Solution: give T4 bot the change nicknames permission.

Condition: T4’s top role (<T4’s top role>) is higher than <user>‘s top role (<user’s top role>).

This will allow the bot to change member’s nickname who has the top role below T4’s top role. Without this, the bot can’t change those members.

Solution: move the T4 bot role higher than the top role of member or assign T4 bot the role that higher that the top role of member.

Condition: <user> is not the owner.

This is the issue that most of members ask us in Support Server.

Because of role hierarchy, no one (included bot) is not allowed to change owner’s nickname.

Solution: sadly, you can’t do anything for this. You can only change your nickname manually.

This is the issue that most of members ask us in Support Server.

Because of role hierarchy, no one (included bot) is not allowed to change owner’s nickname.

Solution: sadly, you can’t do anything for this. You can only change your nickname manually.

Currently the bot doesn’t support those formats. Because some members use emojis in their username/nickname. After the bot adds emoji part to nickname, the bot won’t understand which part is {n} – nickname and which part is {e} – emoji.

Example:

A member has this nickname: Techmon 🤝

And the badge has this emoji: 🚀

So, after adding the badge to that member, the result is: Techmon 🤝 🚀

The bot cannot detect that user’s nickname anymore because the bot can’t detect where the separation part – space character.

Input nickname format: {n} {e}

Like this: Techmon 🤝 🚀

Or like this: Techmon 🤝 🚀

en_USEnglish