Athena Bot | Discord Server Bot v2.5.2

Status plugin
Our newest plugin Status is here! With it, you can monitor the status of multiple games and websites including Discord.
The Discord status works just like the one you already know from our Support server. To set it up, just configure the discord_status_channel in /setup and you’re ready to go!
For all other services, simply use the /status command. We’ll be adding support for more games and services in future updates. Stay tuned!

ㅤ
Plugin Documentation
After months of requests, we’re excited to finally release our plugin documentation!
This guide walks you step by step through our custom plugin system and gives you everything you need to start creating your own addons for Athena. The guide can be found on Github along side the plugin template: https://github.com/Zeroknights16/AthenaBot-PluginTemplate/wiki.

We can’t wait to see what awesome ideas you bring to life!

ㅤ
Phantom Plugin
We’re excited to announce our latest collaboration with the Phantom licensing system! With Athena, Phantom now has full Discord integration, a feature many of you have been asking for.
With this update, you’ll be able to easily create and manage licenses, customers, and products right from Discord.
Got ideas for improvements? We’d love to hear them! Drop your suggestions in our Discord or at Buzz's Development!

ㅤ
Additions/Updates

• Renamed command /status to /devstatus
• Added .validateURL() to util manager
• Custom configs are now reloadable
• Added subcommand /reload event
• Added discord user/bot token filter to automod
• Added fake nitro filter to automod
• Added URL shortener filter to automod
• Added obfuscated invite filter to automod
• Added cyrillic spoofing filter to automod
• Added Zalgo text filter to automod
• Automod warning message is being automatically deleted after 7 seconds now
• /setup no longer resets to default page after configuring a channel
• Added subcommand /economyadmin coins add/remove
• Added subcommand /economyadmin karma add/remove
• Added subcommand /economyadmin lootbox add/remove
• Minecraft addon supports offline servers now
• Updated role saving to not include staff roles
• Added new config option required_role_to_open to ticket category configuration
• Added option bypass_auto_roles to role saving module. If roles are saved, you can enable this to ignore auto roles for this user.
• Removed several words from default blacklisted_words automod filter
• Unknown interaction errors are now suppressed, leaving just a warning in console
• Added new download emoji
• Added new script load_latest_backup. This allows you to go back to a previous version of AthenaBot you installed in case one of the builds are buggy.
• Added a new button to verifypanel for phone users who have "performance" mode enabled and could not see the image.
• /dicksize length is now customizable
• Added new action to command maker addon: USER_SEND
• Added placeholder support to command maker addon
• Added string selects at string command params to command maker addon
• Updated dependencies

ㅤ
Bug Fixes

• Fixed /quest weekly showing a different quest than the one that is active
• Fixed negative ping values at /ping
• Fixed dashboard api route name typos in console
• Fixed negative coin values caused by punishments
• Fixed ticketMessageStaff leaderboard
• Fixed ticketMessage leaderboard
• Fixed manuel mutes & unmutes not being registered properly causing a desynced database
• Fixed mute value at /info
• Fixed a rare issue with mutes not saving punishment data correctly
• Fixed /play throwing an autocomplete error if the lavalink server is unreachable
• Fixed an issue with default permission config at command /leveladmin
• Fixed permission configuration being ignored at interaction events of custom plugins
• Fixed menus like ticket & application not resetting to default value after usage
• Fixed /giveaway reroll ignoring winner input
• Fixed invites_list leaderboard
• Fixed invites_fake leaderboard
• Fixed /editmsg resetting embed colors
• Fixed command log erroring if executed in dms
• Fixed /info command always showing the own data
• Fixed a typo at web api responses
• Fixed an issue with registering custom routes at web api
• Fixed config loading function being set to private
• Fixed authentication typos
• Fixed being able to /report bots
• Fixed "voice log" skipping channel join event in certain cases
• Fixed an issue with the config manager if config was too nested
• Fixed custom images at /level
• Fixed an issue with close request leaving an error in console even though it worked as expected
• Monitoring results of a potential fix for rare ticket issue causing channels to not be recognized as ticket channel (not reproducable)
• Fixed globalBan schedule erroring if guildDoc failed to load
• Fixed calltime printing an error if member is not cached
• Fixed message logs exceeding length limit in certain cases
• Updated message logs to show first 1k characters instead of the last length-1k characters
• Fixed auto_verification not removing roles configured at roles_to_remove
• Fixed /daily & /weekly streaks
• Fixed formatting of /shop
• Fixed economy shop not resetting to default value
• Fixed index.js file not being backuped
• Fixed an issue that lead to update packages fail to load and in other scenarios different update packages to be downloaded than supposed if owning a very old license.
• Fixed role delete log
• Fixed a deprecation warning at command maker addon
• Fixed internal embed builder if timestamp was present
• Several bug fixes for dashboard backend & typos

