---

✨ 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
/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.