UpvoteEngine

UpvoteEngine is a performant Discord vote handler built on a FaaS architecture using Cloudflare Workers. This serverless approach ensures highly performant role management by automatically assigning and removing roles based on top.gg votes with minimal latency and maximum scalability due to the services used.

Currently supported platforms

• Top.gg
• DBL (Discord Bot List)

There are more platforms planned, but not added yet (because every platform requires a completely new handler).

---

How to use the bot

Use the /app command to configure your application. This commands requires Manage Server perms by default.

Note, that you can have up to 25 applications per server, but can only have one server configured per application + source.

Valid Examples	Invalid Examples
Top.gg Bot #1 → Server A (allowed) Top.gg Bot #2 → Server B (allowed) DBL Bot #1 → Server A (allowed, different source)	Top.gg Bot #1 → Server A Top.gg Bot #1 → Server A (rejected, same app + same server + source already configured) Top.gg Bot #1 → Server B (rejected, same app + source already configured)

In short: The combination of application, server and source must be unique across all servers.

Commands

Command	Description
/help	Get helpful links to resources for the bot
/ping	Responds with a pong
/app add	Configure a new application connection for the server
/app edit	Edit an application connection for the server
/app remove	Remove an application connection the server
/app list	List all application connections for the server
/app forwarding set	Set the forwarding configuration for an added application
/app forwarding edit	Edit a forwarding configuration
/app forwarding remove	Remove a forwarding configuration
/app forwarding view	View the forwarding configuration (Secret is sanitized, only the first 4 characters are shown)

Always read the descriptions everywhere. Please.

Further Reading

• Webhook Forwarding: Receive vote notifications at an endpoint of your choice.