> 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-pt/plugins/sumoplugin/setup.md).

# Configuração

{% tabs %}
{% tab title=" Configuração" %}
No ficheiro: plugins/SumoPlugin/config.yml encontrará a configuração.

O ficheiro ficará assim:

```
# 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 IP do servidor que será apresentado no scoreboard                                                                                                                                               |
| gui-type      | Isto altera a interface do comando /sumo gui: se definir para all todos, todas as arenas são apresentadas; se definir como category, a interface mostra opções para jogar em arenas 1vs1 ou 2vs2. |
| check-updates | Notifique os jogadores com permissões de OP se existir uma nova versão do plugin.                                                                                                                 |

{% endtab %}

{% tab title="Mensagens" %}
No ficheiro: plugins/SumoPlugin/messages.yml encontrará as mensagens.

O ficheiro ficará assim:

```
# ─────────────────────────────────────────────────────────────
#  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 sobre sumo                         |
| Join/Leave     | Quando um jogador entra ou sai de uma arena      |
| Titles         | Títulos utilizados ​​durante o jogo              |
| Items          | Nomes dos artigos                                |
| 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, dirija-se ao lobby do Sumo e execute o comando /sumo general setlobby para definir o local para onde o jogador será teletransportado quando a partida terminar.