
BedrockGUI v2
将原生的基岩版表单带给你的 Java 服务器!
BedrockGUI 是一款专为 Paper、Velocity 和 Bungeecord 打造的强大实用工具,允许服务器管理员创建原生的基岩风格交互式表单。通过与 Floodgate 集成,它为基岩版玩家提供无缝的用户体验,同时可通过简单的 YAML 配置进行管理。
✨ 主要功能
🖼️ 多样化的表单类型
- 简单表单 (Simple Forms):基于按钮的菜单。支持通过 URL、纹理或玩家名称自定义图片。
- 模态表单 (Modal Forms):简单的“是/否”确认对话框。
- 自定义表单 (Custom Forms):包含文本输入框、滑块、步进滑块、下拉菜单、开关和标签的数据输入界面。下拉菜单可自动列出在线玩家。
🎛️ 表单控件
- 冷却时间 (Cooldowns):可为每个按钮或整个表单设置冷却时间,防止玩家滥用购买按钮。
- 打开条件 (Open conditions):仅在权限检查、占位符验证或插件检查通过后才会打开表单,并显示你自定义的消息。
- 关闭动作 (Close actions):当玩家关闭表单时执行特定操作,例如返回上一级菜单。
⚡ 统一的动作系统
使用现代的大括号语法执行复杂的逻辑。将多个动作链接在一起,以构建引导式的玩家流程。
- 命令 (Commands):以玩家或控制台的身份运行命令。
- 经济系统 (Economy):通过 Vault 进行余额检查、购买以及玩家间的转账。
- UI 反馈:发送标题、动作栏消息及带颜色的聊天消息。
- 物品栏 (Inventory):按数量给予、移除或检查物品。如果某一步骤失败(如库存不足),后续步骤将停止执行,从而确保出售按钮不会为玩家没有的物品付款。
- 流程控制 (Flow Control):使用
delay(延迟)、random(随机)和 conditional(条件)动作来构建智能菜单。
- BungeeCord:通过插件消息系统将玩家转发到不同的服务器。
🔌 集成支持
- Floodgate:原生支持基岩版玩家检测。
- PlaceholderAPI:在标题、按钮文本或动作值中使用任意 PAPI 占位符。
- YAML 配置:无需重新编译;直接编辑菜单并热重载。
- 完全可翻译:玩家看到的所有消息均位于
messages.yml 中。
- 自动配置更新:启动时会自动添加新设置并移除旧设置,同时保留你的自定义数值。
🧩 官方插件
可选的配套插件,可将流行服务器插件的 GUI 转换为原生基岩版表单——无需自行设计菜单。将它们与 BedrockGUI 和 Floodgate 一同放入服务器即可。
🛒 Essentials 插件
为 传送点 (Warps)、套装 (Kits)、家 (Homes)、TPA、商店和宠物 提供原生基岩版表单,并自动检测你所运行的插件:
- Warps / Kits / Homes / TPA — 支持 EssentialsX、CMI 或 HuskHomes
- Shops — 支持 ShopGUI+ 和 EconomyShopGUI(包括高级版)
- Pets — 支持 MyPet(购买、列表、属性、召唤、技能树)和 MCPets(列表、信息、召唤、收回)
📥 在 GitHub 下载 — BedrockGUI-EssentialsAddon.jar
⚔️ Bedwars 插件
为 商店、队伍升级、竞技场选择器、统计数据、旁观者和组队 提供原生基岩版表单,并自动检测你的 BedWars 插件:
- BedWars2023 和 BedWars1058 — 支持所有模块
- ScreamingBedWars — 支持竞技场、统计、旁观者
📥 在 GitHub 下载 — BedrockGUI-BedwarsAddon.jar
🏡 Homestead 插件
为 Homestead 领地插件提供原生基岩版表单——为其全部 27 个 GUI 量身定制:
- 区域、成员、邀请与封禁、世界/全局/区域标志
- 子区域、已占领区块、地图颜色与图标
- 等级、奖励、日志、评分、区域设置、天气/时间
📥 在 GitHub 下载 — BedrockGUI-HomesteadAddon.jar (需要安装 Homestead 插件)
🗡️ PhoenixDuels 插件
为 PhoenixDuels 和 PhoenixDuelsLite 提供原生基岩版表单:
- 队列、决斗请求、套装及套装预览
- 组队:邀请、成员、自由对战 (FFA)、团队战、多队战及组队挑战
- 统计、排行榜、比赛历史、旁观、设置及遗失物品
- 组队邀请和决斗挑战将以“是/否”表单形式出现,而非聊天消息
📥 在 GitHub 下载 — BedrockGUI-PhoenixDuelsAddon.jar (需要安装 PhoenixDuels 或 PhoenixDuelsLite)
这些插件要求 BedrockGUI 版本 2.0.12+,运行于 Paper + Floodgate 环境。更喜欢自定义菜单?每个插件都提供仅动作模式 (integrated-gui: false),该模式下仅注册其动作而不启用内置表单。请参阅 Wiki 了解设置方法。
📋 依赖要求
- Paper / Folia 1.20.6+(最高至 26.3),需 Java 21+
- Velocity 4 需 Java 25+,或使用 BungeeCord / Waterfall
- Floodgate 需安装在运行 BedrockGUI 的服务器上
在代理端(Velocity / BungeeCord)上,表单、条件和大多数动作均可正常工作,但 economy(经济)、inventory(物品栏)、command_intercept(命令拦截)、PlaceholderAPI 以及各插件需要 Paper 环境支持。此外,BungeeCord 不支持 sound(音效)。请参阅 平台对比。
⌨️ 命令
/bedrockgui open <form> [args] - 为你自己打开一个表单。
/bedrockgui openfor <player> <form> [args] - 为其他玩家打开一个表单。
/bedrockgui reload - 重载所有配置(权限:bedrockgui.admin)。
/bedrockgui convert - 将旧的内联配置转换为每个表单独立一个文件的格式(权限:bedrockgui.admin)。
🛠️ 工具