ㅤ
I hope you like it!
~ Zeroknights » Executive & Developer @ Iynx Development

Important Links

Purchase/Download: https://purchase.iynxdev.com
Documentation: https://docs.iynxdev.com
Discord: https://discord.iynxdev.com

Click to expand...

Addon Developer Updates
V2.4.1 introduces several enhancements to our addon system and expands the toolkit for community developers. You can now take full advantage of Athena’s built-in permission system directly within your addons. Additionally, we've added dedicated handlers that let you seamlessly integrate your own API routes into Athena’s REST API.

* Added permission support for addons
With this update, we've introduced a new option in the constructors of commands and interaction events: permissionLevel: helloConfig.config.permissions.info_command.

This integrates directly with our permission system, allowing you to use any defined permission level from your config. If no permissionLevel is specified, the bot will continue to function as before without restriction.

Click to expand...

* Added support for custom rest api routes
You can now register your own custom API routes alongside Athena’s default REST API endpoints. To get started, simply add the following snippet in your plugin’s setup code:

JavaScript:

const webApi = this.core.discord.core.plugin.manager.get('web_api');
webApi.registerRoute(routeClass);

This line fetches the core web API manager and registers a custom route class. That route class must follow a specific structure. Here's a working example of a basic GET endpoint that returns a simple status message:

JavaScript:

const routeManager = require('../route.js');

module.exports = class status extends routeManager {
    constructor(heart) {
        // If IP is set to true, all incoming requests must be sent from a whitelisted ip.
        // If key is set o true, all incoming reuqests must include the auth key in their headers.
        super(heart, { name: 'status', path: 'status', type: 'get' }, { ip: false, key: false });
    }

    async execute(req, res) {
        try {
            const auth = this.auth(req, this.heart.core.discord.core.config.manager.get('web_api').get());
            if (auth) return res.status(auth.status_code).send(auth);

            res.status(200).send(this.generateSuccessResponse({ status: 'online' }));
        }
        catch (err) {
            this.heart.core.console.log(this.heart.core.console.type.error, `An error occurred while managing api request at route ${req.route.path}`);
            new this.heart.core.error.interface(this.heart, err);
            res.sendStatus(500);
        }
    }
};

Our Addon template has been updated accordingly. It can be found here.

ㅤ

Ticket Limitations
As a highly requested feature, we've updated how ticket limitations work. You can now choose between three different ticket limit modes:

• none: Users can open an unlimited number of tickets in each category.
• category: Users can open only one ticket per category at a time.
• global: Users are limited to one open ticket across all categories.

ㅤ

RSS-Feeds
Want to keep your members updated with the latest news and articles? Now’s your chance! In collaboration with Dilva, we're excited to introduce our newest feature: RSS Feed Integration. You can now subscribe to an unlimited number of RSS feeds and keep your community informed.

ㅤ
Additions/Updates

• Added script to delete backups -> npm run clear_backups
• Added script to delete logs -> npm run clear_logs
• Added script to delete stored dashboard data -> npm run clear_dashboard
• Added proxied config option to web api
• Registered error RestError, session not found
• Improved error messages returned by command maker addon, making it more clear what's wrong.
• Added option to disable custom commands and components at command maker addon
• Command maker plugin no longer disables itself if a component or command was configured incorrectly.
• Added command parameter (string, user) configuration to command maker addon
• Bot now moves to the next Lavalink node if it was disconnected from the previous one
• Added option to add additional nodes to the one from our lavalink service
• Updated dependencies
• Added dashboard field to final status report
• Updated log file names to be ordered after their creation date
• Added a proper warning for common.json validation errors

ㅤ

Bug Fixes

• Fixed ticket commands erroring outside of tickets
• Fixed a typo at api_limitation warning (invalid emoji)
• Fixed placeholder parsing at warnings returned by the /tclaim command
• Fixed /tclaim erroring
• Fixed app limitations being modified by ticket configuration
• Fixed url button validation at command maker addon
• Added fallback emoji if custom ones are not available
• Fixed role mention at twitch notification
• Fixed select menus not resetting to its default value (ticketpanel, ...)
• Fixed welcome/goodbye uploaded to the logs directory images being ignored
• Fixed very rare anti nuke issue, if targeted user is not cached
• Fixed users being unable to reopen apps
• Fixed placeholder configuration at application modals
• Bot prevents errors caused by invalid modal configurations now
• Fixed an issue with auth validation at music plugin
• Fixed /ac leaving an error in console
• Fixed transcripts not loading at the web server
• Fixed an issue with acivity status if ticket plugin is disabled leading to an infinite spam of errors
• Several backend fixes for the dashboard

I hope you like this update!
~ Zeroknights » Executive & Developer @ Iynx Development

