ForgeScript is a comprehensive package that empowers you to effortlessly interact with Discord's API. It ensures scripting remains easy to learn and consistently effective.
- Installation
- Making your first bot
- Extensions
- Limitations
- Update Frequency
- Function Documentation
- Library Documentation
Make sure you have node.js installed, and greater than version v16.11.0. Once done, run the next command in a folder (from any IDE or terminal):
npm i https://github.com/tryforge/ForgeScript.gitIf installing this repository instead of npm, you must have TypeScript as dependency (
npm i typescript --save-dev)
This section will guide you through initializing a client and loading commands from a folder, as well as logging your bot into discord.
We will write the following for a basic bot initialization, in a index.js file:
const { ForgeClient } = require("forgescript")
const client = new ForgeClient({
intents: [
"GuildMessages",
"Guilds",
"MessageContent" // This intent is privileged, must be whitelisted in dev portal, in your application.
],
events: [
"messageCreate",
"ready"
], // Events our bot will act on
prefixes: [
"!",
"?"
] // The prefixes to use for our bot!
})
client.login("token")This will be enough to put our bot on.
Registering commands is the way to go when we want something to happen on certain events.
Let's write this after our client initialization code:
client.commands.add({
name: "user", // Not defining this creates a command that will be executed for every event fired of given type
code: `Your name is $username!`,
type: "messageCreate" // The event to act on
})And this will register a command with name user that will return the name of the user that executed this command.
The previous way to register commands can fill our index file with a lot of junk code, so there's a way to put files with commands in folders and load them from the index file.
- Create a folder, with any name, and a file inside it, name it whatever you want (must end with .js) and write the following in it:
This is essentially the same as the previous command, but will be loaded from a folder!
module.exports = { name: "user", type: "messageCreate", code: `Your name is $username!` }
- Now, let's go back to our index file and write the following after client initialization (Make sure you've erased the code to register a command from index file):
Replace
client.commands.load("./<folder>")
<folder>with the folder name you used, and every file residing in the root folder (the tree doesn't matter as long as the file is in the folder) will be loaded into your bot!
