Karta WorldReset

<div align="center"> # 🌍 KartaWorldReset **Automated, highly configurable, and modern world management plugin for Minecraft.** (https://img.shields.io/badge/Version-2.0.0-success?style=for-the-badge&logo=minecraft)](#) (https://img.shields.io/badge/API-Paper_1.21-blue?style=for-the-badge&logo=java)](#) (https://img.shields.io/badge/Commands-Cloud_V2-orange?style=for-the-badge)](#) (https://img.shields.io/badge/Text-MiniMessage-purple?style=for-the-badge)](#) *An essential tool for Minecraft servers requiring seasonal resets, resource worlds, or scheduled wipes with built-in backup safety and zero hassle.* </div> --- ## ✨ Features - ⏳ **Automated Scheduling**: Set precise reset schedules (e.g., every 30 days, or on a specific cron-like interval). - 🎨 **Modern Aesthetics (MiniMessage)**: 100% configurable messages using HEX colors, gradients, click events, and hover tooltips (`messages.yml`). - ⚡ **Blazing Fast Commands**: Powered by Incendo's *Cloud Command Framework V2* for intelligent, context-aware **Tab Completion**. - 🎯 **Targeted Resets**: Reset all worlds at once, or target specific worlds gracefully (`/kwr reset resource_world`). - 🛡️ **Safety First**: Asynchronous and synchronous backup generation before resets. - 📦 **Multiverse Integration**: Hooks directly into Multiverse-Core for safe unloading, cloning, and physical deletion of world folders. - 🔗 **PlaceholderAPI Support**: Display countdowns and reset info anywhere (holograms, scoreboards) with `%kwr_time_left%` and `%kwr_next_reset%`. - 🚷 **Player Evacuation**: Automatically teleports players to a safe fallback/lobby world before wiping the ground beneath them! --- ## 🚀 Getting Started ### 1. Requirements - **Server Software:** Paper (or forks like Purpur, Folia) version **1.21+**. - **Java:** Java 21+. - **Soft Dependencies:** (https://modrinth.com/plugin/multiverse-core) (highly recommended for world management), (https://www.spigotmc.org/resources/placeholderapi.6245/). ### 2. Installation 1. Download the latest `KartaWorldReset-2.0.0.jar` release. 2. Drop it into your server's `plugins/` folder. 3. Restart your server to generate the configuration files. 4. Modify `config.yml` and `messages.yml` to fit your server's economy and theme! --- ## 🛠️ Commands & Permissions KartaWorldReset provides intelligent subcommands under the generic `/kwr` namespace. *Aliases:* `/worldreset`, `/quest`, `/adventurequest`, `/quests` | Command | Permission Node | Description | | :--- | :--- | :--- | | `/kwr help` | *None* | Displays the interactive help menu. | | `/kwr info ` | `kartaworldreset.info` | View the countdown to the next global reset, or check the internal server clock. | | `/kwr status` | `kartaworldreset.admin` | Shows a technical summary profile of the plugin hook status. | | `/kwr addworld <world>` | `kartaworldreset.admin.schedule` | Adds an active world to the auto-reset watchlist. | | `/kwr removeworld <world>`| `kartaworldreset.admin.schedule` | Removes a world from the watchlist. | | `/kwr autogen` | `kartaworldreset.admin.schedule` | Evaluates the config and artificially generates the next reset timestamp. | | `/kwr pause` / `resume` | `kartaworldreset.admin` | Pauses or unpauses the scheduled cron-timer. | | `/kwr backup <world|all>` | `kartaworldreset.admin.backup` | Manually triggers the backup generation system. | | `/kwr reload` | `kartaworldreset.admin.reload` | Hot-reloads all `.yml` files without restarting the server. | | `/kwr reset ` | `kartaworldreset.admin.reset` | **DANGER**: Triggers a manual reset. Requires typing `/kwr reset confirm` within 30s as a safety mechanism. | --- ## ⚙️ Configuration Guides ### 📝 The `config.yml` Core Settings Here is a brief overview of what you can control: - `Interval.days` / `hours` / `minutes`: Set exactly how long a "season" lasts. - `Lobby.world` / `x` / `y` / `z`: The evacuation safe-zone coordinate for players inside wiping worlds. - `Worlds`: The list of exact Multiverse world names to reset. - `Backup`: Enable/disable world-zipping before deletion, limiting maximum stored backups to save disk space. - `Notifications`: Tune when the Chat, ActionBar, and Title warnings appear (e.g., `3600, 1800, 300, 60, 10, 5`). ### 🎨 The `messages.yml` Aesthetics Layer Unlike legacy plugins, KartaWorldReset uses (https://docs.advntr.dev/minimessage/format.html). Add gradients, hover-text, and run-commands easily! **Example Custom Gradient Title:** ```yaml reset-title: "<gradient:#FF416C:#FF4B2B><bold>Resetting Worlds...</bold></gradient>" reset-subtitle: "<gray>Creating new adventures, sit tight!</gray>" ``` --- ## 🧩 PlaceholderAPI Hooks If PlaceholderAPI is installed, KartaWorldReset automatically registers the following placeholders: - `%kwr_time_left%` — Beautifully formatted string (e.g., `5d 12h 30m`). - `%kwr_next_reset%` — The absolute date formatted