• Fixed auto updates not updating the updating tool
• Fixed an issue with the config updater erroring randomly
• Fixed plugin manager trying to load .zip files in your plugins directory
• Patched an issue with some booleans resetting to its default values
• Fixed an issue with loading models after auto-update
• Fixed an issue with placeholder parsing at custom color embeds

Hey there,
before diving into the latest changes in this big update, I just want to take a moment to say thank you. We’ve officially hit 400 sales of AthenaBot this week after two years of working on this project, and that still feels surreal. When we first started, we never expected it would grow this far, and I’m incredibly grateful for the support you've all shown along the way. Some of you have already seen the sneak peeks in the support server, our next major update, V2.5.0, is right around the corner and it’ll include something we’re really excited about: the dashboard. It’s a huge step forward for AthenaBot, and we’ve put a ton of work into it over the past few weeks and months. We genuinely hope you’ll like what’s coming and we can’t wait to see where this journey takes us next.


This update V2.4.0 includes the whole backend for our dashboard along side all of the following changes:


Addon Developer Updates
V2.4.0 brings a bunch of improvements to our addon system and the tools available for our community developers. This update is all about making development with Athena easier. From now on, Athena will automatically handle the installation of Node dependencies and set up all necessary MongoDB models for your addon. On top of that, we’ve introduced a set of new helper classes to make working with user data much more intuitive.

• Added plugin support to install node packages
• Added plugin support to handle mongodb models
• Added user data builder class
• Updated userData to be exposed for devs instead of being private
• Added a warning for devs if interaction ids do not match the correct format

(!) Our Addon template has been updated accordingly. It can be found here.
ㅤ

Data import from Drako
With this update, we’re introducing a new script that lets you import stored data from DrakoBot into AthenaBot. Right now, it covers the most important pieces like levels, XP, and similar core data but we’re planning to expand this over time. With each future update, we aim to support more and more data to make the transition as smooth as possible.


Twitch Plugin Revamp
Our Twitch notification plugin has received a complete overhaul! You can now subscribe to an unlimited number of streamers directly through commands. We’ve also added two notification modes to give you more flexibility:
The first mode works similarly to the old system (and like YouTube notifications), sending a new message whenever someone goes live. The second mode introduces a dynamic notification embed that stays in place and updates in real time, reflecting the current stream status. Essentially turning it into a live panel for your subscribed creators.

ㅤ
Additions/Updates

• Added giveaway bonus entries
• Added %invited_by%, %invites_by_invitor%, %user_created%, %user_joined% placeholders to welcome message and all of its types
• Added optional date parsing to giveaways now accepting a specific date when the giveaway should end: <year>-<month>-<day> <hour>:<minute>. The old way still works.
• Added a new placeholder for a different giveaway draw date parsing at the giveaway embed
• Added %current_date%, %current_time%, %current_time_seconds%, %current_datetime%, %current_iso% placeholders to global placeholders
• Older invite roles now will be removed when unlocking a new level
• Color embed field accepts placeholders now
• Enabled gif support for welcome/goodbye image
• User nicknames are now being updated at command /roster assign
• Added custom boost notification messages
• Added config option to enable autoplay by default
• Updated /botinfo
• Updated all dependencies to be up to date
• Added config option to let plugins bypass automatic updates if custom modifications were made.
• Added member role saving. When a user leaves your server the roles the user owned will be saved and reapplied once the user rejoins the server
• Added option to kick unverified users after a specified time period
• Added option use_discord_category_permissions to ticket config. This allows you to let tickets sync their permissions with the Discord category they are being created in, instead of using our built in permission_level system. You can choose which ticket permission system you want to use. If enabled the elevation & lower buttons/commands will still work as before, but based on the Discord category permissions instead.

ㅤ
Bug Fixes

• Fixed a typo at "application emoji uploading" console log
• Fixed default pricing of bank upgrades to fix unreachable upgrades - @.neurologic.
• Fixed a potential data loss at saving channel ids using the setup menu
• Fixed emoji parsing at startup log message
• Fixed custom addons not showing up at final status report after startup
• Giveaways can no longer draw users who left the Discord server
• Patched issue at tebex purchase notifications with unknown usernames
• Fixed sticky messages become very spammy if more than one was setuped
• Removed unintended watermarks for watermark addon customers
• Fixed minor internal issues with ticket data management
• Fixed access-control-headers for post & get web api routes
• Moved /level image into the logs directory to not reset with automatic updates

(!) If you're running V2.3.5 or higher, your bot will automatically update to this version, unless you've disabled automatic updates.


I hope you like this update!
~ Zeroknights » Executive & Developer @ Iynx Development

Important Links

Purchase/Download: https://purchase.iynxdev.com
Documentation: https://docs.iynxdev.com
Discord: https://discord.iynxdev.com

Click to expand...

