981546647a
Some checks failed
Build and push Docker image / .net docker build (push) Has been cancelled
.net checks / run .net tests (push) Has been cancelled
.net checks / dotnet-format (push) Has been cancelled
Build and push Rust service Docker images / rust docker build (push) Has been cancelled
rust checks / cargo fmt (push) Has been cancelled
|
||
|---|---|---|
| .cargo | ||
| .github | ||
| ci | ||
| crates | ||
| dashboard | ||
| dev-docs | ||
| docs | ||
| Myriad | ||
| PluralKit.API | ||
| PluralKit.Bot | ||
| PluralKit.Core | ||
| PluralKit.Tests | ||
| scripts | ||
| Serilog@f5eb991cb4 | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitignore | ||
| .gitmodules | ||
| Cargo.lock | ||
| Cargo.toml | ||
| COPYING | ||
| docker-compose.yml | ||
| flake.lock | ||
| flake.nix | ||
| PluralKit.sln | ||
| README.md | ||
| rust-toolchain.toml | ||
| shell.nix | ||
PluralKit
PluralKit is a Discord bot meant for plural communities. It has features like message proxying through webhooks, switch tracking, system and member profiles, and more.
Do you just want to add PluralKit to your server? If so, you don't need any of this. Use the bot's invite link: https://discord.com/oauth2/authorize?client_id=466378653216014359&scope=bot%20applications.commands&permissions=536995904
PluralKit has a Discord server for support, feedback, and discussion: https://discord.gg/PczBt78
Running
In production, we run PluralKit using Kubernetes. The configuration can be found in the infra repo.
For self-hosting, it's simpler to use Docker, with the provided docker-compose file.
Create a .env file with the Discord client ID and bot token:
CLIENT_ID=198622483471925248
BOT_TOKEN=MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs
If you want to use pk;admin commands (to raise member limits and such), set ADMIN_ROLE to a Discord role ID:
ADMIN_ROLE=682632767057428509
If you didn't clone the repository with submodules, run git submodule update --init first to pull the required submodules.
Run docker compose build, then docker compose up -d.
To view logs, use docker compose logs.
Postgres data is stored in a pluralkit_data Docker volume.
Development
User documentation
License
With the exception of the Myriad library, this project is under the GNU Affero General Public License, Version 3. The license text can be found in the COPYING file.
Licensing information for the Myriad library can be found in the library's README.md file.