https://github.com/lispcord/lispcord

A client library for the discordapp bot api
https://github.com/lispcord/lispcord

bot discord discord-api discord-app discordapp

Last synced: about 2 months ago
JSON representation

A client library for the discordapp bot api

• Host: GitHub
• URL: https://github.com/lispcord/lispcord
• Owner: lispcord
• Created: 2017-10-27T10:01:39.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-01-06T08:14:13.000Z (6 months ago)
• Last Synced: 2024-01-06T09:22:21.382Z (6 months ago)
• Topics: bot, discord, discord-api, discord-app, discordapp
• Language: Common Lisp
• Homepage:
• Size: 338 KB
• Stars: 64
• Watchers: 6
• Forks: 12
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Lists

• discord-api-libs - lispcord - A client library for the discordapp bot api (Libraries / Common Lisp)

README

        
# Lispcord -- A wrapper for the [DiscordApp](http://discordapp.com/) WEB-API

Lispcord aims to make it freakishly easy to build bots for Discord.

The [examples](./examples) folder contains some more ideas on how to get started :)

#### NOTE: this is not even an alpha quality software

A lot of the api is changing rapidly, use at own risk!

#### NOTE: recently we axed the Pipe system

Please re-adjust your bots to use the new API going forwards.

As it turned out, the pipes worked well for small bots but had the penchant to

bloat in complexity rather quickly, and weren't particularly fast :D

## Ping bot

This assumes that :lispcord has been loaded in your image. If not, try running

```lisp

(ql:quickload :lispcord)

```

after cloning the repo to your `~/common-lisp` or `~/quicklisp/local-projects` folder.

```lisp

(defpackage :ping-bot

  (:use :cl :lispcord))

(in-package :ping-bot)

(setf (org.shirakumo.verbose:repl-level) :info)

(defbot *ping-bot* "")

(connect *ping-bot*) ; Yes, you can register handlers after connect

(add-event-handler :on-message-create

  (lambda (msg) (if (string= (lc:content msg) "ping!") (reply msg "pong!"))))

```

Unlike many other libraries, **lispcord** is capable of running an arbitrary amount

of client-instances at the same time.  

Every (non-cache related) function takes an optional "bot" parameter,

either via keyword or as an anonymous optional,

with which you can specify what instance should execute the action.  

For convenience, however, **lispcord** *also* defines a dynamic `*CLIENT*` which

gets automatically bound to the last instance defined via `DEFBOT`. This allows you to:

  - drop having to specifiy the bot for 1-instance scripts

  - use `LET` to override the global, and create local 1-instance spaces