Getting started
Install the SDK, edit the starter, ship a zip. The file layout, manifest.json and the plugin lifecycle.
Quick start
Five minutes to a running plugin. The whole local loop is four commands: pip install yourbot-sdk yourbot new my_plugin # scaffold from a template cd my_plugin yourbot dev # run…
The yourbot CLI
The SDK installs a yourbot command — it is the fastest way through every step before upload. Four subcommands cover the local loop: Command What it does yourbot new <id> Scaffold…
Plugin file structure
A plugin is a zip with this layout: my_plugin/ ├── manifest.json # required - id, version, capabilities, … ├── __main__.py # required - your handler code (the entry point) ├──…
manifest.json
Declares who you are, what version this is, and what you're allowed to do. id , name and version are required. id must match the plugin you created in the Dev Portal (3–32 chars:…
Plugin lifecycle
Two hooks carry a plugin's whole lifecycle today: @plugin.on_ready for setup and your event handlers for everything else. Decorator Fires when @plugin.on_ready Running locally…
Where next
You have a running plugin — now make it do something useful. The Cookbook has copy-pasteable recipes for the most common patterns (welcome messages, leaderboards, polls,…