Erela.js 进阶指南：构建功能丰富的音乐机器人命令系统

2025-06-08 01:00:53作者：申梦珏Efrain

前言

在构建基于 Erela.js 的音乐机器人时，单一命令显然无法满足实际需求。本文将深入探讨如何构建一个完整的命令系统，并实现多个实用的音乐控制命令，帮助开发者打造功能完善的音乐机器人。

命令系统架构设计

1. 命令收集器初始化

首先我们需要对基础代码进行改造，引入命令收集器：

const { Client, Collection } = require("discord.js");
const { readdirSync } = require("fs");
const { Manager } = require("erela.js");

const client = new Client();
client.manager = new Manager(/* 你的配置选项 */);

// 初始化命令收集器
client.commands = new Collection();

2. 动态加载命令模块

采用模块化设计，自动加载commands目录下的所有命令文件：

const commandFiles = readdirSync("./commands")
  .filter(file => file.endsWith(".js"));

commandFiles.forEach(file => {
  const command = require(`./commands/${file}`);
  client.commands.set(command.name, command);
});

这种设计模式的优势在于：

命令可维护性高
新增命令无需修改主文件
便于团队协作开发

命令处理器实现

消息事件处理优化

重写消息事件处理器，实现更健壮的命令解析：

client.on("message", async message => {
  // 基础过滤条件
  if (!message.content.startsWith("!") || 
      !message.guild || 
      message.author.bot) return;
  
  // 高级参数解析
  const [commandName, ...args] = message.content
    .slice(1)
    .trim()
    .split(/\s+/g);

  // 命令查找与执行
  const command = client.commands.get(commandName.toLowerCase());
  if (!command) return;

  try {
    await command.execute(message, args, client);
  } catch (error) {
    console.error(error);
    message.reply("执行命令时发生错误！");
  }
});

基础命令开发实践

1. Ping 命令实现

创建commands/ping.js作为测试命令：

module.exports = {
  name: "ping",
  description: "测试机器人响应",
  execute(message) {
    message.reply(`Pong! 延迟: ${Date.now() - message.createdTimestamp}ms`);
  }
}

2. 播放命令增强版

改进后的播放命令commands/play.js：

module.exports = {
  name: "play",
  aliases: ["p"], // 命令别名
  description: "播放音乐或添加到队列",
  async execute(message, args) {
    if (!args.length) {
      return message.reply("请提供搜索词或URL！");
    }
    
    const voiceChannel = message.member.voice.channel;
    if (!voiceChannel) {
      return message.reply("请先加入语音频道！");
    }

    const player = message.client.manager.create({
      guild: message.guild.id,
      voiceChannel: voiceChannel.id,
      textChannel: message.channel.id,
    });

    if (player.state !== "CONNECTED") {
      player.connect();
    }

    const search = args.join(" ");
    const result = await player.search(search, message.author);
    
    if (result.loadType === "NO_MATCHES") {
      return message.reply("未找到匹配结果！");
    }

    player.queue.add(result.tracks[0]);
    if (!player.playing && !player.paused) {
      player.play();
    }
    
    message.channel.send(`已添加: ${result.tracks[0].title}`);
  }
}

高级音乐控制命令

1. 队列管理命令

commands/queue.js实现：

module.exports = {
  name: "queue",
  description: "显示当前播放队列",
  execute(message) {
    const player = message.client.manager.get(message.guild.id);
    
    if (!player) {
      return message.reply("没有活跃的播放器！");
    }
    
    const queue = player.queue;
    if (!queue.current) {
      return message.reply("当前没有播放任何内容！");
    }

    const queueList = queue.map((track, index) => 
      `${index + 1}. ${track.title} (${track.duration})`
    ).join("\n");

    message.channel.send(`
**当前播放:** ${queue.current.title}
**队列列表:**
${queueList}
`);
  }
}

2. 跳过命令实现

commands/skip.js示例：

module.exports = {
  name: "skip",
  description: "跳过当前播放的曲目",
  async execute(message) {
    const player = message.client.manager.get(message.guild.id);
    
    if (!player) {
      return message.reply("没有活跃的播放器！");
    }
    
    const currentTrack = player.queue.current;
    player.stop();
    message.channel.send(`已跳过: ${currentTrack.title}`);
  }
}