# Common questions

# Legend

• <client> is a placeholder for the Client object, such as const client = new Discord.Client();.
• <message> is a placeholder for the Message object, such as client.on('message', message => { ... });.
• <guild> is a placeholder for the Guild object, such as <message>.guild or <client>.guilds.get('<id>').

For a more detailed explanation on the notations commonly used in this guide, the docs, and the support server, see here.

# Administrative

# How do I ban a user?

const user = <message>.mentions.users.first();
<guild>.ban(user);

# How do I kick a user?

const member = <message>.mentions.members.first();
member.kick();

# How do I add a role to a guild member?

const role = <guild>.roles.find('name', '<role name>');
const member = <message>.mentions.members.first();
member.addRole(role);

# How do I check if a guild member has a certain role?

const member = <message>.mentions.members.first();
if (member.roles.exists('name', '<role name>')) {
	// ...
}

# How do I limit a command to a single user?

if (<message>.author.id === '<id>') {
	// ...
}

# Bot Configuration

# How do I set my username?

<client>.user.setUsername('<username>');

# How do I set my avatar?

<client>.user.setAvatar('<url or path>');

# How do I set my playing status?

<client>.user.setActivity('<activity>');

# How do I set my status to "Watching ..." or "Listening to ..."?

<client>.user.setActivity('<activity>', { type: 'WATCHING' });
<client>.user.setActivity('<activity>', { type: 'LISTENING' });

# Miscellaneous

# How do I send a message to a certain channel?

const channel = <client>.channels.get('<id>');
channel.send('<content>');

# How do I DM a certain user?

const user = <client>.users.get('<id>');
user.send('<content>');

# How do I tag a certain user in a message?

const user = <message>.mentions.users.first();
<message>.channel.send(`Hi, ${user}.`);
<message>.channel.send('Hi, <@user id>.');

# How do I prompt the user for additional input?

<message>.channel.send('Please enter more input.').then(() => {
	const filter = m => <message>.author.id === m.author.id;

	<message>.channel.awaitMessages(filter, { time: 60000, maxMatches: 1, errors: ['time'] })
		.then(messages => {
			<message>.channel.send(`You've entered: ${messages.first().content}`);
		})
		.catch(() => {
			<message>.channel.send('You did not enter any input!');
		});
});

# How do I react to the message my bot sent?

<message>.channel.send('My message to react to.').then(sentMessage => {
	sentMessage.react('👍');
	sentMessage.react('<emoji id>');
});

# How do I create a restart command?

process.exit();

# What is the difference between a User and a GuildMember?

A lot of users get confused as to what the difference between Users and GuildMembers is. The simple answer is that a User represents a global Discord user and a GuildMember represents a Discord user on a specific server. That means only GuildMembers can have permissions, roles, and nicknames, for example, because all of these things are server-bound information that could be different on each server that user is in.