Changelog

Here you can find some of the relevant changes we've made to Lurkr over the past few months. We're always working on improving the bot and adding new features, so make sure to check back here regularly!

Despite our efforts, this page is not always so up-to-date. For the most recent changes, please check the

#updates channel in our Discord Server.

Leveling Experience Configuration & User Privacy

6 November 2025

Discord Bot

• Added /config set option for Leveling Experience Gain Interval.

  • Allows you to configure how long Lurkr should wait before granting XP again.
  • This interval is per user.

• Added /config set option for Leveling Experience Per Message.

  • Allows you to configure the minimum & maximum XP granted per message.
  • The actual XP number is randomly selected between these two numbers.

• Added /config toggle option for Gain Leveling Experience from Bot Commands.

  • Allows you to choose whether or not slash command messages count as XP.

• Added /privacy command.

  • Setting your leaderboard privacy to true will anonymize you on all public Lurkr leaderboards!
  • This does not affect Members-only or Managers-only leaderboards!
  • It might take a few minutes for the effects to become visible!

• The originating server name is now displayed on level up messages sent in DMs.

• Fixed a bug where premium users with both Max & Ultimate were not assigned correctly.

• Fixed a bug where slash command messages were not counted as XP.

• Fixed a bug with the top leveling role assignment (Leaderboard Role).

• Fixed a bug where the top leveling user was not being updated properly.

Dashboard

• Added the new /set and /toggle commands into the Dashboard.

  • You can now change XP gain interval, XP gain per message and XP gain from slash commands.

• Added sorting buttons to the role rewards & multipliers section on the leveling page.

  • You can switch between ascending and descending order.

• Changed Server-Wide Default Customization to only accept hex colours.

• Fixed a bug causing selector buttons to not show their correct state.

• Fixed the global multiplier being counted towards the channel & role multiplier limit.

Documentation Overhaul & Privacy Improvements

22 July 2025

Discord Bot

• Changed the default setting of the Web Leaderboard visibility to Members-only.

  • This is to improve privacy by not allowing all leaderboards to be indexed on the web by default.

• To comply with privacy laws, we have reset all visibility settings to Members-only!

  • If you want your Web Leaderboard to continue to be public, you must set it back to public.
  • To change the visibility go to your Lurkr Dashboard → Leveling → Web Leaderboard

• Changed the wording under the Web Leaderboard visibility options to be more transparent.

Dashboard

• Overhauled our Documentation to be prettier and more functional!
  • We'd welcome feedback if you use the documentation a lot, so please feel free to send suggestions!
  • We're still working on migrating the guides over to primarily use the Web Dashboard as a visual guide.

Web Leaderboard Visibility & Leveling Speed

18 July 2025

Discord Bot

• Added visibility options for the web leaderboard!

  • Allows you to change if your leaderboard can be accessed by anyone, by server members or only by managers/administrators.
  • Allows you to change if your leaderboard will be indexed on the web for search engines.

• Added the ability to change your server's leveling speed!

  • Change the cooldown after gaining XP on a message (Default 1 minute)
  • The XP gained is a random number between an interval, you can now change this interval.
  • Be able to set a fixed XP gain!

• Increased the Lurkr Ultimate Command Leaderboard Limit to 500!

  • Use /leaderboard on a Lurkr Ultimate enabled server to browse through the top 500 members!
  • Changed from previously 200.
  • Standard limit still 100.

• Fixed a bug that made users not be able to login to the dashboard sometimes.

• Embed level up messages are now recognized in the /check command.

• Fixed Lurkr informing users about 20% Leveling Boost when using /vote despite the multiplier being disabled on the server.

Introducing the Lurkr API!

28 April 2025

Discord Bot

• Added a public API for other developers to take advantage of Lurkr's deep Leveling System for their own projects!

  • This can allow you to add leveling requirements for your own bots, add or remove levels/xp based on other factors, and integrate Lurkr leveling into other games!
  • You can create and customize your API key on your profile page
  • Please read the API Documentation before creating support requests: lurkr.gg/docs/api

• Improved and updated the rank card!

  • Now applies the name on the rank card in this order: 1. Nickname, 2. Display name, 3. Username
  • Removed the character limit for names on the rank card.
  • Removed the dark gray background around the Avatar in the rank card.

• Added the level_or_milestone option to the /test command.

  • Useful for checking how the level up message or milestone message will look like for specific levels or milestones.

• Fixed the rank card not showing when any image failed to load.

• Fixed cyrillic alphabet not appearing in the rank card.

Dashboard

• Added an API key generation section to the profile page!

Stackable Role Rewards & Profile Page

22 March 2025

Discord Bot

• Added individually stackable role rewards!

  • This now lets you pick and choose which specific role reward should stick around on the User, and which ones should be removed when another role reward gets unlocked!