BedrockGUI v2
Bring native Bedrock Edition forms to your Java server!
BedrockGUI is a powerful utility for Paper, Velocity and Bungeecord that allows server owners to create native Bedrock-style interactive forms. By integrating with Floodgate, it provides a seamless UI experience for Bedrock players while remaining manageable via simple YAML configurations.
✨ Key Features
🖼️ Versatile Form Types
- Simple Forms: Button-based menus. Support for custom images via URLs, textures, or player names.
- Modal Forms: Simple Yes/No confirmation dialogs.
- Custom Forms: Data entry with Text Inputs, Sliders, Step Sliders, Dropdowns, Toggles and Labels. Dropdowns can list online players automatically.
🎛️ Form Controls
- Cooldowns per button or per form, to stop players spamming a buy button.
- Open conditions: only open a form when a permission, placeholder or plugin check passes, with your own message.
- Close actions: run actions when a player closes a form, such as returning to the previous menu.
⚡ Unified Action System
Execute complex logic using a modern curly-brace syntax. Chain actions together to create guided player flows.
- Commands: Run commands as the player or the console.
- Economy: Balance checks, purchases and player-to-player payments through Vault.
- UI Feedback: Send titles, action bars, and colorized messages.
- Inventory: Give, remove and check items by amount. A failed step stops the rest, so a sell button never pays for items the player does not have.
- Flow Control: Use
delay, random, and conditional actions to build intelligent menus.
- BungeeCord: Send players to different servers via plugin messaging.
🔌 Integrations
- Floodgate: Native support for Bedrock player detection.
- PlaceholderAPI: Use any PAPI placeholder in your titles, button text, or action values.
- YAML Configuration: No need to recompile; edit your menus and reload.
- Fully translatable: every message players see lives in
messages.yml.
- Automatic config updates: new settings are added and old ones removed on startup, your values are kept.
🧩 Official Addons
Optional companion plugins that turn the GUIs of popular server plugins into native Bedrock forms — no menu design required. Drop them in alongside BedrockGUI and Floodgate.
🛒 Essentials Addon
Native Bedrock forms for Warps, Kits, Homes, TPA, Shops and Pets, auto-detecting the plugin you run:
- Warps / Kits / Homes / TPA — EssentialsX, CMI, or HuskHomes
- Shops — ShopGUI+ and EconomyShopGUI (incl. Premium)
- Pets — MyPet (buy, list, stats, call, skilltrees) and MCPets (list, info, summon, put away)
📥 Download on GitHub — BedrockGUI-EssentialsAddon.jar
⚔️ Bedwars Addon
Native Bedrock forms for Shop, Team Upgrades, Arena selector, Stats, Spectator and Party, auto-detecting your BedWars plugin:
- BedWars2023 and BedWars1058 — all modules
- ScreamingBedWars — arena, stats, spectator
📥 Download on GitHub — BedrockGUI-BedwarsAddon.jar
🏡 Homestead Addon
Native Bedrock forms for the Homestead land-claiming plugin — all 27 of its GUIs, built for you:
- Regions, members, invites & bans, world/global/member flags
- Sub-areas, claimed chunks, map colour & icon
- Levels, rewards, logs, rating, region settings, weather/time
📥 Download on GitHub — BedrockGUI-HomesteadAddon.jar (requires the Homestead plugin)
🗡️ PhoenixDuels Addon
Native Bedrock forms for PhoenixDuels and PhoenixDuelsLite:
- Queues, duel requests, kits and kit previews
- Parties: invites, members, FFA, team fight, multi-team and party challenges
- Stats, leaderboards, match history, spectating, settings and lost items
- Party invites and duel challenges arrive as Yes/No forms instead of chat
📥 Download on GitHub — BedrockGUI-PhoenixDuelsAddon.jar (requires PhoenixDuels or PhoenixDuelsLite)
These addons require BedrockGUI 2.0.12+ on Paper + Floodgate. Prefer your own menus? Each addon has an actions-only mode (integrated-gui: false) that registers its actions without the built-in forms. See the Wiki for setup.
📋 Requirements
- Paper / Folia 1.20.6+ (up to 26.3) on Java 21+
- Velocity 4 on Java 25+, or BungeeCord / Waterfall
- Floodgate on the server running BedrockGUI
On a proxy (Velocity / BungeeCord) forms, conditions and most actions work, but economy, inventory, command_intercept, PlaceholderAPI and the addons need Paper, and BungeeCord has no sound. See the platform comparison.
⌨️ Commands
/bedrockgui open <form> [args] - Opens a form for yourself.
/bedrockgui openfor <player> <form> [args] - Opens a form for another player.
/bedrockgui reload - Reloads all configurations (Permission: bedrockgui.admin).
/bedrockgui convert - Converts an old inline config to one file per form (Permission: bedrockgui.admin).
🛠️ Tools
- Web Designer: Use our visual editor to build your forms without touching a text editor.
- Wiki: For detailed configuration and action examples, visit the BedrockGUI Guide.
评论 0
登录后参与评分
还没有评论,来抢沙发吧