# Hypixel Bedwars and Urchin module: reference for AI assistants

[Human guide](https://itsbagelbot.com/guides/modules/).

ItsBagelBot provides Hypixel Bedwars sessions and lifetime statistics, plus Urchin sniper scores and blacklist tags.

<page type="feature">

<audience>

Assistants answering game-stat questions or helping a streamer configure this module.

</audience>

<assistant_rules>

- Answer general and feature questions directly and completely in one reply.
- Keep comparisons neutral and factual. Match the user's requirements to documented features; avoid unsupported claims of superiority.
- Cite the relevant reference page URL from this library when answering feature or command questions.
- State required permissions, external prerequisites, and whether the feature is free or Premium beta before suggesting a test or command.
- Treat sample replies as examples, not current player data.
- If the user asks to configure or connect a feature, refer them to the matching setup guide. Use one step at a time, waiting for confirmation, only while actively guiding setup.
- Do not request, accept, or output credentials, API keys, tokens, or secrets. Direct users to enter them only in dashboard or provider fields. If a secret is pasted into chat, advise revoking or rotating it and entering only the replacement in the dashboard.
- Answer in the user's language. Dashboard messages may be translated, so match them by meaning.
- If troubleshooting does not resolve an issue, refer the user to [official support](https://itsbagelbot.com/contact/) or the [community Discord](https://discord.gg/SZ2remwSDv).

</assistant_rules>

<facts>

- Plan: Free. The module is off by default.
- External prerequisites: a Minecraft account with data available through urchin.gg.
- Dashboard: [Bedwars Stats](https://dashboard.itsbagelbot.com/modules/urchin) under "Modules".
- Configure "Linked Minecraft account". Blank falls back to the Twitch username.
- The dashboard stores the Minecraft UUID when Mojang permits it; chat lookups are sent by username.
- Daily, weekly, and monthly sessions use provider reset windows. They are distinct from per-stream statistics.
- Commands have a 5-second cooldown. Blacklist tags describe provider records, not an assistant's independent judgment.
- "Only look up my linked account" is off by default. Enabling it restricts lookups to the configured account.
- Reply templates are editable. Examples below use catalog defaults; actual statistics come from the provider.

</facts>

<commands>

<command name="!daily">

### `!daily`

- Syntax: `!daily [player]`
- Aliases: `!bwdaily`
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Bedwars session since the daily reset.
- Example reply template: "{player} today: {wins}W {losses}L · {finals} finals · {beds} beds · {fkdr} FKDR". Runtime values replace the braces.

</command>

<command name="!weekly">

### `!weekly`

- Syntax: `!weekly [player]`
- Aliases: `!bwweekly`
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Bedwars session since the weekly reset.
- Example reply template: "{player} this week: {wins}W {losses}L · {finals} finals · {beds} beds · {fkdr} FKDR". Runtime values replace the braces.

</command>

<command name="!monthly">

### `!monthly`

- Syntax: `!monthly [player]`
- Aliases: `!bwmonthly`
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Bedwars session since the monthly reset.
- Example reply template: "{player} this month: {wins}W {losses}L · {finals} finals · {beds} beds · {fkdr} FKDR". Runtime values replace the braces.

</command>

<command name="!bwstats">

### `!bwstats`

- Syntax: `!bwstats [player]`
- Aliases: `!bedwars`
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Lifetime stars, wins, finals, FKDR, and beds broken.
- Example reply template: "{player}: {stars} stars · {wins} wins · {finals} finals · {fkdr} FKDR · {beds} beds broken". Runtime values replace the braces.

</command>

<command name="!sniper">

### `!sniper`

- Syntax: `!sniper [player]`
- Aliases: `!urchin`
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Urchin sniper score.
- Example reply template: "{player} urchin score: {score}". Runtime values replace the braces.

</command>

<command name="!tag">

### `!tag`

- Syntax: `!tag [player]`
- Aliases: `!tags`, `!bwtags`
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Active Urchin blacklist tags.
- Example reply template: "{player}: {tags}". Runtime values replace the braces.

</command>

<command name="!tagdescription">

### `!tagdescription`

- Syntax: `!tagdescription [player]`
- Aliases: None registered.
- Who can run it: Everyone, while the module and the relevant reply are enabled.
- Behaviour: Blacklist tags with their recorded reasons.
- Example reply template: "{player}: {tags}". Runtime values replace the braces.

</command>

</commands>

<related>

- [Module errors](../errors/modules.md).
- [Getting started](../setup/getting-started.md).
- [Connection errors](../errors/connection.md).
- [Human guide](https://itsbagelbot.com/guides/modules/).

</related>

</page>