• Disabled commands that are linked to Multipliers or Role Rewards; they now redirect you to use our Dashboard! (It's better)

• Minor stability improvements with sharding.

• Removed /config command.

Dashboard

• Added a profile page!

  • Your profile page right now shows your current Rank Background Image, Accent Colour & miscellaneous information.
  • In the near future, the profile page will let you set, change and customize your entire Lurkr experience as a User!

• Fixed a bug where the dashboard sometimes displayed more servers than expected.

Role Rewards placeholder on Level Up Messages

30 December 2024

Discord Bot

• Added {roleRewards} placeholder to Level Up Message!

  • This now allows you to show which role rewards your members get!
  • Also added support for showing text conditionally, using {#var}text here{/var} and {^var}text here{/var} for negative condition.
  • For Example: {#roleRewards}You gained the {roleRewards} role rewards!{/roleRewards}, this only appears if role rewards were applied.

• Added support for more colour names in the /colour command

• Fixed an issue with the handling of Polaris private leaderboard errors.

• Fixed only one mentioned role working at a time for mentioned role cooldowns.

• Minor stability improvements.

• Removed /image, /purge, and /translate commands.

  • They are no longer the focus of the bot, and weren't used by anyone anymore.

Dashboard

• Fixed a 404 error when accepting cookies in the dashboard page.
• Fixed roles not being saved when updating an existing role multiplier.

Quality of Life Improvements

29 September 2024

Discord Bot

• Increased the Role Mention Cooldown interval to 6 Hours for Lurkr Ultimate servers.

  • The standard limit of 30 minutes has not been changed.

• Added a user option to /background view command.

  • This new option is meant to help users find and report (/background report) offensive user backgrounds.

• Added named colour options to the /colour command.

  • This means you can now type red or green instead of a complicated hex code! Give it a try!

• Fixed Polaris Import importing incorrect levels.

• Reduced probability of getting an "unexpected error" when using /importxp.

• Renamed the until option in the /importxp command to min_level for better clarity on what the option does.

• Fixed an issue not gaining XP when an active multiplier is too low (i.e., x0.01).

• Unfortunately Polaris Import's might still sometimes fail with "unexpected errors". This is because of Polaris' inherent instability and cannot be fixed on our end.

Dashboard

• Added a toggle for Only Announce Level-Ups Together With Role Rewards which was previously only available through the config command.

  • You can find it under Leveling > Level Up Message.

• Added showing the non-shortened number when hovering over it in the Leveling Calculator.

  • Instead of 21.3M, hovering over the number with your mouse will show 21,303,511 now.

• Fixed level up message conditions not showing/updating correctly.

• Miscellaneous styling fixes.

Polaris Leaderboard Import

24 August 2024

Discord Bot

• Added Polaris support to the Import Bots section in the dashboard & /importxp command!

  • Polaris has been discontinued by the creator, and we want to help server owners/admins enjoy a smooth transition to our leveling bot
  • Polaris import supports Role Rewards!

• Changed the /colour error message to better communicate hex colour codes.

• Fixed the very first message a user sends not counting towards their XP but still triggering the XP cooldown.

Dashboard

• Fixed several errors when saving changes on the leveling page of the dashboard.

Embed Level up Messages

8 July 2024

Dashboard

• Added the ability to create Embed Messages as the Level Up Message!

  • You can now create embed messages in addition to the normal level up message that gets sent!
  • You can now remove the Level Up Message entirely in order to replace it with an embed message.
  • Currently this feature is only available on the Dashboard!
  • Thank you everyone for suggesting this feature!

• Added the abilities to preview Embed Messages when using the /test command!

  • Embeds are hard! Preview what your level up message will look like using /test type:XP Message

• Added a cookie pop-up box. Just click it away!

• Updated our Privacy Policy and Terms of Conditions to be more legible and concise. We haven't really touched the contents.

Background Blacklist and Import Bots

27 June 2024

Discord Bot

• Added a blacklisting system for users who upload innapropriate Backgrounds using /background set.

  • This is tied to the /background report command.
  • After reporting someone, our Team reviews the report and may delete the background & blacklist the reported user if necessary.

• Allowed separate role reward levels to share the same roles

• Fixed a bug with deleted users when importing leveling data from MEE6

• Fixed emojis not being displayed properly in some commands

• Fixed /colour command showing erroneous responses

• Fixed duplicate level up messages

• Fixed emoji-list deleting a very large amount of messages

• Fixed XP Multipliers showing duplicated roles at times

• Fixed /importxp for AmariBot only importing the first 50 members

• Stability improvements and other minor bug fixes

Dashboard

• Added the Import Bots section to the Dashboard!

  • Adds the same functionality as the /importxp command but in the nice brand new website!
  • Now shows the progress of the import, useful for large servers!
  • Currently only supports AmariBot and MEE6, let us know which Bots you want us to support next!
  • AtlasBot was removed due to them changing the way their API works.

• Fixed a bunch of styling & scaling issues primarily on Mobile

• Fixed a bug allowing non-selectable roles to be selected in dropdown menus

New Website

26 June 2024

Dashboard

2 Months ago we announced the launch of our new Beta website we've been crunching out for 2 Years! We're glad and

(slightly) relieved to announce it is, as of right now live and accessible from https://lurkr.gg/ directly!

• Features!

  • With the website now out, we can focus more on new features, both for the brand new and still shiny website and for the actual bot!

• Feedback!

  • We'd still love to hear your feedback and ideas! Drop a suggestion into #suggestions with the Website/Dashboard tag!

• 🐛 Stragglers

  • Thank you for all of your contributions in finding and reporting bugs in the Beta website, though we're sure there are still more bugs to squash!
  • If you did find one, head over to support, create a forum post as usual detailing every step you took to reproduce the bug (In as much detail as possible!), the operating system you're on (Mac, Windows, Linux, iOS, Android), what device you're on (Mobile, Laptop, Desktop), what browser you're using (Chrome, Firefox, Safari) and lastly, select the Website/Dashboard tag!