[综合]BossShop —— 强大的自定义GUI菜单插件[1.7-1.12]

本帖最后由坑里的轩轩于 2020-10-17 17:15 编辑

BossShop

强大的GUI菜单/商店插件

简介

O V E R V I E W

BossShop是一款支持自定义GUI菜单/商店的万用插件，你可以制作自己的服务器

菜单，让玩家通过点击界面图标来触发各种各样的效果。告别复杂的指令，省去其他

插件冗余的环节，使用便捷、一步到位，只要你能想到，BossShop就做得到！

本贴作为本插件免费版BossShop和付费版BossShopPro的官方授权搬运帖，

关于两款插件的主体、附加插件和使用教程都将于此进行更新，如有需要也可在本贴

下方留言向我咨询相关问题，也可移步官方发布贴反馈插件漏洞和难以解决的问题。

关于

A B O U T

　　插件作者：Blackixx/Felix Neubauer

　　作者资料：https://www.spigotmc.org/members/blackixx.649/

　　BossShop在SpigotMC上的发布页：https://www.spigotmc.org/resources/bossshop-pow...gin.222/

　　BossShop在Bukkit上的帮助页面：https://dev.bukkit.org/projects/bossshop/pages/

　　BossShopPro在SpigotMC上的发布页：https://www.spigotmc.org/resources/bossshoppro-th...699/

　　BossShopPro在SpigotMC上的帮助页面：https://www.spigotmc.org/wiki/bossshoppro/

　　搬运者：坑里的轩轩

　　本贴已获得作者授权，本插件已由作者授权搬运，本贴将随原发布贴持续更新。

　　使用本插件必须遵守以下规定：

不得倒卖、私自传播插件，禁止任何人向其他人提供非官方下载源；
禁止反编译、盗取插件源代码，或以其他任何形式剽窃原作品内容；
禁止在本论坛对插件主体及各自的附加插件进行二次搬运。

　　如有发现任何违反以上条例的行为，可以点击此处协助我进行举报，也可以通过上方信息与我或作者取得联系。

　　搬运本插件耗费了我很多精力，本贴所有内容都由本人亲自查阅资料和联系作者、经仔细确认后再进行发布。

　　希望大家在愉快使用的同时，给予我一份认可和支持，你可以通过点击本贴下方评分按钮对本搬运帖进行评价，

　　大家的每一颗金粒、每一份人气，都将鼓励我不断努力下去。

　　在今后，我将为大家搬运更多的优质插件，你可以点击上方我的头像加我为好友，及时了解我的最新动态。

功能

F E A T U R E S

　　注：红色字体为本插件付费版BossShopPro的功能。

