# Levlix - Full Documentation > Complete text of the Levlix Discord bot documentation, concatenated for language models. Levlix is a free, GDPR-compliant all-in-one Discord bot with RPG adventures, a server economy, XP and leveling, quizzes, counting games, moderation, ticketing, giveaways, and a web dashboard. Source: https://levlix.io/docs, 40 pages. Index with links: https://levlix.io/llms.txt --- # Page: https://levlix.io/docs/features/economy # Discord Server Economy A thriving server needs a thriving economy. The **Levlix Economy System** provides server owners with a fully customizable, robust virtual currency framework designed to reward activity and monetize engagement. ## Core Economy Mechanics * **Custom Server Currency:** Users earn points by participating in chat, completing tasks, or claiming their daily rewards. * **Server Shop System:** Admins can create custom shop items via the Web Dashboard. Users can purchase custom roles or digital goods using their hard earned coins. * **Points Override System:** Server moderators have full control. You can manually award or deduct points for specific community achievements. ![The points administration view, used to inspect and adjust member balances](https://levlix.io/static/docs-media/dashboard_points.webp) ## Interactive Games Levlix includes four built in games that serve as perfect coin sinks: ### Slots Spin the slot machine with `/slots`. Three reels spin with six different symbols, each worth a different payout. Rarer symbols pay more. Landing three matching symbols triggers a jackpot, while two matching symbols award a smaller win. ### Crash Play the crash game with `/crash`. After placing your bet, a multiplier starts climbing. Your goal is to cash out before the rocket crashes. The longer you wait, the higher the potential reward, but if the rocket crashes before you cash out, you lose your entire wager. ### Rock, Paper, Scissors Challenge the bot with `/rps`. Choose Rock, Paper, or Scissors and wager your points: * **Win:** Your bet is doubled (2x payout) * **Draw:** Your bet is returned * **Loss:** You lose your bet ### Tic-Tac-Toe Play Tic-Tac-Toe with `/tictactoe`, either against the bot or against another member. The winner takes double the wager. ## Game Statistics Use `/minigames-stats` to view your personal game performance including total winnings, total losses, net profit, and recent transactions. The `/minigames` dashboard provides a full overview with tabs for games, statistics, history, and leaderboard. ![The minigame statistics view, tracking games played, amounts wagered, winnings and jackpots](https://levlix.io/static/docs-media/dashboard_minigames.webp) *Note: Following Discord Developer policies, all games use strictly virtual currency with no real world monetary value.* --- # Page: https://levlix.io/docs/features/engagement # Advanced Engagement Growing a server is only half the battle. Keeping it active is the real challenge. Levlix provides a suite of **Engagement Tools** specifically engineered to boost your Discord server retention rate and chat activity. ## Dynamic Leveling System (XP) * **Text XP:** Users gain experience points for being active in text channels. * **Voice XP:** Users earn XP for time spent in voice channels. Only actively connected users earn voice XP (not server-deafened and not in the AFK channel). * **Level Roles:** Automatically reward your most dedicated members with custom vanity roles via the Web Dashboard. When a user reaches a configured XP threshold, the corresponding role is assigned automatically. * **Rank Command:** Users can check their level, total XP, rank, and progress with `/rank`. * **XP Leaderboard:** The `/leaderboard` command shows the top users ranked by XP on the server. ![The server leaderboard, ranking members by their accumulated XP](https://levlix.io/static/docs-media/dashboard_leaderboard.webp) ## Milestone System Levlix tracks individual and server-wide milestones to recognize dedicated community members: * **User Milestones:** Personal achievements like message count, voice hours, invite count, and more. View yours with `/milestones overview` or browse available milestones with `/milestones list`. * **Server Milestones:** Collaborative goals the entire community works towards. Check progress with `/server-milestone list` and claim completed rewards with `/server-milestone claim`. * **Milestone Leaderboard:** Compare your achievement progress against other members with `/milestones leaderboard`. ![The milestone configuration view for personal achievements and server-wide goals](https://levlix.io/static/docs-media/dashboard_milestones.webp) ## Daily Rewards Members can claim their daily reward with `/daily`. The system tracks consecutive claim streaks with milestone tiers: | Tier | Streak Required | |------|----------------| | Starter | Day 1 | | Bronze | 7 consecutive days | | Silver | 30 consecutive days | | Gold | 100 consecutive days | | Platinum | 365 consecutive days | Longer streaks award bonus points. Missing a day resets the streak back to 1. ## Welcome Features First impressions matter. You can set up custom Welcome and Goodbye messages via the Web Dashboard whenever a member joins or leaves. Messages support placeholders like `{user}`, `{username}`, `{server}`, and `{member_count}`. ## Quizzes Ignite your chat with periodic trivia questions! Levlix can drop automated quizzes rewarding the fastest answering users with economy coins. Admins manage all quiz creation and settings through the `/quiz quizadmin` dashboard. ## Tasks & Challenges Members can complete renewable daily and weekly challenges for point rewards. Use `/tasks list` to view your current progress. Tasks reset automatically at midnight (daily) or at the start of each new week (weekly). --- # Page: https://levlix.io/docs/features/events # Automate Community Events > [!IMPORTANT] > The Events module is opt-in. Server admins must enable it via **Dashboard → Modules** before members can participate. Keep your community engaged year-round with Levlix's **Community Event System**. Run seasonal campaigns, track participation, and reward active members — all without running cron jobs yourself. ## Event System Levlix provides a full event management system. All event commands live under the `/event` group: * Members run `/event list` to view all active events with details and rewards. * `/event leaderboard` shows who's leading the current event. * Admins manage events through `/event eventadmin` with a visual dashboard for starting, stopping, extending, and monitoring events. ![The event administration view, used to create and schedule community events](https://levlix.io/static/docs-media/dashboard_events-admin.webp) ## Seasonal Events Levlix ships with built-in seasonal events that bring themed activities to your server: * **Easter** — Seasonal Easter activities with collectible items and themed rewards. * **Summer** — Summer event with unique challenges and seasonal collectibles. * **Valentine** — Valentine's Day themed event with special items and rewards. * **Halloween, Christmas, Autumn, Spring, Winter, New Year** — Additional seasonal packs ready to rotate through the year. ![The member-facing event view, showing the currently running seasonal event](https://levlix.io/static/docs-media/dashboard_events.webp) Each seasonal event tracks participation, has its own leaderboard, and awards exclusive collectibles. View your collected items with `/event my_collections` and compare results across seasons with `/event history`. ## Not to Be Confused With Giveaways If you're looking for a classic raffle or prize drawing, that's a different module — see the [Giveaway Automation](https://levlix.io/docs/features/giveaways) page. --- # Page: https://levlix.io/docs/features/giveaways # Giveaway Automation Hosting giveaways on Discord usually means manual reminders, sketchy random.org screenshots, and arguments about fairness. Levlix takes the whole process off your plate. ## What Levlix Handles for You * **Fair Randomization:** Levlix securely and randomly selects winners from the pool of legitimate participants when the timer expires. * **Requirement Gates:** Set minimum levels or specific roles required to enter a giveaway. This drastically reduces alternate-account abuse and rewards your engaged members. * **Duration Tracking:** Giveaways automatically announce winners when the timer expires and credit the point prize directly to each winner's balance. * **Persistent Participation:** Giveaway buttons survive bot restarts, so members can always enter without the bot losing state. ![The giveaway management view, where giveaways are created and tracked from active to finished](https://levlix.io/static/docs-media/dashboard_giveaways.webp) ## Typical Use Cases * Reward members who hit a certain XP level. * Pair a giveaway with a milestone to celebrate a server milestone. * Run recurring weekly raffles where winners receive in-server currency instead of external prizes. Because the prize is paid out automatically in server points, winners can spend their reward immediately in the [Server Shop](https://levlix.io/docs/features/economy) or on other features without any manual intervention from staff. --- # Page: https://levlix.io/docs/features/integrations # Seamless Discord Integrations The modern gamer does not just play one game. **Levlix Integrations** allow your server members to bridge their Discord identity with external platforms. ## Supported Integrations ### In Game ID Registration Users can securely link external gaming IDs directly to their Discord profile using `/gameid`. The registration process includes: * **Interactive Registration Form:** A modal collects the user's Game ID. * **Admin Approval Workflow:** Submitted IDs can require admin review before becoming active. Admins manage requests, approvals, and settings through the `/gameidadmin` dashboard. * **Change Requests:** Users can request a Game ID update at any time. Changes go through the same approval flow. * **Persistent Views:** Registration buttons remain functional even after bot restarts. ![The Game ID view, listing the gaming accounts members have linked to their Discord profile](https://levlix.io/static/docs-media/dashboard_game-ids.webp) ### Dashboard OAuth Securely authenticate with your Discord account to manage your server settings and view your character data online via the [Levlix Web Dashboard](https://levlix.io/dashboard). Authentication uses the Discord OAuth2 protocol with JWT session tokens. --- # Page: https://levlix.io/docs/features/rpg/characters # RPG Characters & Classes > [!IMPORTANT] > The RPG module is currently in **beta**. Server admins must enable it manually via **Dashboard → Modules** before these commands become available to members. Your journey in the Levlix RPG starts by forging an identity. Users create a unique RPG persona directly in chat to embark on their adventure. ## Getting Started To begin your adventure, type `/rpg start` in any channel where the bot is active. Levlix will guide you through character creation, letting you choose a class and equipping your starter gear. View your character at any time with `/rpg profile`. ## The Six Classes Each class has unique base stats and uses a specific resource type for abilities: | Class | HP | ATK | DEF | INT | LCK | SPD | Resource | |-------|---:|----:|----:|----:|----:|----:|----------| | **Warrior** | 150 | 15 | 12 | 5 | 8 | 8 | Rage (100) | | **Ranger** | 100 | 14 | 8 | 8 | 12 | 12 | Energy (100) | | **Mage** | 80 | 8 | 5 | 18 | 10 | 9 | Mana (200) | | **Paladin** | 130 | 12 | 14 | 10 | 6 | 6 | Mana (150) | | **Rogue** | 90 | 16 | 6 | 7 | 15 | 14 | Energy (100) | | **Druid** | 110 | 10 | 10 | 14 | 8 | 8 | Mana (180) | ### Resource Types * **Rage:** Used by Warriors. Generated through combat actions. * **Energy:** Used by Rangers and Rogues. A fast-regenerating resource. * **Mana:** Used by Mages, Paladins, and Druids. Required to cast powerful class-specific spells. Regenerates between fights. ## Progression & Stats As you defeat monsters, you earn EXP. Leveling up automatically increases your base stats. Each class has different growth rates per level. | Stat | Description | |------|-------------| | **HP** | Your life force. If it hits zero in combat, you die and lose pending rewards. | | **ATK** | Your raw physical damage output. | | **DEF** | Reduces incoming physical damage. | | **INT** | Determines the power of abilities and spells. | | **LCK** | Increases your critical hit chance (+0.5% per point). | | **SPD** | Affects turn order and dodge chance. | ### Level Cap The maximum level is **150**. Higher levels require progressively more XP to reach. Use `/rpg rest` to recover HP between fights. ## The Global Leaderboard Competitive players can climb the global Levlix leaderboard. It tracks the highest leveled characters across all servers. Open **RPG Adventure → Leaderboard** in the [Levlix Dashboard](https://levlix.io/dashboard) to see where you stand in the realms. ![The global RPG leaderboard, ranking characters across all servers](https://levlix.io/static/docs-media/dashboard_rpg-leaderboard.webp) --- # Page: https://levlix.io/docs/features/rpg/combat # Combat Engine & Guild Raids > [!IMPORTANT] > The RPG module is currently in **beta**. Server admins must enable it manually via **Dashboard → Modules** before these commands become available to members. The heart of the Levlix RPG is its interactive, turn-based PvE combat system against a dynamic roster of monsters. ## Combat Modes ### Hunt The quickest way to earn gold and XP. Use `/rpg hunt` to engage a random monster in a short fight. There is a short cooldown between hunts. ### Adventure A longer combat sequence with increasing difficulty. Adventures have a longer cooldown and offer better rewards than standard hunts. ### Dungeons Multi-floor instances with progressively harder enemies and a boss encounter. Enter with `/rpg dungeon`. Each dungeon has a minimum and maximum level requirement: | Dungeon | Level Range | Floors | |---------|-----------|--------| | Forest Ruins | 10 - 20 | 5 | | Abandoned Mine | 20 - 35 | 7 | | Vampire Castle | 40 - 55 | 10 | | Volcano Depths | 55 - 70 | 12 | | Frozen Fortress | 70 - 85 | 15 | | Dragon Nest | 85 - 100 | 20 | Higher-level dungeons have longer cooldowns and better rewards. Each dungeon features boss encounters and rest points along the way. ## The Combat Engine When you encounter a monster, health, resource bars, and critical hits are calculated in real time. * **Basic Attacks:** Consistent damage using your ATK stat against the enemy's DEF. * **Class Abilities:** Consume your class resource (Rage, Energy, or Mana) to unleash powerful skills. * **Cooldown Management:** Skills have cooldowns that must be managed to survive elite enemies. ### Damage Mechanics * **Critical Hits:** Every attack has a chance to critically strike for bonus damage. Higher LCK increases your critical hit chance. * **Damage Variance:** Each hit deals slightly varying damage, keeping fights dynamic and unpredictable. ## Monster Types Monsters come in four tiers of increasing difficulty and reward: | Type | Description | |------|-------------| | **Normal** | Standard enemies found in hunts and early dungeon floors. | | **Elite** | Tougher monsters with better loot drops. | | **Boss** | Dungeon bosses with unique mechanics and guaranteed rare+ loot. | | **Raid** | The most powerful enemies, designed for coordinated party play. | ## Guild Raids (Co-Op Dungeons) Sometimes, a monster is too powerful for a single adventurer. Team up with other server members in cooperative dungeon runs via the Guild Raids system. Strategy and teamwork are required to defeat high tier bosses, but the exclusive rewards are worth the risk. Some dungeons are designed for groups and require a party. Completing a raid distributes loot to the entire party. Start a raid by grouping up with your friends using `/rpg party create` and entering a dungeon together! --- # Page: https://levlix.io/docs/features/rpg/equipment # Equipment, Inventory & Loot > [!IMPORTANT] > The RPG module is currently in **beta**. Server admins must enable it manually via **Dashboard → Modules** before these commands become available to members. An RPG is nothing without epic loot. In Levlix, defeating bosses and engaging in combat rewards you with items that you can equip to boost your stats. ## Equipment Slots Your character has **10 equipment slots**, each providing different stat bonuses: | Slot | Primary Stats | |------|--------------| | **Main Hand** | Attack, Critical Hit Chance | | **Off Hand** | Defense, Block Chance | | **Head** | Defense, INT | | **Chest** | Defense, max HP | | **Hands** | Attack, SPD | | **Legs** | Defense, HP | | **Feet** | SPD, Dodge | | **Cape** | Mixed stats | | **Ring** | Specialized buffs (LCK, INT, Regen) | | **Amulet** | Specialized buffs (Mana Regen, SPD) | ## Rarity Tiers Loot drops follow a weighted rarity system. Higher rarity items are rarer but significantly stronger: | Rarity | Availability | |--------|-------------| | **Common** | Frequently dropped by most enemies | | **Uncommon** | Regularly found in combat | | **Rare** | Uncommon drops, noticeably stronger | | **Epic** | Rare drops from tougher enemies | | **Legendary** | Very rare, powerful gear from bosses | | **Mythic** | Extremely rare, the strongest tier available | Normal monsters mostly drop Common and Uncommon gear, while dungeon bosses have significantly higher chances for Rare and above. ## Loot Drops Different monsters have specific loot tables. Bosses have a chance to drop rare, epic, or even legendary gear. Your equipped items are safely stored in your `/rpg inventory` where you can swap them out or sell unwanted items to the global merchant. ## Gems Gems provide additional stat bonuses when attached to equipment. Use `/rpg gems` to view your gem collection and the gem shop. Check your gem balance with `/rpg balance`. ## Mythic Sets & Crafting Gather materials from Dungeon Bosses and craft Mythic Sets with `/rpg craft` that provide immense synergy bonuses when fully equipped! Mythic items sit at the top of the rarity ladder with a 2.5x stat multiplier. ## Trading & Market * **Player Trading:** Start a direct trade with another player using `/rpg trade`. * **Grand Bazaar:** Buy and sell items on the global marketplace with `/rpg market`. ![The Grand Bazaar in the dashboard, where coins buy potions, equipment and materials](https://levlix.io/static/docs-media/dashboard_rpg-shop.webp) --- # Page: https://levlix.io/docs/features/rpg/overview # Levlix RPG Adventure: Overview > [!IMPORTANT] > The RPG module is currently in **beta**. Server admins must enable it manually via **Dashboard → Modules** before these commands become available to members. Transform your Discord server into a living fantasy world with the **Levlix RPG System**. Forget external websites or complicated setups. Your community can create characters, level up, and battle monsters entirely within Discord. ## What is Levlix RPG? The Levlix RPG module is a fully integrated roleplaying engine that offers a complete MMORPG-like experience directly in text channels. It features a robust class system with six unique classes, active combat mechanics, a deep equipment and crafting system, global leaderboards, and co-op guild raids. ![The RPG character profile in the dashboard: health, XP, gold and power, with tabs for inventory, dungeons, raids and the market](https://levlix.io/static/docs-media/dashboard_rpg-profile.webp) **Community Growth Tip:** Active RPG communities drastically increase message volume and user retention. Members return daily to grind levels, keeping your server metrics highly engaged! ## Core Systems * **[Characters & Classes](https://levlix.io/docs/features/rpg/characters)** - Six classes (Warrior, Ranger, Mage, Paladin, Rogue, Druid), each with unique resource types and stat distributions. * **[Equipment & Loot](https://levlix.io/docs/features/rpg/equipment)** - Ten equipment slots, six rarity tiers from Common to Mythic, and a full crafting system. * **[Combat Engine](https://levlix.io/docs/features/rpg/combat)** - Hunt monsters, explore dungeons, and challenge guild raids with a turn-based PvE system. ## Additional Systems * **Trading & Market:** Trade items directly with other players via `/rpg trade` or buy and sell on the Grand Bazaar marketplace with `/rpg market`. * **Gems:** Collect and manage gems to enhance your gear. Access the gem shop with `/rpg gems`. * **Crafting:** Gather materials from dungeon bosses and craft powerful Mythic equipment with `/rpg craft`. * **Achievements:** Track your progress across dozens of milestones with `/rpg achievements`. * **Parties:** Team up for cooperative content using `/rpg party create`, invite friends, and tackle dungeons together. * **Guilds:** Join a guild for exclusive raids and territory control via `/rpg guild info` and `/rpg guild raid`. * **Daily Quests:** Complete renewable daily objectives with `/rpg daily` for bonus gold and XP. ## Quick Start Type `/rpg start` in any channel where the bot is active. Levlix walks you through character creation, equips your starter gear, and prepares you for your first hunt. Use `/adventure` to open the RPG hub dashboard at any time. --- # Page: https://levlix.io/docs/guides/getting-started # Getting Started with Levlix Welcome! This guide walks you through adding Levlix to your Discord server and getting everything set up in under five minutes. ## Inviting the Bot 1. Visit the **[Levlix Invite Page](https://levlix.io/invite)** on our website. 2. Click the invite button. Discord will ask you to select a server. 3. Choose the server where you want to add Levlix and confirm the permissions. 4. Levlix joins your server and slash commands are available immediately. You need **Manage Server** permission on the target server to add bots. ## First Steps After Inviting Once Levlix is on your server, try these commands to get started: | Command | What it does | |---------|-------------| | `/mycommands` | Browse all available commands organized by category | | `/dashboard` | View your personal dashboard with points, tasks, and stats | | `/preferences` | Set your preferred language and timezone | | `/daily` | Claim your first daily reward | ## Setting Up the Web Dashboard Levlix comes with a full Web Dashboard for managing your server visually: 1. Go to **[levlix.io/dashboard](https://levlix.io/dashboard)**. 2. Log in with your Discord account. 3. Select your server from the list. 4. Configure modules, manage points, set up the shop, and more. ![The server list in the Levlix dashboard, showing each connected server with the role you hold on it](https://levlix.io/static/docs-media/dashboard_servers-overview.webp) The dashboard gives you access to settings that are not available through slash commands, like shop item creation, counting channel management, and notification configuration. ![The server settings view, holding the core configuration each module builds on](https://levlix.io/static/docs-media/dashboard_settings.webp) ## Enabling Modules Levlix is modular. Not every feature needs to be active on every server. From the dashboard, you can enable or disable entire modules with a single toggle: * **RPG Adventure** - Full role-playing system with classes, dungeons, and loot * **Mini Games** - Slots, Crash, and Rock-Paper-Scissors * **XP & Leveling** - Text and voice XP with automatic role rewards * **Counting** - Collaborative counting game * **Quizzes** - Interactive trivia with point rewards * **Shop** - Virtual item marketplace * **Events** - Seasonal events and giveaways * **And more** - Moderation, milestones, tasks, and invites ![The module overview in the dashboard, where each Levlix module is switched on or off per server](https://levlix.io/static/docs-media/dashboard_modules.webp) Each module is independent. Enable only what fits your community. ## Recommended Setup Order For a brand new server, we recommend this setup sequence: 1. **Welcome Messages** - Set up a greeting in the dashboard so new members feel welcomed. 2. **XP & Leveling** - Enable XP tracking and configure a few level roles to create a progression loop. 3. **Daily Rewards** - Activate daily claims to give members a reason to visit every day. 4. **Tasks** - Add daily and weekly challenges for bonus engagement. 5. **Mini Games** - Enable the games module to give members something to spend their points on. After that, explore the RPG module, counting channels, quizzes, and everything else at your own pace. ## Getting Help * Use `/feedback` to report bugs or request features directly from Discord. * Visit our **[Documentation](https://levlix.io/docs)** for detailed guides on every module. * Join the **[Levlix Support Discord](https://discord.gg/levlix)** for community help. --- # Page: https://levlix.io/docs/guides/languages # Languages in Levlix Levlix replies in your Discord language, lets you override it with `/preferences`, and shows English wherever a translation is missing. ## Available Languages English is the source language. Every string is written in English first, and every other language is measured against it. As of the date at the top of this page, the picture looks like this: * **English (US)**: complete. * **German**: largely translated, about 90 percent of all strings. * **28 further languages**: partially translated, between 80 and 85 percent each. These are Bulgarian, Chinese (Simplified and Traditional), Croatian, Czech, Danish, Dutch, Finnish, French, Greek, Hindi, Hungarian, Italian, Japanese, Korean, Lithuanian, Norwegian, Polish, Portuguese (Brazil and Portugal), Romanian, Russian, Spanish (Spain and Latin America), Thai, Turkish, Ukrainian, and Vietnamese. * **English (UK)**: identical to US English apart from a few spelling variants. "Complete" means every string has its own translation. "Partially translated" means the remaining strings appear in English. The untranslated remainder is concentrated in a few areas, above all the Server Logging module, plus strings that were added recently. > [!NOTE] > Whenever a string has no translation in your language, Levlix shows the English original instead. Regional variants try their base language first: Latin American Spanish falls back to Spanish, Brazilian Portuguese to Portuguese, and British English to US English. ## How the Language Is Chosen The language is a personal setting, not a server setting. For each reply, Levlix checks in this order: 1. The language you saved with `/preferences`. 2. If you never saved one, the language of your Discord client. The first time you use a Levlix command, that client language is stored as your initial preference. 3. English, if your Discord language is not one of the 31 above. Because the choice is tied to your account, two members of the same server can read the same command in different languages. Slash command names and descriptions are shown in English in every Discord client. Only the replies are translated. ## Changing Your Language 1. Run `/preferences` in any server where Levlix is present. 2. Choose **Language Settings**. 3. Pick a language from the region menus (Europe, Americas, Asia, or all). The change applies immediately, in every server you share with Levlix. Discord itself offers only Brazilian Portuguese as a client language, so European Portuguese can be selected here and nowhere else. ## Server Language in the Dashboard The server settings in the [web dashboard](https://levlix.io/docs/system/dashboard) also contain a **Language** field with English, German, Spanish, and French. This is a separate, server-wide value. It is currently used by the [Quizzes](https://levlix.io/docs/guides/modules/quizzes) module, which posts quizzes in the server language because one quiz is shared by everyone in the channel. All other replies follow the personal preference described above. ![The General Settings section of the server settings, with the server-wide Language field next to the command prefix](https://levlix.io/static/docs-media/dashboard_settings.webp) Public announcements from the [Notifications](https://levlix.io/docs/guides/modules/notifications) module have their own switch: they use either the server's Discord language or the member's Discord language, as configured in the notification settings. > [!IMPORTANT] > The web dashboard is shown in English. This documentation is available in English and German; the language switch in the navigation bar toggles between them, and pages without a German translation show the English text. --- # Page: https://levlix.io/docs/guides/modules/activity # Levlix Activity Tracking Guide The Levlix Activity module automatically tracks how your members engage with the server. It records messages, voice time, reactions, thread participation, and invites, then presents the data in detailed dashboards. ## What is Tracked | Activity Type | Description | |--------------|-------------| | **Messages** | Messages sent in text channels | | **Voice** | Minutes spent in voice channels | | **Reactions** | Reactions added to messages | | **Threads** | Threads created or participated in | | **Invites** | Invites created and used | ![The activity view, charting messages, voice minutes and reactions over time](https://levlix.io/static/docs-media/dashboard_activity.webp) ## User Commands ### Activity Dashboard ``` /activity overview ``` Opens the activity dashboard with two tabs: * **My Stats** - Your personal activity statistics * **Leaderboard** - Server activity ranking Parameters: * `tab` - Which tab to open (My Stats or Leaderboard) * `activity_type` - Filter by a specific activity (all, messages, voice, reactions, invites, threads) * `period` - Time range (day, week, month, year) * `public` - Show results publicly in the channel ### My Stats ``` /activity mystats ``` View your personal activity statistics for the current server. Includes optional graph generation. Parameters: * `period` - Time range: day, week, month, or year (default: day) * `activity_type` - Filter by type: all, messages, voice, reactions, invites, threads (default: all) * `graph` - Show a visual graph of your activity (default: off) * `public` - Show publicly in the channel (default: private) ### Leaderboard ``` /activity leaderboard ``` View the server's activity leaderboard ranked by a selected activity type. Parameters: * `activity_type` - Rank by: messages, voice, reactions, invites, or threads (default: messages) * `period` - Time range: day, week, month, or year (default: week) * `role` - Filter the leaderboard to a specific role * `public` - Show publicly (default: private) ## Admin Commands ``` /activity serverstats ``` View detailed server-wide activity statistics with optional graph visualization. Parameters: * `period` - Time range for the statistics * `graph` - Include a graph visualization ## Time Periods All commands support four time periods: | Period | Description | |--------|-------------| | `day` | Today's activity | | `week` | This week's activity | | `month` | This month's activity | | `year` | This year's activity | --- # Page: https://levlix.io/docs/guides/modules/autopublish # Levlix Auto-Publish Guide The Auto-Publish module publishes new posts in your chosen announcement channels automatically, so servers that follow those channels receive them right away. Publishing an announcement normally takes an extra click on every single post. With Auto-Publish, an administrator picks the announcement channels once and Levlix takes care of that click for every future post. ## Setup 1. Make sure the channel is an **Announcement channel** in Discord. Regular text channels cannot be published. 2. Run `/autopublish` in your server. A private settings panel opens. 3. Pick a channel from the **Select an announcement channel** menu. The menu only lists announcement channels. 4. Levlix confirms with "Autopublish enabled for #channel" and the channel appears under **Active Channels**. Selecting the same channel again turns Auto-Publish off for it. The panel closes on its own after five minutes. Run `/autopublish` again whenever you want to review or change the list. > [!IMPORTANT] > Levlix can only publish a post if it has permission to do so in that channel. Discord requires **Manage Messages** to publish posts written by other people. When permission is missing, the post is skipped and a warning is written to the bot log; nothing is posted in the channel. ## Commands | Command | Function | Required Permissions | |---------|----------|----------------------| | `/autopublish` | Opens the Auto-Publish settings panel with the list of active channels and the channel toggle | Administrator | Auto-Publish is a core module. It has no on/off switch on the dashboard's Module Management page and is simply inactive until you enable at least one channel. All configuration happens in Discord through `/autopublish`. ## How it works * Levlix watches every new message in your server. A message is published only if it was posted in an announcement channel **and** that channel is on your active list. * Messages posted by bots and webhooks are never published. Posts from members who turned off activity tracking with `/privacy` are also left alone, because Levlix does not process their messages at all. * The active list is cached for one minute. Changes made through the panel take effect immediately. * If Discord rate-limits publishing, or the post was already published, Levlix skips that post silently and does not retry it. * Levlix stores only your server ID and the channel ID for each active channel. Nothing about the posts themselves is saved. ## FAQ **A post was not published. Why?** Check the conditions above: the channel must be an announcement channel, it must be on the active list, the bot must have permission to publish there, and the author must not be a bot or webhook. Posts that hit Discord's publishing rate limit are skipped, not queued. **I converted an announcement channel back into a text channel.** Nothing breaks. Auto-Publish only reacts to announcement channels, so the entry stays on the list but does nothing until the channel becomes an announcement channel again. **A channel shows as "Unknown channel" in the panel.** That channel was deleted. The entry is harmless, because the module never acts on a channel that no longer exists. --- # Page: https://levlix.io/docs/guides/modules/birthdays # Birthdays & Anniversaries Guide The Birthday module tracks four kinds of member "birthdays" and automatically celebrates each one with configurable rewards. Members register their real birthday themselves; the other three are detected from Discord metadata. ## The Four Event Types | Event | Triggered by | |-------|--------------| | **Real Birthday** | The member registers their birth date with `/birthday set` | | **Discord Anniversary** | Yearly anniversary of the member's Discord account creation | | **Join Anniversary** | Yearly anniversary of the member joining this server | | **Server Birthday** | Yearly anniversary of the server itself — celebrated server-wide | ![The birthday configuration view with announcement channel and role settings](https://levlix.io/static/docs-media/dashboard_birthdays.webp) Each event type can be enabled or disabled independently. You can run only Real Birthdays, only Anniversaries, or any combination that fits your community. ## Member Commands All user-facing commands live under the `/birthday` group: | Command | Description | |---------|-------------| | `/birthday set ` | Register your birthday (required for Real Birthday events) | | `/birthday show` | Show your currently stored birthday | | `/birthday remove` | Remove your stored birthday | Each member can only have one birthday stored per server. Registration is entirely optional — members who don't register simply don't trigger Real Birthday events. ## Admin Commands Admins have a parallel `/birthday-admin` group for managing other members: | Command | Description | |---------|-------------| | `/birthday-admin set` | Set a birthday on another member's behalf | | `/birthday-admin remove` | Remove another member's stored birthday | | `/birthday-admin list` | Inspect registered birthdays on the server | ## Rewards Per event type, you can configure: - **Points bonus** — points credited to the member on the day. - **XP bonus** — XP granted via the leveling system. - **Temporary role** — a role assigned for the duration of the announcement day and removed automatically afterwards. - **Custom announcement message** — supports `{user}` as a placeholder for the member mention. Real Birthdays, Discord Anniversaries, and Server Anniversaries are celebrated in an announcement channel you designate. The Server Birthday event is celebrated server-wide, typically with a larger reward since it affects everyone. ## Scheduling A single **Announce at (UTC)** hour controls when Levlix posts that day's celebrations. The scheduler checks every server at that hour once per day, so you can align announcements with your community's peak activity time — no separate cron job per guild. ## Audit Log The dashboard includes an **Audit** tab that shows every birthday announcement Levlix has posted: which member, which event type, which rewards were granted, and at what time. Useful for debugging missing announcements or verifying reward payouts. ## Setup at a Glance 1. Open the [Levlix Dashboard](https://levlix.io/dashboard) and navigate to your server's **Birthdays** page. 2. Flip the module master switch on and choose an announce hour. 3. Enable the event types you want to celebrate and configure rewards and messages for each. 4. Optionally pick a birthday role for each event type. 5. Ask your members to run `/birthday set` to register their real birthdays. --- # Page: https://levlix.io/docs/guides/modules/counting # Levlix Counting Game Guide The counting module is a fun, collaborative way to keep your community active. Members take turns posting the next number, and the goal is to reach the highest count possible without anyone making a mistake. ## Setting Up Your Counting Channel 1. Create a dedicated text channel in your Discord server (e.g., `#counting`). 2. Run `/count setchannel` in Discord, or configure the channel via the [Levlix Dashboard](https://levlix.io/dashboard). ``` /count setchannel channel_id: #counting language: en ``` ### Channel Configuration Options | Parameter | Default | Description | |-----------|---------|-------------| | `channel_id` | - | The text channel to use for counting | | `language` | `en` | UI language (`en`, `de`, etc.) | | `allow_consecutive` | `false` | Allow the same user to count twice in a row | | `warnings_enabled` | `true` | Enable the warning and auto-ban system | | `max_warnings` | `3` | Number of mistakes before automatic ban | | `ban_duration_hours` | `24` | How long bans last in hours | | `reset_on_fail` | `true` | Reset count to 0 when someone posts the wrong number | ## How to Count Members post the next number in sequence. Levlix accepts three input formats: ### Direct Numbers Simply type the next number: `1`, `2`, `3`, `4`, ... ### Math Expressions You can use math instead of typing the number directly: * `2+2` counts as 4 * `10-5` counts as 5 * `3*3` counts as 9 * `20/4` counts as 5 * `(2+3)*2` counts as 10 Supported operators: `+`, `-`, `*`, `/`, and parentheses `()`. ### Text Numbers You can spell out numbers in English or German: * English: `one`, `two`, `three`, `four`, `five`, ... up to `twenty-five` * German: `eins`, `zwei`, `drei`, `vier`, `fünf`, ... up to `fünfundzwanzig` ## Milestone Reactions Levlix automatically adds reactions to celebrate counting milestones: | Milestone | Reaction | |-----------|----------| | Every correct number | ✅ | | Every 25th number | ⭐ | | Every 50th number | 🔥 | | Every 100th number | 💯 | Number emojis (1️⃣-🔟) are not milestone reactions — they are accepted as *input* instead of typing the digit. See the "Text Numbers" and emoji input section above. ## Warning & Ban System When warnings are enabled, mistakes have consequences: 1. **First mistake:** Warning 1/3 issued, message deleted 2. **Second mistake:** Warning 2/3 issued 3. **Third mistake:** Auto-ban for the configured duration (default: 24 hours) Warnings automatically expire after **24 hours**. Bans are lifted automatically after the configured ban duration. ### What Triggers a Warning * Posting the wrong number * Counting twice in a row (when `allow_consecutive` is off) * Posting invalid input (not a number, math expression, or text number) * Near-simultaneous messages from multiple users ## User Commands All member-facing commands live under the `/count` group, plus a top-level dashboard command. | Command | Description | |---------|-------------| | `/count status` | View the current count and next expected number | | `/count warnings` | Check your current warning count and ban status | | `/count rules` | View the counting rules for this channel | | `/counting` | Open the counting dashboard (tabs: Status, Warnings, Rules) | ## Admin Commands | Command | Description | |---------|-------------| | `/count setchannel` | Set up a new counting channel with full configuration | | `/count-admin` | Open the admin management dashboard | ### Admin Dashboard (`/count-admin`) The admin dashboard provides: | Feature | Description | |---------|-------------| | **Channel Select** | Pick from configured counting channels | | **Channel Info** | View current count, rules, warning settings, ban duration | | **Set Count** | Manually set the count to any number | | **Reset to 1** | Reset the count and announce in channel | | **Repair** | Auto-scan the last 50 messages and sync the count from history | | **Delete System** | Completely unregister counting from a channel | | **Unban User** | Select and unban a banned user | | **Setup New Channel** | Add a new counting channel directly from the dashboard | ### Context Menu Commands Right-click on any user to access: * **Count Unban** - Unban a user from counting (requires Manage Guild) * **Count Check User** - View a user's warning count and ban status ## Web Dashboard Management Log into your [Levlix Dashboard](https://levlix.io/dashboard) and select your server to manage counting visually: * **Allow Consecutive Toggle** - Enable or disable solo counting * **Manual Score Overrides** - Set the count to any number to recover from trolls * **Audit Logs** - Every admin action is logged in the Persistent Notification Center ![The counting view, showing the configured channel and the current count state](https://levlix.io/static/docs-media/dashboard_counting.webp) --- # Page: https://levlix.io/docs/guides/modules/daily # Levlix Daily Rewards Guide The Levlix Daily Rewards module encourages members to visit your server every day by offering a recurring point reward with streak bonuses. ## Claiming Your Daily ``` /daily ``` Claim your daily point reward. You can claim once every 24 hours. If you claim on consecutive days, your streak increases and you earn bonus points on top of the base reward. ![The daily rewards view, showing base points, claim statistics and the top streaks](https://levlix.io/static/docs-media/dashboard_daily.webp) ## Streak System Claiming your daily reward on consecutive days builds a streak. Each streak tier awards progressively larger bonus points: | Tier | Days Required | Emoji | Color | |------|--------------|-------|-------| | **Starter** | 1+ | 🎯 | Green | | **Bronze** | 7+ | 🔥 | Orange | | **Silver** | 30+ | 💎 | Silver | | **Gold** | 100+ | 🏆 | Gold | | **Platinum** | 365+ | ⭐ | Platinum | **Important:** Missing a single day resets your streak back to 1. Plan accordingly! ## Optional: Streak Tier Roles Admins can map each streak tier to a Discord role. When a member crosses a tier threshold, Levlix automatically assigns the matching role and removes lower-tier roles — so Gold streakers aren't wearing both Bronze and Silver badges. This turns daily consistency into a visible status in your member list and chat. Configure the tier→role mapping from the dashboard's daily module settings. ## Streak Milestone Notifications When your server has notifications enabled, the following streak milestones trigger a public announcement: | Milestone | Days | Title | |-----------|------|-------| | First Daily | 1 | First Daily | | Week Warrior | 7 | Week Warrior | | Fortnight Fighter | 14 | Fortnight Fighter | | Monthly Master | 30 | Monthly Master | | Dedication King | 60 | Dedication King | | Century Legend | 100 | Century Legend | | Yearly Champion | 365 | Yearly Champion | ## DM Reminders You can set up a daily reminder so Levlix sends you a Direct Message when it's time to claim. This ensures you never accidentally break your streak. To configure reminders, a settings modal lets you: * **Enable or disable** the DM reminder * **Set a custom time** in UTC format (e.g. `08:00`) If DM reminders are enabled and you haven't claimed your daily by the configured time, Levlix sends you a private notification. --- # Page: https://levlix.io/docs/guides/modules/events # Events Module — Admin Setup Guide > [!IMPORTANT] > The Events module is opt-in. Server admins must enable it via **Dashboard → Modules** before the commands below become available. This guide walks administrators through enabling the Events module, running a seasonal event, and managing ongoing events from Discord. For a member-facing overview of what events feel like from the participant side, see the [Community Events feature page](https://levlix.io/docs/features/events). ## Enabling the Module 1. Open the [Levlix Dashboard](https://levlix.io/dashboard) and select your server. 2. Go to **Modules** and enable the **Events** module. 3. The `/event` command group and the admin dashboard become available on your server within a minute. ## The Admin Dashboard All event management happens through a single dashboard command: ``` /event eventadmin ``` ![The event administration view, used to create and schedule events](https://levlix.io/static/docs-media/dashboard_events-admin.webp) This opens an interactive view with tabs for: - **Active Events** — start, pause, extend, or end events that are currently running. - **Scheduled Events** — queue up events to start automatically at a future date. - **Archive** — review past events, participant counts, and winners. - **Settings** — announcement channel, default language, and reward multipliers. All actions create an audit trail viewable from the [Levlix Dashboard](https://levlix.io/dashboard). ## Seasonal Event Packs Levlix ships with nine built-in seasonal event packs. Each pack comes with its own theme, collectibles, and leaderboard: | Event | Typical season | |-------|----------------| | Easter | March / April | | Spring | March / April / May | | Summer | June / July / August | | Autumn | September / October / November | | Halloween | Late October | | Valentine | Mid-February | | Christmas | December | | New Year | Late December / January | | Winter | December / January / February | Packs can be started, paused, or scheduled independently. You can run multiple events at once if your community is large enough to sustain them, or stick to one per season for more focus. ## Member Commands Reference These commands are available to everyone when the module is enabled: | Command | Description | |---------|-------------| | `/event list` | List all currently active events | | `/event leaderboard` | Show the leaderboard of the active event | | `/event my_collections` | View collectibles earned across all events | | `/event history` | Past events the member participated in | ## Setup Checklist - Pick an **announcement channel** in Settings so event kickoff and winner-announcement messages have a home. - Decide whether to enable **automatic seasonal starts**. If on, Levlix launches the corresponding seasonal pack on its canonical date without any action from staff. - If your server is multilingual, set the default **language** — event messages will fall back to this when a member's own language preference is unset. - Let members know via an initial announcement that the module is live, especially on the first event of a season. --- # Page: https://levlix.io/docs/guides/modules/feedback # Levlix Feedback & Bug Reports Guide The Levlix Feedback system gives your community a structured way to report bugs, request features, and provide general feedback, all directly from Discord. ## Commands ### Feedback Menu ``` /feedback public: language: ``` Opens an interactive menu with buttons for submitting bug reports, feature requests, or general feedback. Set `public: true` to show the menu publicly in the channel. ### Bug Report ``` /bug-report ``` Opens a detailed bug report form as a Discord modal. Fill in the description and steps to reproduce, then submit. The report is automatically posted to the development team's forum channel. **Rate limit:** A daily limit applies to prevent spam. ### Feature Request ``` /feature-request ``` Opens a feature request form. Submitted requests are posted to a community forum where other members can vote on them. **Rate limit:** A daily limit applies to prevent spam. ### Popular Features ``` /popular-features ``` View the most popular feature requests ranked by community votes. This helps the development team prioritize features the community actually wants. ## How It Works 1. A user submits a bug report or feature request via the modal form. 2. Levlix creates a new thread in the designated Discord forum channel. 3. Other community members can discuss and vote on feature requests. 4. The development team tracks status changes (open, planned, in development, implemented). ## Notes * Daily limits prevent spam while still allowing meaningful feedback. * All submissions are logged and tracked for follow-up. * Feature requests support a community voting system with score tracking. --- # Page: https://levlix.io/docs/guides/modules/game-id # Levlix Game ID Registration Guide The Game ID module lets members link an external gaming ID (e.g. a Lords Mobile or other game account number) to their Discord account. It unlocks participation in Game ID quizzes and grants a one-time point reward when the ID is approved. ## Member Command ``` /gameid game_id: ``` Submit your Game ID for registration. The bot validates the format and tells you if it's incorrect. Depending on the server's settings, the submission is either auto-approved or held in a staff queue for manual approval. You are notified as soon as your ID is approved. If you need to change your registered ID later, submit `/gameid` again with the new value — the request goes through the same approval workflow, and a staff member has to unlock your slot first. ## Admin Commands All admin functions live under the `/gameidadmin` group: | Command | Description | |---------|-------------| | `/gameidadmin settings` | Central settings dashboard (enable/disable, reward points, format rules) | | `/gameidadmin show` | Look up a member's registered Game ID | | `/gameidadmin update` | Manually set a member's Game ID (no reward granted) | | `/gameidadmin unlock` | Unlock a locked entry so the member can submit a new ID | | `/gameidadmin request` | Inspect and process pending change requests | | `/gameidadmin pending` | List all members awaiting approval | | `/gameidadmin toggle` | Toggle the module on or off for the server | | `/gameidadmin setchannel` | Set the registration channel | | `/gameidadmin setrole` | Set the role members need before they can register | | `/gameidadmin setlabel` | Customise the field label (e.g. "Player ID", "Account Number") | | `/gameidadmin notifychannel` | Set the channel where new registrations are announced | | `/gameidadmin notifyrole` | Set the role pinged on new registrations | | `/gameidadmin testnotify` | Send a test notification to verify the setup | ## Server Configuration Most settings are easier to manage from the [Levlix Dashboard](https://levlix.io/dashboard): | Setting | Description | |---------|-------------| | **Module Enabled** | Turn Game ID registration on or off for the server | | **Reward Points** | Points awarded on a successful, approved registration | | **Registration Channel** | Channel the module accepts registrations from | | **Required Role** | Role a member must hold before they can register | | **Notification Channel** | Channel where new registrations are posted for staff review | | **Notification Role** | Role pinged when a new registration needs review | | **Field Label** | What the ID is called in member-facing messages (e.g. "Player ID") | ![The Game ID view, listing every linked gaming account on the server](https://levlix.io/static/docs-media/dashboard_game-ids.webp) ## Notes - One Game ID per member per server. To switch IDs, a member's slot must be unlocked by a staff member first. - The reward is a one-time bonus paid on the first approved registration. Subsequent changes do not re-award points. - If approval is required and nobody acts on the queue, the member stays pending — run `/gameidadmin pending` periodically to clear the backlog. --- # Page: https://levlix.io/docs/guides/modules/giveaways # Levlix Giveaway Module Guide The Levlix Giveaway Module lets admins post timed giveaways that pay out server points. Members enter with one click and winners are drawn automatically. See also: [Giveaway Automation](https://levlix.io/docs/features/giveaways). ## How a Giveaway Works * An admin sets a title, point prize, number of winners and duration. Levlix posts the giveaway in the chosen channel with an **Enter Giveaway** button. * Members click the button to enter. Each member can enter once, and the entry counter on the post updates after every entry. * When the timer runs out, Levlix picks the winners at random, credits the prize to each winner's balance and posts a winner announcement in the same channel. The original post turns grey, lists the winners and loses its button. * Running giveaways survive a bot restart: buttons are re-attached and end timers rescheduled. ## Creating a Giveaway ``` /giveaway create channel: #giveaways ``` The channel is optional; without it Levlix uses the default channel from the settings, or the current channel. The command opens a form: | Field | Description | |-------|-------------| | **Giveaway Title** | Headline of the post, up to 255 characters | | **Description** | Optional text, up to 1000 characters. Defaults to "Good luck to all participants!" | | **Points Prize** | Points credited to each winner. Must be a positive number | | **Number of Winners** | Between 1 and 20 (default `1`) | | **Duration** | `60m`, `1h`, `1d`, `2d12h` and similar. A plain number counts as minutes. Default `60m` | `/giveaway create-advanced` opens the same form with an extra `require_game_id` option that overrides the server default for this giveaway: only members with a registered [Game ID](https://levlix.io/docs/guides/modules/game-id) can enter. ## Managing Giveaways Every giveaway post shows its ID in the footer; the admin commands use it: | Command | Description | |---------|-------------| | `/giveaway end giveaway_id: ` | Ends the giveaway now, draws the winners and pays the prize | | `/giveaway cancel giveaway_id: ` | Closes the giveaway without winners. The post is marked **CANCELLED** and a notice is sent to the channel | | `/giveaway stats giveaway_id: ` | Status, prize, entries, winners, creation time, time left and a jump link. The ID autocompletes from recent giveaways | | `/giveaway giveawayadmin` | Admin dashboard with the tabs **Active Giveaways**, **Create**, **Settings** and **Statistics** | Creating, ending, cancelling and viewing stats requires **Administrator** or **Manage Server**, or the admin role from the settings. `/giveaway giveawayadmin` and `/giveaway settings` require **Administrator**. > [!NOTE] > Discord hides the admin commands from non-administrators by default. `/giveaway create-advanced` is visible to everyone, but the same permission check applies. ## Settings ``` /giveaway settings default_channel: #giveaways admin_role: @Giveaway Team enabled: True require_game_id: False ``` Only the options you pass are changed. | Option | Description | |--------|-------------| | `default_channel` | Channel used when `/giveaway create` is run without a channel | | `admin_role` | Role allowed to create and manage giveaways besides Administrator and Manage Server | | `enabled` | Turns giveaway creation on or off. When off, the create commands answer "Giveaways are currently disabled on this server." | | `require_game_id` | Server-wide default: only members with a registered Game ID can enter | ## For Members ``` /giveaway prizes ``` Opens a private overview with the tabs **Active Giveaways** (prize, winners, time left, entries, whether you have entered, and a jump link), **My Entries** and **My Wins** (total wins, total winnings, average prize and recent wins). Use `tab` to open a specific tab and `public: True` to post it for everyone. ## Web Dashboard Open your server in the dashboard and choose **Giveaways** in the sidebar (moderator role or higher). The page shows counters for active giveaways, total entries, total prizes and completed giveaways, a card per active giveaway with an **End Early** button, and the last 50 past giveaways with prize, winners, entries and end date. ![The Giveaway Management page in the web dashboard, with counters for active giveaways, total entries, total prizes and completed giveaways above the past giveaways list](https://levlix.io/static/docs-media/dashboard_giveaways.webp) > [!NOTE] > The Discord post, the winner draw and the payout are handled by the bot. Use `/giveaway create` to start a giveaway and `/giveaway end` to draw winners early; the dashboard page is for keeping an overview. ## FAQ **What if there are fewer entries than winners?** Levlix draws as many winners as there are entries. With no entries, it announces that there were not enough participants. **Can a member enter twice?** No. A second click answers "You have already entered this giveaway!" Entries are also refused once the end time has passed. **Can giveaways run in DMs?** No. Giveaways only work in servers. --- # Page: https://levlix.io/docs/guides/modules/invites # Levlix Invite Tracking Guide The Levlix Invites module tracks which members invited whom. This data feeds into the activity tracking, milestone, and leaderboard systems. ## Creating a Tracked Invite ``` /invites create max_uses: <0-unlimited> duration: temporary: ``` Create a custom invite link with full control over its behavior: | Parameter | Description | Default | |-----------|-------------|---------| | `max_uses` | Maximum number of times the link can be used (0 = unlimited) | 0 | | `duration` | How many hours the link stays active (0 = never expires) | 24 | | `temporary` | If true, members who join via this link lose their roles if they disconnect | false | Levlix automatically tracks who created each invite and how many times it was used. ## Personal Invite Links By default, `/invites create` makes an invite for the channel the command is run in. If you would rather have every member share one fixed link to a channel of your choice, for example a hidden verification channel, switch the server to personal invite links: 1. Open the server in the dashboard and go to **Invites**. 2. Under **Personal Invite Links**, pick the destination channel. The setting saves immediately. While a destination channel is set: * `/invites create` always creates a permanent, unlimited invite to that channel. The `max_uses`, `duration` and `temporary` options are ignored. * Each member gets exactly one link. Running the command again returns the same link. * Members need no invite permission at all, and they do not need to see the destination channel. Decide who may run the command with Discord's command permissions (Server Settings, Integrations, Levlix, `/invites`), for example only your verified role. * You can remove **Create Invite** from every role so Levlix links are the only way into the server. * Levlix needs **View Channel** and **Create Instant Invite** in the destination channel. Clear the channel in the dashboard to go back to per-channel invites. Existing personal links keep working until you delete them in Discord. > [!NOTE] > Discord allows at most 1,000 active invites per server. On a very large server, one permanent link per member can reach that limit. ## Admin Commands ### Update Invites ``` /invites updateinvites ``` Manually refresh the invite tracking data. This scans all existing invites and fills in any missing creator attribution. Useful after migrating the bot or recovering from issues. ### Invite Statistics ``` /invites invitestats ``` View detailed invite statistics for the entire server, including top inviters and invite usage over time. ## How Tracking Works Levlix monitors Discord's invite events in real time: * When a member joins, Levlix checks which invite code was used and credits the invite creator. * Invite data is stored in the database and contributes to the user's activity profile. * Invite counts appear in `/activity mystats`, `/leaderboard`, and the milestone system. ![The invite tracking view, attributing joins to the invite that brought them in](https://levlix.io/static/docs-media/dashboard_invites.webp) --- # Page: https://levlix.io/docs/guides/modules/milestones # Milestones Levlix provides two milestone systems that track progress and reward engagement: **User Milestones** for individual achievements and **Server Milestones** for community-wide collaborative goals. Both systems award Levlix Points upon completion. --- ## User Milestones User milestones track your **personal activity** across five categories and reward you as you hit specific thresholds. ### Activity Categories | Category | What Counts | Emoji | |---|---|---| | Messages | Messages sent in tracked channels | 💬 | | Voice Minutes | Time spent in voice channels | 🎤 | | Reactions | Reactions added to messages | 👍 | | Threads Created | New threads started | 🧵 | | Invites | Members who join through your invite links | 📨 | Each category has multiple levels. Every level requires a higher activity threshold and awards a larger point reward. Activity is tracked automatically. There is nothing to configure or enable as a user. ### Viewing Your Milestones ``` /milestones overview ``` Opens an **interactive view** with navigation buttons to switch between an overview of all categories and detailed breakdowns of each one. The view includes: - Progress bars for each category - Current level and next level target - Points earned and points available - Motivational messages based on your progress - Activity-specific tips **Options:** | Parameter | Default | Description | |---|---|---| | `milestone_type` | All | Filter by a specific category (Messages, Voice, Reactions, Threads, Invites) | | `view_mode` | Interactive | Choose between the interactive button view or a simple embed | ### Viewing All Milestone Definitions ``` /milestones list ``` Lists every milestone level for every category, including the requirement amount and point reward. Your current level is highlighted, and completed levels are marked with a checkmark. ### Milestone Leaderboard ``` /milestones leaderboard ``` Shows the top 10 members ranked by total milestone levels across all categories. If you are not in the top 10, your rank is displayed separately at the bottom. --- ## Server Milestones Server milestones are **community-wide goals** created by administrators. The entire server contributes collectively, and every contributor earns a reward when the target is reached. ![The milestone view, combining personal achievements with server-wide community goals](https://levlix.io/static/docs-media/dashboard_milestones.webp) ### How It Works 1. An administrator creates a milestone with a title, type, target amount, and reward. 2. The milestone becomes active immediately. Member activity that matches the milestone type counts as contributions. 3. When the total contributions reach the target, the milestone is completed. 4. Every member who contributed can claim the reward. ### Milestone Types | Type | What Counts | Tracking | |---|---|---| | Messages | Messages sent by any member | Automatic | | Voice Minutes | Voice channel time by any member | Automatic | | Reactions | Reactions added by any member | Automatic | | Threads Created | Threads started by any member | Automatic | | Invites | New members joining through invites | Automatic | | Custom Goal | Any goal defined by the admin | Manual (admin updates progress) | ### User Commands #### View Active Server Milestones ``` /server-milestone list ``` Shows all active server milestones with: - Title and type - Progress bar and percentage - Your personal contribution amount and percentage - Reward amount - Expiration date (if set) **Options:** | Parameter | Default | Description | |---|---|---| | `milestone_type` | All | Filter by type | | `show_completed` | No | Include completed milestones in the list | #### View Milestone Details ``` /servermilestones server-milestone-details milestone_id: 1 show_top_contributors: True ``` Shows detailed information about a specific milestone, including the full description, status, creation date, and expiration. When `show_top_contributors` is enabled, displays a ranked list of the top 20 contributors with trophy icons for the top 3. #### Claim a Reward ``` /server-milestone claim milestone_id: 1 ``` Claims your point reward for a completed server milestone. You must have contributed at least once to be eligible. #### View Your Contributions ``` /servermilestones my-server-milestones ``` Shows every server milestone you have contributed to, grouped by active and completed. Unclaimed rewards are highlighted with a claim prompt. Displays total statistics at the bottom. --- ## Admin Commands All admin commands require **Administrator** permission. ### Creating a Server Milestone ``` /server-milestone create title: "10K Messages Challenge" description: "Let's reach 10,000 messages together!" milestone_type: Messages target_amount: 10000 reward_per_contributor: 200 expires_days: 30 ``` | Parameter | Required | Description | |---|---|---| | `title` | Yes | Name of the milestone | | `description` | Yes | Description shown to members | | `milestone_type` | Yes | Type of activity to track | | `target_amount` | Yes | Total amount needed to complete the milestone | | `reward_per_contributor` | Yes | Points each contributing member receives upon completion | | `expires_days` | No | Number of days until the milestone expires (no expiration if omitted) | ### Listing Server Milestones ``` /server-milestone list /server-milestone list include_completed: True milestone_type: Messages ``` ### Editing a Server Milestone ``` /server-milestone edit milestone_id: 1 title: "Updated Title" target_amount: 15000 reward_per_contributor: 300 is_active: True ``` All parameters except `milestone_id` are optional. Only provide the fields you want to change. Completed milestones cannot be edited. ### Deleting a Server Milestone ``` /server-milestone delete milestone_id: 1 ``` Permanently removes the milestone and all associated contribution data. ### Viewing Milestone Details (Admin) ``` /server-milestone details milestone_id: 1 show_contributors: True ``` Same as the user details command but includes the creator name and reward claim statistics. ### Updating Progress Manually ``` /server-milestone update-progress milestone_id: 1 user_id: "123456789" amount: 50 ``` Used for **custom** milestone types where activity is not tracked automatically. The `user_id` parameter accepts a Discord user ID as text. Use the server ID for anonymous contributions. --- ## Permissions Reference | Action | Required Permission | |---|---| | View personal milestones | Any member | | View milestone leaderboard | Any member | | View server milestones | Any member | | Claim server milestone reward | Any contributing member | | Create server milestone | Administrator | | Edit server milestone | Administrator | | Delete server milestone | Administrator | | Update custom milestone progress | Administrator | --- ## Tips for Administrators - **Set achievable targets first.** A milestone that takes two weeks to complete builds momentum. One that takes three months feels unreachable. - **Rotate activity types.** Alternate between message, voice, and reaction milestones so every type of community member gets a chance to contribute. - **Use expiration dates.** Time-limited milestones create urgency that drives participation. - **Combine with events.** Run a server milestone during a seasonal event for compounding engagement. - **Announce completions.** Use the [Notification System](https://levlix.io/docs/guides/modules/notifications) to celebrate when a milestone is reached. - **Monitor contributions.** Use `/server-milestone details` with `show_contributors: True` to identify your most active community members. --- ## Important Notes - **User milestones are tracked automatically.** No setup is required. Members earn progress simply by participating. - **Server milestones count activity from the creation date forward.** Pre-existing activity is not retroactively counted. - **Custom milestones** require manual progress updates by an administrator. All other types are tracked automatically. - **Rewards must be claimed.** Completed milestones do not auto-distribute rewards. Members must use `/server-milestone claim` to receive their points. - **Contribution percentages** are calculated relative to the total progress, not the target. If a milestone is at 5,000/10,000 and you contributed 500, your percentage is 10% of the current total. --- # Page: https://levlix.io/docs/guides/modules/mini-games # Levlix Mini Games Guide The Levlix Mini Games module brings three interactive point-based games directly into your Discord server. All games use the server's virtual points currency, so real money is never involved and every member can participate. ## Available Games ### Slots ``` /slots bet: ``` Spin the slot machine by providing a point wager. Levlix plays a three-reel spin animation directly in chat. Six different symbols appear on the reels, each worth a different payout. Rarer symbols pay more. Landing three matching symbols means a jackpot win, while two matching symbols award a smaller payout. ### Crash ``` /crash bet: ``` Crash is a risk-reward game built around a rising multiplier. After placing your bet, a multiplier starts climbing. Your goal is to cash out before the rocket crashes. The longer you wait, the higher your potential reward. Hesitate for too long and you lose your entire wager. ### Rock, Paper, Scissors ``` /rps bet: choice: Rock | Paper | Scissors ``` Challenge the bot to a round of Rock, Paper, Scissors. Select your hand from a dropdown at the time of the command. Win and your wager is doubled (2x payout). Draw and you get your wager back. Lose and the wager is gone. ### Tic-Tac-Toe ``` /tictactoe ``` Play Tic-Tac-Toe against the bot or challenge another member. When a wager is set, the winner takes double their bet while the loser forfeits theirs. ## Bet Limits All games enforce the same minimum and maximum bet. The bot will notify you of the allowed range when placing a bet. ## Viewing Your Statistics ``` /minigames-stats ``` Displays a detailed personal overview of your game activity on the current server: | Field | Description | |-------|-------------| | **Current Balance** | Your current point balance | | **Total Winnings** | All points ever won across all games | | **Total Losses** | All points ever lost across all games | | **Net Profit / Loss** | Winnings minus losses | | **Recent Transactions** | Your last 5 game bookings | ## Minigames Dashboard ``` /minigames ``` Opens a full dashboard with tabs for games, statistics, history, and leaderboard. ## Cooldowns Game commands have a built-in cooldown to prevent spam. If you execute a command too quickly after the previous one, Levlix will notify you to wait before trying again. ## Admin Setup The mini games module needs to be activated for your server before members can use it. Make sure the module is enabled in your server configuration via the Levlix Dashboard. ![The minigame statistics view in the web dashboard, with games played, amounts wagered and top players](https://levlix.io/static/docs-media/dashboard_minigames.webp) > [!IMPORTANT] > Points earned through Levlix are virtual currency with **NO** real-world monetary value. In accordance with Discord Developer Policies, winnings and losses carry no real-world monetary value. --- # Page: https://levlix.io/docs/guides/modules/moderation # Moderation Guide > [!IMPORTANT] > The Moderation module is opt-in. Server admins must enable it via **Dashboard → Modules** before the commands listed here become available. The Moderation module gives your staff a complete toolkit: manual sanctions with case tracking, an automated rules engine, anti-nuke protection, and a member-driven report queue. Every action — manual or automated — creates a numbered case so the full history is auditable. ![The moderation settings card, configuring the mod log channel, mute role, member notifications and dry-run mode](https://levlix.io/static/docs-media/dashboard_moderation.webp) ## Manual Sanctions Every sanction records a case number, the responsible moderator, the target, the reason, and a timestamp. Members receive a DM when a sanction is applied. ### Warnings ``` /warn user:@member reason: duration: ``` Issue a formal warning. Warnings accumulate and can trigger automod escalation once a threshold is reached. The optional `duration` parameter controls how long the warning stays active before it expires and stops counting toward escalation. Accepted forms mirror the mute parser: `12h`, `30d`, `6mo`. Passing `0` makes the warning **permanent**. Omit the parameter to fall back to the server default configured under **Dashboard → Moderation → Warn expiry**. | Guild setting | Result on `/warn` (no `duration:`) | |---------------|-----------------------------------| | Warn expiry unset / `0` days | Warnings never expire. | | Warn expiry `N` days | Every new warning expires `N` days after issuance. | ### Timeouts ``` /mute user:@member duration: