# Commands and Permissions

{% hint style="warning" %}
Args encased in { } are required for the command. Args encased in < > are optional.
{% endhint %}

{% hint style="info" %}
The base command for the plugin is /tournaments. However you can define aliases for the commands in the `config.yml`
{% endhint %}

{% hint style="info" %}
You can obtain the information for the `{tournament}` argument by tab completion.

Alternatively the name of the tournament's YAML file can be used.
{% endhint %}

***

## /tournament

This is the base command. It will open up the tournament menu for anyone who runs the command.

Permission: `This command has no permission`

***

## /tournament about

This command displays information about the plugin such as version, and who the plugin is registered to.

Permission: `This command has no permission`

***

## /tournament help

This command displays the help message in chat which lists off commands.

Permission: `tournaments.admin` or `tournaments.command.help`

***

## /tournaments reload

This command reloads the plugin and will reload the configuration files such as menu.yml, config.yml, messages.yml. It will also load any new tournaments.

Permission: `tournaments.admin` or `tournaments.command.reload`

***

## /tournaments list

This command will display a list of all the currently loaded tournaments regardless if they are active or not.

Permission: `tournaments.admin` or `tournaments.command.list`

***

## /tournaments info {tournament}

This command displays info about a specfic tournament.&#x20;

Permission: `tournaments.admin` or `tournaments.command.info`

***

## /tournaments update {tournament}

This command forces a tournament to update and will update data such as the leaderboard & scores.

Permission: `tournaments.admin` or `tournaments.command.update`

***

## /tournaments end {tournament}

This command will forcefully stop an on-going tournament.

Permission: `tournaments.admin` or `tournaments.command.end`

***

## /tournaments clear {tournament}

This command will clear all data for an on-going tournament and reset scores & leaderboards

Permission: `tournaments.admin` or `tournaments.command.clear`

***

## /tournaments clearplayer {player} {tournament}

This command will clear playerdata from an on-going tournament.

Permission: `tournaments.admin` or `tournaments.command.clearplayer`

***

## /tournaments forcejoin {player} {tournament}

This command will add a player to a tournament

Permission `tournaments.admin` or `tournaments.command.forcejoin`

***

## /tournaments forcejoin all {tournament}

This command will add all online players to a tournament.

Permission: `tournaments.admin` or `tournaments.command.forcejoin`

***


---

# 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://docs.zithium.net/xl-series/xltournaments/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.