✨ 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: Multiverse-Core (highly recommended for world management), PlaceholderAPI.

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:

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.