K
Docs
Building Bots

📦 Expansions

Expansions unlock categories of Pieces on the Canvas. The Base Set is always included — install The Mod Squad for moderation tools.

🎁 All expansions are free

📬Unbox → Install

Claim an expansion into your account, then attach it to a bot.

🎁
1. Unbox

Browse the expansion gallery and click Unbox. The expansion lands in your account inventory.

🔧
2. Install on bot

Open bot settings → Expansions and install from your inventory. New Pieces appear in the palette.

📋Expansion Catalog

🛡️
The Mod Squad
mod
Unbox to unlock

Everything the people who keep the chaos at bay could want — kick, ban, timeout, purge, slowmode, lockdown and more. Now automated, so your mods can sleep at night.

Pieces (10)

Kit validation

💡How validation works

Before publishing, Kitcord checks that every piece id in your flows belongs to an expansion installed on that bot. The expansions array in the Kit lists which expansion ids are active (must include base).

📐Under the hood — types
TypeScript
// Canvas catalog (lib/expansions.ts)
interface ExpansionDef {
  id: string;           // "base" | "mod"
  name: string;
  tagline: string;
  alwaysUnboxed?: boolean; // base is always available
}

// In a Bot Kit — validated before publish
type KitExpansions = string[]; // e.g. ["base", "mod"]
kit.json (expansions)JSON
{
  "expansions": ["base", "mod"],
  "flows": [
    {
      "id": "flow_warn",
      "entry": "node_kick",
      "nodes": [
        {
          "id": "node_kick",
          "piece": "mod.kick",
          "config": { "userId": "{{input.options.target.id}}", "reason": "Spam" }
        }
      ],
      "edges": []
    }
  ]
}