HexaForms

插件

· 作者 einfxchwolf

HexaForms – 支持 Java 版与基岩版的 Minecraft 菜单插件,兼容 PlaceholderAPI。 功能:跨平台表单、YAML 菜单、条件判断、动作(命令、消息、音效、经济系统、经验值、权限)、附魔/发光效果。 设置:安装 PlaceholderAPI(+ Floodgate/Geyser),添加 Menu

0 本站下载 0 关注 更新于 6 个月前

最新 1.1.3 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

HexaForms

一个适用于 Minecraft 服务器的先进菜单系统,支持 PlaceholderAPI 集成、基岩版表单支持以及 DeluxeMenus 转换。

功能特性

  • Java 版与基岩版支持:自动检测基岩版玩家并显示原生表单
  • 下拉菜单:为基岩版玩家提供带有自定义选项的交互式下拉菜单
  • 多步下拉表单:支持包含三个下拉步骤的高级表单,用于处理复杂的选择(如封禁命令等)
  • DeluxeMenus 转换器:自动将 DeluxeMenus 配置转换为 HexaForms 格式
  • PlaceholderAPI 集成:完全支持所有 PlaceholderAPI 占位符
  • 灵活配置:基于 YAML 的简单菜单配置方式
  • 条件检查:针对菜单项的高级条件判断功能
  • 动作系统:内置 30 多种动作,包括执行命令、发送消息、播放音效、触发下拉操作等
  • 附魔支持:支持附魔效果及发光特效
  • 经济与权限管理:集成 Vault,用于经济系统与权限管理的动作支持

安装指南

  1. 确保已安装以下插件:

    • PlaceholderAPI(必需)
    • Floodgate(可选,用于基岩版支持)
    • Geyser(可选,用于基岩版支持)
    • Vault(可选,用于经济/权限相关动作)
  2. 将 HexaForms.jar 下载至你的 plugins 文件夹中

  3. 重启服务器

  4. 在 plugins/HexaForms/menus/ 文件夹中配置菜单

快速入门

转换 DeluxeMenus(新功能)

如果您正在从 DeluxeMenus 迁移:

  1. 将您的 DeluxeMenus .yml 文件放入 plugins/HexaForms/dmconvert/
  2. 运行 /hexaconvert deluxemenus all(或 /hexaconvert deluxemenus <filename>)
  3. 转换后的菜单会出现在 plugins/HexaForms/menus/

详见 CONVERTER_README.md 获取详细的转换指南。

创建菜单

在 plugins/HexaForms/menus/ 中创建一个 YAML 文件:

title: "&6&lShop Menu"
size: 27

bedrock_form:
  title: "&6&lShop Menu"
  content: "&7Purchase items and equipment"
  buttons:
    - text: "&a&lWeapons"
      actions:
        - "[command] shop weapons"
        - "[sound] ENTITY_PLAYER_LEVELUP 1 1.5"

items:
  weapons_button:
    slot: 10
    material: DIAMOND_SWORD
    display-name: "&a&lWeapons"
    lore:
      - "&7Click to browse weapons"
    glowing: true
    actions:
      - "[command] shop weapons"

配置

主配置文件 (config.yml)

messages:
  player-only: "&cThis command can only be used by players!"
  menu-not-found: "&cMenu '%menu%' not found!"
  no-permission: "&cYou don't have permission!"
  condition-denied: "&cYou don't meet the requirements for this!"
  reloaded: "&aPlugin reloaded successfully!"

default-menu: "main_menu"
auto-save: true
debug-mode: false

placeholders:
  enabled: true
  cache-time: 1000

bedrock:
  enabled: true
  fallback-to-java: true
  image-cache: true

命令

  • /menu [menuName] - 打开菜单(默认:main_menu)
  • /menureload - 重新加载配置
  • /hexaconvert <deluxemenus> <all|file_name> - 将 DeluxeMenus 转换为 HexaForms(NEW!)

