? KartaWorldReset
适用于 Minecraft 的自动化、高度可配置且现代化的世界管理插件。
对于需要季节性重置、资源世界或计划性清理,并内置备份安全机制且无需繁琐操作的 Minecraft 服务器而言,这是必不可少的工具。
✨ 功能特性
- ⏳ 自动调度:设置精确的重置时间表(例如每 30 天一次,或在特定的类 Cron 间隔执行)。
- ? 现代美学(MiniMessage):使用 HEX 颜色、渐变、点击事件和悬停提示完全自定义消息(
messages.yml)。
- ⚡ 极速命令:基于 Incendo 的 Cloud Command Framework V2 驱动,提供智能、上下文感知的 Tab 补全功能。
- ? 定向重置:一次性重置所有世界,或以优雅的方式针对特定世界进行操作(
/kwr reset resource_world)。
- ?️ 安全第一:在重置前生成异步和同步备份。
- ? Multiverse 集成:直接挂钩 Multiverse-Core,安全地卸载、克隆或删除世界文件夹。
- ? PlaceholderAPI 支持:通过
%kwr_time_left% 和 %kwr_next_reset% 在任何地方(如全息图、计分板)显示倒计时和重置信息。
- ? 玩家撤离:在清除脚下世界之前,自动将玩家传送至安全回退世界/大厅!
? 快速入门
1. 环境要求
2. 安装步骤
- 下载最新的
KartaWorldReset-2.0.0.jar 发布版本。
- 将其放入服务器的
plugins/ 文件夹中。
- 重启服务器以生成配置文件。
- 修改
config.yml 和 messages.yml 以符合您服务器的经济系统和主题风格!
?️ 命令与权限
KartaWorldReset 在通用 /kwr 命名空间下提供智能子命令。
别名: /worldreset, /quest, /adventurequest, /quests
| 命令 |
权限节点 |
描述 |
/kwr help |
无 |
显示交互式帮助菜单。 |
/kwr info [clock] |
kartaworldreset.info |
查看距离下一次全局重置的倒计时,或检查内部服务器时钟。 |
/kwr status |
kartaworldreset.admin |
显示插件挂钩状态的技术摘要概况。 |
/kwr addworld <world> |
kartaworldreset.admin.schedule |
将活动世界添加到自动重置监视列表。 |
/kwr removeworld <world> |
kartaworldreset.admin.schedule |
从监视列表中移除一个世界。 |
/kwr autogen |
kartaworldreset.admin.schedule |
评估配置并人工生成下一个重置时间戳。 |
/kwr pause / resume |
kartaworldreset.admin |
暂停或恢复计划的 Cron 计时器。 |
| `/kwr backup <world |
all>` |
kartaworldreset.admin.backup |
/kwr reload |
kartaworldreset.admin.reload |
热重载所有 .yml 文件,无需重启服务器。 |
/kwr reset [target] |
kartaworldreset.admin.reset |
危险:触发手动重置。作为安全机制,需在 30 秒内输入 /kwr reset confirm。 |
⚙️ 配置指南
? config.yml 核心设置
以下是您可以控制的内容简要概述:
Interval.days / hours / minutes:设置“赛季”的确切持续时间。
Lobby.world / x / y / z:玩家在即将被清理的世界内的撤离安全区坐标。
Worlds:要重置的精确 Multiverse 世界名称列表。
Backup:启用/禁用删除前的世界压缩打包,限制最大存储备份数量以节省磁盘空间。
Notifications:调整聊天栏、动作栏和标题警告出现的时间点(例如 3600, 1800, 300, 60, 10, 5)。
? messages.yml 美学层
与旧版插件不同,KartaWorldReset 使用 MiniMessage。
轻松添加渐变、悬停文本和运行命令!
自定义渐变标题示例:
reset-title: "<gradient:#FF416C:#FF4B2B><bold>正在重置世界...</bold></gradient>"
reset-subtitle: "<gray>正在创造新的冒险,请稍候!</gray>"
? PlaceholderAPI 挂钩
如果安装了 PlaceholderAPI,KartaWorldReset 会自动注册以下占位符:
%kwr_time_left% — 格式美观的字符串(例如 5d 12h 30m)。
%kwr_next_reset% — 通过 config.yml 模式格式化的绝对日期。
%kwr_worlds% — 受追踪世界的逗号分隔列表。
%kwr_backup_status% — 返回 Enabled 或 Disabled。
?? 开发者 API(即将推出)
KartaWorldReset 采用模块化构建。未来版本将开放原生 API,供开发人员监听 WorldResetEvent、WorldPreResetEvent,并从其他插件内部管理时间表。
Crafted with ❤️ by Minekarta Studio.
? 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
- ⏳ 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
- Download the latest
KartaWorldReset-2.0.0.jar release.
- Drop it into your server's
plugins/ folder.
- Restart your server to generate the configuration files.
- 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.
Crafted with ❤️ by Minekarta Studio.
评论 0
登录后参与评分
还没有评论,来抢沙发吧