A lot of the documentation here is still being written, sorry for the incompleteness! This guide should get you up and running with a bot fairly quickly, though.
- A text/code editor (such as VS Code) or an integrated development environment (IDE)
- Some basic programming skills and familiarity with JavaScript/Node.js
- Node.js (a recent LTS version is fine) installed on your system
- An account registered at Fluxer.app (though you’re not forced to use this instance, of course!)
- A community (referred to as a guild in the API) that you’ve created
Step 1: Open “User Settings” in the bottom-left
On mobile web, press “You” in the bottom-right, then the settings icon in the upper-right.
This should work on mobile web devices too!
Step 3: Create a new application
Give it a fancy name. This will be the default username of your application unless changed.
Step 4: Regenerate the bot token
Press the “Regenerate” button for the bot token field, confirm the action, and store the generated value somewhere secure, such as in a password manager.
Step 5: Mark the bot as private (optional)
You might not want anyone to be able to invite your bot if they know its user ID.
Step 6: Generate the bot invite URL
Check “bot” (you don’t need any extra permissions for now) and copy the “Authorize URL.”
Paste the authorization URL in the browser address bar in a new tab and hit enter to add your bot.
Visiting the URL should bring up a view similar to this one:
Choose a community where you have “Manage Community” permissions to continue.
Step 8: A wild bot has appeared!
Now it’s time to start writing some code to make our awesome application do awesome things.
Step 9: Write the code and run the bot
First, create a new project directory:
mkdir fluxer_bot && cd fluxer_bot && npm init -y
npm i -E @discordjs/core@2.4.0 @discordjs/rest@2.6.0 @discordjs/ws@2.0.4
.env file in this folder:
FLUXER_BOT_TOKEN=<your token goes here>
bot.mjs file, looking like so:
import {Client, GatewayDispatchEvents} from '@discordjs/core';
import {REST} from '@discordjs/rest';
import {WebSocketManager} from '@discordjs/ws';
const token = process.env['FLUXER_BOT_TOKEN'];
if (!token) {
throw new Error('You forgot the token!');
}
const rest = new REST({api: 'https://api.fluxer.app', version: '1'}).setToken(token);
const gateway = new WebSocketManager({
intents: 0,
rest,
token,
version: '1',
});
const client = new Client({rest, gateway});
client.on(GatewayDispatchEvents.MessageCreate, async ({api, data}) => {
if (data.author.bot) {
return;
}
if (data.content === '!ping') {
await api.channels.createMessage(data.channel_id, {
content: 'pong!',
message_reference: {message_id: data.id},
});
}
});
client.on(GatewayDispatchEvents.Ready, ({data}) => {
const {username, discriminator} = data.user;
console.log(`Logged in as @${username}#${discriminator}`);
});
gateway.connect();
node --env-file=.env bot.mjs.
➜ fluxer_bot node --env-file=.env bot.mjs
Logged in as @My_Awesome_Application#0168
A lot of the documentation here is still being written, sorry for the incompleteness! This guide should get you up and running with a bot fairly quickly, though.
Fluxer’s HTTP API & Gateway API share similarities with the Discord API to make it easy for you to migrate existing Discord bot libraries. Note that slash commands & interactions are not yet implemented on Fluxer, but they’re coming soon!
