framecord v1.2.4

FrameCord

A Discord bot framework made by Sana Rinomi.

Install via NPM: npm i -s framecord

Index

• Setting up a Bot
  • Adding Commands
    • Adding Commands: Method 1
    • Adding Commands: Method 2
• Nodes
  • Node
  • Data Node
  • Root Node
  • Command Node

Setting up a Bot

To get your bot up up and running is rather simple! We create a Client and then we use the login() function to start the bot!

const {Client} = require("framecord");

let client = new Client("Discord bot token", "d", function(client) { console.log(`Logged in as ${client.discordCli.user.tag}`); });

client.login();

Adding Commands

To add commands to our bot, we need to first create a Node! This node can be be a simple Node or it could also be a DataNode. This node will be the base we will call commands from, and there can be multiple!

In this example we will use a DataNode with the ID of ! and add it to our client.

const {Client, Nodes} = require("framecord");

let client = new Client("Discord bot token", "d", function(client) { console.log(`Logged in as ${client.discordCli.user.tag}`); });

let Base = new Nodes.DataNode("!");

client.registerNode(Base);

client.login();

Now we can add our command, which to do so, we will create a new CommandNode. And as an example, we will make a command that closes our program.

Here's how we create a command:

const {Client, Nodes} = require("framecord");

let client = new Client("Discord bot token", "d", function(client) { console.log(`Logged in as ${client.discordCli.user.tag}`); });

let Base = new Nodes.DataNode("!");
let Exit = new Nodes.CommandNode("exit", (cli, command, msg) => {
    msg.reply("See you later!").then(() => {
        cli.exit();
    });
});

client.registerNode(Base);

client.login();

There are 2 ways we can add the command node to our client:

• Using addChild(Node)
• Using the client method registerNode(Node, String) with a path

Each one has their own benefits, so choose according to what you want to do. You can also use both methods at the same time, so a hybrid approach is possible.

Adding Commands: Method 1

This example shows the use of addChild(Node):

const {Client, Nodes} = require("framecord");

let client = new Client("Discord bot token", "d", function(client) { console.log(`Logged in as ${client.discordCli.user.tag}`); });

let Base = new Nodes.DataNode("!");
let Exit = new Nodes.CommandNode("exit", (cli, command, msg) => {
    msg.reply("See you later!").then(() => {
        cli.exit();
    });
});

Base.addChild(Exit);
client.registerNode(Base);

client.login();

This method is easier to implement, since you directly add your node to the parent using Node's addChild(Node) method without having to worry if the parent exists.

Adding Commands: Method 2

This example shows the use of your client's registerNode(Node, String) method using a path:

const {Client, Nodes} = require("framecord");

let client = new Client("Discord bot token", "d", function(client) { console.log(`Logged in as ${client.discordCli.user.tag}`); });

let Base = new Nodes.DataNode("!");
let Exit = new Nodes.CommandNode("exit", (cli, command, msg) => {
    msg.reply("See you later!").then(() => {
        cli.exit();
    });
});

client.registerNode(Base);
client.registerNode(Exit, "!");

client.login();

With this method, you have to make sure your parent node is already registered, the path is exactly like how you'd call a command within Discord just without the prefix. Like in this example, we want to register a node to our base !, in Discord our path would be e! while the path within the client itself would just be !. A few more examples:

• e!foo => !foo
• e!foo bar => !foo bar

Be aware that registerNode(Node, String) uses the same method as executeNode(String) which is used to call commands. Which means that registering something to !foo bar doesntexist would register to node bar, and doesntexist would be returned as a command argument.

This method works great for modular bots, with code that's loaded in dynamically.

Nodes

You can find all the nodes under Nodes in FrameCord:

const {Nodes} = require("framecord");

These are the nodes available by default with FrameCord:

Node

Type: blank. This node is our base node, and every other node is going to be based off of it.

Constructor

Variables

Methods

• Removing children will call the delete() function of the children.

Data Node

DataNode extends Node.

Type: data. This node adds basic data such as Name. Description, Tags and IsNSFW to Node.

Constructor

Variables

Methods

Root Node

RootNode extends Node.

Type: root. This node includes a bunch of methods related to finding and retrieving nodes, and creating command variables. Used mainly by a Client instance.

Constructor

Methods

Command Node

CommandNode extends DataNode.

Type: command. This node adds basic data such as Name. Description, Tags and IsNSFW to Node.

Constructor

Variables

Methods