P_DominarArena

P_DominarArena

KoTH (King of the Hill) 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).

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.

Main Features

- Flexible Configuration — Automatically starts at the times defined in `config.yml`. - Flexible Configuration — Counts the time each player/clan stays inside the arena without interruptions. - Flexible Configuration — Integration with Flexible Configuration and Flexible Configuration for clan domination mode (optional). - Flexible Configuration — Compatible with Flexible Configuration, Flexible Configuration or native TextDisplay (vanilla). Updates in real-time with status, remaining time, dominating clan/player, tops, etc. - Flexible Configuration — Integration with Flexible Configuration (`%dominararena_status%`, `%dominararena_tempo_restante%`, etc.). - Flexible Configuration — Intuitive interface to configure the arena, view tops, event status, and more. - Flexible Configuration — Configurable broadcasts to notify when the event is about to start, is in progress, and when it ends. - Flexible Configuration — Rewards for the winning player and/or clan (commands executed by the console). - Flexible Configuration — Everything editable via `config.yml` and language files.

Dependencies

Required Dependencies (Hard): - None (works standalone in individual mode).

SaberFactions - SaberFactions → to use the placeholders. - SaberFactions or SaberFactions → for more advanced holograms (otherwise uses vanilla TextDisplay). - SaberFactions or SaberFactions → for clan domination mode.

Installation

1. Place the `P_DominarArena.jar` file in the `/plugins/` folder. 2. Start or restart the server. 3. The DominarArena folder will be created inside `/plugins/` containing: - `config.yml` - `lang/en_us.yml` (or other language) - `data.yml` (saved top data) 4. Configure the plugin by editing `config.yml` (see the configuration section below). 5. Use the command `/dominararena reload` to apply the changes.

Commands and Permissions

Main Command: `/dominararena` (alias: `/da`)

| Subcommand | Description | Permission | |-----------------|--------------------------------------------------|------------------------| | `/da` | Opens the main menu | `dominararena.use` | | `/da reload` | Reloads config, lang, holograms, and schedules | `dominararena.admin` | | `/da setarena` | Sets the two points of the arena (pos1 and pos2) | `dominararena.admin` | | `/da sethologram` | Sets the hologram location | `dominararena.admin` | | `/da forcastart`| Starts the event manually | `dominararena.admin` | | `/da forcestop` | Stops the event manually | `dominararena.admin` | | `/da top` | Opens the tops menu | `dominararena.use` |

Main Configuration (config.yml)

Example of the most important sections:

```yaml

Default language (file in lang/)

language: en_us

Event schedules (24h format - HH:mm)

schedules: - "14:00" - "20:00"

Event duration in minutes

duration-minutes: 30

Minimum time inside the arena to count (seconds) - avoids quick touches

min-time-seconds: 5

Domination mode: "individual" or "clan"

mode: "clan"

Arena (set with /da setarena)

arena: world: "world" pos1: x,y,z pos2: x,y,z

Hologram

hologram: enabled: true onlyWhenRunning: true location: "world,100,65,100" # set with /da sethologram updateIntervalTicks: 20 linesKey: "hologram.lines"

Announcements before the event (in minutes)

pre-announcements: - 10 - 5 - 1

Rewards (commands executed as console)

rewards: player-winner: - "give %player% diamond 10" clan-winner: - "f money give %clan% 10000"

```

Placeholders (with PlaceholderAPI)

| Placeholder | Description | |--------------------------------------|-------------------------------------------------------| | `%dominararena_status%` | Current status (Waiting, In progress, etc.) | | `%dominararena_tempo_restante%` | Formatted remaining time (ex: 12:34) | | `%dominararena_cla_domina%` | Name of the dominating clan | | `%dominararena_cla_domina_tag%` | Tag of the dominating clan | | `%dominararena_jogador_domina%` | Name of the dominating player (individual mode) | | `%dominararena_top_jogador%` | Name of the player with the most time | | `%dominararena_top_jogador_tempo%` | Time of the top player | | `%dominararena_top_cla%` | Name of the top clan | | `%dominararena_top_cla_tempo%` | Time of the top clan |

Support and Updates

Plugin developed by Pedro.

In case of bugs or suggestions, contact via Discord or the plugin purchase location.

Current Version: 1.0.0

Supported Minecraft Versions: 1.20.x - 1.21.x

Have fun and dominate the arena!

P_DominarArena

KoTH (King of the Hill) é um plugin premium para servidores Minecraft (Spigot/Paper 1.20+) que cria um evento automático de dominação de arena no estilo KoTH (King of the Hill).

O objetivo é simples: os jogadores (ou clãs) entram na arena e tentam permanecer o maior tempo possível dentro dela. Quem acumular mais tempo dominando vence o evento e recebe recompensas configuráveis.

Principais Funcionalidades