权限

  • hexaforms.menu.use - 允许访问菜单(默认:true)
  • hexaforms.reload - 允许重新加载插件配置(默认:op)
  • hexaforms.admin - 允许访问管理菜单(默认:op)
  • hexaforms.convert - 允许使用转换命令(默认:op)(NEW!)

动作

命令动作

  • [command] <command> - 以玩家身份执行命令
  • [console] <command> - 从控制台执行命令
  • [commandevent] <command> - 以玩家身份执行未注册的命令

消息动作

  • [message] <text> - 向玩家发送消息
  • [broadcast] <text> - 向所有在线玩家广播消息
  • [minimessage] <text> - 使用 MiniMessage 格式发送消息
  • [minibroadcast] <text> - 使用 MiniMessage 格式广播消息
  • [json] <JSON-text> - 向玩家发送 JSON 消息
  • [jsonbroadcast] <JSON-text> - 广播 JSON 消息
  • [chat] <message> - 以玩家身份在聊天中发送消息

菜单控制动作

  • [command] menu <menu-name> - 打开另一个菜单
  • [close] - 关闭当前打开的菜单
  • [refresh] - 刷新当前菜单视图中的物品

网络动作

  • [connect] <server-name> - 将玩家连接到 BungeeCord 上的服务器

声音动作

  • [sound] <sound> <volume> <pitch> - 为玩家播放声音
  • [broadcastsound] <sound> <volume> <pitch> - 向所有玩家广播声音
  • [broadcastsoundworld] <sound> <volume> <pitch> - 向世界中所有玩家广播声音

经济动作(需要 Vault)

  • [givemoney] <amount> - 给予玩家金钱
  • [takemoney] <amount> - 扣除玩家的金钱

经验值动作

  • [giveexp] <amount>L - 给予玩家经验等级(添加 L)或经验点
  • [takeexp] <amount>L - 扣除玩家的经验等级或经验点

权限动作(需要 Vault)

  • [givepermission] <perm.node> - 给予玩家权限
  • [takepermission] <perm.node> - 移除玩家的权限

元数据动作

  • [meta] <set/remove/add/subtract/switch> <key> <type> <value> - 修改玩家元数据

占位符动作

  • [placeholder] <papi-placeholders> - 解析玩家的占位符

下拉菜单动作(仅限基岩版)

玩家下拉菜单

[playerdropdown] <title>|<content>|<actions>

显示包含所有在线玩家的下拉列表。

占位符:

  • %selected_player% - 选中的玩家名称
  • %player_name% - 执行操作的玩家名称

示例:

- "[playerdropdown] &6Teleport|&7Select a player:|[console] tp %player_name% %selected_player%;[message] &aYou have been teleported!"

自定义下拉菜单

[dropdown] <title>|<content>|<options>|<actions>

显示包含自定义选项的下拉列表。

占位符:

  • %selected_option% - 被选中的选项文本
  • %selected_index% - 被选中选项的索引(从 0 开始)

示例:

- "[dropdown] &a游戏模式|&7选择:|生存,创造,冒险|[console] gamemode %selected_option% %player_name%"

多下拉菜单(NEW!)

[multidropdown] <标题>|<内容>|<标签1>|<标签2>|<标签3>|<选项1>||<选项2>||<选项3>||<操作>

在一个表单中显示三个下拉菜单。非常适合用于封禁指令!

占位符:

  • %selected_option_1%, %selected_option_2%, %selected_option_3% - 选中的选项
  • %selected_index_1%, %selected_index_2%, %selected_index_3% - 选中的索引

示例(封禁命令):

- "[multidropdown] &c&l封禁玩家|&7选择玩家、时长和原因|Player|Duration|Reason|Player1,Player2,Player3||1h,24h,7d,Permanent||Hacking,Spam,Beleidigung||[console] ban %selected_option_1% %selected_option_2% %selected_option_3%;[message] &a%selected_option_1% was banned!"

操作示例

