P_DominarArena

# 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