P_DominarArena

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).

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

• Scheduled Event — Automatically starts at the times defined in config.yml.
• Time-based Domination System — Counts the time each player/clan stays inside the arena without interruptions.
• Clan Support — Integration with FactionsUUID and SaberFactions for clan domination mode (optional).
• Informative Hologram — Compatible with DecentHolograms, HolographicDisplays or native TextDisplay (vanilla). Updates in real-time with status, remaining time, dominating clan/player, tops, etc.
• Full Placeholders — Integration with PlaceholderAPI (%dominararena_status%, %dominararena_tempo_restante%, etc.).
• Complete Menus/GUIs — Intuitive interface to configure the arena, view tops, event status, and more.
• Announcements and Calls — Configurable broadcasts to notify when the event is about to start, is in progress, and when it ends.
• Reward System — 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).

Optional Dependencies (Soft):

• PlaceholderAPI → to use the placeholders.
• DecentHolograms or HolographicDisplays → for more advanced holograms (otherwise uses vanilla TextDisplay).
• FactionsUUID 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:

# 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

P_DominarArena é 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

• Evento com horário programado — Inicia automaticamente nos horários definidos no config.yml.
• Sistema de dominação por tempo — Conta o tempo que cada jogador/clã fica dentro da arena sem interrupções.
• Suporte a clãs — Integração com FactionsUUID e SaberFactions para modo de dominação por clã (opcional).
• Holograma informativo — Compatível com DecentHolograms, HolographicDisplays ou TextDisplay nativo (vanilla). Atualiza em tempo real com status, tempo restante, clã/jogador dominando, tops, etc.
• Placeholders completos — Integração com PlaceholderAPI (%dominararena_status%, %dominararena_tempo_restante%, etc.).
• Menus/GUIs completos — Interface intuitiva para configurar a arena, visualizar tops, status do evento, entre outros.
• Anúncios e chamadas — Broadcasts configuráveis para avisar quando o evento vai começar, está em andamento e quando termina.
• Sistema de recompensas — 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).

Dependências opcionais (Soft):

• PlaceholderAPI → para utilizar os placeholders.
• DecentHolograms ou HolographicDisplays → hologramas mais avançados (caso contrário usa TextDisplay vanilla).
• FactionsUUID 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:

# 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ão atual: 1.0.0
Versões do Minecraft suportadas: 1.20.x - 1.21.x

Divirta-se e domine a arena!