ВЕРСИИ (2)

suporte a 1.8x

# 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: ```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 **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: ```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ão atual:** 1.0.0 **Versões do Minecraft suportadas:** 1.20.x - 1.21.x **Divirta-se e domine a arena!**