14 lines
1.0 KiB
Markdown
14 lines
1.0 KiB
Markdown
## API
|
|
|
|
`discordmt` offers a simple API which other mods can use to listen to and send messages with Discord.
|
|
|
|
It does not expose the command interface or logins to the API, and `discord.register_on_message` events will *not* recieve login information.
|
|
|
|
### `discord.send(message [, optional id])`
|
|
Sends `message` to Discord.
|
|
This function makes an HTTP request; therefore the sending of large volumes of data might be better grouped into a single request. **Do note that Discord limits messages to 2,000 characters, and the relay automatically cuts off messages.**
|
|
The optional `id` parameter specifies a specific Discord user to send the message to.
|
|
|
|
### `discord.register_on_message(function(name, message))`
|
|
Adds a function to `discord.registered_on_messages`, which are called every time a message is received from Discord, excluding logins. `name` is by default the Discord username of the user who sent the message (excluding the discriminator) and `message` is the message content. This function should be called on startup.
|