Karta WorldReset

<div align="center">

🌍 KartaWorldReset

Automated, highly configurable, and modern world management plugin for Minecraft.

*An essential tool for Minecraft servers requiring seasonal resets, resource worlds, or scheduled wipes with built-in backup safety and zero hassle.*

</div>

---

✨ Features

- ⏳ Player Evacuation: Set precise reset schedules (e.g., every 30 days, or on a specific cron-like interval). - 🎨 Player Evacuation: 100% configurable messages using HEX colors, gradients, click events, and hover tooltips (`messages.yml`). - ⚡ Player Evacuation: Powered by Incendo's *Cloud Command Framework V2* for intelligent, context-aware Player Evacuation. - 🎯 Player Evacuation: Reset all worlds at once, or target specific worlds gracefully (`/kwr reset resource_world`). - 🛡️ Player Evacuation: Asynchronous and synchronous backup generation before resets. - 📦 Player Evacuation: Hooks directly into Multiverse-Core for safe unloading, cloning, and physical deletion of world folders. - 🔗 Player Evacuation: 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

- Soft Dependencies: Paper (or forks like Purpur, Folia) version Soft Dependencies:. - Soft Dependencies: Java 21+. - Soft Dependencies: Soft Dependencies: (highly recommended for world management), %%MD1%%.

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 [clock]` | `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 [target]` | `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 MiniMessage. 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 via `config.yml` patterns. - `%kwr_worlds%` — A comma-separated list of tracked worlds. - `%kwr_backup_status%` — Returns `Enabled` or `Disabled`.

---

👨‍💻 Developer API (Coming Soon)

`KartaWorldReset` is built to be modular. Future versions will expose a native API for developers to listen to `WorldResetEvent`, `WorldPreResetEvent`, and manage schedules internally from other plugins.

<div align="center"> <i>Crafted with ❤️ by Minekarta Studio.</i> </div>