actions:
  # 命令
  - "[command] warp spawn"
  - "[console] give %player_name% diamond 1"
  
  # 消息
  - "[message] &a欢迎来到商店!"
  - "[broadcast] &6%player_name% 进入了商店!"
  - "[minimessage] <gradient:green:blue>欢迎!</gradient>"
  
  # 音效
  - "[sound] ENTITY_PLAYER_LEVELUP 1 1.5"
  - "[broadcastsound] ENTITY_EXPERIENCE_ORB_PICKUP 1 1"
  
  # 经济
  - "[givemoney] 1000"
  - "[takemoney] 500"
  
  # 经验值
  - "[giveexp] 10L"
  - "[takeexp] 5"
  
  # 权限
  - "[givepermission] shop.vip"
  - "[takepermission] shop.basic"
  
  # 菜单控制
  - "[command] menu vip_shop"
  - "[close]"
  - "[refresh]"
  
  # 下拉菜单(仅限基岩版)
  - "[playerdropdown] 选择玩家|请选择:|[console] tp %player_name% %selected_player%"
  - "[dropdown] 选择|请选择:|Option1,Option2|[message] 你选择了 %selected_option%!"
  • "[multidropdown] Ban|选择玩家、时间、原因|玩家|时间|原因|P1,P2||1h,24h||Hack,Spam||[console] ban %selected_option_1% %selected_option_2%"

## 条件

### 可用条件类型

- `permission:<权限>` - 检查权限
- `placeholder:<占位符> <运算符> <值>` - 检查占位符值
- `world:<世界名>` - 检查玩家所在的世界
- `gamemode:<游戏模式>` - 检查游戏模式
- `time:<范围>` - 检查游戏时间

### 示例

```yaml
conditions:
  - "permission:shop.weapons"
  - "placeholder:vault_eco_balance >= 1000"
  - "world:world"
  - "gamemode:survival"
  - "time:0-12000"

PlaceholderAPI

该插件支持所有 PlaceholderAPI 占位符:

  • %player_name% - 玩家名称
  • %vault_eco_balance% - 账户余额(Vault)
  • %player_health% - 玩家生命值
  • %player_world% - 当前世界
  • 以及更多……

Bedrock 支持

对于 Bedrock 版玩家,原生表单将自动显示:

  • 自动检测 Bedrock 版玩家
  • 支持下拉选项的原生表单 API
  • 图片支持(URL 和路径)
  • 用于选择玩家/选项的交互式下拉菜单
  • 支持复杂选择的复选下拉表单
  • 若出现问题,则回退至 Java 版菜单

示例菜单

该插件包含多个示例菜单:

  • main_menu.yml - 主导航菜单
  • teleport_menu.yml - 玩家传送带下拉菜单(基岩版)
  • shop_menu.yml - 包含物品和分类的商店
  • admin_menu.yml - 管理员工具与命令

故障排除

常见问题

  1. 菜单未显示:检查权限和配置
  2. 占位符无效:确保已安装 PlaceholderAPI
  3. 基岩版表单无法使用:检查 Floodgate/Geyser 的安装情况
  4. 下拉菜单不显示:仅适用于基岩版玩家——Java 版玩家看到的是箱子菜单
  5. 转换器无法使用:将 DeluxeMenus 文件放入 plugins/HexaForms/dmconvert/ 目录中

调试模式

在 config.yml 中启用调试模式:

debug-mode: true

版本历史

详细版本历史请参阅 CHANGELOG.md。

当前版本: 1.1.2

  • 新增 DeluxeMenus 转换器
  • 新增多级下拉操作
  • 修复基岩版表单的颜色代码处理问题
  • 增强占位符支持

技术支持

如有问题或疑问:

  1. 检查服务器日志
  2. 确保所有依赖项已安装
  3. 使用调试模式进行测试
  4. 查看 CHANGELOG.md 了解最近的更改

许可证

本插件采用 CC-BY-NC-4.0 许可协议。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源