# FOR BUG REPORTS: [https://report.fraio.cc](https://report.fraio.cc/) [![Main](https://cdn.modrinth.com/data/cached_images/37b0ab0911b53d92a3fd2767dce362f5029b2589.webp)](https://go.fraio.cc)

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 `! 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 ` | Gift Premium status. | `frpass.gift` | | `/frpassadmin editor` | Open in-game quest editor. | `frpass.admin` | | `/frpassadmin ai ` | Generate or edit quests with Flay AI. | `frpass.admin` | | `/frpassadmin addxp ` | Add XP to a player. | `frpass.admin` | | `/frpassadmin setpremium ` | Grant Premium access. | `frpass.admin` | | `/frpassadmin giveticket ` | 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](https://github.com/fraiocc/frpass) - **Discord Support:** [discord.gg/N9Jr94Wvcf](https://discord.gg/N9Jr94Wvcf)

FrPass

1.1.0