原创 闭源 娱乐 SurvivalFlyPlugin-简单好用的生存飞行插件 1.1.0

增加了游戏模式的逻辑检测，防止创造或旁观模式玩家的飞行被插件一并清除

1.此次更新删除了部分重复变量，详情见下表。
2.因插件兼容原因，本插件放弃对Folia服务端的支持。
3.修复了无限飞行的bug。
注意！！！因删除了部分变量，导致config.yml文件中的部分变量失效，建议保留备份后删除config.yml重新生成。您也可以参照以下变量展示按需改动！！！
变量展示：

YAML：

# ============================================
# SurvivalFlyPlugin 占位符完整列表
# 所有占位符格式: %fly_变量名%
# ============================================


# ============================================
# 一、玩家相关
# ============================================
%fly_player%: "玩家名称"
  # 示例: Steve


# ============================================
# 二、飞行状态
# ============================================
%fly_status%: "飞行状态文字"
  # 示例: 飞行中 / 已关闭

%fly_status_icon%: "飞行状态图标"
  # 示例: ✈ / ⏹

%fly_is_flying%: "是否在飞行（布尔值）"
  # 示例: true / false


# ============================================
# 三、飞行时间（推荐使用）
# ============================================

# ---------- 带单位（中文） ----------
%fly_time%: "中文完整时间"
  # 示例: 1天2小时30分钟
  # 适用场景: 玩家消息、GUI显示

%fly_time_short%: "英文简短时间"
  # 示例: 1d2h30m
  # 适用场景: 记分板、紧凑显示

# ---------- 纯数字 ----------
%fly_time_total_minutes%: "总分钟数"
  # 示例: 1590

%fly_time_total_seconds%: "总秒数"
  # 示例: 95400

%fly_time_days%: "天数"
  # 示例: 1

%fly_time_hours%: "小时数（不含天）"
  # 示例: 2

%fly_time_minutes%: "分钟数（不含小时）"
  # 示例: 30

%fly_time_seconds%: "秒数（不含分钟）"
  # 示例: 0

# ---------- 补零格式 ----------
%fly_time_days_pad%: "天数（补零）"
  # 示例: 01

%fly_time_hours_pad%: "小时数（补零）"
  # 示例: 02

%fly_time_minutes_pad%: "分钟数（补零）"
  # 示例: 30

%fly_time_seconds_pad%: "秒数（补零）"
  # 示例: 00

# ---------- 组合格式（中文） ----------
%fly_time_dhm%: "天/小时/分钟/秒"
  # 示例: 1天2小时30分钟0秒

%fly_time_hms%: "小时/分钟/秒"
  # 示例: 2小时30分钟0秒

%fly_time_ms%: "分钟/秒"
  # 示例: 30分钟0秒

%fly_time_hm%: "小时/分钟"
  # 示例: 2小时30分钟

# ---------- 组合格式（英文简短） ----------
%fly_time_dhm_short%: "天/小时/分钟/秒（英文）"
  # 示例: 1d2h30m0s

%fly_time_hms_short%: "小时/分钟/秒（英文）"
  # 示例: 2h30m0s

%fly_time_ms_short%: "分钟/秒（英文）"
  # 示例: 30m0s

%fly_time_hm_short%: "小时/分钟（英文）"
  # 示例: 2h30m


# ============================================
# 四、缓降
# ============================================
%fly_slowfall%: "缓降状态文字"
  # 示例: 开启 / 关闭

%fly_slowfall_icon%: "缓降状态图标"
  # 示例: 🪂 / ❌

%fly_slowfall_duration%: "缓降总时长（秒）"
  # 示例: 15

%fly_slowfall_seconds%: "缓降剩余秒数"
  # 示例: 8


# ============================================
# 五、经济
# ============================================
%fly_money%: "玩家余额（整数）"
  # 示例: 100

%fly_currency%: "货币名称"
  # 示例: Points / dollars


# ============================================
# 六、其他
# ============================================
%fly_custom_data%: "自定义数据数量"
  # 示例: 5


