原创 工具 ZKielFlightTime | 轻量化多功能飞行插件 支持vault和经验兑换时长 | 支持权限组补充时长 | 支持节假日无限时长飞行 | 可设世界是否允许飞行 1.0.0

# ============================================================
# FlightTime · Paper 1.21.8 飞行时长插件 默认配置
# 缩进只能用空格，出现 Tab 会让 Paper 启动报错
# 改完执行 /flight reload 生效；定时任务会一并重启，玩家时长数据不会重读
# 颜色支持 &a &b 这类传统写法与 &#RRGGBB 十六进制；%prefix% 会替换成 messages.prefix
# ============================================================
# ---- 通用设置 ----
settings: # 全局设置
timezone: 'Asia/Shanghai' # 所有定时按这个时区计算，服务器在境外务必改
check-interval-ticks: 20 # 状态检测间隔（tick），20 tick = 1 秒，一般不用改
count-elytra: false # 鞘翅滑翔是否也扣时长，false = 只有双击空格真正飞起来才扣
warn-seconds: [60, 30, 10] # 剩余时长低于这些秒数时提醒一次，[] = 不提醒
save-interval-seconds: 300 # data.yml 自动保存间隔（秒），关服时一定会保存
ignored-gamemodes: # 这些游戏模式的玩家不受管控，也不扣时长
- CREATIVE # 创造模式
- SPECTATOR # 旁观模式
allowed-worlds: [] # 允许飞行的世界名（根目录里的世界文件夹名），[] = 所有世界都允许
# ---- 飞行中的 BossBar ----
bossbar: # 玩家真正飞起来之后显示的顶部进度条，落地自动收起
enabled: true # 是否启用，false = 完全不显示
title: '&b飞行时长 &7| &f%left%' # 标题，可用 %left%（剩余时长）%status% %player%
color: BLUE # 颜色，可选 PINK BLUE RED GREEN YELLOW PURPLE WHITE
style: SOLID # 样式，可选 SOLID SEGMENTED_6 SEGMENTED_10 SEGMENTED_12 SEGMENTED_20
progress-minutes: 60 # 进度条满格对应多少分钟，剩余时长达到这个值就是满格
# ---- 一、定时开放无限飞行 ----
scheduled-flight: # 定时开放在线玩家的无限飞行，命中时间段不扣时长
enabled: true # 是否启用定时开放
require-permission: false # true = 还需要下面的权限节点，false = 全员开放
permission: 'flight.event' # require-permission 为 true 时要求的权限节点
broadcast: true # 开始与结束时是否全服提示
windows: # 时间段列表，每项可用 name/days/dates/start/end，另可选 permission
- name: '周末全天' # 活动名称，用于提示
days: [SATURDAY, SUNDAY] # 生效的星期，[] = 每天
start: '00:00' # 开始时间，与 end 相同 = 整天
end: '00:00' # 结束时间，'00:00' 表示到当天 24:00，这一分钟不含在内
- name: '工作日晚高峰' # 活动名称，用于提示
days: # 生效的星期，留空 = 每天
- MONDAY # 周一
- TUESDAY # 周二
- WEDNESDAY # 周三
- THURSDAY # 周四
- FRIDAY # 周五
start: '19:00' # 开始时间
end: '23:00' # 结束时间，23:00 这一分钟不含在内
- name: '国庆活动' # 活动名称，用于提示
dates: # 只在指定日期生效（yyyy-MM-dd），留空 = 不限日期
- '2026-10-01' # 10 月 1 日
- '2026-10-02' # 10 月 2 日
- '2026-10-03' # 10 月 3 日
start: '00:00' # 开始时间
end: '00:00' # 结束时间，'00:00' 表示到当天 24:00
# ---- 二、购买飞行时长 ----
shop: # 购买飞行时长
money: # 用 Vault 金币购买
enabled: true # 是否启用金币购买
price-per-minute: 100.0 # 每分钟价格，支持小数
min-minutes: 1 # 单次最少买多少分钟
max-minutes: 600 # 单次最多买多少分钟
max-total-minutes: 1440 # 买完后累计时长上限（分钟），0 = 不限
exp: # 用经验点购买，消耗的是经验点不是等级
enabled: true # 是否启用经验购买
exp-per-minute: 30 # 每分钟消耗多少经验点
min-minutes: 1 # 单次最少买多少分钟
max-minutes: 300 # 单次最多买多少分钟
max-total-minutes: 1440 # 买完后累计时长上限（分钟），0 = 不限
# ---- 三、权限组无限飞行 ----
unlimited: # 权限组无限飞行，命中即永久不消耗时长
groups: [] # 组名列表，大小写不敏感，也可直接给该组加 flight.unlimited 节点
# 示例
# groups:
# - vip
# - svip
# ---- 四、按权限组定时发放飞行时长 ----
scheduled-grants: # 按权限组定时发放时长，到点不在线可在进服时补发
enabled: true # 是否启用定时发放
grants: # 发放列表，每项是一个权限组的额度
- id: 'vip-daily' # 唯一标识，用于记录今天是否已经发过
group: 'vip' # 权限组名
minutes: 60 # 每次发放多少分钟
time: '00:00' # 每天几点发放（HH:mm）
days: [] # 星期几发放，[] = 每天，也可写 [MONDAY, FRIDAY]
announce: true # 发放时是否给收到的人发提示
apply-on-join: true # 到点不在线的成员，进服时补发当天额度
run-if-missed: true # 到点时服务器没开，启动后是否立刻补发
- id: 'svip-daily' # 唯一标识，用于记录今天是否已经发过
group: 'svip' # 权限组名
minutes: 180 # 每次发放多少分钟
time: '00:00' # 每天几点发放（HH:mm）
days: [] # 星期几发放，[] = 每天
announce: true # 发放时是否给收到的人发提示
apply-on-join: true # 到点不在线的成员，进服时补发当天额度
run-if-missed: true # 到点时服务器没开，启动后是否立刻补发
# ---- 提示文本 ----
messages: # 提示文本，占位符见各行的说明
prefix: '&8[&b飞行&8] &r' # 全局前缀，会替换各文本里的 %prefix%
no-permission: # 没有权限时
'%prefix%&c你没有权限执行这个操作'
player-only: # 控制台执行玩家专用命令时
'%prefix%&c这个命令只能由玩家执行'
unknown-command: # 输入了不存在的子命令时
'%prefix%&c未知子命令，输入 &f/flight help &c查看帮助'
invalid-number: # 分钟数不是数字时
'%prefix%&c请输入大于 0 的整数'
player-not-found: # 找不到目标玩家时，可用 %player%
'%prefix%&c找不到玩家 &f%player%'
reloaded: # 执行 /flight reload 成功后
'%prefix%&a配置已重载'
time-self: # 查询自己剩余时长时，可用 %time% %left%
'%prefix%&7剩余飞行时长: &b%time%'
time-self-unlimited: # 查询自己且处于无限飞行时
'%prefix%&7当前状态: &d无限飞行'
time-zero: # 查询自己没有剩余时长时
'%prefix%&7你当前没有飞行时长，可用 &f/flight buy <分钟> &7购买'
time-other: # 查询别人剩余时长时，可用 %player% %time% %left%
'%prefix%&7玩家 &f%player% &7剩余飞行时长: &b%time%'
time-other-unlimited: # 查询别人且对方无限飞行时，可用 %player%
'%prefix%&7玩家 &f%player% &7当前状态: &d无限飞行'
flight-expired: # 飞行中途时长用尽时
'%prefix%&c飞行时长已用尽，飞行已关闭'
flight-warn: # 剩余时长达到提醒阈值时，可用 %time% %left%
'%prefix%&e飞行时长仅剩 &c%time%&e，请尽快降落'
fly-on: # 用 /fly 开启飞行时，可用 %left%
'%prefix%&a已开启飞行 &7| &f剩余 %left%&7，双击空格起飞'
fly-off: # 用 /fly 关闭飞行时
'%prefix%&e已关闭飞行 &7，在空中会开始下坠'
fly-no-time: # 用 /fly 但没有任何可飞时长时
'%prefix%&c你没有可飞的飞行时长，请先 &f/flight buy <分钟> &c购买'
fly-world-denied: # 在不在 allowed-worlds 里的世界用 /fly 时
'%prefix%&c当前世界不允许飞行'
event-start: # 定时开放活动开始时，可用 %name% %end%
'%prefix%&a全服无限飞行「&f%name%&a」已开始，结束时间 &f%end%'
event-end: # 定时开放活动结束时，可用 %name%
'%prefix%&7全服无限飞行「&f%name%&7」已结束'
event-status-active: # 用 /flight status 且有活动进行中时，可用 %name% %end%
'%prefix%&a正在进行的活动: &f%name% &7(结束于 %end%)'
event-status-none: # 用 /flight status 且当前没有活动时
'%prefix%&7当前没有定时开放活动'
shop-no-economy: # 服务器没有 Vault 经济却用金币购买时
'%prefix%&c服务器未接入 Vault 经济，无法用金币购买'
shop-disabled: # 该购买方式在配置里关闭时
'%prefix%&c该购买方式已关闭'
shop-usage-money: # 金币购买没写分钟数时
'%prefix%&7用法: &f/flight buy <分钟>'
shop-usage-exp: # 经验购买没写分钟数时
'%prefix%&7用法: &f/flight buyxp <分钟>'
shop-limit: # 分钟数超出单次范围时，可用 %min% %max%
'%prefix%&c单次只能购买 &f%min% &c~ &f%max% &c分钟'
shop-max-total: # 加上本次会超过累计上限时，可用 %max%
'%prefix%&c累计飞行时长已达上限 &f%max% &c分钟'
shop-no-money: # 金币不足时，可用 %price% %balance%
'%prefix%&c金币不足，需要 &f%price% &c，你只有 &f%balance%'
shop-no-exp: # 经验点不足时，可用 %price% %balance%
'%prefix%&c经验点不足，需要 &f%price% &c，你只有 &f%balance%'
shop-failed: # 扣款失败（经济插件报错）时
'%prefix%&c扣款失败，本次购买已取消'
shop-success-money: # 金币购买成功时，可用 %time% %price% %total%
'%prefix%&a购买成功 &f+%time% &7(-%price% 金币)，当前剩余 &f%total% &7，输入 &f/fly &7开启飞行'
shop-success-exp: # 经验购买成功时，可用 %time% %price% %total%
'%prefix%&a购买成功 &f+%time% &7(-%price% 经验点)，当前剩余 &f%total% &7，输入 &f/fly &7开启飞行'
admin-give: # 管理员执行 give 成功时，可用 %player% %time% %total%
'%prefix%&a已给 &f%player% &a增加 &f%time%&a，当前剩余 &f%total%'
admin-take: # 管理员执行 take 成功时，可用 %player% %time% %total%
'%prefix%&e已从 &f%player% &e扣除 &f%time%&e，当前剩余 &f%total%'
admin-set: # 管理员执行 set 成功时，可用 %player% %time%
'%prefix%&a已将 &f%player% &a的时长设为 &f%time%'
admin-reset: # 管理员执行 reset 成功时，可用 %player%
'%prefix%&a已清空 &f%player% &a的飞行时长'
admin-received: # 被管理员加时长时发给玩家，可用 %time%
'%prefix%&a管理员给你增加了 &f%time% &a飞行时长'
admin-taken: # 被管理员扣时长时发给玩家，可用 %time%
'%prefix%&c管理员扣除了你 &f%time% &c飞行时长'
grant-received: # 收到定时发放的额度时，可用 %name% %time%
'%prefix%&a你获得了「&f%name%&a」发放的 &f%time% &a飞行时长'
help: # /flight help 的输出，每行一条
- '&8&m---------- &bFlightTime &8&m----------'
- '&f/flight &7- 查看自己的飞行时长'
- '&f/fly &7- 打开或关闭飞行（下线自动关闭）'
- '&f/flight buy <分钟> &7- 用金币购买飞行时长'
- '&f/flight buyxp <分钟> &7- 用经验值购买飞行时长'
- '&f/flight check <玩家> &7- 查看别人的飞行时长'
- '&f/flight status &7- 查看当前定时开放活动'
- '&f/flight give <玩家|all> <分钟> &7- 增加时长'
- '&f/flight take <玩家|all> <分钟> &7- 扣减时长'
- '&f/flight set <玩家|all> <分钟> &7- 设为指定时长'
- '&f/flight reset <玩家|all> &7- 清空时长'
- '&f/flight reload &7- 重载配置'
- '&8&m------------------------------'