XP DEPOT Documentation
📈 XP & Leveling System
XP DEPOT features a comprehensive experience (XP) and leveling system designed to reward user activity and engagement on your server.
How XP is Earned:
- Messages: Users earn a random amount of XP (typically between 15-25) for sending messages. There's a cooldown (usually 60 seconds) per user to prevent spamming for XP.
- Reactions: Reacting to messages also grants a small amount of XP, with its own cooldown.
- Voice Activity: Users passively earn XP for spending time in voice channels. XP is typically awarded in intervals (e.g., every 15 minutes).
- Winning Games: Successfully winning bot-hosted games (like Trivia, Blackjack, etc.) typically awards a set amount of XP.
Leveling Up:
As users accumulate XP, they will level up. The XP required for each level increases, following a formula like: Required XP = 150 * (1.4 ^ (Current Level - 1)). This means higher levels require significantly more XP.
Level-up announcements can be configured to post in a specific channel, celebrating user achievements.
Rank Card:
Users can check their current XP, level, rank, and progress towards the next level using the /xp_rank_card command. This displays a customizable image card.
XP Boosts & Shop:
Users can purchase temporary XP multipliers (e.g., 2x XP for 1 week) using their accumulated XP via the /xp_shop command. Boosts can also be gifted to other users. Server administrators can configure a channel for boost purchase/gift announcements.
🎮 Community Commands
These commands are available to all users on the server.
General:
/xp_rank_card [user]: Displays your (or another specified user's) rank card showing XP, level, and server rank./xp_shop [view|buy|gift]: Opens the XP Boost shop.view: Shows available boosts.buy [boost_id]: Buys a specific boost for yourself.gift [boost_id] [user]: Gifts a specific boost to another user.
/xp_help: Shows an ephemeral help message listing all available community commands and general bot information.
Games:
All game commands start with /xp_game_. Playing and winning games typically awards XP.
/xp_game_trivia [category]: Starts a trivia game. You can optionally specify a category or let the bot pick one./xp_game_blackjack: Starts a game of Blackjack against the house./xp_game_button_search: Starts a server-wide button searching game./xp_game_connect4 [@opponent]: Challenges another user to a game of Connect 4./xp_game_hangman: Starts a game of Hangman where one player sets a word and others guess./xp_game_memory: Starts a memory game where you repeat a sequence of emojis./xp_game_rock_paper_scissors [@opponent]: Challenges another user to Rock Paper Scissors./xp_game_texas_holdem: Starts a game of Texas Hold'em poker./xp_game_tic_tac_toe [@opponent]: Challenges another user to Tic-Tac-Toe.
🛡️ Administrator Commands
These commands are typically restricted to users with administrative permissions.
Configuration & Settings:
/xp_admin_settings: Displays all current XP system settings for the server./xp_admin_channel_level_ups [#channel]: Sets the channel for level-up announcements./xp_admin_channel_game_winners [#channel]: Sets the channel for game win announcements./xp_admin_channel_boosts [#channel]: Sets the channel for XP boost purchase/gift announcements./xp_admin_channel_leaderboard [#channel]: Sets the channel for automated daily leaderboard posts./xp_admin_channel_trivia [#channel]: Sets the channel for automated trivia games.
Automated Tasks:
/xp_admin_auto_post_leaderboard [enable/disable]: Toggles the automated daily leaderboard posting./xp_admin_auto_add_users [enable/disable]: Toggles whether new members are automatically added to the XP system./xp_admin_trivia_scheduler [toggle/setcategories] [options]: Manages the automated trivia feature. Use 'toggle' to enable or disable the automated trivia (which runs on a fixed, predefined UTC schedule). Use 'setcategories' to define the pool of trivia categories for the automated games.
User Management:
/xp_admin_user_add [user/@role]: Manually adds a user or all users with a specific role to the XP system./xp_admin_user_update [user/@role/all]: Syncs database information (nickname, level, role emoji) for specified users with their current server status.
Data Management:
/xp_admin_data_export: Exports user ID and XP data for the server to a JSON file./xp_admin_data_import: Imports user XP and Level data from a JSON file (use with caution).
Utilities:
/xp_admin_leaderboard: Manually displays the current XP leaderboard for the server./xp_admin_ping_bot: Checks the bot's current websocket latency./xp_admin_help: Shows an ephemeral help message with all administrator commands.