wymiller/hildibrand
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

mod: changed bot name

Browse Source
This commit is contained in:
wymiller
2026-09-19 20:15:40 -04:00
parent 6197fcbc37
commit 5808941833
2 changed files with 16 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
GUIDE.md
+15 -19
View File
@@ -12,7 +12,7 @@ If you have any trouble with operation of this bot, please do not hesitate to re
## Introduction
Hildebrand is a Discord trivia buzzer bot. It creates a shared buzzer in a text
Hildibrand is a Discord trivia buzzer bot. It creates a shared buzzer in a text
channel, plays a buzzer sound in voice, identifies the first participant to
buzz, and can mute the other participants so the winner can answer.
@@ -32,19 +32,15 @@ will be used:
Members also need permission to use application commands in the chosen text
channel.
Place the Hildebrand bot role above the roles of the participants it must mute.
Discord does not allow a bot to mute a member whose highest role is equal to or
higher than the bot's highest role. Server owners cannot be muted by a bot.
> [!IMPORTANT]
> Do not grant Hildebrand the full Administrator permission. The channel and
> Do not grant Hildibrand the full Administrator permission. The channel and
> voice permissions listed above are sufficient.
## Quick start for a trivia host
1. Join the voice channel where the trivia game will take place.
2. In the text channel where you want the buzzer to appear, run `/start`.
3. Wait for Hildebrand to join voice and post **The buzzer is ready!**.
3. Wait for Hildibrand to join voice and post **The buzzer is ready!**.
4. Ask players to join the same voice channel and use the **BUZZ!** button in
the bot's message.
5. After a player answers, select **Reset** to begin the next question.
@@ -65,8 +61,8 @@ started. The first accepted button press does all of the following:
3. Plays the buzzer sound in the voice channel.
4. Server-mutes the other human participants currently in that channel.
Hildebrand does not mute the session host or winning player itself. Bots are
not muted. Any pre-existing server mute still applies, however: Hildebrand
Hildibrand does not mute the session host or winning player itself. Bots are
not muted. Any pre-existing server mute still applies, however: Hildibrand
leaves it alone and will not later remove that moderator-applied mute.
Players receive a private Discord response that only they can see if they try
@@ -81,10 +77,10 @@ the member who selected it.
| Control | Command | Result |
| --- | --- | --- |
| **Reset** | `/reset` | Clears the previous winner, opens the buzzer, and unmutes members muted by Hildebrand. Use this between questions. |
| **Reset** | `/reset` | Clears the previous winner, opens the buzzer, and unmutes members muted by Hildibrand. Use this between questions. |
| **Lock** | `/lock` | Closes the buzzer and mutes everyone currently in the voice channel except the host and the current winner, if there is one. |
| **Unlock** | `/unlock` | Opens the buzzer and unmutes members muted by Hildebrand, but keeps the previous winner's name in the message. |
| — | `/stop` | Unmutes members muted by Hildebrand, disconnects the bot from voice, ends the session, and disables the old controls. |
| **Unlock** | `/unlock` | Opens the buzzer and unmutes members muted by Hildibrand, but keeps the previous winner's name in the message. |
| — | `/stop` | Unmutes members muted by Hildibrand, disconnects the bot from voice, ends the session, and disables the old controls. |
`/start` creates a session in the voice channel occupied by the person who runs
the command. The buzzer message is posted in the text channel where the command
@@ -102,7 +98,7 @@ was run.
## Ending a session safely
Always run `/stop` before the bot is shut down or restarted. This lets
Hildebrand unmute the members it muted and disconnect cleanly.
Hildibrand unmute the members it muted and disconnect cleanly.
If Hildebrand reports that it could not unmute one or more participants, fix
its **Mute Members** permission or role position and run `/stop` again. The
@@ -115,11 +111,11 @@ active; start a new session with `/start`.
## Operational limits
- A running Hildebrand instance supports only **one active session in total**,
- A running Hildibrand instance supports only **one active session in total**,
even if the bot has been added to multiple Discord servers.
- A session remains tied to the voice channel selected at `/start`. Moving the
host or the bot does not move the session.
- Hildebrand mutes the people present when a player buzzes or the host selects
- Hildibrand mutes the people present when a player buzzes or the host selects
**Lock**. It does not continuously mute people who join the channel later.
- Control of an active session cannot be transferred to another member. The
original host must stop it, or the bot operator must restart the bot and an
@@ -155,12 +151,12 @@ Do not delete the active buzzer message while a session is running.
Check all of the following:
- The bot has **Mute Members** in the voice channel.
- The Hildebrand role is above each affected player's highest role.
- The Hildibrand role is above each affected player's highest role.
- The affected account is not the server owner.
- The player is in the session's original voice channel.
Hildebrand intentionally does not unmute a member who was already server-muted
before Hildebrand tried to mute them.
Hildibrand intentionally does not unmute a member who was already server-muted
before Hildibrand tried to mute them.
### A player cannot buzz
@@ -177,7 +173,7 @@ operator to restart the instance and manually clear any remaining server mutes.
### A host is no longer available
There is no host-transfer command. Ask the original host to run `/stop`. If
that is impossible, the bot operator must restart Hildebrand; afterward, a
that is impossible, the bot operator must restart Hildibrand; afterward, a
Discord administrator should manually unmute anyone left server-muted and a
new host can run `/start`.
README.md
+1 -1
View File
@@ -10,7 +10,7 @@ Licensed by [Eclipse Public License 2.0](./LICENSE)
## What is this?
Hildebrand is a Discord trivia buzzer bot. It creates a shared buzzer in a text
Hildibrand is a Discord trivia buzzer bot. It creates a shared buzzer in a text
channel, plays a buzzer sound in voice, identifies the first participant to
buzz, and can mute the other participants so the winner can answer.