玩家可使用木牌、指令或手持特定物品左/右键来打开菜单
支持多种点击图标触发的效果：
- 给予物品
- 给予金钱（需要前置插件Vault，点击此处直接下载最新版）
- 给予经验
- 给予权限（需要前置插件Vault，点击此处直接下载最新版）
- 给予点券（支持PlayerPoints、CommandPoints、Enjin Points、PointsAPI、TokenEnchant、Jobs、VotingPlugin、Kingdoms）
- 给予最大数量某物品（填充玩家背包）
- 触发延时指令（需要前置插件ScheduledCommands，点击此处直接下载最新版）
- 使控制台运行命令（支持多个命令）
- 使玩家运行命令（支持多个命令）
- 使玩家以管理员身份运行命令（支持多个命令）
- 使BungeeCord服务端运行命令（支持多个命令）
- 使玩家手持物品附魔
- 跳转到另一个菜单
- 将玩家传送到其他服务器（BungeeCord和Lilypad服务器专用）
- 跳转到玩家商店的其他页
- 不触发任何效果
支持多种触发条件：
- 支付物品
- 支付经验
- 支付金钱
- 支付点数
- 支付背包内全部某物品
- 无条件
自定义菜单图标属性：
- ID
- 名称（支持多种变量，点击此处查看BossShop变量，点击此处查看BossShopPro变量）
- 描述（支持多种变量，点击此处查看BossShop变量，点击此处查看BossShopPro变量，如果过长可自动换行）
- 数量
- 数据值
- 附魔效果
- 药水效果（药水专用）
- 颜色（皮革装专用）
- 头颅材质（头颅专用，支持自定义材质和玩家头颅材质）
- 书的标题、作者及内容（成书专用）
- 怪物种类（刷怪笼及刷怪蛋专用）
自定义界面属性：
- 标题（支持多种变量）
- 行数（原则上支持无限行，但出于美观原因建议在6行以内）
- 图标位置
- 刷新延时
图标连点保护系统，防止玩家通过恶意连续点击图标卡服（可自定义多少秒内最多点击图标多少次）
无延时加载，服务器启动后就可以开始使用菜单
针对不同玩家设置不同的价格（折扣或加价，例如对赞助者折扣，对普通玩家加价）
服务器ping信息展示（BungeeCord服务器专用，点击此处查看使用教程）：
- 某个服务器的玩家数量
- 某个服务器的MOTD
- 玩家总数
- 延迟
提示信息，例如玩家金钱不足时出现在聊天区的提示
定时记录玩家操作行为（可选）
自动更新插件（可选）
支持PlaceHolderAPI
当商店物品超出时，自动增加页数（点击此处查看使用教程）
支持多种音效（例如打开菜单的音效、点击图标的音效、金钱不足时的音效）
支持鼠标左键、鼠标右键、鼠标中键、shift+鼠标左键、shift+鼠标右键点击同一图标触发不同的效果（点击此处查看使用教程）
显示数字缩略形式（如将『14027』显示为『14k』）
自动使售出物品显示在商店下一空位
为不同菜单绑定不同指令，使玩家通过不同指令打开不同菜单（支持为统一菜单绑定多条指令）
针对不同情况改变菜单图标（例如金钱足够时显示『可购买』图标，不够时显示『不可购买』图标，点击此处查看使用教程）：
- 金钱
- 点券
- 生命值
- 饥饿值
- 物品数量
- 权限
- 权限组
- 玩家坐标
- 世界时间
- 玩家数量
- 真实年、月、日、小时、分钟、秒、毫秒

指令

C O M M A N D S

　　注：红色字体为本插件付费版BossShopPro的指令。

/bs - 打开主菜单
/bs <shop> - 打开指定菜单
/bs open <shop> <playername> - 为某玩家打开指定菜单
/bs close <playername> - 为某玩家关闭菜单
/bs reload - 重载插件全部内容
/bs check - 检视插件
/shop read - 查看主手物品信息
命令别名（可替换/bs部分）：
- /shop
- /BossShop
你可以自行增加或删除命令别名

教程

T U T O R I A L

　BossShop篇：

　　　BossShop的组成如下，其中黄色代表文件夹，蓝色代表可编辑的.yml文件，且shops文件夹下的菜单

　　　有两种分布方式：

　　　　· BossShop的组成：

　　　　　　· config.yml - 总体设置文件

　　　　　　· messages.yml - 插件提示语文件

　　　　　　· shops - 存放菜单的文件夹

　　　　一、config.yml配置教程

简体中文版

# BossShop

# 作者：Felix Neubauer

# 请移步右侧网站查看更多相关信息：http://dev.bukkit.org/bukkit-plugins/bossshop/pages/configuration/

# 帮助链接：

# BossShop插件发布页面（旧版）：

# http://dev.bukkit.org/bukkit-plugins/bossshop/

# 所有版本下载链接：

# http://dev.bukkit.org/bukkit-plugins/bossshop/files/

# 嘿！

# 你开始使用BossShop了吗？太棒了。

# 相信我：配置起来很容易。

# 你可以通过最经典（无聊且不方便）的方式来编辑config文件，

# 或者通过"老板"的方式来进行配置：使用"BossShopConfigure"（一个可以让你点几下鼠标就能轻轻松松配置插件的小工具）。

