// Mallard: a Discord bot you write yourself

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

var userId = ctx.args.user;
var reason = ctx.args.reason || "No reason provided";

// DM them first. After the ban there is no mutual
// server left to reach them through.
sendDm(userId, "", [{
    title: "Banned",
    description: "Reason: " + reason
}]);

ban(userId, reason, 0);

var target = getMember(userId);
var targetName = target ? target.username : userId;
editResponse("Banned " + targetName + " (" + userId + "). Reason: " + reason);

1
2
3
4
5
6
7
8

var seconds = parseInt(ctx.args.seconds);

if (isNaN(seconds) || seconds < 0 || seconds > 21600) {
    editResponse("Invalid slowmode. Must be 0 to 21600.");
} else {
    setSlowmode(ctx.channelId, seconds);
    editResponse("Slowmode set to " + seconds + " seconds.");
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

var userId = ctx.args.user;
var reason = ctx.args.reason || "No reason provided";
var durationMin = parseInt(ctx.args.duration_min);

timeout(userId, reason, durationMin);

// Mod actions go in the guild's own key-value store, one
// record per user, so /notes can read them back later.
var notes = JSON.parse(getKV("mod:notes:" + userId) || "[]");
notes.push({ type: "timeout", userId: userId, reason: reason });
setKV("mod:notes:" + userId, JSON.stringify(notes));

var target = getMember(userId);
var targetName = target ? target.username : userId;
editResponse("Timed out " + targetName + " (" + userId + ") for "
    + durationMin + " minutes. Reason: " + reason);

beta: pricing and limits still being tuned

what the blocks turn into

What Easy Mode writes for you

Blocks compile to ordinary JavaScript, and you can read it below the canvas while you build. That file is the only thing that ever runs, so a script assembled here gets the same triggers and the same logs as one you typed. When you want the rest of the language, take the file and carry on in it.

1
2
3
4
5

// Give a member a role
addRole(ctx.actorId, "1528016624483958906");

// Send a message
sendMessage("1527981654843457679", "Welcome! Read the rules and say hi.");

30 action blocks, plus conditions and an early exit, up to 60 of them per script. It deliberately does not cover everything: no loops, no stored data, no fetch, no buttons, and one embed at a time. That is what the right-hand column above is for, and switching to Advanced hands you the file to keep going in.

easy mode is an early preview, and still changing

look inside the dashboard

Look inside the dashboard

Everything below is the actual editing surface, not a mockup.

dashboard / scripts / easy

Click to enlarge

dashboard / scripts

Click to enlarge

dashboard / scripts / trigger

Click to enlarge

dashboard / database

Click to enlarge

what a script looks like

What a script looks like

Plain JavaScript against a small API. Discord actions, an HTTP client, per-guild storage, and secrets your moderators never see.

1
2
3
4
5
6
7
8
9
10
11

// Times out repeat image-posters for mods to review, no command needed
const key = `imgspam.${ctx.message.authorId}`;
const recent = JSON.parse(getKV(key) || "[]")
    .filter(e => Date.now() - e.timestamp < 10000);
recent.push({ messageId: ctx.message.id, timestamp: Date.now() });
setKV(key, JSON.stringify(recent), 60);

if (recent.length >= 3 && ctx.message.attachments.length > 0) {
    timeout(ctx.message.authorId, "Image spam", 1440);
    sendMessage(ctx.env.mod_alert_channel_id, "🖼️ Timed out for image spam. Please review.");
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

// ctx.secret.* are opaque {{secret:NAME}} tokens. The real key is
// injected only inside fetch(), never visible to the script (or your mods)
const chat = getMessages(ctx.channelId, 100).reverse()
    .map(function (m) { return m.authorDisplayName + ": " + m.content; })
    .join("\n");

const res = fetch("https://openrouter.ai/api/v1/chat/completions", JSON.stringify({
    method: "POST",
    headers: {
        authorization: "Bearer " + ctx.secret.OpenrouterKey,
        "content-type": "application/json"
    },
    body: JSON.stringify({
        model: "google/gemini-3.1-flash-lite",
        messages: [{ role: "user", content: "Summarize this chat:\n" + chat }]
    })
}));
editResponse(JSON.parse(res.body).choices[0].message.content);

1
2
3
4
5
6
7
8

// Twitch events arrive as triggers just like Discord ones
if (ctx.env.twitch_announce_channel_id) {
    sendMessage(ctx.env.twitch_announce_channel_id, "", [{
        title: "🔴 Live now: " + ctx.twitch.title,
        description: "Playing " + ctx.twitch.category
            + " at twitch.tv/" + ctx.twitch.broadcasterLogin
    }]);
}

Browse the full template library

start with what you already need

Start with what you already need

Install it, use the commands it comes with, and change them when they get in your way. Add the next one out of blocks, or write it. If you would rather see the whole API first, the docs cover every trigger and function.

Questions, or want to see what other servers are running? The support server has a scripts hub.