# KartaWorldReset 插件
KartaWorldReset 是一个强大且易于使用的 Minecraft 插件，它能够按照可定制的时间表自动重置世界，从而帮助维持玩家游戏环境的新鲜度和优化。
## 特性
- **计划重置**: 将世界配置为每天、每周或每月在特定时间重置。
- **多世界支持**: 同时指定多个世界进行重置。
- **动态世界管理**: 通过游戏内命令直接添加或删除重置列表中的世界。
- **可定制消息**: 几乎所有插件消息都可以通过 `config.yml` 进行定制。
- **PlaceholderAPI 支持**: 在分数板、boss bar 等上显示倒计时和重置信息。
- **大厅系统**: 设置一个安全的大厅世界，在世界重置发生前将玩家传送到该世界。
- **基于权限的命令**: 对谁可以使用管理命令进行细粒度控制。
## 命令
主命令是 `/kartaworldreset`，可以使用 `/kwr` 作为别名。
| 命令 | 描述 | 权限 |
|--------------------------|-------------------------------------------|-------------------------|
| `/kwr help` | 显示帮助消息。 | (无) |
| `/kwr info` | 显示下次重置剩余时间。 | (无) |
| `/kwr info clock` | 显示当前系统时间。 | (无) |
| `/kwr info setting` | 显示当前的配置设置。 | `kartaworldreset.admin` |
| `/kwr info worldlist` | 显示要重置的世界列表。 | `kartaworldreset.admin` |
| `/kwr reload` | 重新加载插件的配置文件。 | `kartaworldreset.admin` |
| `/kwr autogen` | 自动生成 `nextReset` 日期。 | `kartaworldreset.admin` |
| `/kwr addworld ` | 将一个世界添加到重置列表。 | `kartaworldreset.admin` |
| `/kwr removeworld `| 从重置列表中移除一个世界。 | `kartaworldreset.admin` |
| `/kwr papi reload` | 重新加载 PlaceholderAPI 扩展。 | `kartaworldreset.admin` |
| `/kwr reset` | 手动重置列表中包含的世界。 | `kartaworldreset.admin` |
## 权限
| 权限 | 描述 |
|-------------------------|-------------------------------------------|
| `kartaworldreset.admin` | 授予访问所有管理命令的权限。 |
## PlaceholderAPI 占位符
| 占位符 | 描述 |
|-------------------------|-------------------------------------------|
| `%kartaworldreset_normal%`| 显示下次重置剩余时间，采用长格式（例如，“1周2天3小时”）。 |
| `%kartaworldreset_nextReset%`| 显示下次重置的准确日期和时间。 |
| `%kartaworldreset_short%` | 显示下次重置剩余时间，采用短格式（例如，“dd:hh:mm:ss”）。 |
## 配置 (`config.yml`)
配置分为几个部分。
### 主配置
```yaml
Config:
# 设置重置频率。
# d = 天, w = 周, m = 月
every: 1w
# 设置一天中的重置时间（24小时制）。
time: "00:00"
Save:
# 下次重置的日期。
# 可以设为 null 以在首次运行时自动生成。
# 格式: dd-MM-yyyy
nextReset: null
Worlds:
# 要重置的世界列表。
- your_world
Lobby:
# 玩家在重置发生前传送到的大厅世界。
# 设置为 null 将玩家传送到他们的床或主世界。
- world
```
### 消息定制
所有面向用户的消息可以在 `Messages` 部分进行定制。 你可以使用标准的 Bukkit 颜色代码 (`&a`, `&b` 等)。
为 `addworld` 和 `removeworld` 命令添加了新的消息。
```yaml
Messages:
reload: "&a[KartaWorldReset] 配置文件已重新加载！"
autogen: "&a[KartaWorldReset] 自动生成完成！"
papi-reloaded: "&a[KartaWorldReset] PAPI 已注册！"
papi-failed: "&c[KartaWorldReset] PAPI 注册失败！"
no-permission: "&c你没有执行此操作的权限。"
world-list: "&e世界列表 : &f[%worlds%]"
lobby: "&e大厅 : &f%lobby%"
world-added: "&a世界 %world% 已添加到列表。"
world-removed: "&a世界 %world% 已从列表移除。"
world-already-exists: "&c世界 %world% 已在列表中。"
world-not-found: "&c世界 %world% 在列表中不存在。"
add-world-usage: "&c用法: /kwr addworld "
remove-world-usage: "&c用法: /kwr removeworld "
help:
- "&eKartaWorldReset 插件"
- "&e[用法]:"
- "&f/kwr reload &7- &a重新加载配置 (管理员)"
- "&f/kwr autogen &7- &a自动生成配置 (管理员)"
- "&f/kwr addworld &7- &a将世界添加到重置列表 (管理员)"
- "&f/kwr removeworld &7- &a从重置列表中移除世界 (管理员)"
- "&f/kwr info &7- &a显示剩余时间"
```