# ============================================
# 七、使用场景示例
# ============================================

# ---------- 消息中使用 ----------
messages:
  fly-enabled: '&a%fly_player% 飞行已开启！剩余 %fly_time%'
  fly-disabled: '&e%fly_player% 飞行已关闭，剩余 %fly_time% 已保留'
  fly-expired: '&c%fly_player% 飞行时间已用完！正在启动缓降...'
  no-flight-time: '&c%fly_player% 没有飞行时间！请购买套餐。'
  insufficient-funds: '&c%fly_player% 资金不足！需要 %cost% %currency%。'
  slow-fall-start: '&a🪂 %fly_player% 已开启缓降效果，持续 %fly_slowfall_duration% 秒！'
  slow-fall-remaining: '&7🪂 %fly_player% 缓降剩余: &e%fly_slowfall_seconds% &7秒'
  rejoin-slowfall: '&a🪂 %fly_player% 欢迎回来！给予 %fly_slowfall_duration% 秒缓降保护'
  time-remaining: '&b%fly_player% 剩余时间: %fly_time%'

# ---------- GUI 中使用 ----------
gui:
  buttons:
    info:
      lore:
      - '&7剩余时间: &e%fly_time%'
      - '&7总余额: &e%fly_time_total_minutes% 分钟'

    slowfall_toggle:
      lore:
      - '&7当前状态: %fly_slowfall%'

# ---------- 套餐中使用 ----------
packages:
  list:
    basic:
      lore:
      - '&7飞行时长: &e%fly_time%'

# ---------- 记分板中使用 ----------
# 需要 PlaceholderAPI 支持
scoreboard:
  lines:
    - '&7状态: %fly_status_icon% %fly_status%'
    - '&7时间: %fly_time%'
    - '&7余额: %fly_money% %fly_currency%'
    - '&7缓降: %fly_slowfall_icon% %fly_slowfall%'


# ============================================
# 八、快速推荐
# ============================================

# 用途 → 推荐占位符
"显示完整时间（中文）": "%fly_time%"
"显示简短时间（英文）": "%fly_time_short%"
"显示总分钟数": "%fly_time_total_minutes%"
"显示玩家名称": "%fly_player%"
"显示飞行状态": "%fly_status%"
"显示缓降状态": "%fly_slowfall%"
"显示余额": "%fly_money%"
"显示货币": "%fly_currency%"
"显示缓降剩余秒数": "%fly_slowfall_seconds%"
"显示自定义数据数量": "%fly_custom_data%"


# ============================================
# 九、兼容占位符（不推荐使用，可能在未来版本移除）
# ============================================
# 以下占位符仅为兼容旧配置保留，建议全部替换为 %fly_ 格式
%player%: "→ 请使用 %fly_player%"
%status%: "→ 请使用 %fly_slowfall%"
%remaining%: "→ 请使用 %fly_time%"
%balance%: "→ 请使用 %fly_time_total_minutes%"
%minutes%: "→ 请使用 %fly_time_minutes%"
%seconds%: "→ 请使用 %fly_time_seconds%"
%duration%: "→ 请使用 %fly_time%"
%currency%: "→ 请使用 %fly_currency%"