# 你可以在这里下载到BossShopConfigure：http://dev.bukkit.org/bukkit-plugins/bossshop/

# EnableSigns:

# 如果设置为'false'，本插件将停用。

EnableSigns: true

# MainShop:

# 这里填写主菜单名称。当有人使用指令'/bossshop'是，这个菜单就会被打开。其他菜单可以供过指令'/bossshop <菜单名>'打开。

# 并且，所有菜单都可以通过木牌打开（前提是该功能已开启），或者通过点击特定物品打开（如果你安装了'GuiShopManager'）。

MainShop: Menu

# AdvancedSecurity:

# 当这项被开启时，在打开菜单的情况下玩家无法移动背包内的物品。这个功能可以100%保证菜单安全。

# 其实在一般情况下都不会刷物品，但在Cauldron-1.7服务器中存在这个bug，开启这个选项可以修复这个问题。

AdvancedSecurity: false

# HideItemsPlayersDoNotHavePermissionsFor:

# 当启用该项时，没有权限的玩家将看不到图标。你可以凭此做一些很酷的功能，比如升级系统。

# 你可以把多个图标放在同一槽，并隐藏不想启用的图标。比如制作升级系统时，你可以隐藏旧的升级图标，只显示下一个升级图标。

HideItemsPlayersDoNotHavePermissionsFor: false

# CanPlayersSellItemsWithGreaterEnchants:

# 当启用该项功能时，玩家可以向商店出售附魔等级更高的道具。这样可以帮助玩家处理附魔废品。

# 但这也可能导致玩家手误，得不偿失。

CanPlayersSellItemsWithGreaterEnchants: false

# EnableTransactionLog:

# 当启用该项时，所有进程都会被记录在文档中。

EnableTransactionLog: false

# SearchSubfoldersForShops:

# 当启用该项时，插件将从'shops'目录下的子文件夹中读取菜单文件。开启这个功能可以很方便地为大量菜单分类。

SearchSubfoldersForShops: false

# ServerPingingDelay:

# 服务器Ping延时，以游戏刻为单位（20游戏刻=1秒）。

ServerPingingDelay: 20

# AllowUnsafeEnchantments:

# 当启用该项时，插件将允许等级超常的附魔。

AllowUnsafeEnchantments: false

# DisableUpdateNotifications:

# 当关闭该项时，你不会再收到任何更新提示。

DisableUpdateNotifications: false

# MultiplierGroups:

# 你可以在此设置价格倍率。

# 当启用该项时，拥有相关权限的玩家将受到相应的加价或折扣。

# 格式如右侧所示：<权限>:<种类>:<倍率>。

# <权限>：该项完全自定义。如果你想让整个权限组的玩家都受到加价或折扣，给予权限组该权限即可。

# <种类>：此处填写加价种类。此处选填：Money、Points,、Exp。

# <倍率>：实际价格=原价×倍率。

# 玩家可同时拥有不同的"MultiplierGroups"。

MultiplierGroups:

Enabled: false

List:

- BossShop.PriceMultiplier.Points:points:0.75

- BossShop.PriceMultiplier.Money:money:0.5

- BossShop.PriceMultiplier.MoneyNegative:money:2.0

- BossShop.PriceMultiplier.Exp:exp:0.8

# PointsPlugin:

# 该项只在服务器安装有点券插件的情况下有用。

# 这里填写点券插件种类。BossShop将和指定的点券插件相关联。

# 当你安装有多款点券插件时，只能在下面填写一个点券插件的名字，BossShop将选择它们作为自己的点券系统。

# 此处选填：'PlayerPoints', 'CommandPoints', 'EnjinMinecraftPlugin'/'Enjin', 'PointsAPI', 'Kingdoms', 'Jobs', 'TokenEnchant'、'VotingPlugin'。

PointsPlugin: auto-detect

English Version

# BossShop

# by Felix Neubauer

