Grumble Download

Developers

Grumble's own bots

Four bots for what servers ask for most. Run them as they are, or copy and change them. They're yours to use, under the MIT licence.

Running one

  1. Get Node.js 22 or newer.
  2. Make a bot in the Developer Portal, copy its token, and add it to your server with the permissions below.
  3. Download the bot, unzip it, and in its folder: npm install, then GRUMBLE_TOKEN=your-token npm start.

For an encrypted server, run the Grumble bridge beside it (npx grumble-bridge, with the same token), and start the bot with GRUMBLE_API=http://127.0.0.1:3170/api as well. Each bot's README says more.

They keep as little as they can, each in one file beside it: no messages, and nothing about anyone beyond what the bot is for. The leaderboard and levels bots have /forgetme.

All four are on GitHub too, at github.com/aternix-studio/grumble-bots, to clone, fork or send changes to.

Voice leaderboard

Who's spent the most time in voice: this week, this month and all time.

  • /leaderboard, with buttons for the week, the month and all time
  • /voicetime, for you or someone else
  • /forgetme and /countme

Permissions: None beyond seeing the voice channels.

Download voice leaderboard On GitHub

Levels

Experience for taking part (at most once a minute, so spamming earns nothing), levels, and roles given at levels.

  • /rank and /levels
  • /levelrole add, remove and list
  • /forgetme and /countme

Permissions: Send Messages, and Manage Roles with its role above the ones it gives.

Download levels On GitHub

Tickets

A button to ask the team for help. Each ticket is a private thread with the person and the team, closed with a button.

  • /tickets setup, to pick the team's role
  • /tickets panel, to post the button
  • /tickets close, in a ticket

Permissions: Create Private Threads, Send Messages in Threads and Manage Threads, and Server Members turned on for it.

Download tickets On GitHub

Reaction roles

React to a message to get a role, and take the reaction back to lose it.

  • /reactionroles add, with the message, the emoji and the role
  • /reactionroles remove and list

Permissions: Add Reactions, Read Message History, and Manage Roles with its role above the ones it gives.

Download reaction roles On GitHub

More bots

See the bots people want, and the libraries that run on Grumble. Made one? Show it in Grumble Developers, our server for people building on Grumble.