Discord API library written in Lua for the Luvit runtime environment
Discordia is a Lua wrapper for the official Discord API, and provides a high-level, object-oriented, event-driven interface for developing Discord bots. By using Lua's native coroutines, asynchronous HTTP and WebSocket communication is internally abstracted in a way that allows end-users to write blocking-style code without blocking I/O operations.
Join the Discord API community to discuss Discordia and other Discord libraries!
- To install Luvit, visit https://luvit.io and follow the instructions provided for your platform.
- To install Discordia, run
lit install SinisterRectus/discordia
- Run your bot script using, for example,
local discordia = require('discordia') local client = discordia.Client() client:on('ready', function() print('Logged in as '.. client.user.username) end) client:on('messageCreate', function(message) if message.content == '!ping' then message.channel:send('Pong!') end end) client:run('Bot INSERT_TOKEN_HERE')
Please visit this project's Wiki for documentation and tutorials.
The earliest version of Discordia, before it even had that name, was released as a Just Cause 2 Multiplayer module on 7 March 2016. It utilized LuaSocket, LuaSec, and (eventually) Copas to provide basic REST functionality in a sandboxed Lua 5.2 environment. The goal was to bridge the game chat with a Discord client. Due to a lack of WSS support (at the time), the project was put on hold in favor of a general-purpose Lua library for Discord. After finishing a relatively stable version of Discordia, the JC2MP bridge was re-designed to connect with Discordia via inter-process communication.
- Luvit makes Lua web development an easy task on multiple platforms. Its installation process is (optionally) automated and uses pre-built luvi cores when available. It also comes with many libraries essential to async I/O programming and networking. Compared to Node.js, Luvit advertises similar speed, but reduced memory consumption. Compared to other Discord libraries, Discordia is expected to perform well due Luvit's use of LuaJIT, although it has not been benchmarked.
Can I run this on a different Lua distribution?
- The development and deployment of Discordia relies on the Luvit framework and its package manager. Porting Discordia and its dependencies to classic Lua or LuaJIT may be possible, but this is not a current project goal.
How can I contribute?
- Pull requests are welcomed, but please check with the library author before starting a major implementation. Contributions to the Wiki are helpful, too.
Are there other Discord libraries?
- Absolutely. Check the official libraries page of the Discord API documentation or the unofficial Discord API server linked above.