[综合|娱乐|信息]Menu v1.0.0 —— 菜单插件,传统命令与物品界面的替代者 [1.8.3+]

kongkongye

更多文档请进项目主页查看

快速使用

一. 安装
1. 前置插件
需要安装以下几个前置插件:

• Vault
• ProtocolLib
• PlaceholderAPI
  

2. 安装
百度网盘下载
下载好后直接放入插件文件夹,重启服务器即可生效.
注意观察启动时服务器控制后台的输出信息,查看插件是否启动成功.

二. 指令
在游戏内输入/menu,第一次进服默认会打开指导菜单,可在指导菜单的最后面关闭,关闭后,再次输入/menu就会进入主菜单.
输入/menu reload来重载配置(需要控制后台输入或有per.menu.admin权限的玩家输入)

三. 配置
1. 在哪里配置?
插件配置目录内有个main与guide目录,这两个目录是此插件内置注册的配置目录.
推荐在main目录内编辑你的配置,可以复制里面已经有的配置文件参照着编辑.

2. 编辑器
推荐使用菜单配置网页编辑器,操作也很简单:

• 导入: 选择一个现成的xml配置文件,将里面的内容复制粘贴到导入框内,然后点击导入
• 编辑:在导入框的上方是主要的编辑面板,你可以点击来编辑
• 导出:编辑完成后,点击下方的导出按钮,然后点击全选,再按Ctrl+C复制,然后粘贴到xml配置文件中
  

  
3. 简单配置
可以参照main目录内的index-样例菜单.xml文件:

• 文件名的格式是路径-标题.xml
• 有且只有一个根元素menu
• menu元素内有若干line元素,表示有若干行
• line元素内有button元素,表示行内有按钮
• button元素有cmd属性,表示点击按钮会执行cmd内的命令
  

比如你在main目录下新建一个tp-传送菜单.xml配置文件,那么使用命令/menu join main tp可进入此菜单

配置文件

############################### ##       主菜单 ############################### #命名空间排序(不在列表内的会放到最后面) #(会影响主菜单中不同命名空间显示的顺序) namespaceOrder:   - guide   - main ############################### ##       指导菜单 ############################### #是否启用自动指导功能 #开启后,玩家输入'/menu'时会自动进入指导菜单, #可以在指导菜单最后点击'关闭指导菜单' autoGuideEnable: true ############################### ##       显示格式配置 ############################### #标题显示格式 #变量: #  {0}: 代表原标题内容 #  {1}: 代表当前页 #  {2}: 代表最大页 title:   #单页面时(页面数=1)   onePage: "&b&l{0}"   #多页面时(页面数>1)   multiPage: "&b&l{0}&e&l({1}/{2})" #行显示格式 #其中变量{0}代表原行内容 line:   currentAction: "&c ?&e{0}"   notCurrentAction: "&7? &e{0}"   currentNoAction: "&c ?&e{0}"   notCurrentNoAction: "&7? &e{0}"   currentActionSub: "&c   ?&e{0}"   notCurrentActionSub: "&7  ? &e{0}"   currentNoActionSub: "&c   ?&e{0}"   notCurrentNoActionSub: "&7  ? &e{0}" ############################### ##       样式配置 ############################### #输入样式 #其中变量{0}代表原输入内容 #样式可以自定义 inputs:   #样式('@'表示默认样式)   "@":     #当前行     current: "&a?{0}▁"     #非当前行     notCurrent: "&7?{0}▁" #按钮样式 #其中变量{0}代表原按钮内容 #样式可以自定义 buttons:   #样式('@'表示默认样式)   "@":     #当前行+有效     currentValid: "&a?{0}&a?"     #非当前行+有效     notCurrentValid: "&a?{0}&a?"     #当前行+无效     currentNotValid: "&7?{0}&7?"     #非当前行+无效     notCurrentNotValid: "&7?{0}&7?"   hand:     currentValid: "&a{0} &a?"     notCurrentValid: "&a{0} &a?"     currentNotValid: "&7{0} &7?"     notCurrentNotValid: "&7{0} &7?"   same:     currentValid: "{0}"     notCurrentValid: "{0}"     currentNotValid: "{0}"     notCurrentNotValid: "{0}" #子菜单样式 #样式可以自定义 subs:   #样式('@'表示默认样式)   "@":     #当前行+打开     currentOpen: " &a?"     #非当前行+打开     notCurrentOpen: " &7?"     #当前行+关闭     currentClosed: " &a?"     #非当前行+关闭     notCurrentClosed: " &7?" ############################### ##       映射管道配置 ############################### #如果某个值没有对应的映射,则会原样返回 mapPipes:   #管道名   #可自定义管道   bool:     #映射,格式'原值(忽略大小写) 映射值'     #映射值会转换颜色字符&,可包含空格,但不能以空格开头     #提示: 空字符串映射的格式为' 映射值',会正确地解析     - "0 false"     - "no false"     - "1 true"     - "yes true"   bool_str:     - "true 是"     - "false 否"   bool_str_color:     - "true &a是"     - "false &c否"   bool_str_symbol:     - "true &a?"     - "false &c?"   empty:     - " 无"   defaultTitle:     - " 无标题" ############################### ##       翻页配置 ############################### #翻页速度间隔,单位tick,>=0,0表示无间隔限制(1秒包含20tick) #只会对用滚轮切换快捷栏位置来翻页有影响(其它的如用命令或方法调用来翻页的不会被此限制) pageInterval: 5 ############################### ##       高级配置 ############################### #最大菜单数,>=1 #当前菜单+之前的菜单数不会超过这个值 maxMenus: 10 ############################### ##       版本相关配置 ############################### #这里的配置与游戏版本有关,不同版本限制可能不同 #推荐设置为版本允许的最大值 #侧边栏标题最大长度(有的版本可能限制为64),>=1 maxTitleLength: 32 #侧边栏项的最大长度,>=1 #(提示: 程序会保留两个字符,因此减2后是每行的最大长度) #(比如配置为40,某一行有40个字符,实际上会变成两行,第一行38个字符,第二行2个字符) maxLineLength: 40 #侧边栏项的最大行数,[1,16] maxLines: 15 复制代码