1.此次更新添加了变量，可供服主将其显示在记分板上或所有支持变量显示的地方(需要安装PlaceholderAPI插件:https://modrinth.com/plugin/placeholderapi)
2.删除/flygui打开gui的命令。自插件1.0.3版本(包括1.0.3版本)后请输入/fly以打开gui
3.添加/fly on/off以供玩家快速打开飞行或关闭飞行
此次添加的变量:

YAML：

# ============================================
# 生存飞行插件变量（用于 PlaceholderAPI / 记分板 / 其他插件）
# ============================================

# ---------- 玩家相关 ----------
%fly_player%: "玩家名称"                    # 示例: Steve
%fly_player_uuid%: "玩家UUID"              # 示例: f47ac10b-58cc-4372-a567-0e02b2c3d479
%fly_player_displayname%: "玩家显示名称"   # 示例: §aSteve

# ---------- 飞行状态 ----------
%fly_status%: "飞行状态文字"               # 示例: 飞行中 / 已关闭
%fly_status_icon%: "飞行状态图标"          # 示例: ✈ / ⏹
%fly_is_flying%: "是否在飞行"              # 示例: true / false

# ---------- 剩余时间 ----------
%fly_time%: "剩余时间（中文）"              # 示例: 1小时30分钟
%fly_time_short%: "剩余时间（简短）"        # 示例: 1h30m
%fly_time_minutes%: "剩余时间（分钟）"      # 示例: 90
%fly_time_seconds%: "剩余时间（秒）"        # 示例: 5400
%fly_time_days%: "剩余天数"                 # 示例: 1
%fly_time_hours%: "剩余小时数"              # 示例: 2
%fly_time_minutes_only%: "剩余分钟数（不含小时）" # 示例: 30
%fly_time_seconds_only%: "剩余秒数（不含分钟）"  # 示例: 45

# ---------- 缓降 ----------
%fly_slowfall%: "缓降状态文字"              # 示例: 开启 / 关闭
%fly_slowfall_icon%: "缓降状态图标"         # 示例: 🪂 / ❌

# ---------- 经济 ----------
%fly_money%: "玩家余额（整数）"             # 示例: 100
%fly_money_formatted%: "玩家余额（格式化）" # 示例: 100.00 Points
%fly_currency%: "货币名称"                  # 示例: Points / dollars

# ---------- 自定义数据 ----------
%fly_custom_data%: "自定义数据数量"         # 示例: 5


# ============================================
# 使用场景示例
# ============================================

# ---------- 记分板配置 ----------
scoreboard:
  title: "&6&l飞行信息"
  lines:
    - "&7&m------------------"
    - "  &6玩家: &f%fly_player%"
    - "  &6状态: %fly_status_icon% %fly_status%"
    - "  &6时间: %fly_time%"
    - "  &6余额: %fly_money% %fly_currency%"
    - "  &6缓降: %fly_slowfall_icon% %fly_slowfall%"
    - "&7&m------------------"

# ---------- 聊天格式 ----------
chat:
  format: "&7[%fly_status_icon%] &f%player%: &7%message%"

# ---------- 插件消息 ----------
messages:
  fly-enabled: "&a%player% 飞行已开启！剩余 %time%"
  fly-disabled: "&e%player% 飞行已关闭，剩余 %time% 已保留"
  fly-expired: "&c%player% 飞行时间已用完！"
  time-remaining: "&b剩余时间: %time%"
  insufficient-funds: "&c资金不足！需要 %cost% %currency%。"


# ============================================
# 显示效果示例
# ============================================

# 玩家 Steve 正在飞行，剩余 1小时30分钟，余额 100 Points：
#
# 记分板显示：
# --------------------
#   ✈ 飞行信息
#   玩家: Steve
#   状态: ✈ 飞行中
#   时间: 1小时30分钟
#   余额: 100 Points
#   缓降: 🪂 开启
# --------------------
#
# 聊天显示：
# [✈] Steve: 大家好！
#
# 消息显示：
# [飞行] Steve 飞行已开启！剩余 1小时30分钟

此次更新添加了vault经济支持，并允许在配置文件中配置
配置文件（如果你是在1.0.0版本升级到1.0.2，请在config.yml中加入"version: 1.0.0"字样，不用加双引号）：

YAML：

# SurvivalFlyPlugin 配置文件
# 请勿手动修改此项，插件会自动管理
version: 1.0.2

# ========== 经济设置 ==========
economy:
  # 经济系统类型: PLAYERPOINTS 或 VAULT
  # PLAYERPOINTS - 使用 PlayerPoints 插件
  # VAULT - 使用 Vault 经济系统
  type: PLAYERPOINTS
  enable-bypass: true

# ========== 缓降设置 ==========
slow-fall:
  # 缓降持续时间（秒）
  duration: 15
  # 是否启用缓降效果
  enabled: true
  # 缓降提醒间隔（秒），0为不提醒
  reminder-interval: 2
  # 玩家离线时是否自动关闭飞行（默认开启）
  auto-disable-on-quit: true
  # 重新进服时缓降持续时间（秒），0为不给予缓降
  rejoin-slowfall-duration: 5

# ========== 套餐设置 ==========
packages:
  enabled: true
  list:
    basic:
      name: '&a经济套餐'
      material: GOLD_INGOT
      price: 30
      duration: 20
      slot: 10
      lore:
      - '&7飞行时长: &e20 分钟'
      - '&7价格: &6%price% %currency%'
      - '&7节省: &a10 %currency%'
      - ''
      - '&e点击购买并开启飞行！'
    
    premium:
      name: '&6豪华套餐'
      material: DIAMOND
      price: 50
      duration: 40
      slot: 11
      lore:
      - '&7飞行时长: &e40 分钟'
      - '&7价格: &6%price% %currency%'
      - '&7节省: &a30 %currency%'
      - ''
      - '&e点击购买并开启飞行！'
    
    ultimate:
      name: '&d&l至尊套餐'
      material: NETHER_STAR
      price: 110
      duration: 100
      slot: 12
      lore:
      - '&7飞行时长: &e100 分钟'
      - '&7价格: &6%price% %currency%'
      - '&7节省: &a100 %currency%'
      - ''
      - '&e点击购买并开启飞行！'
    
    monthly:
      name: '&b&l5小时套餐'
      material: EMERALD
      price: 300
      duration: 300
      slot: 14
      lore:
      - '&7飞行时长: &e300 分钟 (5小时)'
      - '&7价格: &6%price% %currency%'
      - '&7节省: &a300 %currency%'
      - ''
      - '&e点击购买并开启飞行！'
    
    seasonal:
      name: '&5&l1000分钟套餐'
      material: EMERALD_BLOCK
      price: 800
      duration: 1000
      slot: 15
      lore:
      - '&7飞行时长: &e1000 分钟 (16.6小时)'
      - '&7价格: &6%price% %currency%'
      - '&7节省: &a800 %currency%'
      - ''
      - '&e点击购买并开启飞行！'
    
    yearly:
      name: '&c&lVIP卡套餐'
      material: BEACON
      price: 1500
      duration: 5000
      slot: 16
      lore:
      - '&7飞行时长: &e5000 分钟 (83小时)'
      - '&7价格: &6%price% %currency%'
      - '&7节省: &a2500 %currency%'
      - ''
      - '&e点击购买并开启飞行！'

# ========== GUI设置 ==========
gui:
  title: '&b&l飞行控制台'
  size: 27
  buttons:
    enable:
      material: FEATHER
      name: '&a&l开启飞行'
      lore:
      - '&7当前飞行时间: &e%balance% 分钟'
      - ''
      - '&7点击开启飞行！'
      slot: 11
    
    disable:
      material: BARRIER
      name: '&c&l关闭飞行'
      lore:
      - '&7点击关闭飞行'
      - '&7剩余时间将保留'
      slot: 13
    
    info:
      material: CLOCK
      name: '&b&l飞行状态'
      lore:
      - '&7剩余时间: &e%remaining% 分钟'
      - '&7总余额: &e%balance% 分钟'
      - ''
      - '&7点击刷新'
      slot: 15
    
    packages:
      material: CHEST
      name: '&d&l飞行套餐'
      lore:
      - '&7购买飞行套餐获得飞行时间'
      - ''
      - '&e点击查看套餐'
      slot: 22
    
    slowfall_toggle:
      material: ELYTRA
      name: '&b&l缓降设置'
      lore:
      - '&7当前状态: %status%'
      - ''
      - '&7开启后飞行结束时自动缓降'
      - '&e点击切换'
      slot: 4

# ========== 消息设置 ==========
messages:
  prefix: '&8[&b飞行&8]&r '
  no-permission: '&c你没有权限使用此命令！'
  player-only: '&c此命令只能由玩家执行！'
  already-flying: '&c你已经处于飞行状态了！'
  not-flying: '&c你当前并没有在飞行。'
  fly-enabled: '&a飞行已开启！剩余 %duration% 分钟。'
  fly-disabled: '&e飞行已关闭，剩余 %remaining% 分钟已保留。'
  fly-expired: '&c飞行时间已用完！正在启动缓降...'
  insufficient-funds: '&c资金不足！需要 %cost% %currency%。'
  time-remaining: '&b飞行剩余时间: &e%minutes% 分 %seconds% 秒'
  reloaded: '&a配置文件已重载！'
  player-not-found: '&c找不到玩家: %player%'
  package-purchased: '&a成功购买 %package%！获得 %duration% 分钟飞行时间！'
  package-already-flying: '&c你正在飞行中！请先关闭飞行再购买套餐。'
  package-gui-title: '&d&l飞行套餐购买'
  package-not-found: '&c无效的套餐！'
  no-flight-time: '&c你没有飞行时间！请购买套餐。'
  slow-fall-start: '&a🪂 已开启缓降效果，持续 %duration% 秒！'
  slow-fall-end: '&7缓降效果已结束'
  slow-fall-remaining: '&7🪂 缓降剩余: &e%seconds% &7秒'
  slow-fall-enabled: '&a缓降已开启'
  slow-fall-disabled: '&c缓降已关闭'
  rejoin-slowfall: '&a🪂 欢迎回来！给予 %duration% 秒缓降保护'
  economy-not-available: '&c经济系统不可用！请联系管理员。'

1.新增进服缓降，防止退服前处于空中摔死，时长可配置
2.新增退服自动关闭飞行，防止玩家因为忘记关闭飞行退服持续计费，可配置是否开关
3.新增版本检测，自动转换数据文件格式（格式更改）及配置文件，如可以建议让插件重新生成，因为插件直接在老文件添加新配置项无注释(在删除老配置文件前记得备份哦awa)
4.添加/flycustom用以玩家编辑配置数据(一般用不到)
附新配置文件

YAML：

# SurvivalFlyPlugin 配置文件
# 版本: 1.0.1
# 请勿手动修改此项！
version: 1.0.1

# ========== 经济设置 ==========
economy:
  enable-bypass: true

# ========== 缓降设置 ==========
slow-fall:
  # 缓降持续时间（秒）
  duration: 10
  # 是否启用缓降效果
  enabled: true
  # 缓降提醒间隔（秒），0为不提醒
  reminder-interval: 2
  # 玩家离线时是否自动关闭飞行（默认开启）
  auto-disable-on-quit: true
  # 重新进服时缓降持续时间（秒），0为不给予缓降
  rejoin-slowfall-duration: 5

# ========== 套餐设置 ==========
packages:
  enabled: true
  list:
    basic:
      name: "&a经济套餐"
      material: "GOLD_INGOT"
      price: 30
      duration: 20
      slot: 10
      lore:
        - "&7飞行时长: &e20 分钟"
        - "&7价格: &6%price% Points"
        - "&7节省: &a10 Points"
        - ""
        - "&e点击购买并开启飞行！"
  
    premium:
      name: "&6豪华套餐"
      material: "DIAMOND"
      price: 50
      duration: 40
      slot: 11
      lore:
        - "&7飞行时长: &e40 分钟"
        - "&7价格: &6%price% Points"
        - "&7节省: &a30 Points"
        - ""
        - "&e点击购买并开启飞行！"
  
    ultimate:
      name: "&d&l至尊套餐"
      material: "NETHER_STAR"
      price: 100
      duration: 100
      slot: 12
      lore:
        - "&7飞行时长: &e100 分钟"
        - "&7价格: &6%price% Points"
        - "&7节省: &a100 Points"
        - ""
        - "&e点击购买并开启飞行！"
  
    monthly:
      name: "&b&l月卡套餐"
      material: "EMERALD"
      price: 200
      duration: 300
      slot: 14
      lore:
        - "&7飞行时长: &e300 分钟 (5小时)"
        - "&7价格: &6%price% Points"
        - "&7节省: &a300 Points"
        - ""
        - "&e点击购买并开启飞行！"
  
    seasonal:
      name: "&5&l季卡套餐"
      material: "EMERALD_BLOCK"
      price: 500
      duration: 1000
      slot: 15
      lore:
        - "&7飞行时长: &e1000 分钟 (16.6小时)"
        - "&7价格: &6%price% Points"
        - "&7节省: &a800 Points"
        - ""
        - "&e点击购买并开启飞行！"
  
    yearly:
      name: "&c&l年卡套餐"
      material: "BEACON"
      price: 1500
      duration: 5000
      slot: 16
      lore:
        - "&7飞行时长: &e5000 分钟 (83小时)"
        - "&7价格: &6%price% Points"
        - "&7节省: &a2500 Points"
        - ""
        - "&e点击购买并开启飞行！"

# ========== GUI设置 ==========
gui:
  title: "&b&l飞行控制台"
  size: 27
  buttons:
    enable:
      material: FEATHER
      name: "&a&l开启飞行"
      lore:
        - "&7当前飞行时间: &e%balance% 分钟"
        - ""
        - "&7点击开启飞行！"
      slot: 11
    
    disable:
      material: BARRIER
      name: "&c&l关闭飞行"
      lore:
        - "&7点击关闭飞行"
        - "&7剩余时间将保留"
      slot: 13
    
    info:
      material: CLOCK
      name: "&b&l飞行状态"
      lore:
        - "&7剩余时间: &e%remaining% 分钟"
        - "&7总余额: &e%balance% 分钟"
        - ""
        - "&7点击刷新"
      slot: 15
  
    packages:
      material: "CHEST"
      name: "&d&l飞行套餐"
      lore:
        - "&7购买飞行套餐获得飞行时间"
        - ""
        - "&e点击查看套餐"
      slot: 22
  
    slowfall_toggle:
      material: "ELYTRA"
      name: "&b&l缓降设置"
      lore:
        - "&7当前状态: %status%"
        - ""
        - "&7开启后飞行结束时自动缓降"
        - "&e点击切换"
      slot: 4

# ========== 消息设置 ==========
messages:
  prefix: "&8[&b飞行&8]&r "
  no-permission: "&c你没有权限使用此命令！"
  player-only: "&c此命令只能由玩家执行！"
  already-flying: "&c你已经处于飞行状态了！"
  not-flying: "&c你当前并没有在飞行。"
  fly-enabled: "&a飞行已开启！剩余 %duration% 分钟。"
  fly-disabled: "&e飞行已关闭，剩余 %remaining% 分钟已保留。"
  fly-expired: "&c飞行时间已用完！正在启动缓降..."
  insufficient-funds: "&cPoints 不足！需要 %cost% Points。"
  time-remaining: "&b飞行剩余时间: &e%minutes% 分 %seconds% 秒"
  reloaded: "&a配置文件已重载！"
  player-not-found: "&c找不到玩家: %player%"
  package-purchased: "&a成功购买 %package%！获得 %duration% 分钟飞行时间！"
  package-already-flying: "&c你正在飞行中！请先关闭飞行再购买套餐。"
  package-gui-title: "&d&l飞行套餐购买"
  package-not-found: "&c无效的套餐！"
  no-flight-time: "&c你没有飞行时间！请购买套餐。"
  slow-fall-start: "&a🪂 已开启缓降效果，持续 %duration% 秒！"
  slow-fall-end: "&7缓降效果已结束"
  slow-fall-remaining: "&7🪂 缓降剩余: &e%seconds% &7秒"
  slow-fall-enabled: "&a缓降已开启"
  slow-fall-disabled: "&c缓降已关闭"
  rejoin-slowfall: "&a🪂 欢迎回来！给予 %duration% 秒缓降保护"