Skip to content

时间、逻辑与类型

时间函数

时间戳

  • 用法:时间戳()
  • 参数:无
  • 返回值:long
text
开始毫秒 = 时间戳()
副本.设置变量("开始毫秒", 开始毫秒)

秒级时间戳

  • 用法:秒级时间戳()
  • 参数:无
  • 返回值:long
text
记录秒 = 秒级时间戳()
日志("记录时间: " + 记录秒)

日期

  • 用法:日期()
  • 参数:无
  • 返回值:String
text
今日日期 = 日期()
消息.发送("&7今日日期: " + 今日日期)

时间

  • 用法:时间()
  • 参数:无
  • 返回值:String
text
当前时刻 = 时间()
日志("脚本触发时间: " + 当前时刻)

日期时间

  • 用法:日期时间()
  • 参数:无
  • 返回值:String
text
完整时间 = 日期时间()
副本.设置变量("上次触发时间", 完整时间)

小时

  • 用法:小时()
  • 参数:无
  • 返回值:int
text
if 小时() >= 20 {
    消息.广播("&e当前已经进入晚间活动时段")
}

分钟

  • 用法:分钟()
  • 参数:无
  • 返回值:int
text
当前分钟 = 分钟()
日志("当前分钟: " + 当前分钟)

  • 用法:秒()
  • 参数:无
  • 返回值:int
text
当前秒数 = 秒()
副本.设置变量("当前秒数", 当前秒数)

星期

  • 用法:星期()
  • 参数:无
  • 返回值:int
text
if 星期() == 1 {
    消息.广播("&6周日双倍活动已开启")
}

  • 用法:日()
  • 参数:无
  • 返回值:int
text
本月日期 = 日()
日志("今天是本月第 " + 本月日期 + " 天")

  • 用法:月()
  • 参数:无
  • 返回值:int
text
当前月份 = 月()
副本.设置变量("活动月份", 当前月份)

  • 用法:年()
  • 参数:无
  • 返回值:int
text
当前年份 = 年()
日志("当前年份: " + 当前年份)

秒转tick

  • 用法:秒转tick(秒数)
  • 参数:秒数
  • 返回值:long
text
等待Tick = 秒转tick(3)
流程.等待(等待Tick)
消息.广播("&e三秒倒计时结束")

tick转秒

  • 用法:tick转秒(tick)
  • 参数:tick 数
  • 返回值:double
text
等待秒数 = tick转秒(120)
消息.发送("&7本次等待时长: " + 等待秒数 + " 秒")

格式化时长

  • 用法:格式化时长(秒数)
  • 参数:秒数
  • 返回值:String
text
显示用时 = 格式化时长(125)
消息.广播("&b当前用时: " + 显示用时)

逻辑函数

限制范围

  • 用法:限制范围(值, 最小值, 最大值)
  • 参数:值、最小值、最大值
  • 返回值:double
text
实际倍率 = 限制范围(玩家倍率, 1.0, 3.0)
副本.设置变量("实际倍率", 实际倍率)

范围判断

  • 用法:范围判断(值, 最小值, 最大值)
  • 参数:值、最小值、最大值
  • 返回值:boolean
text
if 范围判断(@player.level, 30, 60) {
    消息.发送("&a你的等级符合本阶段要求")
}

非空值

  • 用法:非空值(值1, 值2, ...)
  • 参数:1 个或更多值
  • 返回值:第一个非空值
text
公告文本 = 非空值(副本.读取变量("公告"), "当前没有公告")
消息.广播("&e" + 公告文本)

空值替代

  • 用法:空值替代(值, 备用值)
  • 参数:值、备用值
  • 返回值:原值或备用值
text
Boss名称 = 空值替代(副本.读取变量("Boss名称"), "未知Boss")
消息.广播("&c当前 Boss: " + Boss名称)

条件

  • 用法:条件(条件, 成立值, 不成立值)
  • 参数:条件、成立值、不成立值
  • 返回值:成立值或不成立值
text
难度文本 = 条件(副本.存活人数() <= 2, "危险", "稳定")
消息.广播("&e当前局势: " + 难度文本)

全满足

  • 用法:全满足(条件1, 条件2, ...)
  • 参数:1 个或更多条件
  • 返回值:boolean
text
if 全满足(阶段.当前() == "Boss阶段", 副本.存活人数() >= 3, 副本.结束中() == false) {
    消息.广播("&aBoss 阶段状态正常")
}

任一满足

  • 用法:任一满足(条件1, 条件2, ...)
  • 参数:1 个或更多条件
  • 返回值:boolean
text
if 任一满足(@player.health <= 6, @player.food <= 6) {
    消息.发送("&c你的状态已经比较危险")
}

类型函数

转整数

  • 用法:转整数(值)
  • 参数:任意值
  • 返回值:int
text
次数 = 转整数("12")
玩家.设置变量("可用次数", 次数)

转小数

  • 用法:转小数(值)
  • 参数:任意值
  • 返回值:double
text
倍率 = 转小数("1.35")
副本.设置变量("奖励倍率", 倍率)

转布尔

  • 用法:转布尔(值)
  • 参数:任意值
  • 返回值:boolean
text
开关 = 转布尔("true")
if 开关 {
    消息.广播("&a机关已开启")
}

转文本

  • 用法:转文本(值)
  • 参数:任意值
  • 返回值:String
text
显示层数 = 转文本(层.当前())
消息.广播("&e当前层数: " + 显示层数)

是否数字

  • 用法:是否数字(值)
  • 参数:任意值
  • 返回值:boolean
text
if 是否数字(副本.读取变量("奖励倍率")) {
    消息.发送("&a奖励倍率配置有效")
}

是否布尔

  • 用法:是否布尔(值)
  • 参数:任意值
  • 返回值:boolean
text
if 是否布尔("false") {
    日志("当前输入可以被识别成布尔值")
}

TQ Minecraft Server Plugin Docs