mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2024-11-08 00:37:15 +01:00
135 lines
5.7 KiB
Markdown
135 lines
5.7 KiB
Markdown
|
<div align="center"><img src="docpages/DPP-markdown-logo.png" alt="DPP"/>
|
||
|
|
<h3>An incredibly lightweight C++ Discord library</h3>
|
||
|
|
<br />
|
||
|
|
|
||
|
|
[](https://discord.gg/dpp)
|
||
|
|
|
||
|
|
[](https://www.codacy.com/gh/brainboxdotcc/DPP/dashboard?utm_source=github.com&utm_medium=referral&utm_content=brainboxdotcc/DPP&utm_campaign=Badge_Grade)
|
||
|
|
|
||
|
|
[](https://github.com/brainboxdotcc/DPP/actions/workflows/ci.yml)
|
||
|
|
[](https://aur.archlinux.org/packages/dpp) [](CODE_OF_CONDUCT.md)
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<hr />
|
||
|
|
|
||
|
|
|
||
|
|
D++ is a lightweight and efficient library for **Discord** written in **modern C++**, covering as much of the API specification as possible with an **incredibly small memory footprint** even when caching large amounts of data.
|
||
|
|
|
||
|
|
### Library features:
|
||
|
|
|
||
|
|
* Support for Discord API v10
|
||
|
|
* Really small memory footprint
|
||
|
|
* Efficient caching system for guilds, channels, guild members, roles, users
|
||
|
|
* Sharding and clustering (Many shards, one process: specify the number of shards, or let the library decide)
|
||
|
|
* Highly optimised ETF (Erlang Term Format) support for very fast websocket throughput
|
||
|
|
* [Slash Commands/Interactions support](https://dpp.dev/slashcommands.html)
|
||
|
|
* [Voice support](https://dpp.dev/soundboard.html) (sending **and** receiving audio)
|
||
|
|
* The entire Discord API is available for use in the library
|
||
|
|
* Stable [Windows support](https://dpp.dev/buildwindows.html)
|
||
|
|
* Ready-made compiled packages for Windows, Raspberry Pi (ARM64/ARM7/ARMv6), Debian x86/x64 and RPM based distributions
|
||
|
|
* Highly scalable for large amounts of guilds and users
|
||
|
|
|
||
|
|
Want to help? Drop me a line or send a PR.
|
||
|
|
|
||
|
|
This library is in use on [TriviaBot](https://triviabot.co.uk/) and [Sporks bot](https://sporks.gg) and many other bots!
|
||
|
|
|
||
|
|
## Documentation
|
||
|
|
|
||
|
|
The documentation is constantly evolving and improving, generated from the code comments and markdown examples using Doxygen.
|
||
|
|
|
||
|
|
#### [View the D++ library documentation](https://dpp.dev/)
|
||
|
|
|
||
|
|
### Example
|
||
|
|
|
||
|
|
This is a simple ping-pong example using slash commands.
|
||
|
|
|
||
|
|
```c++
|
||
|
|
#include <dpp/dpp.h>
|
||
|
|
#include <cstdlib>
|
||
|
|
|
||
|
|
int main() {
|
||
|
|
dpp::cluster bot(std::getenv("BOT_TOKEN"));
|
||
|
|
|
||
|
|
bot.on_slashcommand([](auto event) {
|
||
|
|
if (event.command.get_command_name() == "ping") {
|
||
|
|
event.reply("Pong!");
|
||
|
|
}
|
||
|
|
});
|
||
|
|
|
||
|
|
bot.on_ready([&bot](auto event) {
|
||
|
|
if (dpp::run_once<struct register_bot_commands>()) {
|
||
|
|
bot.global_command_create(
|
||
|
|
dpp::slashcommand("ping", "Ping pong!", bot.me.id)
|
||
|
|
);
|
||
|
|
}
|
||
|
|
});
|
||
|
|
|
||
|
|
bot.start(dpp::st_wait);
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
You can find more examples in our [example page](https://dpp.dev/md_docpages_03_example_programs.html).
|
||
|
|
|
||
|
|
## Supported Systems
|
||
|
|
|
||
|
|
### Linux
|
||
|
|
The library runs ideally on **Linux**.
|
||
|
|
|
||
|
|
### Mac OS X and FreeBSD
|
||
|
|
The library is well-functional and stable on **Mac OS X** and **FreeBSD** too.
|
||
|
|
|
||
|
|
### Raspberry Pi
|
||
|
|
For running your bot on a **Raspberry Pi**, we offer a prebuilt .deb package for ARM64, ARM6, and ARM7 so that you do not have to wait for it to compile.
|
||
|
|
|
||
|
|
### Windows
|
||
|
|
**Windows** is well-supported with ready-made compiled DLL and LIB files, please check out our [Windows Bot Template repository](https://github.com/brainboxdotcc/windows-bot-template). The Windows Bot repository can be cloned and integrated immediately into any Visual Studio 2019 and 2022 project in a matter of minutes.
|
||
|
|
|
||
|
|
### Other OS
|
||
|
|
The library should work fine on other operating systems as well, and if you run a D++ bot on something not listed here, please let us know!
|
||
|
|
|
||
|
|
## 🤝 Contributing
|
||
|
|
|
||
|
|
Contributions, issues and feature requests are welcome. After cloning and setting up project locally, you can just submit
|
||
|
|
a PR to this repo and it will be deployed once it's accepted.
|
||
|
|
|
||
|
|
Please read the [D++ Code Style Guide](https://dpp.dev/coding-standards.html) for more information on how we format pull requests.
|
||
|
|
|
||
|
|
## 💬 Get in touch
|
||
|
|
|
||
|
|
If you have various suggestions, questions or want to discuss things with our community, [Join our discord server](https://discord.gg/dpp)!
|
||
|
|
Make a humorous reference to brains in your nickname to get access to a secret brain cult channel! :)
|
||
|
|
|
||
|
|
[](https://discord.gg/dpp)
|
||
|
|
|
||
|
|
## Show your support
|
||
|
|
|
||
|
|
We love people's support in growing and improving. Be sure to leave a ⭐️ if you like the project and also be sure to contribute, if you're interested!
|
||
|
|
|
||
|
|
## Dependencies
|
||
|
|
|
||
|
|
### Build requirements
|
||
|
|
* [cmake](https://cmake.org/) (version 3.13+)
|
||
|
|
* A supported C++ compiler from the list below
|
||
|
|
|
||
|
|
### Supported compilers
|
||
|
|
* [g++](https://gcc.gnu.org) (version 8 or higher)
|
||
|
|
* [clang](https://clang.llvm.org/)
|
||
|
|
* AppleClang (12.0 or higher)
|
||
|
|
* Microsoft Visual Studio 2019 or 2022 (16.x/17.x)
|
||
|
|
* [mingw-w64](https://www.mingw-w64.org/) (gcc version 8 or higher)
|
||
|
|
|
||
|
|
Other compilers may work (either newer versions of those listed above, or different compilers entirely) but have not been tested by us.
|
||
|
|
|
||
|
|
### External Dependencies (You must install these)
|
||
|
|
* [OpenSSL](https://openssl.org/) (whichever `-dev` package comes with your OS)
|
||
|
|
* [zlib](https://zlib.net) (whichever `-dev` package comes with your OS)
|
||
|
|
|
||
|
|
#### Optional Dependencies
|
||
|
|
For voice support you require both of:
|
||
|
|
* [LibOpus](https://www.opus-codec.org)
|
||
|
|
* [libsodium](https://github.com/jedisct1/libsodium)
|
||
|
|
|
||
|
|
### Included Dependencies (Packaged with the library)
|
||
|
|
* [nlohmann::json](https://github.com/nlohmann/json)
|