TheClock - 定时任务与指令方块替代

The Clock 是一款简单实用的服务器时间管理插件，它能在游戏中显示服务器时间，并允许你基于现实时间或游戏刻（tick）来安排任务。它还提供了便捷的笔记功能和类似命令方块的自动化能力，帮助你轻松管理服务器活动。

💡下载与版本

• 适用于 Minecraft 1.20 及以上版本
• 下载链接：https://www.spigotmc.org/resources/theclock.46953/download?version=482956
• 适用于 Minecraft 1.13.0 至 1.19 版本
• 下载链接：https://www.spigotmc.org/resources/theclock.46953/download?version=482956
• 适用于 Minecraft 1.10 至 1.12.2 版本
• 下载链接：https://www.spigotmc.org/resources/theclock.46953/download?version=227705

🎮核心功能

• 显示时间：在游戏中显示服务器现实时间或游戏内时间。
• 定时任务：在指定的现实时间或游戏刻自动执行命令。
• 事件提醒：设置未来日期的事件，插件会显示倒计时并在事件发生时广播消息。
• 笔记系统：快速记录笔记，并可点击笔记传送回记录地点。
• 告示牌显示：通过告示牌动态显示时间或事件倒计时。
• 玩家选择器：在命令中使用 @a（所有在线玩家）、@r（随机在线玩家）、@o（所有离线玩家）、@al（在线玩家列表）、@ol（离线玩家列表）等选择器。
• 跨插件兼容：可以执行来自其他插件（如经济插件）的命令。

🔧配置与文件

插件的主要配置文件如下，你可以通过编辑它们来自定义插件行为。

config.yml

主要配置文件，包含语言、显示设置、时区等。

# 时区设置，默认为 America/New_York
timeZone: 'America/New_York'
# 是否在登录时显示欢迎信息和时钟
showWelcomeMessage: true
# 是否在BOSS血条上显示现实时间
showBossBarClock: true
# 是否在BOSS血条上显示游戏内时间
showBossBarIngameClock: true
# 事件广播间隔（分钟），0为不广播
minutesEventToDisplay: 10

world.yml

用于设置基于现实时间（每小时）和游戏刻的自动命令。

# 现实时间任务示例：在早上7点广播
hourly:
  7:
    - 'broadcast 大家早上好！'
# 游戏刻任务示例：在游戏内清晨（0刻）广播
timeInGame:
  0:
    - 'broadcastWorld world  Minecraft世界的新一天开始了！'

ticker.yml

用于创建复杂的、可重复或定时的任务组，功能类似命令方块。

tasks:
  alwaysDay:
    tick: 1200
    repeatable: true
    events:
      - time set day

eventMessage.yml

用于管理服务器事件和倒计时。

events:
  christmas:
    eventDate: '2023-12-25 00:00:00'
    colorEventTitle: 'yellow'
    eventMessageSubtitle: '直到圣诞节'

✨命令与权限

常用命令

• /theclock help - 显示帮助信息
• /theclock getEvents - 获取记录所有事件的书（OP可获得可删除事件的特殊书）
• /theclock addEvent [事件名] [日期] [时间] [标题颜色] [副标题颜色] [消息] - 添加一个新事件
• /theclock deleteEvent [事件名] - 删除一个事件
• /theclock broadcastWorld [世界名] [消息] - 向指定世界广播消息
• /theclock addNote - 添加一条笔记（管理员可用）
• /theclock groupevents list - 显示GUI以管理事件组
• /theclock start [事件组名] - 启动一个事件组
• /theclock stop [事件组名] - 停止一个事件组

权限节点

• theclock.admin - 管理员权限（红色聊天颜色）
• theclock.mod - moderator权限（橙色聊天颜色）
• 默认权限（绿色聊天颜色）
• OP玩家自动拥有所有权限，无需单独分配。

⭐告示牌使用

在告示牌上输入特定内容可以使其变成动态显示器

• 第一行输入：[theClock]
• 第二行输入以下任一关键词：
• TimeReal - 显示服务器现实时间
• TimeIngame - 显示游戏内时间
• TimeRemain - 显示最近事件的剩余时间

放置告示牌后，重启服务器或右键点击告示牌即可更新显示。

❓注意事项与提示

• 确保服务器 server.properties 文件中的 broadcast-console-to-ops=false，以避免控制台命令刷屏。
• 使用 @a, @r, @o 等选择器时，注意同一行命令不能混合使用多个不同选择器。
• 若要同时针对在线和离线玩家，请将命令分两行写。
• 插件从 1.3.0 版本开始，配置文件在更新时会自动合并，无需手动比对。
• 事件组管理命令（groupevents）仅在 ticker.yml 中创建节点，具体内容需要直接编辑文件。
• 笔记功能允许你点击笔记文本直接传送到记录地点。

💡简介

TheClock 是一款多功能时间与事件管理插件，允许管理员创建和管理服务器活动时间线，并为玩家提供便捷的时间查询功能。通过它，您可以安排未来事件、创建个人笔记、进行世界广播，甚至燃放烟花。

🎮管理员指令 (权限: theclock.admin)

管理员可以使用以下指令来管理插件核心功能。

事件管理

• /theclock AddEvent [EventName] [Date] [Hour] [Color_Title] [Color_Subtitle] [message]

在时间线中添加一个新事件。距离当前时间最近的事件将被优先显示。

• /theclock DeleteEvent [EventName]

删除一个指定的事件。

笔记管理

• /theclock addNote [Your Note Here]

创建一个笔记。此笔记可以记录位置，并用于之后传送回记录点。

• /theclock getNote

列出您创建的所有笔记。

• /theclock deleteNote [noteNumber]

根据编号删除一个笔记。

世界与群组管理

• /theclock loadMissWorld

如果世界是在服务器加载后创建的，使用此指令加载缺失的世界。

• /theclock groupEvents [list/add/remove] [groupName]

管理事件群组。这些群组是 ticker.yml 文件中的一系列“动作”。

• /theclock start [NameOfGroupEvents]

启动选定的事件群组。

• /theclock stop [NameOfGroupEvents]

停止选定的事件群组。

🎮模组指令 (权限: theclock.mod)

拥有模组权限的玩家可以使用以下实用指令。

广播与效果

• /theclock broadcastWorld [world] [message]

向指定世界的所有玩家广播一条消息。

• /theclock rocketStar [player] [NumberFireWorks]

在目标玩家执行指令时所处的位置，生成指定数量的烟花。

其他功能

• /theclock sign

列出所有可以放置的告示牌类型。

🎮玩家指令 (无需权限)

所有玩家均可使用以下基础指令。

信息查询

• /theclock help

显示帮助页面，列出根据您权限可用的所有指令。

• /theclock getCurrentTime

获取服务器的当前时间。

• /theclock getRemainTime

获取距离下一个已安排事件（通过 AddEvent 添加）的剩余时间。

• /theclock getEvents

获得一本记载所有即将到来事件的书。注意：管理员会获得一本特殊的书，可以随时删除其中列出的事件。

• /theclock getInfo

获取当前天气的剩余时间等其他信息。