Event-PVP-Plugin

# Event-PVP-Plugin — Quick Overview A lightweight, powerful all-in-one Minecraft plugin that unifies **custom automated event management** and a **PvP wager betting system** with an interactive **browser-based web configurator**. > ### 💬 Feedback, Feature Requests & Bug Reports Wanted! > Have an idea for a feature, found a bug, or need help? I'd love to hear from you! > You can submit feedback directly via the **(https://sterra.online/?tab=feedback)** (`https://sterra.online/?tab=feedback`). > > - 🔒 **Completely Anonymous:** No account required (adding an email address for replies is completely optional). > - 💡 **Any Feedback Welcome:** Whether it's a bug report, feature suggestion, question, or general feedback — every message helps shape future updates to meet your needs! > - 🙏 **Your Input Matters:** Feedback in any form is greatly appreciated and directly helps the ongoing development. --- !(https://cdn.modrinth.com/data/cached_images/55a8bea46817ffd20512a6f86a71b31c436ec2a9.png) --- ## What Can You Do? ### Custom Event System - **3 Game Modes**: Solo (Free-For-All), 2-Team, and 3-Team. - **4 Win Conditions**: Last Standing, Pickup Item, Kill Count, and Time Survival — combinable with every game mode. - **Switchable Lobby Phase**: Run events with an optional pre-event lobby world or teleport directly into the arena. - **7 Spawn Types**: Single point, random radius, random area, random cube, multiple spawns, team spawns, and command-based spawns. - **Automated Scheduling**: Automatically launch events on intervals with random or sequential rotation. - **Custom Rewards & Leaderboards**: Distribute item and command payouts to winners and participants; track stats with PlaceholderAPI, AJLeaderboards, and DecentHolograms. ### PvP Wager System - **Betting Mechanics**: Challenge players to duels with money wagers (Vault / VaultUnlocked) or item wagers. - **Pre-Configured Equipment Kits**: Design custom armor, weapons, off-hand items, and inventories. - **Arena Management**: Multiple custom arena presets with automatic resets and world protection. - **Interactive Match Flow**: GUI challenge creation, counter-offers, draw voting, surrendering, and spectator mode. ### Modern Web Configurator - **Visual YAML Editor**: Edit `config.yml`, `worlds.yml`, `equipment.yml`, and `web-config.yml` in real time with deep-snapshot precision dirty-tracking. - **Dedicated 3-Tab Inventory Manager**: *Explorer* (search and inspect backups on an authentic Minecraft canvas with XP bar, restore after a confirmation prompt), *Sessions* (live crash-guard sessions), and *Settings*. - **Multiverse World Management**: Create, import, load, unload, delete (with safety checks), and backup/restore worlds directly in the browser. - **Server Item Textures**: Optionally extracts and displays custom item textures from your server resource pack (off by default); ~1650 vanilla item icons ship with the plugin, no internet required. - **Secure Token Login**: Access the panel via one-time tokens (`/eventpvp webtoken`) with per-IP rate limiting; restores are additionally capped at 10 per minute. - **Web Server Settings**: Configurable port with pre-save safety warning dialog, bind address for reverse-proxy setups, and a public URL with automatic `{port}` substitution. ### Crash Protection & Inventory Safety - **Powered by `InventoryBackup`**: Full automatic backup before every teleport and restore on match/event end, respawn, or rejoin. - **Anti-Strand Recovery**: Players stranded in an arena or event world after a server crash/disconnect are returned safely on reconnect via `player-return-locations.yml`. - **Persistent Payout Queue**: Queues wager winnings and event rewards for players who disconnect before payout. ### 100% Multilingual (7 Languages) - Fully translated in **English**, **German**, **Spanish**, **French**, **Japanese**, **Polish**, and **Russian** with 100% key parity (1097 keys). - Full console and logger localization via `messages.console.*`. - Automatic fallback to embedded English defaults for missing custom keys. !(https://cdn.modrinth.com/data/cached_images/cccdf739c9185ab11c8e5d8133bc1504d3125fa1.png) --- ## Quick Start & Dependencies ### 1. Requirements - **Server**: Paper / Spigot **1.19+**, Java 17+ — in practice **1.20+**, because the mandatory InventoryBackup requires it. - **Mandatory Plugins**: * (https://modrinth.com/project/3wmN97b8) (v4 or v5) * (https://modrinth.com/project/ayRaM8J7) — recommended; the classic (https://www.spigotmc.org/resources/vault.34315/) from SpigotMC also works * (https://modrinth.com/project/rpKY25cW) - **Optional Integrations**: PlaceholderAPI, AJLeaderboards, DecentHolograms, PvPManager ### 2. Setup 1. Put `Event-PVP-Plugin.jar`, `Multiverse-Core`, `VaultUnlocked` (or `Vault`), and `InventoryBackup` into your `plugins/` folder. 2. Start the server (con