- Configuração flexível — Inicia automaticamente nos horários definidos no `config.yml`. - Configuração flexível — Conta o tempo que cada jogador/clã fica dentro da arena sem interrupções. - Configuração flexível — Integração com Configuração flexível e Configuração flexível para modo de dominação por clã (opcional). - Configuração flexível — Compatível com Configuração flexível, Configuração flexível ou TextDisplay nativo (vanilla). Atualiza em tempo real com status, tempo restante, clã/jogador dominando, tops, etc. - Configuração flexível — Integração com Configuração flexível (`%dominararena_status%`, `%dominararena_tempo_restante%`, etc.). - Configuração flexível — Interface intuitiva para configurar a arena, visualizar tops, status do evento, entre outros. - Configuração flexível — Broadcasts configuráveis para avisar quando o evento vai começar, está em andamento e quando termina. - Configuração flexível — Recompensas para o jogador vencedor e/ou clã vencedor (comandos executados pelo console). - Configuração flexível — Tudo editável via `config.yml` e arquivos de idioma.

Dependências

Dependências obrigatórias (Hard): - Nenhuma (funciona standalone no modo individual).

SaberFactions - SaberFactions → para utilizar os placeholders. - SaberFactions ou SaberFactions → hologramas mais avançados (caso contrário usa TextDisplay vanilla). - SaberFactions ou SaberFactions → para modo de dominação por clã.

Instalação

1. Coloque o arquivo `P_DominarArena.jar` na pasta `/plugins/`. 2. Inicie ou reinicie o servidor. 3. Será criada a pasta DominarArena dentro de `/plugins/` contendo: - `config.yml` - `lang/pt_br.yml` (ou outro idioma) - `data.yml` (dados salvos dos tops) 4. Configure o plugin editando o `config.yml` (veja a seção de configuração abaixo). 5. Use o comando `/dominararena reload` para aplicar as alterações.

Comandos e Permissões

Comando principal: `/dominararena` (alias: `/da`)

| Subcomando | Descrição | Permissão | |------------------------|-----------------------------------------------------|-------------------------------| | `/da` | Abre o menu principal | `dominararena.use` | | `/da reload` | Recarrega config, lang, hologramas e horários | `dominararena.admin` | | `/da setarena` | Define os dois pontos da arena (pos1 e pos2) | `dominararena.admin` | | `/da sethologram` | Define a localização do holograma | `dominararena.admin` | | `/da forcastart` | Inicia o evento manualmente | `dominararena.admin` | | `/da forcestop` | Para o evento manualmente | `dominararena.admin` | | `/da top` | Abre o menu de tops | `dominararena.use` |

Configuração Principal (config.yml)

Exemplo das seções mais importantes:

```yaml

Idioma padrão (arquivo em lang/)

idioma: pt_br

Horários do evento (formato 24h - HH:mm)

horarios: - "14:00" - "20:00"

Duração do evento em minutos

duracao-minutos: 30

Tempo mínimo dentro da arena para contar (segundos) - evita "toques rápidos"

tempo-minimo-segundos: 5

Modo de dominação: "individual" ou "clan"

modo: "clan"

Arena (definida com /da setarena)

arena: mundo: "world" pos1: x,y,z pos2: x,y,z

Holograma

hologram: enabled: true onlyWhenRunning: true location: "world,100,65,100" # definido com /da sethologram updateIntervalTicks: 20 linesKey: "hologram.lines"

Anúncios antes do evento (em minutos)

anuncios-antes: - 10 - 5 - 1

Recompensas (comandos executados como console)

recompensas: jogador-vencedor: - "give %player% diamond 10" cla-vencedor: - "f money give %clan% 10000"

```

Placeholders (com PlaceholderAPI)

| Placeholder | Descrição | |--------------------------------------|----------------------------------------------------| | `%dominararena_status%` | Status atual (Aguardando, Em andamento, etc.) | | `%dominararena_tempo_restante%` | Tempo restante formatado (ex: 12:34) | | `%dominararena_cla_domina%` | Nome do clã que está dominando | | `%dominararena_cla_domina_tag%` | Tag do clã dominando | | `%dominararena_jogador_domina%` | Nome do jogador dominando (modo individual) | | `%dominararena_top_jogador%` | Nome do jogador com mais tempo | | `%dominararena_top_jogador_tempo%` | Tempo do top jogador | | `%dominararena_top_cla%` | Nome do clã top | | `%dominararena_top_cla_tempo%` | Tempo do clã top |

Suporte e Atualizações

Plugin desenvolvido por Pedro.

Em caso de bugs ou sugestões, entre em contato pelo Discord ou pelo local de compra do plugin.

Versões do Minecraft suportadas: 1.0.0 Versões do Minecraft suportadas: 1.20.x - 1.21.x

Divirta-se e domine a arena!