Karta WorldReset
Automated, highly configurable, and modern world reset management plugin for Minecraft.
406
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
Karta WorldReset
🌍 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.*
---
✨ 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.
