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 和插件禁用时清理自身状态,防止玩家被困在空中或被踢出服务器(提示“正在飞行”)。
游玩体验
- 跳跃一次 → 完全正常的跳跃动作。
- 仍在空中时再次跳跃 → 启动飞行,伴随音效和粒子爆发。
- 自由飞行,如同创造模式一般。
- 着陆,或再次双击跳跃键 → 飞行结束。
- 随时想再次起飞时,只需连续跳跃两次。
前置要求
- Paper 1.21 或更高版本(已针对
1.21.11 构建并测试)。不支持 Spigot —— PremiumFly 依赖仅 Paper 可用的 API 以保证性能和可靠性。
- Java 21 或更高版本。
安装指南
- 从 Modrinth 或 GitHub Releases 下载最新的
PremiumFly-<version>.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 启动或重启服务器。
- 根据需要编辑
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 创建
PremiumFly
PremiumFly brings Creative-style flight to Survival, Adventure, and any other non-Creative game mode — triggered by a satisfying double jump, just like Creative mode. Reward your donors, VIPs, or staff with a flight perk that never breaks the survival feel of your server.
Table of Contents
Why PremiumFly
Most "fly" plugins just flip allowFlight on. PremiumFly is built to feel like an intentional game mechanic — a double jump — rather than a slash command toggle, so donors and VIPs get something that actually feels premium.
- Built specifically for Paper 1.21, using the modern Adventure/MiniMessage text API — no legacy
&-code messages.
- Grants can come from a permission node (great for LuckPerms rank groups) or a simple admin command — your choice.
- Player data is stored safely using Bukkit's Persistent Data Container, not scoreboard tags, so it won't collide with scoreboard plugins.
Features
- ?️ Double-jump flight — jump once normally, jump again mid-air to take off, exactly like Creative mode.
- ? Two ways to grant access
/pfly <player> enable for one-off, manual grants.
- The
premiumfly.fly permission node for automatic grants through LuckPerms or any permission plugin.
- ? Fully localized — built-in Japanese and English message packs, both fully editable in
config.yml using MiniMessage formatting (hex colors, gradients, hover text, and more).
- ? Sound & particle feedback on take-off and landing, so flight feels like an ability, not a toggle — fully configurable, can be disabled.
- ? Per-world control — disable PremiumFly in specific worlds (minigames, parkour maps, etc.) via
disabled-worlds in the config.
- ? Admin quality-of-life — tab completion,
/pfly list to see who currently has flight, /pfly info for version/update status, and /pfly reload to reload without a restart.
- ? Built-in update checker — get notified in-game (and in console) when a new version is published on Modrinth.
- ? Optional bStats metrics — see real anonymous usage stats for your own copy of the plugin.
- ?️ Safe by design
- Automatically revokes flight the moment permission is removed or the target world changes.
- Never touches Creative or Spectator mode flight, so staff and admins are unaffected.
- Cleans up its own state on
/reload and plugin disable so nobody gets stuck flying (or gets kicked for "flying").
How It Feels To Play
- Jump once → a completely normal jump.
- While still airborne, jump again → flight engages, with a sound and particle burst.
- Fly around freely, just like Creative mode.
- Land, or double-tap again → flight ends.
- Jump twice again whenever you want to take off once more.
Requirements
- Paper 1.21 or later (built and tested against
1.21.11). Spigot is not supported — PremiumFly relies on Paper-only APIs for performance and reliability.
- Java 21 or later.
Installation
- Download the latest
PremiumFly-<version>.jar from Modrinth or GitHub Releases.
- Drop it into your server's
plugins/ folder.
- Start or restart the server.
- Edit
plugins/PremiumFly/config.yml to taste, then run /pfly reload.
Commands
| Command |
Description |
Permission |
/pfly <player> enable |
Grant PremiumFly to a player |
pfly.admin |
/pfly <player> disable |
Revoke PremiumFly from a player |
pfly.admin |
/pfly list |
List every online player who currently has PremiumFly |
pfly.admin |
/pfly reload |
Reload config.yml without restarting |
pfly.admin |
/pfly info |
Show plugin version and update status |
pfly.admin |
/pfly help |
Show the command list in-game |
pfly.admin |
Permissions
| Permission |
Default |
Description |
pfly.admin |
op |
Access to every /pfly subcommand. |
premiumfly.fly |
false |
Automatically grants double-jump flight — no command needed. Perfect for LuckPerms rank groups. |
premiumfly.notify |
op |
Notifies the player on join if a newer PremiumFly version is available. |
Configuration
Every value below lives in config.yml and reloads live with /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
metrics:
enabled: true
plugin-id: 0
messages:
jp: { ... }
en: { ... }
flight.speed — flying speed while PremiumFly is active (0.1–1.0).
flight.jump-window-ticks — how long a player has, after a real jump, to double-jump into flight.
flight.disabled-worlds — world names where PremiumFly never activates.
update-checker.modrinth-id — set this to your own Modrinth project slug if you fork this plugin.
metrics.plugin-id — get a free plugin ID at bStats.org to enable metrics; leave 0 to keep metrics off.
messages — every in-game string, fully overridable per language with MiniMessage formatting.
Integrating With Other Plugins
Flight grants are stored in a PersistentDataContainer under the key premiumfly:granted, so other plugins can safely read it without touching scoreboards. If you already manage ranks with LuckPerms (or any permission plugin), simply give the desired group the premiumfly.fly permission — no command required.
FAQ
Does this work in Spigot, or only Paper?
Paper only. PremiumFly uses Paper's PlayerJumpEvent for reliable, low-overhead jump detection — this event does not exist on vanilla Spigot.
Will this conflict with Essentials /fly or other flight plugins?
No — PremiumFly only manages flight for players it has granted, and safely restores their state if the plugin is disabled or reloaded.
Can I use this without commands, purely through LuckPerms?
Yes — grant the premiumfly.fly permission to a group and every member instantly gets double-jump flight.
Upgrading from an older PremiumFly version?
Existing grants are migrated automatically the next time each player joins — no action needed.
Support
Found a bug or have a feature request? Please open an issue on GitHub.
License
PremiumFly is released under the MIT License — free to use, modify, and redistribute.
Author
Created by Takkunlego0916
评论 0
登录后参与评分
还没有评论,来抢沙发吧