# Commands and Permissions

{% hint style="warning" %}
All commands require the permission **tetrisfriends.commands**
{% endhint %}

### User Commands (/tetrisfriends)

| Command          | Permission                  | Description                                                                                                            | Type           |
| ---------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------- |
| /tf help         | tetrisfriends.commands.help | Shows a help menu for all of the TetrisFriends commands. All entries have hover and click events.                      | Player/Console |
| /tf menu \[menu] | tetrisfriends.commands.menu | Opens the main menu. You can open specific menus with the menu parameter. Use the tab completer to see openable menus. | Player         |

### Admin commands (/tetrisfriendsadmin)

{% hint style="warning" %}
All admin commands require the permission **tetrisfriends.admin**
{% endhint %}

| Command                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Type           |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| /tfa help                                        | Shows a help menu for all of the TetrisFriends admin commands. All entries have hover and click events.                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Player/Console |
| /tfa startgame \<gamemode> \<player1> \[player2] | Start a game in a specific gamemode. \<player1> is required for singleplayer and multiplayer game modes. \[player2] is required for multiplayer game modes.                                                                                                                                                                                                                                                                                                                                                                                                       | Player/Console |
| /tfa schematic \<action>                         | This command is used to create your own TetrisFriends schematic. For an in-depth tutorial please review [this page](/creating-your-own-schematic.md).                                                                                                                                                                                                                                                                                                                                                                                                             | Player         |
| /tfa reload                                      | Reload all configuration files. This will end all games and close all open TetrisFriends menus.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Player/Console |
| /tfa pregenerate \<cells> \[interval]            | <p>This command allows you to pregenerate the schematics in the game cells. This will ensure that the server won't lag when "live".<br><br>Generate the amount of \<cells> you believe is the max concurrent players. E.g. you expect a max of 5 players playing Tetris at the same time; then generate 5 or a few more to be sure. </p><p></p><p>The \[interval] is in seconds. This will allow your server to keep up when generating a large number of schematics. E.g. generating 10 cells at the default rate of 2 seconds will take roughly 20 seconds.</p> | Player/Console |

{% hint style="info" %}
All commands have parameter suggestions - use tab-completion.
{% endhint %}

### Permissions

| Permission           | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| tetrisfriends.play   | Players with this permission can play any TetrisFriends game mode. |
| tetrisfriends.update | Player with this permission will receive update notifications.     |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tetrisfriends.benzoft.com/commands-and-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.