> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira.party/llms.txt
> Use this file to discover all available pages before exploring further.

# Minecraft

> NameMC lookups, username availability, and a full two-way bridge to your server.

Two separate things live here: **lookups**, which anyone can use, and the **bridge**, which connects a real Minecraft server to Discord.

## Lookups

<CodeGroup>
  ```javascript A profile theme={null}
  !minecraft someone
  ```

  ```javascript Skins theme={null}
  !minecraft skins someone
  ```

  ```javascript Name history theme={null}
  !minecraft namehistory someone
  ```

  ```javascript Username availability theme={null}
  !minecraft availability someone
  ```

  ```javascript NameMC social theme={null}
  !minecraft followers someone
  !minecraft following someone
  ```

  ```javascript Crafting recipes theme={null}
  !minecraft recipe beacon
  ```
</CodeGroup>

Aliases: `namemc`, `craft`, `mine`, `mc`.

`minecraft availability` (alias `drop`) shows the drop window for a username — when it becomes claimable.

## The bridge

The bridge connects a Minecraft server to Discord in both directions: in-game chat, joins, deaths and advancements relay to Discord, and Discord messages relay back into game chat. It also gives you a console, player statistics and account linking. All while being extremely efficient and below 500 KB in size.

Requires **Administrator** to set up.

### Installing

```javascript theme={null}
!minecraft bridge plugin
```

Generates a plugin configured for your Discord server and DMs it to you. Drop it in your server's `plugins/` folder and restart.

Requires open DMs and **server owner**. Aliases: `setup`, `connect`, `install`.

Once it connects, `!minecraft bridge interface` opens a guided configuration menu, or you can utilize the "Minecraft Bridge" section on the dashboard.

### Relaying events

```javascript theme={null}
!minecraft bridge channel chat #minecraft
!minecraft bridge channel join #minecraft-logs
!minecraft bridge channel death #minecraft-logs
```

Each event type gets its own channel. `!minecraft bridge list` shows what's currently relayed; `!minecraft bridge remove <event>` stops one; `!minecraft bridge clear` stops everything.

```javascript theme={null}
!minecraft bridge webhook chat
```

Relays that event through a webhook so in-game messages appear under the player's name and skin. Requires **Manage Webhooks**.

### Discord → Minecraft

```javascript theme={null}
!minecraft bridge discord #minecraft
```

Messages in that channel appear in game chat. `!minecraft bridge discord remove` stops it.

### Server status in a channel topic

```javascript theme={null}
!minecraft bridge status #minecraft {online}/{max} online
```

Keeps a channel's topic updated with live server state. `!minecraft bridge status remove` stops it.

### Health

```javascript theme={null}
!minecraft bridge health
```

TPS, memory usage and uptime. Aliases: `statistics`, `stats`, `memory`, `tps`. Anyone can run it.

## Account linking

```javascript theme={null}
!minecraft bridge link
```

Links a player's Minecraft account to their Discord account. Requires open DMs. Also available as `!minecraft link`.

Once linked:

<CodeGroup>
  ```javascript Their stats theme={null}
  !minecraft bridge player @someone
  ```

  ```javascript Their playtime theme={null}
  !minecraft bridge time @someone
  ```

  ```javascript Everyone linked theme={null}
  !minecraft bridge linked
  ```
</CodeGroup>

### The join gate

```javascript theme={null}
!minecraft bridge gate
!minecraft bridge gate channel #gate-logs
```

Requires players to have a linked Discord account before they can join the Minecraft server. Effective whitelist replacement that also gives you a Discord identity for every player.

Requires operator permissions in game.

## Console

```javascript theme={null}
!minecraft bridge console #console
```

Streams server console output to a channel. Requires **operator** permissions on the Minecraft server, verified through your linked account.

<CodeGroup>
  ```javascript Run a command theme={null}
  !minecraft bridge execute say hello
  ```

  ```javascript Relay Discord messages as commands theme={null}
  !minecraft bridge console commands on
  ```

  ```javascript Stop relaying theme={null}
  !minecraft bridge console remove
  ```
</CodeGroup>

`execute` aliases: `exec`, `run`, `/`.

<Warning>
  Console access is full server control. Only grant it in a channel your admins can see, and remember it's gated on **Minecraft** operator status — not Discord permissions. Someone with Discord Administrator can't use it unless they're an op in game.
</Warning>

## Troll commands

```javascript theme={null}
!minecraft bridge troll freeze someone 10s
!minecraft bridge troll chickens someone 50
!minecraft bridge troll explode someone
!minecraft bridge troll firering someone
!minecraft bridge troll trip someone 30s
```

Harmless visual effects on a player — freezing, chicken rain, explosion particles, fire rings, nausea. Requires operator permissions.

Nothing here damages the world or the player's inventory.

## Command reference

| Command                                        | Permission              | Description                |
| ---------------------------------------------- | ----------------------- | -------------------------- |
| `minecraft [argument]`                         | —                       | NameMC profile             |
| `minecraft skins <profile>`                    | —                       | Skin history               |
| `minecraft namehistory <profile>`              | —                       | Username history           |
| `minecraft availability <username>`            | —                       | Drop window                |
| `minecraft followers/following <profile>`      | —                       | NameMC social              |
| `minecraft recipe <query>`                     | —                       | Crafting recipe            |
| `minecraft link`                               | —                       | Link your account          |
| `minecraft bridge plugin`                      | Server owner            | Generate the plugin        |
| `minecraft bridge interface`                   | Server owner            | Guided configuration       |
| `minecraft bridge channel <event> <channel>`   | Administrator           | Relay an event             |
| `minecraft bridge list`                        | —                       | Relayed events             |
| `minecraft bridge remove <event>`              | Administrator           | Stop relaying one          |
| `minecraft bridge clear`                       | Administrator           | Stop relaying everything   |
| `minecraft bridge webhook <event>`             | Manage Webhooks + Admin | Relay via webhook          |
| `minecraft bridge discord <channel>`           | Administrator           | Discord → Minecraft chat   |
| `minecraft bridge status <channel> <template>` | Administrator           | Live channel topic         |
| `minecraft bridge health`                      | —                       | TPS, memory, uptime        |
| `minecraft bridge link`                        | —                       | Link your account          |
| `minecraft bridge linked`                      | Administrator           | Linked accounts            |
| `minecraft bridge player <member>`             | —                       | In-game statistics         |
| `minecraft bridge time <member>`               | —                       | Total playtime             |
| `minecraft bridge gate`                        | Operator                | Require a linked account   |
| `minecraft bridge console <channel>`           | Operator                | Stream the console         |
| `minecraft bridge execute <command>`           | Operator                | Run a server command       |
| `minecraft bridge troll ...`                   | Operator                | Visual effects on a player |