# Check out following page for more information: http://dev.bukkit.org/bukkit-plugins/bossshop/pages/configuration/

# Help Links:

# BossShop Page:

# http://dev.bukkit.org/bukkit-plugins/bossshop/

# Downloads:

# http://dev.bukkit.org/bukkit-plugins/bossshop/files/

# Hey!

# You got BossShop? Awesome.

# Believe me: Setting it up is simple.

# You can either set it up the Classic (And boring/hard) way with editing the Config Files

# OR you can edit it the Boss way: Use "BossShopConfigure" (An awesome software which allows simple Setup with a few clicks).

# You can download BossShopConfigure here: http://dev.bukkit.org/bukkit-plugins/bossshop/

# EnableSigns:

# If set EnableSigns to 'false' BossShop signs will be disabled.

EnableSigns: true

# MainShop:

# That's the name of your Main Shop. Whenever someone uses '/bossshop', this Shop is opened. Other Shops can be opened via '/bossshop <shop>'.

# Also, all Shops can be opened via Sign (If Signs are enabled) or with clicking a specific Item (If you have 'GuiShopManager' installed).

MainShop: Menu

# AdvancedSecurity:

# When enabled players are not able to move items around in their inventory while a BossShop is open. This option will make shops 100% secure.

# Duping items should not be able in any case, however there were some issues on kCauldron-1.7 servers which can be solved with this option.

AdvancedSecurity: false

# HideItemsPlayersDoNotHavePermissionsFor:

# If enabled all Items your players do not have permissions for will be "hidden". That way you can create cool things like upgrade systems:

# Put multiple Items on the same slot and hide the ones which are not available any more. For example if you work with upgrades, hide the old upgrade and show the next one.

HideItemsPlayersDoNotHavePermissionsFor: false

# CanPlayersSellItemsWithGreaterEnchants:

# If enabled players can sell items with greater enchants than needed to a shop that allows to sell items. That might be helpful when dealing with items with bad enchants,

# but also might lead to accidently selling items below their worth.

CanPlayersSellItemsWithGreaterEnchants: false

# EnableTransactionLog:

# If enabled all Transactions will be logged in a TransactionLog file.

EnableTransactionLog: false

# SearchSubfoldersForShops:

# If enabled BossShop will search children folders of the '/shops' directory for shop files. That can be quite helpful for sorting, when dealing with a big amount of shops.

SearchSubfoldersForShops: false

# ServerPingingDelay:

# ServerPinging Delay in ticks (20 ticks = 1 second). Relevant only when working with ServerPinging: dev.bukkit.org/bukkit-plugins/bossshop/pages/server-pinging/

ServerPingingDelay: 20

# AllowUnsafeEnchantments:

# If enabled you can set up items with insane enchants like knockback level 10 or a mad cookie that burns players.

AllowUnsafeEnchantments: false

# DisableUpdateNotifications:

# If disabled you won't get Update notifications any more.

DisableUpdateNotifications: false

# MultiplierGroups:

# Here you can set up Price multipliers.

# If enabled, this MultiplierGroups will be loaded and players with the right permissions will get a price decrease/increase.

# The lines of the List look like this: <Permission>:<Type>:<Multiplier>.

# <Permission>: Here you can put in whatever you want. If you want a group to have this multiplier, just give that group your permission.

# <Type>: Multiplier Type. Valid: Money, Points, Exp

# <Multiplier>: Price = old Price * Multiplier

# Players can be in multiple "MultiplierGroups" at the same time.

MultiplierGroups:

Enabled: false

List:

- BossShop.PriceMultiplier.Points:points:0.75

- BossShop.PriceMultiplier.Money:money:0.5

- BossShop.PriceMultiplier.MoneyNegative:money:2.0

- BossShop.PriceMultiplier.Exp:exp:0.8

# PointsPlugin:

# Only important if you work with Points.

# Here you can enter whatever you want. BossShop will always detect the Points Plugin you are using and it will hook into it

