> For the complete documentation index, see [llms.txt](https://augu0107.gitbook.io/auguplugin-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://augu0107.gitbook.io/auguplugin-docs/auguplugin-docs-br/plugins/sumoplugin/configuracao.md).

# Configuração

{% tabs %}
{% tab title="Configuration" %}
No arquivo: plugins/SumoPlugin/config.yml você encontrará a configuração.

O arquivo terá a seguinte aparência:

```
# IP shown in the sidebar scoreboard
server-ip: basicalityisland.playmc.be

# GUI display mode: "all" shows all arenas together, "category" shows 1v1/2v2 selection first
gui-type: category

# Check for updates on startup and notify OPs on join
check-updates: true

```

| Opção         | Uso                                                                                                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| server-ip     | O endereço IP do servidor que será exibido no scoreboard.                                                                                                                                          |
| gui-type      | Isso altera a interface gráfica do comando /sumo gui. Se você selecionar all, todas as arenas serão exibidas. Se selecionar category, será exibido se você deseja jogar em uma arena 1vs1 ou 2vs2. |
| check-updates | Notifique os jogadores de OP se houver uma nova versão do plugin.                                                                                                                                  |

{% endtab %}

{% tab title="Messages" %}
No arquivo: plugins/SumoPlugin/messages.yml você encontrará as mensagens

O arquivo terá a seguinte aparência:

```
# ─────────────────────────────────────────────────────────────
#  SumoPlugin - messages.yml
#  Supports & color codes. Use {0}, {1}... for placeholders.
# ─────────────────────────────────────────────────────────────

# ── General ──────────────────────────────────────────────────
prefix:                    "&8[&6Sumo&8] &r"
no-permission:             "&cYou don't have permission."
only-players:              "&cOnly players can use this command."

# ── Join / Leave ─────────────────────────────────────────────
player-joined:             "&e{0} &7joined! &f({1})"
player-left-waiting:       "&c{0} &7left. Waiting for players..."
already-in-game:           "&cYou are already in a game!"
arena-busy:                "&cThat arena is currently busy!"
arena-full:                "&cThat arena is full!"
left-arena:                "&eYou left the arena."
cant-leave-running:        "&cYou can't leave during an active game!"

# ── Titles ───────────────────────────────────────────────────
title-start:               "&aSTART!"
title-start-subtitle:      ""
title-win:                 "&6YOU WIN!"
title-win-subtitle:        "&eYou knocked them off!"
title-win-disconnect:      "&6YOU WIN!"
title-win-disconnect-sub:  "&eOpponent disconnected!"
title-lose:                "&cYOU LOSE!"
title-lose-subtitle:       "&7You fell off!"
title-draw:                "&eDrawRAW!"
title-draw-subtitle:       "&7Time ran out!"

# ── Items ─────────────────────────────────────────────────────
item-leave-name:           "&cReturn to Lobby"
item-stick-name:           "&6Knockback Stick"

# ── Stats command ─────────────────────────────────────────────
stats-header:              "&6&l» Sumo Stats"
stats-wins:                "&a  Wins:   &f{0}"
stats-losses:              "&c  Losses: &f{0}"

# ── Admin feedback ────────────────────────────────────────────
arena-created:             "&aArena '&f{0}&a' created! Set spawns and lobby."
arena-already-exists:      "&cArena '&f{0}&c' already exists!"
arena-not-found:           "&cArena not found!"
spawn-set:                 "&aSpawn &f{0}&a set!"
arena-lobby-set:           "&aWaiting lobby set for '&f{0}&a'!'"
arena-deleted:             "&aArena '&f{0}&a' deleted!"
arena-type-set:            "&aArena '&f{0}&a' type set to &f{1}&a!"
general-lobby-set:         "&aGeneral lobby set!"
server-ip-set:             "&aServer IP set to: &f{0}"
reload-done:               "&aConfig and messages reloaded successfully!"
world-mobs-cleared:        "&bWorld '&f{0}&b': mob spawning disabled, &f{1}&b mob(s) removed."

# ── GUI ───────────────────────────────────────────────────────
gui-title:                 "&3&lSumo &8- &3Select Arena"
gui-no-arenas-name:        "&cNo arenas available!"
gui-no-arenas-lore:        "&7Ask an admin to set one up."
gui-arena-status-waiting:  "&aWaiting"
gui-arena-status-starting: "&eStarting"
gui-arena-status-running:  "&cIn Game"
gui-arena-status-ending:   "&7Ending"
gui-arena-lore-status:     "&7Status: {0}"
gui-arena-lore-players:    "&7Players: &f{0}"
gui-arena-lore-join:       "&a▶ Click to join!"
gui-arena-lore-busy:       "&c✗ Arena is busy"

# ─────────────────────────────────────────────────────────────
#  SCOREBOARD
# ─────────────────────────────────────────────────────────────

scoreboard:
  # Sidebar title (always visible at the top)
  title: "&6&lSUMO"

  waiting:
    line3: "&eWaiting for players.."   # top line
    line2: "&f{0}"                     # {0} = "current/max" passed from code
    line1: " "
    line0: "&8{ip}"                    # {ip} = server-ip from config.yml

  starting:
    line3: "&eStarting..."
    line2: "&f{0}"                     # {0} = countdown number
    line1: " "
    line0: "&8{ip}"

  running:
    line3: "&aGame started"
    line2: "&fTime {0}"                # {0} = mm:ss
    line1: " "
    line0: "&8{ip}"

```

| Categoria      | Uso                                              |
| -------------- | ------------------------------------------------ |
| General        | Textos gerais de sumô                            |
| Join/Leave     | Quando um jogador entra/sai de uma arena         |
| Titles         | Títulos usados ​​durante o jogo                  |
| Items          | Nomes de itens                                   |
| Stats command  | Textos para o comando /sumo stats                |
| Admin feedback | Feedback ao executar um comando de administrador |
| GUI            | Textos do comando /sumo gui                      |
| SCOREBOARD     | Textos do scoreboard                             |
| {% endtab %}   |                                                  |
| {% endtabs %}  |                                                  |

Após configurar o plugin, acesse o lobby do Sumo e digite /sumo general setlobby para definir o lobby para onde o jogador será teleportado ao término da partida.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://augu0107.gitbook.io/auguplugin-docs/auguplugin-docs-br/plugins/sumoplugin/configuracao.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.