Discord-starboard-plus NPM

⭐ Discord Starboard Plus

Effortlessly highlight your community's favorite messages with customizable starboards. Pin and celebrate standout content, tailor reaction requirements, add personalized messages, and enjoy detailed logging. Showcase your server's best moments and engage with members like never before. Turn your Discord server into a star-studded community with Starboard Plus!
BIG UPDATES : New edit message system, more configuration, add message, image, custom emoji and videos !

🪐 Table of Contents

📑 Overview
🚀 Features
🏗️ Project Structure
🧩 Modules
🛠️ Getting Started
- 🔌 Prerequisites
- ⬇️ Installation
📖 Usage
🧪 Running Tests
⚡ To-do
🤝 Contributing
📄 License
👏 Credits

📑 Overview

The Discord Starboard Plus is a powerful and customizable Discord bot module that allows you to create starboards for your server. Whether you want to highlight memorable messages, pin important content, or engage with your community, Starboard Plus has got you covered. With features like customizable star emojis, reaction requirements, personalized messages, and detailed logging, you can easily turn your server into a star-studded community.

🚀 Features

Customizable Starboards: Create multiple starboards with different settings to highlight various types of content.
Reaction Requirements: Set the number of reactions required for a message to appear on the starboard.
Personalized Messages: Add custom messages to your starboard entries to engage with your community.
Logging: Detailed logging options to keep track of starred messages and bot actions.
Ignore Configuration: Configure which channels or guilds to ignore when monitoring reactions.

🏗️ Project Structure

Your package directory structure should resemble the following:

discord-starboard-plus/
├── src/
│ ├── starboard.js
├── exemple.js
├── package.json
└── README.md

🧩 Modules

starboard.js: The main module containing the Starboard class and logic for managing starboards.

🛠️ Getting Started

🔌 Prerequisites

Before you begin, ensure you have the following prerequisites:

Node.js installed on your machine.

⬇️ Installation

Install the discord-starboard-plus package using npm:

npm install discord-starboard-plus

📖 Usage

To use Discord Starboard Plus in your bot, you need to create an instance of the Starboard class and pass the necessary options.

const { Client, GatewayIntentBits } = require('discord.js');
const Starboard = require('discord-starboard-plus'); // Import module

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.GuildMessageReactions,
    GatewayIntentBits.MessageContent,
    GatewayIntentBits.GuildMembers,
    GatewayIntentBits.GuildPresences,
  ],
});

const starboardOptions = {
  starboardChannelID: 'YOUR_STARBOARD_CHANNEL_ID',
  requiredReactions: 1, // Default : '1'
  starEmoji: 'STAR_EMOJI' // Default : '⭐' (for custom emoji need to use only name of emoji)
  // Add other options as needed 
};

client.once('ready', () => {
  console.log(`Logged in as ${client.user.tag}`);
  const starboard = new Starboard(client, starboardOptions);
});

client.login('YOUR_BOT_TOKEN');

🧪 Running Tests

Tests for Discord Starboard Plus can be run using a testing framework like Mocha or Jest. Make sure to set up appropriate testing scenarios and assertions for your specific use case.