
本教程详细讲解了如何在discord.js机器人中获取发送消息用户的相关信息,特别是用户id。文章深入探讨了discord提及机制的原理,强调了使用用户id进行准确@提及的重要性,并提供了具体的node.js代码示例,帮助开发者实现动态地提及消息发送者。
在Node.js环境中使用Discord.js库开发机器人时,一个常见的需求是获取发送消息的用户信息,并在机器人的回复中提及(ping)该用户。虽然直接使用用户名看似直观,但Discord的API和discord.js库对用户提及有着特定的处理方式,需要开发者理解其背后的机制。
获取消息发送者信息
当Discord机器人接收到一条消息时,message对象包含了关于该消息及其发送者的所有相关数据。要获取消息的发送者,可以通过message.author属性。
message.author是一个User对象,它提供了发送消息用户的详细信息,包括:
- id: 用户的唯一标识符,一个字符串。这是在Discord中进行用户提及的关键。
- username: 用户的显示名称。
- discriminator: 用户的四位数字标签(例如 #1234),通常与username一起构成完整的用户标签。
- tag: 完整的用户标签,格式为 username#discriminator。
- bot: 一个布尔值,指示该用户是否为机器人。
例如,要简单地获取发送者的用户名,可以使用message.author.username。
Discord提及机制解析
尽管message.author.username能够获取到用户的显示名称,但在Discord中,直接在消息内容中使用@用户名的字符串形式,并不能保证机器人能够正确地提及(ping)到该用户,使其收到通知。Discord的提及机制是基于用户的唯一ID工作的。当你通过Discord客户端输入@用户时,客户端实际上会将其内部转换为的格式发送出去。
因此,如果希望机器人回复的消息中能够真正地“@”到某人,使其收到通知,就必须使用其用户ID来构造提及字符串。
在Node.js中获取用户ID并进行提及
为了在机器人回复中正确地提及消息发送者,我们需要获取message.author.id,并将其嵌入到特定的提及格式中。Discord.js支持的有效用户提及格式是 ""。
以下是基于原始场景的修正示例,展示了如何在匹配特定消息内容后,动态地提及消息发送者:
const Discord = require('discord.js');
const { token } = require('./config.json'); // 假设您的机器人token存储在config.json中
// 对于Discord.js v13及更高版本,需要声明Intents以允许机器人接收特定事件和数据。
// 例如,要读取消息内容,需要MessageContent意图。
const client = new Discord.Client({
intents: [
Discord.GatewayIntentBits.Guilds, // 访问服务器信息
Discord.GatewayIntentBits.GuildMessages, // 接收服务器消息
Discord.GatewayIntentBits.MessageContent // 读取消息内容
]
});
client.once('ready', () => {
console.log('Discord机器人已准备就绪!');
});
// 在v13+中,处理新消息的事件已更名为'messageCreate'
client.on('messageCreate', message => {
// 重要的检查:避免机器人回复自己的消息或其他机器人的消息,防止无限循环
if (message.author.bot) return;
// 检查消息内容是否与特定字符串匹配
if (message.content === `[ done ] the @? gold ? succes`) {
// 使用JavaScript的模板字符串(反引号 `` ` ``)来构建消息,
// 将message.author.id动态地嵌入到提及格式中。
message.channel.send(`!addinvites <@${message.author.id}> 50`);
}
});
client.login(token);代码解释:
- Discord.Client初始化与Intents: 对于Discord.js v13及更高版本,为了让机器人能够接收和处理消息内容,必须在客户端初始化时声明Intents,特别是Discord.GatewayIntentBits.MessageContent。
- client.on('messageCreate', ...): messageCreate是Discord.js v13及更高版本中用于监听新消息的事件名称。如果你使用的是旧版本(如v12),则事件名为message。
- if (message.author.bot) return;: 这是一个非常重要的安全检查。它确保机器人不会响应由其他机器人(包括它自己)发送的消息,从而有效防止机器人进入无限循环或执行不必要的任务。
- !addinvites 50: 这里使用了JavaScript的模板字符串(由反引号 ` 包裹),它允许开发者方便地将变量(如message.author.id)直接嵌入到字符串中。 会被Discord解析为一个有效的用户提及,从而确保消息发送者能够收到通知。
注意事项
- Discord.js 版本兼容性: 上述代码示例考虑了Discord.js v13+的Intents和messageCreate事件。如果你使用的是旧版本(如v12),则可能不需要Intents配置,并且监听消息的事件名为message。请根据你所使用的库版本进行相应的调整。
- 机器人权限: 确保你的Discord机器人在其所在的服务器中拥有发送消息的权限(SEND_MESSAGES),以及读取消息内容的必要权限。如果机器人没有这些权限,它将无法正常工作。
- 用户对象与成员对象: message.author始终代表发送消息的用户(User对象)。如果需要获取服务器成员(GuildMember)的更多信息,例如他们在特定服务器中的昵称、角色列表等,可以通过message.member属性获取。但请注意,message.member仅在消息来自服务器频道(而非私聊DM)时可用。
总结
在Discord.js中,要实现在机器人回复中正确地提及消息发送者,核心在于理解并利用message.author.id。通过将用户的唯一ID嵌入到特定的""格式的字符串中,可以确保机器人能够发出有效的用户提及,从而使目标用户收到通知。理解Discord的提及机制以及正确使用discord.js提供的User对象属性,是构建功能完善且用户友好的Discord机器人的关键一步。










