
BedrockGUI v2
将原生的基岩版表单带给你的 Java 服务器! BedrockGUI 是一款专为 Paper、Velocity 和 Bungeecord 打造的强大实用工具,允许服务器管理员创建原生的基岩风格交互式表单。通过与 Floodgate 集成,它为基岩版玩家提供无缝的用户体验,同时可通过简单的 YAML 配置进行管理。
🚀 Web 设计器 | 📖 文档 | 💬 Discord 支持
✨ 主要功能
🖼️ 多样化的表单类型
- 简单表单 (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)。
🛠️ 工具
- Web 设计器:使用我们的 可视化编辑器 构建表单,无需触碰文本编辑器。
- Wiki:如需详细的配置示例和动作说明,请访问 BedrockGUI 指南。

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.
🚀 Web Designer | 📖 Documentation | 💬 Discord Support
✨ 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, andconditionalactions 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 nosound. 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.
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BedrockGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
在 Paper 和 Folia 1.20.6 至 26.3(Java 21)、Velocity 4(Java 25)以及 BungeeCord/Waterfall 上运行。表单、条件和大多数操作在所有平台上均有效;economy、inventory、command_intercept、PlaceholderAPI 及插件需要 Paper,而 BungeeCord 不支持 sound。完整表格:Paper, Velocity or BungeeCord?
新增
- 自定义表单组件
label和step_slider。 - 下拉列表中的
{online_players}显示除查看者之外的所有在线玩家。 - 按钮和表单上的
cooldown:功能(支持5、30s、2m、1h)。 open_condition:配合可选的open_condition_message:。on_close:在玩家关闭表单时执行操作。- 玩家看到的所有消息均位于
messages.yml中;技术性错误输出到控制台。 config.yml和messages.yml在启动时添加新键并移除已删除的键,同时保留您的配置值。- 全新安装时包含
pay_player示例表单。
更改
- 步骤失败会停止后续序列,并向玩家显示原因。
- 占位符逐步解析,因此购买后显示的余额是最新的。
- 表单的
permission:在所有平台上保护其command:。BungeeCord 上的表单命令不再需要bedrockgui.form.<id>;请在需要限制的表单上设置permission:。
修复
- 输入的文本和命令参数不再能注入额外操作。
pay向目标存款,若失败则退款;inventory check和remove统计实际物品数量。broadcast过滤生效,permission:、world:和radius:正常工作。- 冒号保留在标题、广播和条件中;标题内请使用
\:。 - 没有操作的按钮不再导致其他按钮移位;
$1不再与$10冲突。 - Velocity 颜色代码和
delay、BungeeCord 控制台命令、Folia 命令分发。 - 不在服务器线程上睡眠;
BARRIER和其他无图标材质不显示图标。 {player}及其他内置占位符可在标题、文本、按钮、标签和输入默认值中使用。conditional处理含冒号的值,分支消息显示来自早期步骤的值。open接受表单 ID 中的占位符;嵌套的random条目被跳过。conditional分支内的delay暂停该分支的其余部分。command_intercept传递输入的参数(如/warp spawn)并捕获 CMI 的/cmi别名。Java 玩家在表单命令上获得清晰的提示信息。- 未能成功加载的插件不再被视为已安装。
- 启动时不再出现针对插件操作的虚假“未知操作”警告。
- 极长的操作值不再导致操作崩溃。
代理(Velocity / BungeeCord)
message操作再次送达玩家,标题、动作栏和消息中支持&和十六进制颜色代码。- Velocity:
sound可用;command在代理上运行代理命令,并将其余命令发送给玩家的后台服务器。 - 代理自行处理
bungee的Connect、ConnectOther、Message和KickPlayer操作。 - 平台无法运行的操作会提示“不可用”,并在启动时列出警告。
- 表单命令:控制台可以为玩家打开表单(例如
shop Steve),检查必需参数,Velocity 对无权限的玩家隐藏这些命令,重新加载时已移除表单的命令也会消失。 /bgui和/bgui open在所有平台的任何人都可以使用;plugin:条件忽略大小写。- 不再出现虚假的“无效图片”警告。
API
- 自定义表单构建器支持
label和stepSlider。 - 构建器方法链式调用:
.content(...).button(...)。 - 使用
build(player)自行交付构建好的表单。 - 向多个玩家发送的构建器能正确响应每一位玩家。
createComponent("input", ...)设置默认值而非占位符;动态表单保持组件顺序。- 新指南:Building an Addon。
插件(需要 BedrockGUI 2.0.12)
- BedrockGUI-EssentialsAddon 1.3.1:套包遵循 EssentialsX 的冷却时间、费用和
essentials.kits.<name>。CMI 传送点、套包和 TPA 功能恢复,并使用 CMI 自身的费用和冷却时间;CMI 家园默认为私有,重命名后仍保持私有。大厅显示宠物,并为缺失的插件隐藏按钮。EconomyShopGUI 子商店链接不再显示“购买 N/A”。仅在模块启用时接管/warp和/kit。 - BedrockGUI-BedwarsAddon 1.1.1:在非比赛期间,商店和升级显示“您必须处于比赛中”;未能成功加载的 BedWars 插件被视为缺失;
/bedwarsaddon reload重建所有模块。BedWars2023 5.0.0 需要 TAB 和 Paper 1.20.6 至 1.21.8。 - BedrockGUI-HomesteadAddon 1.2.1:重新读取输入的文本(邀请、封禁、重命名、描述、转让、子区域、评分、地图颜色和图标);
/hs top打开表单;评分排序显示评分;拒绝拼写错误的玩家名称。需要 Homestead 6.0.0.1 或更高版本。 - BedrockGUI-PhoenixDuelsAddon 1.1.1:确认菜单以 Yes/No 表单形式打开;重新读取输入的回合数和邀请名称。
文档:
V2.0.11 - 大量修复、改进,并适用于最新的 Addons 版本!
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