Simple Timer
一款适用于 Minecraft 服务器(Spigot、Paper 等)的简洁且交互式计时器插件,
支持多个带名称的计时器,提供直观的命令和可点击的游戏内 UI 元素。
⚠️ 注意: 此版本的插件(v2.0.0 及以上版本)已完全重写,
包括文档。旧版文档请参见:
功能
- 管理具有自定义名称的多个计时器。
- 可点击的游戏内计时器列表,带有悬停提示和命令建议。
- 支持暂停、恢复、重置、保存和重载。
- 可配置的显示效果,包含颜色选项和暂停消息。
- 计时器可在无玩家在线时继续运行,并在玩家死亡时自动暂停(可配置)。
命令
/timer resume
恢复当前计时器。
/timer pause
暂停当前计时器。
/timer reset
停止并将当前计时器重置为 0。
/timer create <name>
创建一个具有指定名称的新计时器。
计时器名称必须满足以下条件:
- 不能为空
- ≤ 20 个字符
- 仅包含字母、数字、下划线
_ 或连字符 -
示例:
/timer create speedrun1
如果成功,将出现一条可点击的消息,允许你立即选择该计时器。
/timer select <name>
选择指定名称的计时器,并默认将其暂停。
/timer name
显示当前选中计时器的名称。
/timer rename <name>
将当前计时器重命名为指定的名称。命名规则与 /timer create <name> 相同。
/timer state <name>
显示指定计时器(或未指定名称时显示活动计时器)的当前状态(时间)。
/timer list
列出所有可用计时器及其当前时间。
每个条目:
- 可点击: 建议执行
/timer select <name>
- 可悬停: 显示“点击以选择”
示例输出:
These timers exist:
- speedrun1 (0s)
- bossfight (1h 23m 51s)
/timer set <time>
将当前计时器设置为特定时间。
<time> 参数可以是简单的秒数(例如 300),
也可以是结合天、小时、分钟和秒的更详细格式,例如:
13d2s、78m12s、15h7s、12h、465s、484
示例:
/timer set 1d3h17m12s
/timer add <time>
向当前计时器添加给定时间。
<time> 参数接受与 /timer set 相同的格式,例如:
300、78m12s、15h7s、13d2s、465s
示例:
/timer add 1h30m
/timer subtract <time>
从当前计时器减去给定时间。
<time> 参数接受与 /timer set 相同的格式,例如:
300、78m12s、15h7s、13d2s、465s
示例:
/timer subtract 45m20s
/timer remove <name>
移除指定的计时器。如果未指定名称,则移除当前计时器。
如果移除了当前活动的计时器,则不会保留任何选中的计时器。
/timer reload
从磁盘重新加载配置文件。
/timer save
手动将所有计时器数据保存到磁盘。
否则,数据将在每次服务器关闭时自动保存。
安装
- 从 Modrinth 下载
.jar 文件。
- 将其放入服务器的
/plugins 文件夹中。
- 重启服务器。
配置
位于:
/plugins/SimpleTimer/config.yml
选项
| 选项 |
描述 |
默认值 |
| show_pause_message |
在暂停期间是否显示自定义消息(与时间交替显示)? |
true |
| pause_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 仓库 上提交 issue 或 pull request。
Simple Timer
A simple and interactive timer plugin for Minecraft servers (Spigot, Paper, etc.),
supporting multiple named timers with intuitive commands and clickable in-game UI elements.
⚠️ Note: This version of the plugin (v2.0.0 and above) has been completely rewritten,
including the documentation. For the old documentation, see here:
Features
- Manage multiple timers with custom names.
- Clickable in-game timer list with hover tooltips and command suggestions.
- Supports pausing, resuming, resetting, saving, and reloading.
- Configurable display with color options and pause messages.
- Timers can run without players online and pause automatically on player death (configurable).
Commands
/timer resume
Resumes the current timer.
/timer pause
Pauses the current timer.
/timer reset
Stops and resets the current timer to 0.
/timer create <name>
Creates a new timer with the given name.
Timer names must be:
- Not empty
- ≤ 20 characters
- Contain only letters, numbers, _ or -
Example:
/timer create speedrun1
If successful, a clickable message appears allowing you to select the timer immediately.
/timer select <name>
Selects the timer with the given name and pauses it by default.
/timer name
Shows the name of the currently selected timer.
/timer rename <name>
Renames the current timer to the specified name. The same naming rules apply as for /timer create <name>.
/timer state <name>
Shows the current state (time) of the specified timer or the active timer if no name is given.
/timer list
Lists all available timers with their current times.
Each entry is:
- Clickable: suggests
/timer select <name>
- Hoverable: shows "Click to select"
Example output:
These timers exist:
- speedrun1 (0s)
- bossfight (1h 23m 51s)
/timer set <time>
Sets the current timer to a specific time.
The <time> argument can be either a simple number of seconds (e.g. 300)
or a more detailed format combining days, hours, minutes, and seconds, e.g.:
13d2s, 78m12s, 15h7s, 12h, 465s, 484
Example:
/timer set 1d3h17m12s
/timer add <time>
Adds the given time to the current timer.
The <time> argument accepts the same formats as /timer set, for example:
300, 78m12s, 15h7s, 13d2s, 465s
Example:
/timer add 1h30m
/timer subtract <time>
Subtracts the given time from the current timer.
The <time> argument accepts the same formats as /timer set, for example:
300, 78m12s, 15h7s, 13d2s, 465s
Example:
/timer subtract 45m20s
/timer remove <name>
Removes the specified timer. If no name is given, removes the current timer.
If the currently active timer is removed, no timer remains selected.
/timer reload
Reloads the configuration file from disk.
/timer save
Manually saves all timer data to disk.
Otherwise, the data is saved with every server shutdown.
Installation
- Download the
.jar file from Modrinth.
- Place it in your server's
/plugins folder.
- Restart the server.
Configuration
Located at:
/plugins/SimpleTimer/config.yml
Options
| Option |
Description |
Default |
| show_pause_message |
Show a custom message while paused (alternating with time)? |
true |
| pause_message |
The message to display when the timer is paused. |
"Timer paused" |
| color_running |
Timer color when running (YELLOW, WHITE, etc.) |
"YELLOW" |
| color_paused |
Timer value color when paused. |
"GOLD" |
| color_pause_message |
Color of the pause message. |
"GOLD" |
| run_without_players |
If true, timer continues running even when no players are online |
false |
| pause_on_player_death |
If true, timer pauses automatically when a player dies |
false |
| auto_select_new_timer |
Automatically select the newly created timer |
false |
Available Colors
AQUA, BLACK, BLUE, DARK_AQUA, DARK_BLUE, DARK_GRAY, DARK_GREEN, DARK_PURPLE,
DARK_RED, GOLD, GRAY, GREEN, LIGHT_PURPLE, RED, WHITE, YELLOW
For issues, suggestions, or contributions, feel free to open an issue or pull request on the GitHub repository.
评论 0
登录后参与评分
还没有评论,来抢沙发吧