discord-afk-js

discord-afk-js

discord-afk-js is a JavaScript library created to facilitate the management of AFK (Away From Keyboard) status within Discord bots. This library is designed to simplify the process of tracking and handling AFK users in a Discord server without the need for an external database.

Requirements

• NodeJS 18.x or higher

Installation

To start using discord-afk-js, you can install it through npm, the Node.js package manager. Open your terminal and run the following command:

npm install discord-afk-js

Usage

discord-afk-js offers a straightforward way to manage AFK users in your Discord bot. Below is an example of how to utilize the AfkClient class:

const { AfkClient } = require('discord-afk-js');

// Create an instance of AfkClient
const afk = new AfkClient();

// ================================================================

// Checking if a user is AFK without time
afk.setUser({ id: 'id1', reason: 'Afk Playing Game' });

const [reason, time] = await afk.getReason('id1');

if (afk.findUser('id1')) {
  console.log('User is marked as AFK'); // console: User is marked as AFK
  console.log('AFK Message:', `${reason} ${time}`); // console: AFK Message: Afk Playing Game a few seconds ago
}

// ================================================================

// Adding a user to AFK status without reason
afk.setUser({ id: 'id2' });

if (afk.findUser('id2')) {
  console.log('User is marked as AFK'); // console: User is marked as AFK
  const [reason, time] = await afk.getReason('id2');

  console.log('AFK Message:', `${reason} ${time}`); // console: AFK Message: No Reason a few seconds ago
}

// ================================================================

// Get reason without array
afk.setUser({ id: 'id3' });
const reason = await afk.getReason('id3');

console.log(reason); // console: No Reason a few seconds ago

//================================================================

// Removing a user from AFK status
afk.removeUser('user123');

In the code snippet above, we start by importing the AfkClient class. After creating an instance of this class, we demonstrate how to add a user to the AFK list, check their AFK status, and remove them from AFK status.

Changelog | Migrating to discord-afk-js

+ change afk to AfkClient for import
+ afk.addUser() -> afk.setUser()
+ afk.deleteUser() -> afk.removeUser()
+ afk.getReason()

License

This project is open-source and is licensed under the MIT License. You can find more details about the license in the LICENSE.md file included in the project.

With this comprehensive readme, you have a clear and detailed guide on how to use the discord-afk-js library to manage AFK status in your Discord bot.

Discord Servers