Simple Timer

# 简单计时器 一个简单的、交互式的 Minecraft 服务器（Spigot、Paper 等）计时器插件， 支持带有友好的命令和可点击的游戏内 UI 元素的多个命名计时器。 --- **⚠️ 注意：** 此插件的版本（v2.0.0 及以上）已完全重写， 包括文档。 对于旧文档，请参阅此处： [https://github.com/IschdeFelin/mc-simple-timer/tree/main-v1](https://github.com/IschdeFelin/mc-simple-timer/blob/main-v1/README.md) --- ## 功能 - 管理带有自定义名称的多个计时器。 - 可点击的游戏内计时器列表，带有悬停提示和命令建议。 - 支持暂停、恢复、重置、保存和重新加载。 - 可配置的显示，包括颜色选项和暂停消息。 - 计时器可以在没有玩家在线的情况下运行，并且在玩家死亡时自动暂停（可配置）。 --- ## 命令 ### `/timer resume` 恢复当前计时器。 ### `/timer pause` 暂停当前计时器。 ### `/timer reset` 停止并重置当前计时器为 0。 ### `/timer create ` 使用给定的名称创建一个新的计时器。 计时器名称必须： - 不为空 - ≤ 20 个字符 - 仅包含字母、数字、_ 或 - 示例： ```bash /timer create speedrun1 ``` 如果成功，将出现一个可点击的消息，允许您立即选择计时器。 ### `/timer select ` 选择具有给定名称的计时器，并默认暂停它。 ### `/timer name` 显示当前选定计时器的名称。 ### `/timer rename ` 将当前计时器重命名为指定的名称。 命名规则与 `/timer create ` 相同。 ### `/timer state ` 显示指定计时器（或如果没有给定名称则显示活动计时器）的当前状态（时间）。 ### `/timer list` 列出所有可用的计时器及其当前时间。 每个条目： - **可点击：** 建议 `/timer select ` - **悬停：** 显示“点击选择” 示例输出： ```plaintext These timers exist: - speedrun1 (0s) - bossfight (1h 23m 51s) ``` ### `/timer set ` 将当前计时器设置到特定的时间。 `` 参数可以是简单的秒数（例如 `300`） 或一个更详细的格式，结合天、小时、分钟和秒，例如： `13d2s`, `78m12s`, `15h7s`, `12h`, `465s`, `484` 示例： ```bash /timer set 1d3h17m12s ``` ### `/timer add ` 将给定的时间添加到当前计时器。 `` 参数接受与 `/timer set` 相同的格式，例如： `300`, `78m12s`, `15h7s`, `13d2s`, `465s` 示例： ```bash /timer add 1h30m ``` ### `/timer subtract ` 从当前计时器中减去给定的时间。 `` 参数接受与 `/timer set` 相同的格式，例如： `300`, `78m12s`, `15h7s`, `13d2s`, `465s` 示例： ```bash /timer subtract 45m20s ``` ### `/timer remove ` 移除指定的计时器。 如果未给定名称，则移除当前计时器。 如果当前活动的计时器被移除，则没有计时器剩余被选中。 ### `/timer reload` 从磁盘重新加载配置文件。 ### `/timer save` 手动将所有计时器数据保存到磁盘。 否则，数据将在每次服务器关闭时保存。 --- ## 安装 1) 从 Modrinth 下载 `.jar` 文件。 2) 将其放在服务器的 `/plugins` 文件夹中。 3) 重启服务器。 --- ## 配置 位于： ``` /plugins/SimpleTimer/config.yml ``` ### 选项 | 选项 | 描述 | 默认值 | |-----------------------|--------------------------------------------------------------------|------------------| | show_pause_message | 在暂停时显示自定义消息 (与时间交替)? | `true` | | pause_message | 当计时器暂停时要显示的 message。 | `"Timer paused"` | | color_running | 计时器运行时的颜色 (`YELLOW`, `WHITE` 等) | `"YELLOW"` | | color_paused | 计时器暂停时的计时器值颜色。 | `"GOLD"` | | color_pause_message | 暂停消息的颜色。 | `"GOLD"` | | run_without_players | 如果 `true`，即使没有玩家在线，计时器也会继续运行 | `false` | | pause_on_player_death | 如果 `true`，当玩家死亡时，计时器将自动暂停 | `false` | | auto_select_new_timer | 自动选择新创建的计时器 | `false` | ### 可用的颜色 AQUA, BLACK, BLUE, DARK_AQUA, DARK_BLUE, DARK_GRAY, DARK_GREEN, DARK_PURPLE, DARK_RED, GOLD, GRAY, GREEN, LIGHT_PURPLE, RED, WHITE, YELLOW --- 对于问题、建议或贡献，请随时在 [GitHub 仓库](https://github.com/IschdeFelin/mc-simple-timer) 上打开 issue 或 pull request。