> 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-it/plugin/sumoplugin/setup.md).

# Setup

{% tabs %}
{% tab title="Configuration" %}
Nel file: plugins/SumoPlugin/config.yml troverai la configurazione

Il file sarà simile a questo:

```
# 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

```

| Opzione       | Uso                                                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| server-ip     | Ip del server che verrà mostrato nelle scorreboard                                                                                                     |
| gui-type      | Cambia la gui di /sumo gui se lo metti su all mostrerà tutte le arene se lo metti su category mostrerà se vuoi giocare in una arena 1vs1 o in una 2vs2 |
| check-updates | Notifica i player OP se c'è una nuova versione del plugin                                                                                              |

{% endtab %}

{% tab title="Messages" %}
Nel file: plugins/SumoPlugin/messages.yml troverai i messaggi

Il file sarà simile a questo:

```
# ─────────────────────────────────────────────────────────────
#  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        | Testi sumo generali                             |
| Join/Leave     | Quando un giocatore entra/esce da un'arena      |
| Titles         | I titoli usati in gioco                         |
| Items          | Nome degli oggetti                              |
| Stats command  | Testi per il comando /sumo stats                |
| Admin feedback | Feedback durante esecuzione di un comando admin |
| GUI            | Testi per il comando /sumo gui                  |
| SCOREBOARD     | Testi delle scoreboard                          |
| {% endtab %}   |                                                 |
| {% endtabs %}  |                                                 |

Dopo aver configurato il plugin vai nella lobby del sumo ed esegui /sumo general setlobby dove i player verranno teletrasportati quando una partita finisce


---

# 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-it/plugin/sumoplugin/setup.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.