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: got a 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 event 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.

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

export const conditions = [];
export const any_guild = false;
export const allow_bots = false;

➖ MemberLeave​

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

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

export const conditions = [];
export const any_guild = false;
export const 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.

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

export const conditions = [];
export const any_guild = false;
export const allow_bots = false;

🖥️ Methods and parameters​

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

export async function parse(member)

While MemberUpdate has 2 arguments

export async function parse(old_member, new_member)

⎯ Exports

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

export const conditions = [];
export const any_guild = false;
export const 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
  • allow_bots → if false, it will ignore events when the member is a bot