Examples

// The smallest bot: answers !ping. Run it with  ROAR_TOKEN=... node ping.js
import { Bot } from "roar.js";

const bot = new Bot({ token: process.env.ROAR_TOKEN });

bot.on("ready", () => console.log(`${bot.user.username} is online!`));

bot.on("message", async (msg) => {
  if (msg.content === "!ping") await msg.reply("Pong! 🏓");
});

bot.start();

// Slash commands with options: /roll and /coin.
import { Bot } from "roar.js";

const bot = new Bot({ token: process.env.ROAR_TOKEN });

bot.command({
  name: "roll",
  description: "Roll a die",
  options: [
    { name: "sides", description: "How many sides", type: "integer", choices: [4, 6, 8, 10, 12, 20] },
  ],
}, async (i) => {
  const sides = i.options.sides ?? 6;
  const n = 1 + Math.floor(Math.random() * sides);
  await i.reply(`🎲 ${i.user.displayName} rolled **${n}** (d${sides})`);
});

bot.command("coin", "Flip a coin", (i) => i.reply(Math.random() < 0.5 ? "🪙 Heads!" : "🪙 Tails!"));

bot.start();

// Welcomes new members and gives them a role.
// The bot needs a role with Manage Roles placed above "Member" (Server Settings → Roles).
import { Bot, mention } from "roar.js";

const bot = new Bot({ token: process.env.ROAR_TOKEN });

bot.on("memberJoin", async (member) => {
  const channel = member.guild.channel("welcome") ?? member.guild.systemChannel;
  if (channel) await channel.send(`Welcome to **${member.guild.name}**, ${mention(member)}! 👋`);
  if (member.guild.role("Member")) await member.addRole("Member", "New member");
});

bot.on("memberLeave", async (member) => {
  const channel = member.guild?.channel("welcome");
  if (channel) await channel.send(`${member.user.displayName} left. 😢`);
});

bot.start();

// Reaction roles: !rolemenu posts a message; reacting gives a role, removing the reaction takes it away.
// The bot needs Manage Roles, above the roles it hands out.
import { Bot } from "roar.js";

const bot = new Bot({ token: process.env.ROAR_TOKEN });
const ROLES = { "🎮": "Gamer", "🎨": "Artist", "🎵": "Music" };
const menus = new Set(); // ids of the menu messages (kept in memory: post a new menu after a restart)

bot.on("message", async (msg) => {
  if (msg.content !== "!rolemenu" || !msg.guild) return;
  const lines = Object.entries(ROLES).map(([emoji, role]) => `${emoji}  ${role}`);
  const menu = await msg.channel.send(`**Pick your roles**\n${lines.join("\n")}`);
  menus.add(menu.id);
  for (const emoji of Object.keys(ROLES)) await menu.react(emoji);
});

bot.on("reactionAdd", async (r) => {
  if (menus.has(r.messageId) && ROLES[r.emoji]) await r.guild.addRole(r.userId, ROLES[r.emoji]);
});

bot.on("reactionRemove", async (r) => {
  if (menus.has(r.messageId) && ROLES[r.emoji]) await r.guild.removeRole(r.userId, ROLES[r.emoji]);
});

bot.start();

// Embeds: /serverinfo and /whois.
import { Bot } from "roar.js";

const bot = new Bot({ token: process.env.ROAR_TOKEN });

bot.command("serverinfo", "About this server", (i) => i.reply({
  embed: {
    title: i.guild.name,
    color: "#5fd96a",
    fields: [
      { name: "Members", value: String(i.guild.memberCount), inline: true },
      { name: "Channels", value: String(i.guild.channels.size), inline: true },
      { name: "Roles", value: String(i.guild.roles.size), inline: true },
    ],
    footer: `Server id ${i.guild.id}`,
  },
}));

bot.command({
  name: "whois",
  description: "About someone",
  options: [{ name: "person", description: "Who", type: "user", required: true }],
}, (i) => {
  const member = i.guild.member(i.options.person);
  if (!member) return i.reply({ content: "I can't find them here.", ephemeral: true });
  return i.reply({
    embed: {
      title: member.displayName,
      description: `@${member.user.username}`,
      thumbnail: member.user.avatarUrl ?? undefined,
      fields: [
        { name: "Joined", value: member.joinedAt?.toDateString() ?? "?", inline: true },
        { name: "Account made", value: member.user.createdAt.toDateString(), inline: true },
      ],
    },
  });
});

bot.start();

// /remind: answers straight away, then pings you later.
import { Bot, mention } from "roar.js";

const bot = new Bot({ token: process.env.ROAR_TOKEN });

bot.command({
  name: "remind",
  description: "Remind me later",
  options: [
    { name: "minutes", description: "In how many minutes", type: "integer", required: true },
    { name: "what", description: "What to remind you about", type: "string", required: true },
  ],
}, async (i) => {
  const minutes = Math.min(Math.max(1, i.options.minutes), 24 * 60);
  await i.reply({ content: `⏰ OK, I'll remind you in ${minutes === 1 ? "1 minute" : `${minutes} minutes`}.`, ephemeral: true });
  setTimeout(() => bot.send(i.channelId, `⏰ ${mention(i.user)}: ${i.options.what}`), minutes * 60000);
});

bot.start();

// No bot needed: post to a channel from any program with a webhook URL
// (Channel Settings → Webhooks → New Webhook → Copy URL).
import { Webhook } from "roar.js";

const hook = new Webhook(process.env.ROAR_WEBHOOK_URL);

await hook.send({
  username: "Build Bot",
  content: "The build passed ✅",
  embed: { title: "main @ 63444f4", color: "#5fd96a", footer: "from webhook.js" },
});