InfiniTeaInfiniTea Docs

Commands

Use these Discord slash commands to interact with InfiniTea. Type / in any server where the bot is installed to see available commands.

User commands

/arpg

  • Syntax: /arpg <game>
  • What it does: Shows the current season timing or upcoming season details for supported ARPGs via https://arpg-timeline.com.
  • Example:
/arpg Diablo 4

/give_rep

  • Syntax: /give_rep <user>
  • What it does: Gives 1 community reputation point to the target.
  • Anti-abuse: Built-in cooldown prevents spam.
  • Example:
/give_rep Smex

/info

  • Syntax: /info <category> <sub_category?>
  • What it does: Retrieves content from Info Book by category or sub-category.
  • Visibility: Display options are controlled by role settings. See Role Forge.
  • Examples:
/info Rules
/info Rules Posting

/leaderboard

  • What it does: Sends an automatically disappearing leaderboard. Expires after 5 minutes.
  • When no category provided: Returns the combined leaderboard.
  • Example:
/leaderboard

/rank

  • What it does: Returns your rank card. Priority: user-personalized → guild-personalized → default InfiniTea.
  • Aliases: /card
  • Example:
/rank

/rank (user)

  • Syntax: /rank <user>
  • What it does: Shows another member’s rank card.
  • Aliases: /card <user>
  • Example:
/rank Jaqquor

/ping

  • What it does: Replies with Pong!

/temp-message

  • What it does: Sends a message that automatically expires.

Staff / admin commands

/give_staff_rep

  • Syntax: /give_staff_rep <user>
  • What it does: Gives 1 staff reputation point to the target.
  • Permissions: Requires Administrator.
  • Anti-abuse: Shares the same cooldown protections as /give_rep.
  • Example:
/give_staff_rep Smex

/clear

  • Syntax: /clear <number_of_messages> <filter_by_user?> <filter_by_role?> <filter_by_bot?>
  • What it does: Bulk deletes recent messages. Up to 500 messages can be removed per run.
  • Notes:
    • Messages older than 14 days take longer to process because Discord requires individual deletions.
    • Optional filters let you target messages from a specific user, role, or bots only.
  • Permissions: Requires Manage Messages.
  • Example:
/clear 100 filter_by_user:@Spammer

/drop

  • Syntax: /drop <activity_type> <amount> <lottery_chance?> <lottery_multiplier?>
  • What it does: Manually creates an XP drop in the current channel.
  • Activity types: message, engagement, voice, reputation, reaction.
  • Requirements: Tracking must be enabled for the selected activity type. If a drop already exists and you later disable that type, the existing drop will still be honored.
  • Lottery (optional):
    • lottery_chance is a percentage from 0–100.
    • If the lottery triggers, the reward is multiplied by lottery_multiplier.
  • Examples:
/drop message 50
/drop reaction 100 20 3
  • Notes:
    • Deleting a drop will remove it entirely.

/leaderboard (category)

  • Syntax: /leaderboard <category>
  • What it does: Sends an expiring leaderboard for the selected category.
  • Example:
/leaderboard messages

/remove

  • Syntax: /remove <messages_with_emojis> <filter_by_user?> <filter_by_role?> <filter_by_bot?>
  • What it does: Finds the most recent messages with reactions and removes their emoji. Use the filters to narrow the search.
  • Modes: Supports clearing all reactions or specific emoji during the prompted workflow.
  • Permissions: Requires Manage Messages.
  • Example:
/remove 25 filter_by_role:@Moderators

/report

  • Syntax: /report <user>
  • What it does: Files a report for a warning or actionable offense to the InfiniTea network.
  • Impact: May result in cross-server bans. Use with extreme caution.
  • Abuse policy: Misuse may lead to removal of access to this feature.

Posting embeds

/post_leaderboard

  • Syntax: /post_leaderboard <activity_type_1> <activity_type_2?> … <activity_type_6?>
  • What it does: Posts a persistent leaderboard message. With one activity type it renders a single pane. Add up to six activity types to build an interactive panel with quick-switch buttons for each.
  • How it behaves:
    • The first activity type loads immediately.
    • When multiple activity types are provided, smart buttons appear under the embed so viewers can toggle between them instantly.
    • The refresh button re-pulls data for whichever activity is currently selected.
  • Autocomplete tips:
    • Only activity types with tracking enabled for your guild appear in the dropdown.
    • Previously selected activity types are hidden so you can’t pick duplicates.
  • Use this when: You need a leaderboard message that sticks around and can be refreshed in-place instead of expiring.

/post_lfg

  • What it does: Posts the LFG creation container so members can spin up new events directly from the configured channel.
  • Prerequisites: Configure the Command Container channel and Participant Destination channel in the LFG panel before posting.
  • Config-aware: Honors maximum posts per user, voice participation requirements, and other rules you enable in the LFG settings.

/post_quest

  • Syntax: /post_quest <opt1> <opt2?> <optX?>
  • What it does: Posts the configured Join Quests embed.
  • Behavior:
    • One option: Renders a button.
    • Two or more options: Renders a selector menu in the given option order.
    • When multiple options are provided, the embed uses the content from option 1 to render.

Bulk role management

/roles add

  • Syntax: /roles add <where_user_has_role_1> <give_them_role_1> <opts...>
  • What it does: Bulk grants a role to users who already have a specified role (query-based targeting).
  • Notes: Operations are intentionally batched to respect rate limits. Large jobs can take up to an hour; you’ll be notified when complete.

/roles remove

  • Syntax: /roles remove ...
  • What it does: Bulk removes roles using the same query-style targeting as add.

/roles replace

  • Syntax: /roles replace ...
  • What it does: Replaces one role with another in bulk (combines remove and add semantics).

Persistent vs. temporary leaderboards

  • Temporary: /leaderboard messages auto-expire after 5 minutes.
  • Persistent: Use /post_leaderboard <activity_type_1> <activity_type_2?> … to post a refreshable message that can show multiple categories in a single place.

Development/debug commands

Commands not listed above are intended for the development team or debugging. If support asks you to run one, they’ll provide exact instructions.