stoatbot.js

Note: this package is currently in the early stages of development and testing

stoatbot.js is a Node.js library for building bots on the Revolt platform. It provides an easy-to-use interface for interacting with Revolt's API, managing events, and handling various bot functionalities. NOTE: node 21 is required to run this revolt server docs

Installation

npm install stoatbot.js
Copy

or

yarn add stoatbot.js
Copy

Basic Setup

Below is an example of how to set up a basic bot using stoatbot.js:

Example Code

typescript

import { client, MessageStruct } from "stoatbot.js";

const bot = new client({});

bot.on("ready", () => {
  console.log("Bot is ready!");
});

bot.on("message", (message: MessageStruct) => {
  if (message.content === "ping") {
    message.reply("pong");
  }
});

bot.login("YOUR_BOT_TOKEN");
Copy

javascript

const { client } = require("stoatbot.js");

const bot = new client({});

bot.on("ready", () => {
  console.log("Bot is ready!");
});

bot.on("message", (message) => {
  if (message.content === "ping") {
    message.reply("pong");
  }
});

bot.login("YOUR_BOT_TOKEN");
Copy

Features

• Event-based architecture for handling messages, server updates, and more.
• Easy-to-use managers for channels, servers, users, and roles.
• Experimental support for 3rd party instances using backend version 0.7 +

Development

To contribute or modify the library:

1. Clone the repository:

   git clone https://github.com/Jade3375/stoatbot.js.git
   cd stoatbot.js
   Copy

2. Install dependencies:

   yarn install
   Copy

3. Build the project:

   yarn build
   Copy

Contribution

We welcome contributions to stoatbot.js! To contribute, follow these steps:

1. Fork the Repository
   Go to the repository and click the "Fork" button to create your own copy.

2. Clone Your Fork
   Clone your forked repository to your local machine:

   git clone https://github.com/your-username/stoatbot.js
   cd stoatbot.js
   Copy

3. Create a Branch
   Create a new branch for your feature or bug fix:

   git checkout -b feature-or-bugfix-name
   Copy

4. Make Changes
   Implement your changes or fixes in the codebase.

5. Test Your Changes
   Ensure your changes work as expected by running the project and any relevant tests:

   yarn test
   Copy

6. Commit Your Changes
   Commit your changes with a descriptive message:

   git add .
   git commit -m "Description of your changes"
   Copy

7. Push Your Branch
   Push your branch to your forked repository:

   git push origin feature-or-bugfix-name
   Copy

8. Open a Pull Request
   Go to the original repository and open a pull request from your branch. Provide a clear description of your changes and why they should be merged.

Guidelines

• Follow the existing code style and structure.
• Write clear and concise commit messages.
• Add or update documentation if necessary.
• Ensure your changes do not break existing functionality.

Thank you for contributing to stoatbot.js!

License

This project is licensed under the MIT License.