SOURCE UPDATE
The CommandMaker, Economy & Minecraft addon of AthenaBot comes additionally with the Source addon for free now. Existing customers of the source addon have to use /claim once in our Support Discord.


AUTO UPDATES » PUBLIC RELEASE
We’re excited to announce the release of our new Auto-Updating System! After several weeks of development, bug fixing, and refinement, it's finally ready for everyone.

How does it work?

To get started, you’ll need to manually update your bot files one last time to version V2.3.6. Once that’s done, simply start your bot. Your common config file will automatically be updated with new settings to support the auto-update feature. You’ll then be able to choose between two update methods:
Major stable releases (as published on BBB) or Dev-Builds, which are more frequent but may carry a slightly higher risk of bugs. With this system in place, staying up-to-date has never been easier!

Click to expand...

OTHER CHANGES

• Fixed rare error spam at auditlog logs
• Fixed /purge running forever
• Fixed typo at purge "too_old_msgs" warning
• Updated dependencies
• Added support to remove reactionroles by their button name
• Fixed an issue with bot erroring if system messages failed to load
• Fixed an issue with logger erroring at bigint values
• Fixed issues with executing message context menus
• Fixed an issue with using /sudo at bots
• Added details to management config where to change the welcome/goodbye images

AUTO UPDATES » BETA » CHANGES

• All addons are being automatically updated now, this includes the Minecraft, Command Maker & Economy Addon
• Source addon is being supported now, if you own source the bot will automatically download the source code instead of the obfuscated version
• Your file integrity is being checked after each update now, fixing up the file structure if something is missing or has been updated.
• Merged updater config into your common.json file
• We have added support to choose from dev-builds or "major" releases. The dev-build is ~ up to date with our #『』github channel, choosing it allows you to gain access to all future updates a lot faster but with the risk of encountering more bugs. Major releases includes all changes in #『』github collected together in one big update that will be released on BBB as well.

OTHER ADDITIONS

• Fixed a typo at the channel setup info page
• Fixed an issue with /televate & /tlower, not allowing you to jump freely through the configured permission levels
• Patched an error at getting Minecraft server member count
• Fixed occurred typo
• Added custom image support for welcome & goodbye message - these are also not being reset anymore by using the updating tool / auto updates.
• Added an optional parameter to /ban allowing you to disable submitting the global ban for this specific case
• All autocomplete interactions are now capped at 25 entries to fix a few bugs at larger servers
• Fixed an issue with staff management when editing existing staff roles
• Updated all dependencies

[NEW] AUTO UPDATES » BETA
Following the successful initial release of our update tool, we are pleased to introduce the automated updating system. This system provides automatic updates for your bot, including configuration files, eliminating the need for manual intervention. Discord notifications will be dispatched upon successful completion of each update.

Note: This system is locked/disabled by default. Only a selected group of people will be able to enable it for testing purposes. After 1-2 weeks it will be automatically unlocked & enabled for everyone else. To join our BETA please keep an eye at our announcements channel.


[NEW] CHANGELOGS
This update introduces a new changelog feature, simplifying how you communicate updates to your community. Now you can create structured, visually pleasing lists of changes, ensuring everyone stays informed about the latest server or application developments.


ADDITIONS

• All console logs are automatically saved within txt files now (/logs/console/)
• Added ticket elevate & lower quick update command allowing you to jump through all permission levels
• Blacklisted automod rule now flags all non-lower cased matches

BUG FIXES

• Fixed an issue with adding boosters
• Fixed an issue with music player disconnecting after a few minutes
• Corrected miss leading console log at temp voice channels
• Fixed an issue with booster list emoji parsing
• Fixed an issue with system messages erroring if api fails to respond
• Fixed a typo at player_leave message
• Removed "watermark" at /pastebin for addon customers

[NEW] TYPES
This improvement enhances IntelliSense in your development editor, making it easier to work with Athena. A good portion of our core features and functions are now exposed and available for use, helping streamline future development.


ADDITIONS

• Made all file operations async
• Added Mongodb pterodactyl egg
• Modal input length at ticket & application questions is now being validated
• Updated ticket configuration option send_transcript_to_ticket_creator to only remove the transcript from the ticket closure notification.
• Added closeRequest ticket button
• Setup menu is now being "deferred" to allow a slower loading speed
• Added experimental feature to prevent duplicated messages (prevent_duplicated_message in your common config)

BUG FIXES

• Fixed an issue with /tmove not updating permissions correctly
• Fixed an issue with music system crashing if staying too long on idle
• Fixed an issue with tapps & tickets throwing invalid url errors
• Fixed an issue with temp voice channels not clearing correctly
• Fixed /tapplication enable & /tapplication disable erroring
• Fixed an issue with owner assignment at temporary voice channels
• Fixed several issues with sticky messages