==================================================
菜单插件
==================================================
菜单插件为服务器提供图形化界面，方便玩家进行功能操作，如进入商店、切换分区、查看帮助、快捷指令等。  
本节主要介绍 DeluxeMenus 插件的安装、菜单规划、配置方法和优化建议。

插件简介
==================================================
- 支持高度自定义的 GUI 菜单
- 可与 PlaceholderAPI、Vault、LuckPerms 等插件联动
- 支持点击触发命令、变量显示、权限控制
- 免费开源，长期维护

.. image:: https://wiki.helpch.at/assets/images/deluxemenus-banner.png
   :width: 600px
   :align: center

关键链接
==================================================
- 官方文档: https://wiki.helpch.at/helpchat-plugins/deluxemenus
- 下载地址: https://www.spigotmc.org/resources/deluxemenus.11734/
- 菜单示例: https://wiki.helpch.at/helpchat-plugins/deluxemenus/examples

安装步骤
==================================================
1. 下载 DeluxeMenus.jar，放到所有分区的 plugins 目录
2. 重启服务端，生成默认配置文件
3. 推荐同时安装 PlaceholderAPI，支持变量显示

.. code-block:: bash

    wget https://github.com/HelpChat/DeluxeMenus/releases/latest/download/DeluxeMenus.jar
    cp DeluxeMenus.jar /home/mc/instances/dl1/plugins/
    cp DeluxeMenus.jar /home/mc/instances/dp1/plugins/
    cp DeluxeMenus.jar /home/mc/instances/sc1/plugins/
    cp DeluxeMenus.jar /home/mc/instances/sc2/plugins/
    # 重启所有服务端

菜单规划
==================================================
主页菜单可通过命令或快捷键（如 /menu 或 shift+F）打开，作为各类功能入口。建议包含如下板块：

1. 分区切换入口
2. 帮助文档
3. 系统商店（收购矿物、农作物等）
4. 家目录设置
5. 常用小工具（如 rtp、tpa、tpahere 等）
6. 地皮快捷指令
7. 玩家信息展示（如余额、等级、权限组等）

菜单配置示例
==================================================
DeluxeMenus 的菜单配置采用 YAML 格式，支持多层嵌套和变量调用。  
以下为一个简单的主菜单配置片段：

.. literalinclude:: ../codes/scripts/menu/gui_menus/cmd.yml
   :language: yaml
   :caption: 主菜单


.. literalinclude:: ../codes/scripts/menu/gui_menus/sell.yml
   :language: yaml
   :caption: 商店菜单


脚本化生成菜单
==================================================
如需批量生成矿物、农作物收购菜单，建议用脚本（如 Python/Excel）自动生成 YAML 配置，减少重复劳动。  
可将物品列表、价格等信息整理为表格，批量输出菜单配置片段。

.. code-block:: bash 

  # codes/scripts目录下有脚本。 
  sell.csv是用来定义你要收购的物品的清单的， 列名第一行。 
  generate_and_push_sell.sh 是用来是生成yml文件+推送到服务期的plugins目录的脚本。 
  # 修改的话， 基本就是需要修改sell_header_template.yml 这个模版文件， 或者sell.csv文件即可。
  # 运行脚本：
  ./generate_and_push_sell.sh

权限配置
==================================================
通过 LuckPerms 授权玩家使用菜单命令,这个默认注册命令了， 命令可以检查权限的， 不用单独做权限设置的。 



.. code-block:: bash

   # null

常见问题 QA
==================================================
:Q1: 菜单无法打开或报错？  
:A1: 检查 YAML 格式是否正确，查看服务端日志，确认 PlaceholderAPI 已安装。

:Q2: 菜单变量不显示？  
:A2: 检查 PlaceholderAPI 是否安装并加载对应扩展，变量格式是否正确。

:Q3: 菜单权限无效？  
:A3: 检查 LuckPerms 权限配置，确认已授权 deluxemenus.open.* 相关权限。