语言文件

#基础 lang-2: "&b[菜单]&e{0}" lang-5: "&b[菜单]&e{0}..." lang-8: "&c需要权限: &e{0}" #游戏内提示 lang-10: "&b[菜单]&c菜单未找到,命名空间: &e{0} &c菜单路径: &e{1}&c." lang-15: "&b[菜单]&c页面超出范围,最大页{0}." lang-20: "&b[菜单]&c当前没有菜单." lang-25: "&b[菜单]&c页面不能小于1." lang-30: "&b[菜单]&c指定行不存在." lang-45: "&b[菜单]&c此菜单未启用." lang-50: "&b[菜单]&c输入内容的类型错误." lang-55: "&b[菜单]&c没有当前行." lang-60: "&b[菜单]&c当前没有需要输入的地方." lang-70: "&b[菜单]&c当前没有需要确认的地方." lang-80: "&b[菜单]&c当前按钮未生效,请输入完整变量." lang-90: "&b[菜单]&c未找到有动作的上一行." lang-100: "&b[菜单]&c未找到有动作的下一行." lang-110: "&b[菜单]&c指定行没有动作." lang-115: "&b[菜单]&c上下文有误: {0}" #日志里显示的 lang-120: "未找到类型为'{0}'的菜单上下文变量获取器" lang-130: "菜单上下文类型'{0}'内不包含键名为'{1}'的变量" lang-140: "未找到输入样式'{0}'" lang-150: "未找到按钮样式'{0}'" lang-160: "未找到子菜单样式'{0}'" lang-200: "条件类型'{0}'不存在." lang-210: "条件'{0}'格式错误." lang-215: "注册管道: {0}" lang-220: "注册条件: {0}" lang-230: "注册菜单变量: {0}" lang-240: "上下文属性配置有误: '{0}'." lang-250: "路径重复!命名空间:{0} 路径:{1}" lang-260: "注册菜单配置,命名空间:{0} 目录:{1}" lang-270: "菜单插件启动成功!" #指导功能 lang-500: "玩家{0}" #命令 lang-1000: "&b[菜单]&c此命令只能由玩家发出." lang-1010: "&b[菜单]&a重载配置成功." lang-1020: "&b[菜单]&c重载配置失败." lang-1030: "&b[菜单]&c命令格式有误." lang-1040: "&b[菜单]&c指导菜单已经关闭." lang-1050: "&b[菜单]&a关闭指导菜单成功." lang-1060: "&b[菜单]&c关闭指导菜单失败." lang-1070: "&b[菜单]&c无需关闭." 复制代码

截图

w2200219297

很好的插件