Build
Discord events, slash commands, buttons and menus, modals, background tasks and cron schedules.
Discord events
Use @plugin.on_event(name) for raw Discord events. Twenty event types are dispatched to plugins: Event Payload highlights message_create message_id, channel_id, author_id,…
Slash commands
Two steps: declare the command in manifest.json , then handle it with @plugin.on_slash_command . The platform syncs the command registration with Discord automatically when your…
Buttons & menus
Component classes build Discord component JSON for you. They take string-style values, not enums. Button from yourbot_sdk import Button, ActionRow Button( label="Click me",…
Modal dialogs
Modals collect text input from the user. Open one with ctx.interaction.send_modal and handle the submission with @plugin.on_modal_submit : Required manifest flag: Discord only…
Background tasks
How schedules reach production: declare each @plugin.cron task in your manifest's "cron" array (see below) and the platform fires it per installed server — UTC, a 5-minute floor,…
Cron schedules
@plugin.cron(spec) runs a task on a 5-field cron schedule in UTC . Use this when you want a job to fire at a wall-clock time (e.g. Monday 09:00) instead of a fixed interval since…
Limits that apply on this tab
Area Limit Events 50 events/s per (server, plugin); at-least-once delivery; failed handlers are not retried Interactions 3 s to first response (pre-acked for you); defer()…