fix: enhance dashboard UI, queue persistence, voice stability, and command fixes

config.js

@@ -160,7 +160,7 @@ const config = {
     command: {
         disableCommand: [],                                 // Disabled commands, all enabled by default
         adminCommand: ['blacklist', 'language', 'server', 'status', 'volume-default'], // Admin commands, only Admin role user can use
-        djCommand: ['dj', 'filter'],                        // DJ commands, only DJ role user can use
+        djCommand: ['dj', 'filter', 'stop', 'pause', 'resume', 'skip', 'clear', 'leave', 'shuffle', 'loop', 'volume'], // DJ commands, only DJ role user can use
         // Supported commands: 'skip', 'seek', 'pause'
         // When a command name is listed here, only the requester of the currently playing song may use it.
         // Admins can always bypass this restriction regardless.
@@ -177,6 +177,11 @@ const config = {
         enabled             : false             // Enable/disable persistent queue storage
     },
 
+    // Playlist settings
+    playlist: {
+        enabled             : true              // Enable/disable playlist feature
+    },
+
     // SQLite database settings
     database: {
         path                : './data/database.db' // Path to SQLite database file

package.json

@@ -27,13 +27,9 @@
         "url": "https://github.com/hmes98318/Music-Disc/issues"
     },
     "homepage": "https://github.com/hmes98318/Music-Disc#readme",
-    "overrides": {
-        "body-parser": "^2.2.3",
-        "brace-expansion": "^5.0.8"
-    },
     "dependencies": {
         "bcryptjs": "^3.0.3",
-        "better-sqlite3": "^13.0.2",
+        "better-sqlite3": "^13.0.3",
         "cookie": "^2.0.1",
         "discord.js": "~14.27.0",
         "dotenv": "^17.4.2",
@@ -48,12 +44,12 @@
         "@eslint/js": "^10.0.1",
         "@types/better-sqlite3": "^9.6.0",
         "@types/express": "^5.0.6",
-        "@types/node": "^26.1.2",
-        "eslint": "^10.8.0",
-        "globals": "^17.9.0",
-        "tsx": "^4.23.5",
+        "@types/node": "^26.2.0",
+        "eslint": "^10.8.1",
+        "globals": "^17.11.0",
+        "tsx": "^4.23.12",
         "typescript": "~6.0.3",
-        "typescript-eslint": "^8.66.0"
+        "typescript-eslint": "^8.67.0"
     },
     "engines": {
         "node": ">=22.23.2"

src/@types/index.ts

@@ -114,12 +114,17 @@ export type Config = {
     bot: BotConfig;
     nodeList: NodeOptions[];
     spotify: SpotifyConfig;
-    blacklist: string[],
+    blacklist: string[];
     webDashboard: WebDashboardConfig;
     localNode: LocalNodeConfig;
     command: CommandConfig;
     database: DatabaseConfig;
     queuePersistence: QueuePersistenceConfig;
+    playlist: PlaylistConfig;
+};
+
+export type PlaylistConfig = {
+    enabled: boolean;
 };
 
 export type BotConfig = {

src/App.ts

@@ -134,7 +134,12 @@ class App {
      * @private
      */
     #setShutdownSignalHandlers(): void {
+        let isShuttingDown = false;
+
         const shutdown = async (signal: string) => {
+            if (isShuttingDown) return;
+            isShuttingDown = true;
+
             this.bot.logger.log( this.bot.shardId, `Received ${signal}. Closing server gracefully...`);
 
             const timeout = setTimeout(() => {
@@ -143,29 +148,33 @@ class App {
             }, 30 * 1000);
 
             try {
-                // Stop periodic saves and save all active queues before shutdown
+                // Stop periodic saves and save all active queues in parallel before shutdown
                 if (this.bot.config.queuePersistence.enabled && this.#client.queuePersistence) {
                     this.bot.logger.log( this.bot.shardId, 'Saving active queues before shutdown...');
                     this.#client.queuePersistence.stopAllPeriodicSaves();
-                    for (const player of this.#client.lavashark.players.values()) {
-                        await this.#client.queuePersistence.saveQueue(player);
-                    }
+                    const players = Array.from(this.#client.lavashark?.players?.values() ?? []);
+                    await Promise.allSettled(
+                        players.map(player => this.#client.queuePersistence!.saveQueue(player))
+                    );
                 }
 
                 // Close the lavashark players connections
                 this.bot.logger.log( this.bot.shardId, 'Closing voice channel connection...');
+                const activePlayers = Array.from(this.#client.lavashark?.players?.values() ?? []);
                 await Promise.allSettled(
-                    Array.from(this.#client.lavashark.players.values()).map(player => player.destroy())
+                    activePlayers.map(player => player.destroy())
                 );
-                await new Promise(resolve => setTimeout(resolve, 2000));
                 this.bot.logger.log( this.bot.shardId, 'Voice channel connection closed.');
 
                 // Close the lavashark nodes connections
                 this.bot.logger.log( this.bot.shardId, 'Closing lavashark nodes...');
-                for (const node of this.#client.lavashark.nodes) {
-                    node.disconnect();
+                if (this.#client.lavashark?.nodes) {
+                    for (const node of this.#client.lavashark.nodes) {
+                        try {
+                            node.disconnect();
+                        } catch (_) {}
+                    }
                 }
-                await new Promise(resolve => setTimeout(resolve, 2000));
                 this.bot.logger.log( this.bot.shardId, 'Lavashark nodes closed.');
 
                 // Close discord.js connection
@@ -227,6 +236,10 @@ const main = async () => {
 main();
 
 
-process.on('unhandledRejection', (error) => {
-    console.error('Unhandled promise rejection:', error);
+process.on('unhandledRejection', (reason, promise) => {
+    console.error('Unhandled Promise Rejection at:', promise, 'reason:', reason);
+});
+
+process.on('uncaughtException', (error) => {
+    console.error('Uncaught Exception thrown:', error);
 });

src/commands/BlacklistCommand.ts

@@ -24,30 +24,32 @@ export class BlacklistCommand extends BaseCommand {
     /**
      * Build blacklist command metadata and slash command options
      */
-    public getMetadata(_bot: Bot): CommandMetadata {
+    public getMetadata(_bot: Bot, lng?: string): CommandMetadata {
         return {
             aliases: [],
             category: CommandCategory.UTILITY,
-            description: i18next.t('commands:CONFIG_BLACKLIST_DESCRIPTION'),
+            description: i18next.t('commands:CONFIG_BLACKLIST_DESCRIPTION', { lng }),
             name: 'blacklist',
             options: [
                 this.createUserSubcommand(
                     'add',
                     'commands:CONFIG_BLACKLIST_OPTION_ADD',
+                    lng,
                 ),
                 this.createUserSubcommand(
                     'remove',
                     'commands:CONFIG_BLACKLIST_OPTION_REMOVE',
+                    lng,
                 ),
                 {
-                    description: i18next.t('commands:CONFIG_BLACKLIST_OPTION_LIST'),
+                    description: i18next.t('commands:CONFIG_BLACKLIST_OPTION_LIST', { lng }),
                     name: 'list',
                     type: ApplicationCommandOptionType.Subcommand,
                 },
             ],
             sendTyping: true,
             showHelp: true,
-            usage: i18next.t('commands:CONFIG_BLACKLIST_USAGE'),
+            usage: i18next.t('commands:CONFIG_BLACKLIST_USAGE', { lng }),
             voiceChannel: false,
         };
     }
@@ -99,13 +101,14 @@ export class BlacklistCommand extends BaseCommand {
     private createUserSubcommand(
         name: BlacklistMutationAction,
         descriptionKey: string,
+        lng?: string
     ): ApplicationCommandSubCommandData {
         return {
-            description: i18next.t(descriptionKey),
+            description: i18next.t(descriptionKey, { lng }),
             name,
             options: [
                 {
-                    description: i18next.t('commands:CONFIG_BLACKLIST_OPTION_USER'),
+                    description: i18next.t('commands:CONFIG_BLACKLIST_OPTION_USER', { lng }),
                     name: 'user',
                     required: true,
                     type: ApplicationCommandOptionType.User,

src/commands/ClearCommand.ts

@@ -8,12 +8,12 @@ import type { Bot, CommandMetadata } from '../@types/index.js';
 
 
 export class ClearCommand extends BaseCommand {
-    public getMetadata(_bot: Bot): CommandMetadata {
+    public getMetadata(_bot: Bot, lng?: string): CommandMetadata {
         return {
             name: 'clear',
             aliases: ['cls'],
-            description: i18next.t('commands:CONFIG_CLEAR_DESCRIPTION'),
-            usage: i18next.t('commands:CONFIG_CLEAR_USAGE'),
+            description: i18next.t('commands:CONFIG_CLEAR_DESCRIPTION', { lng }),
+            usage: i18next.t('commands:CONFIG_CLEAR_USAGE', { lng }),
             category: CommandCategory.MUSIC,
             voiceChannel: true,
             showHelp: true,
@@ -48,7 +48,7 @@ export class ClearCommand extends BaseCommand {
         }
         else {
             await context.replySuccess(bot, isRadioPlaying
-                ? context.t('commands:MESSAGE_CLEAR_RADIO_SUCCESS', { defaultValue: '🧹 Cleared queue and stopped radio playback.' })
+                ? context.t('commands:MESSAGE_CLEAR_RADIO_SUCCESS')
                 : context.t('commands:MESSAGE_CLEAR_SUCCESS'));
         }
     }

src/commands/DashboardCommand.ts

@@ -8,12 +8,12 @@ import type { Bot, CommandMetadata } from '../@types/index.js';
 
 
 export class DashboardCommand extends BaseCommand {
-    public getMetadata(_bot: Bot): CommandMetadata {
+    public getMetadata(_bot: Bot, lng?: string): CommandMetadata {
         return {
             name: 'dashboard',
-            aliases: ['d', 'console'],
-            description: i18next.t('commands:CONFIG_DASHBOARD_DESCRIPTION'),
-            usage: i18next.t('commands:CONFIG_DASHBOARD_USAGE'),
+            aliases: ['db'],
+            description: i18next.t('commands:CONFIG_DASHBOARD_DESCRIPTION', { lng }),
+            usage: i18next.t('commands:CONFIG_DASHBOARD_USAGE', { lng }),
             category: CommandCategory.MUSIC,
             voiceChannel: true,
             showHelp: true,

src/commands/DjCommand.ts

@@ -12,20 +12,20 @@ import type { Bot, CommandMetadata } from '../@types/index.js';
 
 
 export class DjCommand extends BaseCommand {
-    public getMetadata(_bot: Bot): CommandMetadata {
+    public getMetadata(_bot: Bot, lng?: string): CommandMetadata {
         return {
             name: 'dj',
             aliases: ['adddj'],
-            description: i18next.t('commands:CONFIG_DJ_DESCRIPTION'),
-            usage: i18next.t('commands:CONFIG_DJ_USAGE'),
+            description: i18next.t('commands:CONFIG_DJ_DESCRIPTION', { lng }),
+            usage: i18next.t('commands:CONFIG_DJ_USAGE', { lng }),
             category: CommandCategory.UTILITY,
             voiceChannel: false,
             showHelp: true,
             sendTyping: false,
             options: [
                 {
                     name: 'user',
-                    description: i18next.t('commands:CONFIG_DJ_OPTION_DESCRIPTION'),
+                    description: i18next.t('commands:CONFIG_DJ_OPTION_DESCRIPTION', { lng }),
                     type: ApplicationCommandOptionType.User,
                     required: false
                 }

src/commands/FilterCommand.ts

@@ -18,20 +18,20 @@ import type { Bot, CommandMetadata } from '../@types/index.js';
 
 
 export class FilterCommand extends BaseCommand {
-    public getMetadata(_bot: Bot): CommandMetadata {
+    public getMetadata(_bot: Bot, lng?: string): CommandMetadata {
         return {
             name: 'filter',
             aliases: ['eq', 'equalizer'],
-            description: i18next.t('commands:CONFIG_FILTER_DESCRIPTION'),
-            usage: i18next.t('commands:CONFIG_FILTER_USAGE'),
+            description: i18next.t('commands:CONFIG_FILTER_DESCRIPTION', { lng }),
+            usage: i18next.t('commands:CONFIG_FILTER_USAGE', { lng }),
             category: CommandCategory.MUSIC,
             voiceChannel: true,
             showHelp: true,
             sendTyping: true,
             options: [
                 {
                     name: 'filter',
-                    description: i18next.t('commands:CONFIG_FILTER_OPTION_DESCRIPTION'),
+                    description: i18next.t('commands:CONFIG_FILTER_OPTION_DESCRIPTION', { lng }),
                     type: 3,
                     required: true,
                     choices: [

src/commands/HelpCommand.ts

@@ -17,20 +17,20 @@ import type { Bot, CommandMetadata } from '../@types/index.js';
 
 
 export class HelpCommand extends BaseCommand {
-    public getMetadata(_bot: Bot): CommandMetadata {
+    public getMetadata(_bot: Bot, lng?: string): CommandMetadata {
         return {
             name: 'help',
             aliases: ['h'],
-            description: i18next.t('commands:CONFIG_HELP_DESCRIPTION'),
-            usage: i18next.t('commands:CONFIG_HELP_USAGE'),
+            description: i18next.t('commands:CONFIG_HELP_DESCRIPTION', { lng }),
+            usage: i18next.t('commands:CONFIG_HELP_USAGE', { lng }),
             category: CommandCategory.UTILITY,
             voiceChannel: false,
             showHelp: true,
             sendTyping: true,
             options: [
                 {
                     name: 'command',
-                    description: i18next.t('commands:CONFIG_HELP_OPTION_DESCRIPTION'),
+                    description: i18next.t('commands:CONFIG_HELP_OPTION_DESCRIPTION', { lng }),
                     type: 3,
                     required: false
                 }
@@ -59,15 +59,14 @@ export class HelpCommand extends BaseCommand {
      * @private
      */
     async #showCommandList(bot: Bot, client: Client, context: CommandContext): Promise<void> {
-        const title = client.user?.username;
-        const commands = client.commands.getHelpCommands(bot);
+        const commands = client.commands.getHelpCommands(bot, context.language);
 
         const musicCommands = commands.filter(cmd => {
-            const metadata = cmd.getMetadata(bot);
+            const metadata = cmd.getMetadata(bot, context.language);
             return metadata.category === CommandCategory.MUSIC;
         });
         const utilityCommands = commands.filter(cmd => {
-            const metadata = cmd.getMetadata(bot);
+            const metadata = cmd.getMetadata(bot, context.language);
             return metadata.category === CommandCategory.UTILITY;
         });
 
@@ -76,7 +75,7 @@ export class HelpCommand extends BaseCommand {
             .setCustomId(SelectButtonId.HelpMusic)
             .setPlaceholder(context.t('commands:HELP_SELECT_MUSIC_PLACEHOLDER'))
             .setOptions(musicCommands.map(cmd => {
-                const metadata = cmd.getMetadata(bot);
+                const metadata = cmd.getMetadata(bot, context.language);
                 const aliases = metadata.aliases && metadata.aliases.length > 0 ? metadata.aliases.join(', ') : context.t('commands:HELP_COMMAND_NONE');
                 return {
                     label: metadata.name,
@@ -89,7 +88,7 @@ export class HelpCommand extends BaseCommand {
             .setCustomId(SelectButtonId.HelpUtility)
             .setPlaceholder(context.t('commands:HELP_SELECT_UTILITY_PLACEHOLDER'))
             .setOptions(utilityCommands.map(cmd => {
-                const metadata = cmd.getMetadata(bot);
+                const metadata = cmd.getMetadata(bot, context.language);
                 const aliases = metadata.aliases && metadata.aliases.length > 0 ? metadata.aliases.join(', ') : context.t('commands:HELP_COMMAND_NONE');
                 return {
                     label: metadata.name,
@@ -120,12 +119,12 @@ export class HelpCommand extends BaseCommand {
             const selectedCommand = client.commands.get(i.values[0]);
             if (!selectedCommand) return;
 
-            const metadata = selectedCommand.getMetadata(bot);
+            const metadata = selectedCommand.getMetadata(bot, context.language);
             const usage = `${metadata.description}\n\`\`\`${bot.config.bot.prefix}${metadata.usage}\`\`\``;
 
             await i.deferUpdate();
             await msg.edit({
-                embeds: [embeds.help(bot, title!, usage, context.language)],
+                embeds: [embeds.help(bot, metadata.name, usage, context.language)],
                 components: [],
                 allowedMentions: { repliedUser: false }
             }).catch(() => bot.logger.discord( bot.shardId, 'Failed to edit deleted message.'));
@@ -150,11 +149,11 @@ export class HelpCommand extends BaseCommand {
      */
     async #showCommandHelp(bot: Bot, client: Client, context: CommandContext, commandName: string): Promise<void> {
         const prefix = bot.config.bot.prefix;
-        const commands = client.commands.getHelpCommands(bot);
+        const commands = client.commands.getHelpCommands(bot, context.language);
 
         let found = false;
         for (const cmd of commands) {
-            const metadata = cmd.getMetadata(bot);
+            const metadata = cmd.getMetadata(bot, context.language);
             if (commandName === metadata.name || (metadata.aliases && metadata.aliases.includes(commandName))) {
                 const description = `${metadata.description}\n\`\`\`${prefix}${metadata.usage}\`\`\``;