PremiumFly

插件

· 作者 TakkunMC

PremiumFly 是一个适用于 Paper/Spigot 的插件,为指定玩家在中生存模式下添加了类似创造模式飞行的二段跳飞行功能。

0 本站下载 0 关注 更新于 3 个月前

最新 2.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

PremiumFly

PremiumFly 将创造模式的飞行能力带入生存、冒险及其他非创造游戏模式——通过令人满足的双段跳触发,与创造模式如出一辙。将这项飞行特权作为奖励提供给捐赠者、VIP 或工作人员,同时不会破坏服务器的生存体验。


目录


为什么选择 PremiumFly

大多数“飞行”类插件仅仅是开启 allowFlight 选项。PremiumFly 旨在作为一种有意的游戏机制(即双段跳)来构建,而非简单的指令开关,让捐赠者和 VIP 获得真正具有“高级感”的体验。

  • 专为 Paper 1.21 构建,使用现代的 Adventure/MiniMessage 文本 API —— 不再依赖传统的 & 代码消息。
  • 授予方式可选:可通过 权限节点(非常适合 LuckPerms 的权限组)或 简单的管理员命令获取。
  • 玩家数据使用 Bukkit 的 Persistent Data Container 安全存储,而非计分板标签,因此不会与计分板插件发生冲突。

功能特性

  • ?️ 双段跳飞行 — 正常跳跃一次,在半空中再次跳跃即可起飞,完全复刻创造模式的操作。
  • ? 两种授予方式
    • /pfly <player> enable 用于一次性手动授予。
    • premiumfly.fly 权限节点,通过 LuckPerms 或其他权限插件自动授予。
  • ? 完全本地化 — 内置日语和英语消息包,均可在 config.yml 中使用 MiniMessage 格式进行完全编辑(支持十六进制颜色、渐变、悬停文本等)。
  • ? 起飞与落地的音效及粒子反馈 — 让飞行感觉像是一种技能而非开关——完全可配置,也可禁用。
  • ? 按世界控制 — 通过在配置文件中设置 disabled-worlds,可在特定世界(如小游戏、跑酷地图等)中禁用 PremiumFly。
  • ? 管理员便利性工具 — 支持 Tab 补全、/pfly list 查看当前拥有飞行权限的玩家列表、/pfly info 显示版本/更新状态,以及 /pfly reload 无需重启服务器即可重载配置。
  • ? 内置更新检查器 — 当 Modrinth 上发布新版本时,会在游戏内(和控制台)收到通知。
  • ? 可选的 bStats 指标 — 查看您插件副本的真实匿名使用统计数据。
  • ?️ 设计安全
    • 一旦权限被移除或目标世界发生变化,会自动撤销飞行权限。
    • 绝不触碰创造模式或旁观者模式的飞行,因此不影响员工和管理员。
    • 在 /reload 和插件禁用时清理自身状态,防止玩家被困在空中或被踢出服务器(提示“正在飞行”)。

游玩体验

  1. 跳跃一次 → 完全正常的跳跃动作。
  2. 仍在空中时再次跳跃 → 启动飞行,伴随音效和粒子爆发。
  3. 自由飞行,如同创造模式一般。
  4. 着陆,或再次双击跳跃键 → 飞行结束。
  5. 随时想再次起飞时,只需连续跳跃两次。

前置要求

  • Paper 1.21 或更高版本(已针对 1.21.11 构建并测试)。不支持 Spigot —— PremiumFly 依赖仅 Paper 可用的 API 以保证性能和可靠性。
  • Java 21 或更高版本。

安装指南

  1. 从 Modrinth 或 GitHub Releases 下载最新的 PremiumFly-<version>.jar。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 启动或重启服务器。
  4. 根据需要编辑 plugins/PremiumFly/config.yml,然后运行 /pfly reload。

命令

命令 描述 权限
/pfly <player> enable 授予某玩家 PremiumFly 权限 pfly.admin
/pfly <player> disable 撤销某玩家的 PremiumFly 权限 pfly.admin
/pfly list 列出所有当前拥有 PremiumFly 权限的在线玩家 pfly.admin
/pfly reload 无需重启即可重载 config.yml pfly.admin
/pfly info 显示插件版本和更新状态 pfly.admin
/pfly help 在游戏内显示命令列表 pfly.admin

权限

权限 默认值 描述
pfly.admin op 访问所有 /pfly 子命令。
premiumfly.fly false 自动授予双段跳飞行权限 —— 无需任何命令。非常适合 LuckPerms 权限组。
premiumfly.notify op 如果有更新的 PremiumFly 版本可用,在玩家加入时通知该玩家。

配置

以下每个值都位于 config.yml 中,并通过 /pfly reload 实时重载。

language: jp

flight:
  speed: 0.2
  jump-window-ticks: 40
  disabled-worlds: []

effects:
  sound:
    enabled: true
    activate: ENTITY_ENDERMAN_TELEPORT
    deactivate: ENTITY_BAT_TAKEOFF
  particles:
    enabled: true
    activate: CLOUD

hints:
  jump-hint-enabled: true
  jump-hint-cooldown-seconds: 3

update-checker:
  enabled: true
  modrinth-id: premiumfly

指标:
  enabled: true
  plugin-id: 0

消息:
  jp: { ... }
  en: { ... }
  • flight.speed — PremiumFly 激活时的飞行速度(0.1–1.0)。
  • flight.jump-window-ticks — 玩家在一次真实跳跃后,可以进行二段跳进入飞行状态的持续时间(以刻为单位)。
  • flight.disabled-worlds — PremiumFly 永不生效的世界名称列表。
  • update-checker.modrinth-id — 如果你分叉了此插件,请将其设置为你自己的 Modrinth 项目标识符。
  • metrics.plugin-id — 在 bStats.org 获取免费的插件 ID 以启用指标;保持为 0 则关闭指标功能。
  • messages — 所有游戏内字符串,支持使用 MiniMessage 格式按语言完全自定义覆盖。

与其他插件集成

飞行授予状态存储在名为 premiumfly:granted 的 PersistentDataContainer 中,因此其他插件可以安全地读取该数据而无需触碰记分板。如果你已经使用 LuckPerms(或任何权限插件)管理权限组,只需给目标组授予 premiumfly.fly 权限即可——无需执行命令。

常见问题

这能在 Spigot 上运行吗?还是仅限 Paper? 仅限 Paper。PremiumFly 依赖 Paper 的 PlayerJumpEvent 来实现可靠且低开销的跳跃检测——该事件在原版 Spigot 中并不存在。

这会与 Essentials 的 /fly 或其他飞行插件冲突吗? 不会——PremiumFly 仅管理已授予其飞行权限的玩家,并在插件被禁用或重载时安全恢复他们的状态。

能否完全不使用命令,仅通过 LuckPerms 实现? 可以——将 premiumfly.fly 权限授予某个用户组,该组内的所有成员即可立即获得二段跳飞行能力。

从旧版 PremiumFly 升级需要注意什么? 现有的飞行授予状态会在每位玩家下次登录时自动迁移——无需手动操作。

支持

发现 Bug 或有功能建议?请在 GitHub 上提交 Issue。

许可证

PremiumFly 根据 MIT 许可证 发布——可自由使用、修改和再分发。

作者

由 Takkunlego0916 创建

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源