BUG 反馈:
文本版本
FrPass
一款面向 Paper & Folia 服务器的下一代、基于数据包的 Battlepass(通行证)与任务插件。免疫传统漏洞,旨在提供极致体验。
功能
Flay AI (NEW)
使用 /frpassadmin ai 命令并通过自然语言提示词,在几秒钟内生成整个任务包或修改现有任务!用通俗文字描述您的需求,让 Flay AI 自动构建有效的任务、目标和奖励,无需触碰配置文件。
- 自然语言 · 任务包 · 实时编辑 · 即时应用
游戏内编辑器
通过 /frpassadmin editor 命令,无需离开 Minecraft 即可构建和调整任务。通过简单的图形界面编辑任务类型、目标、奖励和图标,并实时查看每项更改的生效效果。
高级版赠送
拥有高级版通行证的玩家可以使用 /frpass gift <player> 将高级版状态赠送给他人!支持可配置的成本(Vault 货币、通行证经验值或通行证等级)以及转移开关。
任务重掷系统
交互式任务重掷模式!玩家可以直接在游戏内的“任务”GUI 中进入重掷会话,选择最多符合配置数量的任务(带有发光的选择反馈),并立即替换当前活跃的任务。
高级版票据物品
物理右键点击的高级版通行证票据!支持 CustomModelData 和 Nexo 物品,并具备自动的全库存队列保护功能。玩家可以从您的商店购买这些票据,或与其他玩家交易。
零卡顿且兼容 Folia
由 PacketEvents 和 Folia 区域调度器驱动。菜单操作完全不会阻塞主线程。彻底免疫传统的 GUI 物品复制漏洞和 TPS 下降问题。
免费与高级双轨制
采用简洁的双轨制 GUI,支持 Nexo 和 CustomModelData。玩家可以分别解锁并领取免费奖励和高级奖励,享受精美现代的交互体验。
集成任务系统
保持服务器活跃度,内置 13 种以上的任务类型以及动态的每日/每周轮换机制!奖励玩家进行挖矿、击杀生物、制作、钓鱼或探索世界等行为。
FrSync 热重载
内置的 FrSync 文件监听器会自动检测并实时应用对您配置文件、菜单、层级和任务的更改。无需重启服务器或执行重载命令。
开发者 API
丰富的开发者 API 和自定义 Bukkit 事件(FrPassLevelUpEvent、FrPassTierClaimEvent、FrPassQuestProgressEvent)已就绪,方便您的其他插件轻松接入。
多数据库支持与占位符
支持 HikariCP 驱动的 SQLite、MySQL、MariaDB 和 PostgreSQL 存储,同时原生支持 PlaceholderAPI,可在任何地方显示等级、经验值和状态信息。
命令
| 命令 | 描述 | 权限 |
|---|---|---|
/frpass |
打开主界面。 | 无需权限 |
/frpass gift <player> |
赠送高级版状态。 | frpass.gift |
/frpassadmin editor |
打开游戏内任务编辑器。 | frpass.admin |
/frpassadmin ai <create|edit|status> |
使用 Flay AI 生成或编辑任务。 | frpass.admin |
/frpassadmin addxp <player> <amount> |
为玩家添加经验值。 | frpass.admin |
/frpassadmin setpremium <player> <true/false> |
授予高级版访问权限。 | frpass.admin |
/frpassadmin giveticket <player> <amount> |
发放高级版票据。 | frpass.admin |
占位符 (PlaceholderAPI)
| 占位符 | 描述 |
|---|---|
%frpass_level% / %frpass_tier% |
当前通行证等级 / 层级。 |
%frpass_xp% |
当前经验值数量。 |
%frpass_is_premium% |
返回 true 或 false。 |
%frpass_premium_formatted% |
格式化后的状态文本。 |
%frpass_active_quests% |
活跃任务的数量。 |
在任何支持 PlaceholderAPI 的地方均可使用:计分板、标签页列表、聊天框和全息图。
链接
- 源代码: github.com/fraiocc/frpass
- Discord 支持: discord.gg/N9Jr94Wvcf
FOR BUG REPORTS:
Text Version
FrPass
A next-generation, packet-based Battlepass & Quests plugin for Paper & Folia servers. Immune to traditional bugs, designed for the absolute best experience.
Features
Flay AI (NEW)
Generate entire quest packs or modify existing quests in seconds using natural language prompts with /frpassadmin ai! Describe what you want in plain text and let Flay AI build valid quests, objectives, and rewards automatically without touching config files.
- Natural Language · Quest Packs · Live Edit · Instant Apply
In-Game Editor
Build and tweak quests without leaving Minecraft via /frpassadmin editor. Edit quest types, targets, rewards, and icons through a simple GUI and see every change applied instantly.
Premium Gifting
Players with a Premium Battlepass can gift Premium status to others with /frpass gift <player>! Supports configurable costs (Vault Money, Pass XP, or Pass Level) and transfer toggles.
Quest Reroll System
Interactive Quest Reroll mode! Players can enter a reroll session directly inside the Quests GUI, select up to configured quest limits with glowing selection feedback, and replace active quests instantly.
Premium Ticket Item
Physical right-clickable Premium Pass Tickets! Supports CustomModelData and Nexo items with automatic full-inventory queue protection. Players can purchase these from your store or trade them with others.
Lag-Free & Folia Ready
Powered by PacketEvents and Folia region schedulers. Zero main-thread blocking for menus. Completely immune to traditional GUI item dupes and TPS drops.
Free & Premium Tracks
A sleek dual-track GUI with Nexo & CustomModelData support. Players can unlock and claim their Free and Premium rewards separately with a beautifully modern experience.
Integrated Quests
Keep your server active with 13+ quest types and dynamic daily/weekly rotations! Reward players for mining, killing mobs, crafting, fishing, or exploring the world.
FrSync Hot-Reload
Built-in FrSync file watcher automatically detects and applies changes to your configs, menus, tiers, and quests on the fly. Zero server restarts or reload commands needed.
Developer API
Rich Developer API and custom Bukkit Events (FrPassLevelUpEvent, FrPassTierClaimEvent, FrPassQuestProgressEvent) ready for your other plugins to hook into easily.
Multi-DB & Placeholders
HikariCP-powered SQLite, MySQL, MariaDB, and PostgreSQL storage alongside native PlaceholderAPI support to display levels, XP, and status anywhere.
Commands
| Command | Description | Permission |
|---|---|---|
/frpass |
Opens the main interface. | No permission required |
/frpass gift <player> |
Gift Premium status. | frpass.gift |
/frpassadmin editor |
Open in-game quest editor. | frpass.admin |
/frpassadmin ai <create|edit|status> |
Generate or edit quests with Flay AI. | frpass.admin |
/frpassadmin addxp <player> <amount> |
Add XP to a player. | frpass.admin |
/frpassadmin setpremium <player> <true/false> |
Grant Premium access. | frpass.admin |
/frpassadmin giveticket <player> <amount> |
Give premium tickets. | frpass.admin |
Placeholders (PlaceholderAPI)
| Placeholder | Description |
|---|---|
%frpass_level% / %frpass_tier% |
Current Battlepass level / tier. |
%frpass_xp% |
Current XP amount. |
%frpass_is_premium% |
Returns true or false. |
%frpass_premium_formatted% |
Formatted status text. |
%frpass_active_quests% |
Count of active quests. |
Works anywhere PlaceholderAPI is supported: scoreboards, tab lists, chat, and holograms.
Links
- Source Code: github.com/fraiocc/frpass
- Discord Support: discord.gg/N9Jr94Wvcf
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FrPass - 基于数据包的战令
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
功能:版本 1.3.0 - 排行榜系统、任务重置计时器、多语言支持和配置迁移
- 添加 /frpass top 排行榜命令,支持可配置的 GUI(menus/leaderboard_menu.yml)、主菜单按钮和聊天回退机制
- 添加 %frpass_top_<n>name%、%frpass_top<n>tier% 和 %frpass_top<n>_xp% PlaceholderAPI 变量
- 在 quests_menu.yml 中添加可配置的任务重置倒计时物品(reset_timer)以及 %frpass_quest_reset% 占位符
- 添加土耳其语(tr.yml)、德语(de.yml)和法语(fr.yml)本地化文件,并自动提取默认语言
- 添加 ConfigMigrator,通过 config-version 跟踪在更新时合并新的配置和菜单键,同时不覆盖用户设置
- 防止创造模式和旁观者模式下的任务漏洞(可通过 quest-system.ignore-creative 配置)
- 通过在加载数据前等待待处理的玩家保存操作,修复退出/重新加入时的异步竞态条件
- 在 QuestManager 中用原子化的地图交换替代原地清空任务地图,以防止重载时的竞态条件
- 更新 README.md 文档,包含新命令、占位符、奖励类型和开发者 API 方法
功能:版本 1.2.0 - 任务图标编辑器、扩展的开发者 API 以及关键漏洞修复和线程安全修复
-
在游戏内任务编辑器中为自定义图标材质和 CustomModelData 配置添加支持
-
扩展 FrPassAPI,新增玩家进度、等级层级、奖励计数及任务管理方法
-
实现针对已满玩家背包的工单队列系统,在空间可用时自动出队
-
修复允许完成的任务重新生成以获取无限经验值和奖励的关键任务重掷漏洞
-
对方块破坏和放置监听器强制执行 HIGHEST 事件优先级,以尊重区域保护插件
-
防止在 KILL_PLAYER 和 KILL_MOB 任务中出现自杀和 Citizens NPC 击杀漏洞
-
修复自然生长的垂直作物(甘蔗、竹子、仙人掌)在农业任务中的破坏检测问题
-
修复单个工单消耗导致的幽灵物品不同步问题,并防止 PassMenu 槽位索引越界
-
为自定义事件添加异步事件分发支持,以兼容 Folia 区域和后台线程安全
-
向 UpdateChecker GitHub API 请求中添加缺失的 User-Agent 标头,以消除 HTTP 403 错误
-
确保初始化时 SQLite 父目录存在,并改进 ALL 模式下的任务同步
feat: 版本 1.1.0 - 新增奖励动作、管理员管理命令、PAPI 变量以及未领取奖励提醒
- 添加 [PLAYER_COMMAND]、[BROADCAST]、[SOUND] 和 [TITLE] 奖励动作
- 添加未领取 Battlepass 奖励的加入提醒 (notify-unclaimed-on-join)
- 添加 /frpassadmin setxp、setlevel、reset 和 completequest 命令,并支持 Tab 补全
- 添加 %frpass_xp_required% 和 %frpass_xp_remaining% 占位符,以及可配置的高级状态格式化
- 修复 PostgreSQL 布尔值插入类型不匹配问题,并在游戏内编辑器中保留自定义任务图标
- 防止未成年作物和垂直植物(甘蔗/竹子/仙人掌)的 BREAK_BLOCK 漏洞利用
- feat: 集成 AI 任务生成器,支持生成与编辑命令
- feat: 添加 MiniMessage 渐变与现代标签支持,并保留传统十六进制颜色回退方案
- feat: 在加载时自动同步 jar 包中缺失的配置项与语言键
- perf: 在 LangManager 中使用 ConcurrentHashMap 实现消息缓存,支持多行列表
- perf: 优化 PlayerDataManager,采用异步批量保存并精简任务分配逻辑
- perf: 将 ConfigWatcher 重构为 FrSync,具备 1.5 秒防抖机制及 Folia 线程安全性
- refactor: 将 MenuManager 拆分为模块化菜单处理器(MainMenu、QuestsMenu、PassMenu)
- refactor: 清理配置文件中敏感的 AI 后端设置,仅保留必要的用户选项
- fix: 修复现有安装中缺失的翻译键未写入磁盘的问题
功能:动态命令别名、新任务类型以及性能优化
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持

评论 0
登录后参与评分
还没有评论,来抢沙发吧