# P_DominarArena<\/p>\n
**P_DominarArena** is a premium plugin for Minecraft servers (Spigot\/Paper 1.20+) that creates an automatic arena domination event in the style of **KoTH (King of the Hill)**.<\/p>\n
The objective is simple: players (or clans) enter the arena and try to stay inside it for as long as possible. Whoever accumulates the most domination time wins the event and receives configurable rewards.<\/p>\n
## Main Features<\/p>\n
– **Scheduled Event** \u2014 Automatically starts at the times defined in `config.yml`.
\n– **Time-based Domination System** \u2014 Counts the time each player\/clan stays inside the arena without interruptions.
\n– **Clan Support** \u2014 Integration with **FactionsUUID** and **SaberFactions** for clan domination mode (optional).
\n– **Informative Hologram** \u2014 Compatible with **DecentHolograms**, **HolographicDisplays** or native TextDisplay (vanilla). Updates in real-time with status, remaining time, dominating clan\/player, tops, etc.
\n– **Full Placeholders** \u2014 Integration with **PlaceholderAPI** (`%dominararena_status%`, `%dominararena_tempo_restante%`, etc.).
\n– **Complete Menus\/GUIs** \u2014 Intuitive interface to configure the arena, view tops, event status, and more.
\n– **Announcements and Calls** \u2014 Configurable broadcasts to notify when the event is about to start, is in progress, and when it ends.
\n– **Reward System** \u2014 Rewards for the winning player and\/or clan (commands executed by the console).
\n– **Flexible Configuration** \u2014 Everything editable via `config.yml` and language files.<\/p>\n
## Dependencies<\/p>\n
**Required Dependencies (Hard):**
\n– None (works standalone in individual mode).<\/p>\n
**Optional Dependencies (Soft):**
\n– **PlaceholderAPI** \u2192 to use the placeholders.
\n– **DecentHolograms** or **HolographicDisplays** \u2192 for more advanced holograms (otherwise uses vanilla TextDisplay).
\n– **FactionsUUID** or **SaberFactions** \u2192 for clan domination mode.<\/p>\n
## Installation<\/p>\n
1. Place the `P_DominarArena.jar` file in the `\/plugins\/` folder.
\n2. Start or restart the server.
\n3. The **DominarArena** folder will be created inside `\/plugins\/` containing:
\n – `config.yml`
\n – `lang\/en_us.yml` (or other language)
\n – `data.yml` (saved top data)
\n4. Configure the plugin by editing `config.yml` (see the configuration section below).
\n5. Use the command `\/dominararena reload` to apply the changes.<\/p>\n
## Commands and Permissions<\/p>\n
**Main Command:** `\/dominararena` (alias: `\/da`)<\/p>\n
| Subcommand | Description | Permission |
\n|—————–|————————————————–|————————|
\n| `\/da` | Opens the main menu | `dominararena.use` |
\n| `\/da reload` | Reloads config, lang, holograms, and schedules | `dominararena.admin` |
\n| `\/da setarena` | Sets the two points of the arena (pos1 and pos2) | `dominararena.admin` |
\n| `\/da sethologram` | Sets the hologram location | `dominararena.admin` |
\n| `\/da forcastart`| Starts the event manually | `dominararena.admin` |
\n| `\/da forcestop` | Stops the event manually | `dominararena.admin` |
\n| `\/da top` | Opens the tops menu | `dominararena.use` |<\/p>\n
## Main Configuration (config.yml)<\/p>\n
Example of the most important sections:<\/p>\n
“`yaml
\n# Default language (file in lang\/)
\nlanguage: en_us<\/p>\n
# Event schedules (24h format – HH:mm)
\nschedules:
\n – “14:00”
\n – “20:00”<\/p>\n
# Event duration in minutes
\nduration-minutes: 30<\/p>\n
# Minimum time inside the arena to count (seconds) – avoids quick touches
\nmin-time-seconds: 5<\/p>\n
# Domination mode: “individual” or “clan”
\nmode: “clan”<\/p>\n
# Arena (set with \/da setarena)
\narena:
\n world: “world”
\n pos1: x,y,z
\n pos2: x,y,z<\/p>\n
# Hologram
\nhologram:
\n enabled: true
\n onlyWhenRunning: true
\n location: “world,100,65,100” # set with \/da sethologram
\n updateIntervalTicks: 20
\n linesKey: “hologram.lines”<\/p>\n
# Announcements before the event (in minutes)
\npre-announcements:
\n – 10
\n – 5
\n – 1<\/p>\n
# Rewards (commands executed as console)
\nrewards:
\n player-winner:
\n – “give %player% diamond 10”
\n clan-winner:
\n – “f money give %clan% 10000”<\/p>\n
“`
\n## Placeholders (with PlaceholderAPI)<\/p>\n
| Placeholder | Description |
\n|————————————–|——————————————————-|
\n| `%dominararena_status%` | Current status (Waiting, In progress, etc.) |
\n| `%dominararena_tempo_restante%` | Formatted remaining time (ex: 12:34) |
\n| `%dominararena_cla_domina%` | Name of the dominating clan |
\n| `%dominararena_cla_domina_tag%` | Tag of the dominating clan |
\n| `%dominararena_jogador_domina%` | Name of the dominating player (individual mode) |
\n| `%dominararena_top_jogador%` | Name of the player with the most time |
\n| `%dominararena_top_jogador_tempo%` | Time of the top player |
\n| `%dominararena_top_cla%` | Name of the top clan |
\n| `%dominararena_top_cla_tempo%` | Time of the top clan |<\/p>\n
## Support and Updates<\/p>\n
Plugin developed by **Pedro**.<\/p>\n
In case of bugs or suggestions, contact via **Discord** or the plugin purchase location.<\/p>\n
**Current Version:** 1.0.0<\/p>\n
**Supported Minecraft Versions:** 1.20.x – 1.21.x<\/p>\n
**Have fun and dominate the arena!** <\/p>\n
# P_DominarArena<\/p>\n
**P_DominarArena** \u00e9 um plugin premium para servidores Minecraft (Spigot\/Paper 1.20+) que cria um evento autom\u00e1tico de domina\u00e7\u00e3o de arena no estilo **KoTH (King of the Hill)**.<\/p>\n
O objetivo \u00e9 simples: os jogadores (ou cl\u00e3s) entram na arena e tentam permanecer o maior tempo poss\u00edvel dentro dela. Quem acumular mais tempo dominando vence o evento e recebe recompensas configur\u00e1veis.<\/p>\n
## Principais Funcionalidades<\/p>\n
– **Evento com hor\u00e1rio programado** \u2014 Inicia automaticamente nos hor\u00e1rios definidos no `config.yml`.
\n– **Sistema de domina\u00e7\u00e3o por tempo** \u2014 Conta o tempo que cada jogador\/cl\u00e3 fica dentro da arena sem interrup\u00e7\u00f5es.
\n– **Suporte a cl\u00e3s** \u2014 Integra\u00e7\u00e3o com **FactionsUUID** e **SaberFactions** para modo de domina\u00e7\u00e3o por cl\u00e3 (opcional).
\n– **Holograma informativo** \u2014 Compat\u00edvel com **DecentHolograms**, **HolographicDisplays** ou TextDisplay nativo (vanilla). Atualiza em tempo real com status, tempo restante, cl\u00e3\/jogador dominando, tops, etc.
\n– **Placeholders completos** \u2014 Integra\u00e7\u00e3o com **PlaceholderAPI** (`%dominararena_status%`, `%dominararena_tempo_restante%`, etc.).
\n– **Menus\/GUIs completos** \u2014 Interface intuitiva para configurar a arena, visualizar tops, status do evento, entre outros.
\n– **An\u00fancios e chamadas** \u2014 Broadcasts configur\u00e1veis para avisar quando o evento vai come\u00e7ar, est\u00e1 em andamento e quando termina.
\n– **Sistema de recompensas** \u2014 Recompensas para o jogador vencedor e\/ou cl\u00e3 vencedor (comandos executados pelo console).
\n– **Configura\u00e7\u00e3o flex\u00edvel** \u2014 Tudo edit\u00e1vel via `config.yml` e arquivos de idioma.<\/p>\n
## Depend\u00eancias<\/p>\n
**Depend\u00eancias obrigat\u00f3rias (Hard):**
\n– Nenhuma (funciona standalone no modo individual).<\/p>\n
**Depend\u00eancias opcionais (Soft):**
\n– **PlaceholderAPI** \u2192 para utilizar os placeholders.
\n– **DecentHolograms** ou **HolographicDisplays** \u2192 hologramas mais avan\u00e7ados (caso contr\u00e1rio usa TextDisplay vanilla).
\n– **FactionsUUID** ou **SaberFactions** \u2192 para modo de domina\u00e7\u00e3o por cl\u00e3.<\/p>\n
## Instala\u00e7\u00e3o<\/p>\n
1. Coloque o arquivo `P_DominarArena.jar` na pasta `\/plugins\/`.
\n2. Inicie ou reinicie o servidor.
\n3. Ser\u00e1 criada a pasta **DominarArena** dentro de `\/plugins\/` contendo:
\n – `config.yml`
\n – `lang\/pt_br.yml` (ou outro idioma)
\n – `data.yml` (dados salvos dos tops)
\n4. Configure o plugin editando o `config.yml` (veja a se\u00e7\u00e3o de configura\u00e7\u00e3o abaixo).
\n5. Use o comando `\/dominararena reload` para aplicar as altera\u00e7\u00f5es.<\/p>\n
## Comandos e Permiss\u00f5es<\/p>\n
**Comando principal:** `\/dominararena` (alias: `\/da`)<\/p>\n
| Subcomando | Descri\u00e7\u00e3o | Permiss\u00e3o |
\n|————————|—————————————————–|——————————-|
\n| `\/da` | Abre o menu principal | `dominararena.use` |
\n| `\/da reload` | Recarrega config, lang, hologramas e hor\u00e1rios | `dominararena.admin` |
\n| `\/da setarena` | Define os dois pontos da arena (pos1 e pos2) | `dominararena.admin` |
\n| `\/da sethologram` | Define a localiza\u00e7\u00e3o do holograma | `dominararena.admin` |
\n| `\/da forcastart` | Inicia o evento manualmente | `dominararena.admin` |
\n| `\/da forcestop` | Para o evento manualmente | `dominararena.admin` |
\n| `\/da top` | Abre o menu de tops | `dominararena.use` |<\/p>\n
## Configura\u00e7\u00e3o Principal (config.yml)<\/p>\n
Exemplo das se\u00e7\u00f5es mais importantes:<\/p>\n
“`yaml
\n# Idioma padr\u00e3o (arquivo em lang\/)
\nidioma: pt_br<\/p>\n
# Hor\u00e1rios do evento (formato 24h – HH:mm)
\nhorarios:
\n – “14:00”
\n – “20:00”<\/p>\n
# Dura\u00e7\u00e3o do evento em minutos
\nduracao-minutos: 30<\/p>\n
# Tempo m\u00ednimo dentro da arena para contar (segundos) – evita “toques r\u00e1pidos”
\ntempo-minimo-segundos: 5<\/p>\n
# Modo de domina\u00e7\u00e3o: “individual” ou “clan”
\nmodo: “clan”<\/p>\n
# Arena (definida com \/da setarena)
\narena:
\n mundo: “world”
\n pos1: x,y,z
\n pos2: x,y,z<\/p>\n
# Holograma
\nhologram:
\n enabled: true
\n onlyWhenRunning: true
\n location: “world,100,65,100” # definido com \/da sethologram
\n updateIntervalTicks: 20
\n linesKey: “hologram.lines”<\/p>\n
# An\u00fancios antes do evento (em minutos)
\nanuncios-antes:
\n – 10
\n – 5
\n – 1<\/p>\n
# Recompensas (comandos executados como console)
\nrecompensas:
\n jogador-vencedor:
\n – “give %player% diamond 10”
\n cla-vencedor:
\n – “f money give %clan% 10000”<\/p>\n
“`<\/p>\n
## Placeholders (com PlaceholderAPI)<\/p>\n
| Placeholder | Descri\u00e7\u00e3o |
\n|————————————–|—————————————————-|
\n| `%dominararena_status%` | Status atual (Aguardando, Em andamento, etc.) |
\n| `%dominararena_tempo_restante%` | Tempo restante formatado (ex: 12:34) |
\n| `%dominararena_cla_domina%` | Nome do cl\u00e3 que est\u00e1 dominando |
\n| `%dominararena_cla_domina_tag%` | Tag do cl\u00e3 dominando |
\n| `%dominararena_jogador_domina%` | Nome do jogador dominando (modo individual) |
\n| `%dominararena_top_jogador%` | Nome do jogador com mais tempo |
\n| `%dominararena_top_jogador_tempo%` | Tempo do top jogador |
\n| `%dominararena_top_cla%` | Nome do cl\u00e3 top |
\n| `%dominararena_top_cla_tempo%` | Tempo do cl\u00e3 top |<\/p>\n
## Suporte e Atualiza\u00e7\u00f5es<\/p>\n
Plugin desenvolvido por **Pedro**. <\/p>\n
Em caso de bugs ou sugest\u00f5es, entre em contato pelo **Discord** ou pelo local de compra do plugin.<\/p>\n
**Vers\u00e3o atual:** 1.0.0
\n**Vers\u00f5es do Minecraft suportadas:** 1.20.x – 1.21.x <\/p>\n
**Divirta-se e domine a arena!**<\/p>\n","protected":false},"excerpt":{"rendered":"
Dominate the arena and be the ultimate winner, bring your clan!<\/p>\n","protected":false},"featured_media":118722,"template":"","meta":{"_minecraft_slug":"p_dominararena","_minecraft_project_id":"JF1By2he","_minecraft_author":"Mr_Haruki","_minecraft_license":"MIT","_minecraft_downloads":35,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"p_dominararena.zip","_minecraft_size_bytes":217507,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:51:42.871805Z","_minecraft_date_created":"2026-01-24T19:32:00.742873Z","_minecraft_date_modified":"2026-04-15T00:17:38.702024Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/p_dominararena","_minecraft_icon_attachment_id":118722,"_minecraft_imported_at":"2026-06-06T23:33:35+00:00","_minecraft_import_hash":"56c4fb631753f42c98aeea1bd51a83b7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,844,88,89,866,127,867,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31],"class_list":["post-118721","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9"],"yoast_head":"\n