NoTime

按真实时间执行命令、限制登录时段。支持 Bukkit、Spigot、Paper 和 Folia。 English

下载与发布平台 · Downloads

简介 · Overview

用一份配置完成开服公告、整点提醒、每周奖励、重启倒计时，以及指定时段禁止进服。时间按服务器本机时钟计算，不需要数据库。

特性 · Features

• 登录限制：按时间段拦截进服；限制开始时可踢出已在线玩家
• 白名单 / 黑名单：默认白名单放行；blacklist 里只要有真实玩家名就会改成只拦名单内的人
• 反向窗口：opposite: true 时，受影响玩家只能在设定时段内进入
• 定时命令：每天一个时间点、一天多个时间点，或按间隔循环
• 星期 / 日期条件：命令串里用 week= / 周=、month= / 月= 限定执行日
• Folia：自动检测运行环境，调度走 Folia 兼容接口
• 可选 PlaceholderAPI：解析任务里的变量，并提供下次执行倒计时

生成的 config.yml 是中英双语注释，完整示例见 src/config.yml。

前置要求 · Requirements

• PlaceholderAPI：仅在需要解析 %变量% 或使用 NoTime 倒计时变量时安装

Minecraft 1.8 到 26.2，Java 8 或更新版本。plugin.yml 的 api-version 为 1.13，更低版本一般也能加载。

安装 · Installation

1. 从 GitHub Releases 下载最新 JAR
2. 放入服务器 plugins 目录
3. 启动一次以生成 plugins/NoTime/config.yml
4. 改完配置后执行 /notime reload

命令与权限 · Commands

命令	权限	说明
/notime	notime.admin	列出子命令
/notime reload	notime.admin	重载配置并重建全部定时任务
/notime test <任务名>	notime.admin	立刻执行指定任务（仍会判断 week= / month=）

notime.admin 默认给 OP。

登录限制 · Login limits

notime:
  enable: true
  whitelist:
    - "YourName"
  blacklist:
    - ""
  start: "00:00"
  end: "07:00"
  kick-message: "&c[防沉迷] &b%start% &f至 &b%end% &f时间段内不能进入"
  kick-old: true
  opposite: false

• kick-message 支持 %start%、%end%、& 颜色码；要输出字面 & 时写成 &&
• kick-old: true 时，插件加载或 /notime reload 若正处在限制时段，会踢出受影响的在线玩家
• 空的 blacklist 项（例如 ""）不会开启黑名单模式

定时任务 · Scheduled tasks

时间格式为 HH:mm 或 HH:mm:ss。每天一个时间点：

run:
  "早安问候":
    enable: true
    time: "08:00"
    command:
      - "@m &a早上好！祝您游戏愉快~"

time 写成列表时，每一行时间和同一位置的命令一一对应：

run:
  "自动重启":
    enable: false
    time:
      - "02:55"
      - "02:59"
      - "03:00"
    command:
      - "@m &c服务器将在 &35分钟 &c后重启"
      - "@m &c服务器将在 &31分钟 &c后重启"
      - "@k &c服务器正在重启;@s"

fortime 按间隔循环，单位可组合：s 秒、m 分、h 时、d 天。间隔从插件加载时开始计，不绑墙上的整点；/notime reload 会把间隔重新从零算。

run:
  "自动公告":
    enable: true
    fortime: "10m"
    command:
      - "@m &a服务器交流群：123456789"
      - "@m &d祝您游戏愉快~"

星期与每月几号 · Weekday and month-day

条件写在用 ; 连接的命令串开头。当天不匹配时，这条串后面的动作全部跳过。

run:
  "每周任务":
    enable: true
    time: "12:30"
    command:
      - "week=1;@m &e周一奖励已发放"
      - "周=1;@all give @name@ cooked_chicken"

  "每月任务":
    enable: true
    time: "12:30"
    command:
      - "month=1;@m &e每月 1 号福利"
      - "月=1;@all give @name@ diamond 1"

• week=1 到 week=7 表示周一到周日，也可用 周=，或写成 星期一 这类中文
• month=1 到 month=31 表示每月几号，也可用 月=
• 这些是命令字符串里的条件，不是独立的 YAML 键

配合排行榜、奖励类插件时，NoTime 只负责到点执行它们的命令，并不自带排行榜。

动作前缀 · Actions

前缀	说明	示例
@m	向全体在线玩家广播	@m &a服务器重启通知
@all	以后台身份为每个在线玩家执行一条命令，@name@ 替换为该玩家名	@all give @name@ apple
@all_command	让每个在线玩家自己执行该命令	@all_command spawn
@k	按当前黑白名单踢出受影响的在线玩家	@k &c维护时间到了
@s	关闭服务器	@s
@papi	本条命令不解析 PlaceholderAPI 变量，把 %变量% 当原文交给后面的命令	@papi papi parse me %player_name%

没有 @ 前缀的条目以后台执行。一条配置里可用 ; 串多条动作。已安装 PlaceholderAPI 时，默认会先解析变量；其它插件需要拿到带 % 的原文时再加 @papi。

启动命令 · Startup commands

插件启用约 1 秒后执行，完整重启后也会再跑一遍。这里只走后台原生命令，不解析 @m、week= 等定时任务前缀。

startcommand:
  enable: false
  commands:
    - "say 开服时执行命令1"
    - "say 开服时执行命令2"

PlaceholderAPI · Placeholders

任务命令里可以直接写其它插件的 %变量%。NoTime 自己提供距离下次执行的倒计时：

%notime_<任务名>_s%
%notime_<任务名>_m%
%notime_<任务名>_h%
%notime_<任务名>_d%

末尾字母分别是秒、分、时、天。占位符用下划线分段，任务名不要带下划线，否则会对不上。

配置注意 · Notes

• 任务时间使用服务器本机本地时间
• 单个 time 每天执行一次；time 列表按行配对命令
• fortime 从加载插件时起算，不是墙上时钟
• /notime reload 会重建调度器，循环任务的间隔会重新开始
• 未安装 PlaceholderAPI 时，定时和登录限制仍然可用

常见问题 · FAQ

只想拦某几个人、其他人随时能进？
在 blacklist 里写上这些玩家名。名单里有真实名字后会进入黑名单模式，白名单不再生效。

定时任务没跑？
确认该任务 enable: true，时间是 HH:mm 或 HH:mm:ss，以及 week= / month= 是否把今天排除了。循环任务在重载后会重新计时。

/notime test 为什么没执行奖励？
测试命令同样会判断星期和日期条件，今天对不上就会跳过后面的动作。

支持哪些版本？Folia 能用吗？
面向 1.8–26.2。Bukkit、Spigot、Paper 和 Folia 都会自动适配。

支持与反馈 · Support

• QQ 群：620224543
• Issues：提交问题
• GitHub Releases
• Modrinth
• MineBBS
• 苦力怕论坛

如果觉得好用，请给个 ⭐ Star 支持一下！

使用统计 · Metrics