# (If you are using one). If you use multiple Points Plugins fill in the name of the one that you want BossShop to work with.

# 'PlayerPoints', 'CommandPoints', 'EnjinMinecraftPlugin'/'Enjin', 'PointsAPI', 'Kingdoms', 'Jobs', 'TokenEnchant', 'VotingPlugin'.

PointsPlugin: auto-detect

　　　　二、messages.yml配置教程

简体中文版

English Version

　　　　三、菜单配置教程

格式说明

此处以制作一个简易菜单为例进行讲解，不如先来看看做好的样子吧：

ShopName: menu # 这里填写菜单名，请注意菜单名和文件名无关。

DisplayName: '&2&l简易菜单' # 这里填写GUI菜单标题，它将显示于菜单顶部。

signs:

text: '[menu]' # 这里填写木牌菜单标题，在木牌首行填写相同文字后，拥有相关权限的玩家通过木牌就能打开菜单。

NeedPermissionToCreateSign: true # 玩家是否需要权限才能使用木牌。

shop:

icon1: # 图标名称，可任意填写，但必须保证独一无二。

RewardType: PlayerCommands # 点击图标后触发的内容种类，可选填：Items、Money、Permissions、Commands、PlayerCommands、Points、Enchantments、Shop、BungeeCordServer、LilypadServer、Nothing。各项的意义请见本贴下方Wiki解释。

Reward: # 该项目下填写触发的具体内容，具体情况请按具体格式填写，详情请参照本贴下方Wiki解释。

- spawn

PriceType: Money # 使用图标的条件种类，可选填：Items、Exp、Money、Points、Free。各项的意义请见本贴下方Wiki解释。

Price: 20 # 该项目下填写使用图标的具体条件，具体情况请按具体格式填写，详情请参照本贴下方Wiki解释。

MenuItem: # 该项下所有带有'-'的项目均为图标属性项，它们决定了图标的名称、描述、ID、数据值、耐久度等等，详见本贴下方Wiki。

- name:&6&l&n点击回城 # 图标名称

- lore:&2你的金钱: &a%balance% # 图标描述1（显示在第1行）

- lore:&7欢迎回到托马斯小镇! # 图标描述2（显示在第2行）

- type:SKULL_ITEM # 图标种类

- amount:1 # 图标数量

- durability:3 # 图标数据值

- playerhead:%name% # 图标使用的玩家头颅材质

Message: '' # 图标被成功触发后显示在使用者聊天区的内容。

InventoryLocation: 1 # 图标的位置。

ExtraPermission: '' # 使用该图标所需拥有的权限。

icon2: # 第二个图标。可以参考上面的图标。

RewardType: PlayerCommands

Reward:

- warp heiansenlin

PriceType: Free

MenuItem:

- id:2

- amount:1

- name:&a&l&n前往黑暗森林

- lore:&7这里是危险的世界, 有怪物出没。

Message: ''

InventoryLocation: 2

ExtraPermission: ''

权限

P E R M I S S I O N S

　　注：红色字体为本插件付费版BossShopPro的权限。

BossShop.open - 允许通过指令/木牌打开菜单
BossShop.open.sign - 允许通过木牌打开菜单
BossShop.open.sign.<菜单名称> - 允许通过木牌打开指定菜单
BossShop.open.command - 允许通过指令打开菜单
BossShop.open.command.<菜单名称> - 允许通过指令打开指定菜单
BossShop.open.other - 允许为其他玩家打开菜单
BossShop.close - 允许关闭当前菜单
BossShop.createSign - 允许创建可以打开菜单的木牌
BossShop.reload - 允许重载插件
BossShop.check - 允许检视插件
BossShop.bypass - 忽略图标点击频率检测

展示

E X A M P L E S

下载

D O W N L O A D

MCStats下载量统计

截至目前，BossShop在SpigotMC和Bukkit的下载量总计已达464267次，

它也许是目前两大平台全部插件中功能最全、质量最好、下载量最高的GUI菜单插件。

