Skip to main content

🧑‍🧑‍🧒‍🧒 Members

ℹ️ Magic tips​

If you want to create "fake join" or "fake leave" to test you handlers, you can use builtin commands : join and leave.

🎊 Multi events​

There is 3 kinds of events here:

  • MemberAdd → (we will call it MemberJoin, it's easier to understand) when a user join a guild
  • MemberRemove → (we will call it MemberLeave, it's easier to understand) when a user leave a guild
  • MemberUpdate → when a member (user inside a guild) is updated (e.g: new role)

Since we have 3 kinds of events, we can no longer simply put them in ./sources/modules/<module_name>/members, we need to specify which of the 3 events is to be used. To do this, we add an extension to the end of the file:

⎯ Example for each classes replace <module_name> by the name of your module

  • join → ./sources/modules/<module_name>/members/member_join.js
  • leave → ./sources/modules/<module_name>/members/member_leave.js
  • update → ./sources/modules/<module_name>/members/member_update.js

🤔 "Member"​

Member is an object with several data and methods, you should read discord.js documentation to see how to work with Member.

➕ MemberJoin​

Has one argument member who is an instance of Member.

async function parse(member)
{
	console.log("new member:", member.user.username)
}

module.exports = {
	parse,
	conditions: [],
	any_guild: false,
	dm: false,
	allow_bots: false
}

➖ MemberLeave​

Possède un argument member qui est une instance de Member.

async function parse(member)
{
	console.log("a member left:", member.user.username)
}

module.exports = {
	parse,
	conditions: [],
	any_guild: false,
	dm: false,
	allow_bots: false
}

🆙 MemberUpdate​

Possède deux arguments old_member et new_member qui sont des instances de Member.

⚠️ Attention: old_member est l'état du membre avant la mise à jour et new_member après la mise à jour.

async function parse(old_member, new_member)
{
	console.log("member: ", old_member.user.username, " has been updated")
}

module.exports = {
	parse,
	conditions: [],
	any_guild: false,
	dm: false,
	allow_bots: false
}

🖥️ Methods and parameters​

Be careful MemberJoin and MemberLeave both has only one argument so as shown below:

async function parse(member)

While MemberUpdate has 2 arguments

async function parse(old_member, new_member)

⎯ Exports

At the bottom of the file we have exports, which includes several important elements.

module.exports = {
	parse,
	conditions: [],
	any_guild: false,
	dm: false,
	allow_bots: false
}
  • parse → method to handle the event
  • conditions → list of methods to check if member has the right conditions
  • any_guild → if false, the command can be executed only on the main guild
  • dm → if true, we can use this interaction in direct messages
  • allow_bots → if false, it will ignore events when the member is a bot