Muse自定义状态教程：打造个性化的Discord机器人在线形象

【免费下载链接】muse 🎧 a self-hosted midwestern Discord music bot that doesn't suck 项目地址: https://gitcode.com/gh_mirrors/mus/muse

Muse是一款自托管的Discord音乐机器人，通过简单的配置就能让你的机器人展现独特的在线状态。本教程将带你快速掌握如何自定义Muse机器人的状态信息，让你的Discord服务器更加个性化。

为什么需要自定义机器人状态？

自定义机器人状态不仅能让你的Muse机器人看起来更专业，还能直观地展示机器人当前的功能状态。例如，你可以设置机器人显示"正在播放音乐"或"在线等待指令"等信息，让服务器成员一目了然。

Muse机器人默认状态展示

图：Muse机器人在Discord中的状态显示效果，包含播放状态和队列信息

准备工作：获取Muse机器人源码

首先需要获取Muse机器人的源代码，通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/mus/muse
cd muse

自定义状态的核心配置项

Muse机器人的状态配置主要通过环境变量实现，核心配置项位于src/services/config.ts文件中。主要包含以下几个关键配置：

• BOT_STATUS：机器人在线状态（online, idle, dnd, invisible）
• BOT_ACTIVITY：活动文本内容
• BOT_ACTIVITY_TYPE：活动类型（PLAYING, LISTENING, WATCHING, STREAMING）
• BOT_ACTIVITY_URL：如果是STREAMING类型，需要提供直播URL

简单配置：通过.env文件设置状态

最简便的自定义方式是修改项目根目录下的.env文件（如果没有则创建一个），添加以下配置：

# 机器人状态设置
BOT_STATUS=online
BOT_ACTIVITY=你的音乐 | !help
BOT_ACTIVITY_TYPE=LISTENING

活动类型说明

Muse支持四种活动类型，可根据需要选择：

• PLAYING：显示"正在玩..."
• LISTENING：显示"正在听..."（推荐音乐机器人使用）
• WATCHING：显示"正在看..."
• STREAMING：显示"正在直播"（需要配合BOT_ACTIVITY_URL使用）

高级配置：动态修改状态

如果你需要更复杂的状态逻辑，可以修改src/bot.ts文件中的相关代码。机器人状态设置的核心代码如下：

// src/bot.ts中设置状态的代码
this.client.user?.setPresence({
  activities: [
    {
      name: this.config.BOT_ACTIVITY,
      type: this.config.BOT_ACTIVITY_TYPE,
      url: this.config.BOT_ACTIVITY_URL,
    },
  ],
  status: this.config.BOT_STATUS,
});

你可以根据需要添加动态逻辑，例如根据当前播放状态自动更新活动内容。

应用配置并重启机器人

完成配置后，使用以下命令重启Muse机器人使配置生效：

# 使用yarn重启
yarn start

# 或者使用npm
npm start

常见问题解决

配置不生效怎么办？

1. 确保.env文件位于项目根目录
2. 检查配置项名称是否正确（区分大小写）
3. 确认重启了机器人
4. 检查日志是否有相关错误信息

支持哪些状态类型？

Muse支持Discord的所有标准状态：

• online（在线）
• idle（离开）
• dnd（请勿打扰）
• invisible（隐身）

总结

通过简单的环境变量配置，你就能轻松自定义Muse机器人的在线状态，让它更好地融入你的Discord服务器。无论是展示当前播放的音乐，还是提供帮助指令提示，个性化的状态都能提升用户体验。

图：Muse机器人官方logo

现在，开始打造你独一无二的Muse机器人状态吧！如果需要更多高级功能，可以查阅项目的源代码和配置文件进行深入定制。

【免费下载链接】muse 🎧 a self-hosted midwestern Discord music bot that doesn't suck 项目地址: https://gitcode.com/gh_mirrors/mus/muse