相比另一款功能类似的插件ChestCommandsGUI，BossShop拥有更多的功能、更棒的优化，

且作者提供免费的技术帮助。你可以随时在SpigotMC提出自己的困惑，或者分享自己制作的菜单。

BossShop发布于2013年9月4日，直至今天，作者一直保持插件的更新。而ChestCommandsGUI的

发布时间为2013年5月5日，虽然比BossShop提前4个月时间，却没有像BossShop一样坚持更新。

ChestCommandsGUI于2016年5月17日就已停止更新，其作者也再没发表过与插件相关的任何内容。

因此，无论从功能种类、实用性还是技术含量上讲，ChestCommandsGUI都是无法与BossShop相媲美的。

你甚至可以通过它来制作一些新奇有趣的功能，例如随机抽奖系统、打地鼠小游戏、合成表、玩家广告位。

本插件提供免费（BossShop）和付费（BossShopPro）两种版本，付费插件当前售价为11.99美元，约合

人民币79元，你可以通过下载免费版试用，也可以购买付费版来永久享受插件的全部功能和作者的技术帮助！

点击直接下载最新版BossShop　点击进入BossShopPro购买页

你需要先注册一个SpigotMC账号才能购买BossShopPro，并且需要一个PayPal账户来支付款项。

如果你在购买上遇到了问题，可以联系我代购插件，我的联系方式请见本贴最上方『关于』一栏。

插件

A D D O N S

　　BossShop提供了许多官方插件，它们都出自同一作者，以满足一些用户的特殊需要。

　　你可以下载它们来使用一些延伸功能。

　　注：红色字体为本插件付费版BossShopPro的插件。

GuiShopManager - 使用左键/右键点击背包或快捷栏内的指定物品打开特定菜单（BossShop专用版）
BS-SingleUse - 限制物品购买次数
GuiShopManager - 使用左键/右键点击背包或快捷栏内的指定物品打开特定菜单（BossShopPro专用版）
ThirdCurrency - 增加第三种货币
TrickyShops - 更方便地创建玩家商店
ItemShops - 更便捷的系统商店
PlayerShops GUI - 允许玩家创建自己的GUI商店
LimitedUses - 为商店图标设置冷却时间和使用次数限制
EssentialsGUI - 更方便的Kit礼包领取和Warp地标传送系统（需要Essentials插件）

帮助

H E L P

　　由于BossShop在Bukkit上的Wiki有许多内容存在过期、错误、缺失的现象，我将于此根据旧版内容重写Wiki。

　　而BossShopPro拥有内容详细且错误率极低的Wiki，你可以点击此处查看BossShopPro官方Wiki。

　　有用的参考文献：

　　"【BossShop】[PCD]全面教程+配合其他插件制作完美菜单" - 作者：Auange_M夜幕

　　http://www.mcbbs.net/thread-690682-1-1.html

　　"[Wiki][PCD]BossShop-老板商店Wiki翻译" - 作者：Smokey_Days

　　http://www.mcbbs.net/thread-684102-1-1.html

常见问题集锦

　　有更多问题？欢迎在本帖留言或移步SpigotMC给作者留言获取帮助！

开源

O P E N S O U R C E

　　BossShop不但是一款玩家爱不释手的实用工具，也是供开发者们交流探讨学习的优秀作品。

　　作者提供的开源协议：

The license being used is "All Rights Reserved" as shown here: https://dev.bukkit.org/projects/bossshop,
however in certain circumstances I grant concrete people special rights.

　　作者已将其源代码发表至GitHub，你可以免费下载其开源内容，但请务必遵守以下规则：

开源内容仅供交流使用，禁止任何人通过修改源代码来作为自己的作品进行发布；
禁止将源代码复制到自己的工程中使用；
禁止一切形式二次发表；

点击进入GitHub查看开源内容

[综合]BossShop —— 强大的自定义GUI菜单插件[1.7-1.12]

回复: