ChestCommands从入门到精(入)通(坟)[1.7+~1.13]

本帖最后由 Zapic 于 2019-9-30 16:50 编辑

废话

===========正题分界线==========

插件权限/指令

配置文件

1.config.yml

2. lang.yml

这个文件是干啥在这里的?
这是一个语言文件,可以修改插件在游戏里的提示信息.
默认配置:

no-open-permission: '&cYou don''t have permission &e{permission} &cto use this menu.'
default-no-icon-permission: '&cYou don''t have permission for this icon.'
open-menu: '&aOpening the menu "{menu}".'
no-exp: '&cYou need {levels} XP levels for this.'
menu-not-found: '&cMenu not found! Please inform the staff.'
no-money: '&cYou need {money}$ for this.'
no-required-item: '&cYou must have &e{amount}x {material} &c(data value: {datavalue}) for this.'
open-menu-others: '&aOpening the menu "{menu}" to {player}.'
any: any

复制代码

简单的解释:

属性	默认值	作用
no-open-permission	You don''t have permission {permission} to use this menu.	当无权限"chestcommands.open.文件名.yml"时尝试打开相应菜单时会在聊天框发出这个提示. 其中"{permission}"是对应权限.
default-no-icon-permission	You don''t have permission for this icon.	当没有权限使用这个选项时而又没有设置自定义提示语时会发出这个提示
open-menu	Opening the menu "{menu}".	使用"/cc open <文件名>" 打开菜单时会发出这个提示. 其中"{menu}"为打开的菜单.
no-exp	You need {levels} XP levels for this.	当点击一个需要经验的选项而没有足够经验时会弹出这个提示. 其中"{levels}"为所需经验等级数.
menu-not-found	Menu not found! Please inform the staff.	当尝试打开一个不存在的菜单时会发出这个提示.
no-money	You need {money}$ for this.	当点击一个需要经济的选项而没有足够金钱时会弹出这个提示. 其中"{money}"为所需经验金钱数.
no-required-item	You must have {amount}x {material} (data value: {datavalue}) for this.	当点击一个需要指定物品的选项而没有足够的指定物品时会弹出这个提示. 其中"{amount}"为所需物品数,"{material}"为所需物品名, "{datavalue}"为物品数据值(1.13+已移除数据值支持)
open-menu-others	Opening the menu "{menu}" to {player}.	当使用" /cc open <文件名> [玩家]"指令打开菜单时会发出这个提示. 其中"{menu}"为打开的菜单,"{player}"为目标玩家.
any	any	任何,当"no-required-item"提示中的"{datavalue}"在菜单中没有指定时会使用这个代替空白.

简单的汉化(仅供参考):

no-points: '&c你需要&e{points}&c点券来这样做.'
no-open-permission: '&c你没有权限&e"{permission}"&c来打开这个菜单'
default-no-icon-permission: '&c权限不足'
open-menu: '&a正在打开菜单"{menu}".'
no-exp: '&c你需要&e{levels}&c经验等级来这样做.'
menu-not-found: '&c菜单不存在,请联系管理员'
no-money: '&c你需要&e{money}&c来这样做'
no-required-item: '&c你需要&e{amount}&cx&e{material}(data value: {datavalue})&c来这样做'
open-menu-others: '&a为{player} 打开菜单"{menu}" .'
any: 任何

复制代码

其实也可以自己去自定义啦~

3.placeholders.yml

===========重头戏分界线===========

如何写一个菜单?

1.菜单的组成

这是一个完整的示例:
menu.yml:

menu-settings:
name: '&lTest'
rows: 6
command: '233'
auto-refresh: 1
open-action: ''
open-with-item:
id: stick
left-click: false
right-click: false
test:
ID: stone
POSITION-X: 1
POSITION-Y: 1
NAME: '&6测试'
LORE:
- '物品属性1'
- '&c带颜色的物品属性2'
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
COMMAND: 'spawn;op: say hello;console: say console message;sound: PLAYER_LEVEL_UP;give: diamond,1;tell: &72333'
PRICE: 100
LEVELS: 10
POINTS: 10
REQUIRED-ITEM: 'diamond, 30'
KEEP-OPEN: true
PERMISSION: 'test1.test'
VIEW-PERMISSION: 'test2.test'
PERMISSION-MESSAGE: '&c无权限警告'

复制代码

在游戏里看起来会像这样:

示例的简单解释:
menu-settings:

属性	作用
name	菜单名字,在菜单顶部显示
rows	菜单行数,不应超过6行,否则客户端显示会出错
command	打开菜单的指令
auto-refresh	菜单自动刷新的间隔,值越小菜单反应越快,也更消耗性能
open-action	打开菜单时执行的指令
open-with-item	绑定特定物品打开菜单
id	绑定物品的id
left-click	左键绑定物品是否可以打开菜单
right-click	右键绑定物品是否可以打开菜单

"menu-settings:"是必须存在的,否则会被视为无效菜单,其他菜单项也不能以"menu-settings"命名,否则也会成为无效菜单!

test(这个是可以改的,例如"example"/"233"/"wtf???"只要不是"menu-settings"就OK):

节点	作用
ID	在菜单内显示的图标,1.12.x(对应插件v3.1.4及以下)及以下可以使用英文ID和数字ID(部分英文ID在插件中有别名,具体查看后面物品别名表), 1.13.x(对应插件v3.2.0+)只能使用英文ID,并且取消了所有物品别名,可以直接使用原版物品名.
POSITION-X	在菜单的第x排,最大为9
POSITION-Y	在插件的第x行,最大不超过"menu-settings"中的"rows"的数值
NAME	悬浮时显示的物品名,不加入这一行为"ID"对应物品在游戏里的对应物品名 (如:"ID: BEACON",不加入"NAME",则这一项在语言为中文的游戏里显示"信标",在英文游戏显示为"Beacon").
LORE	物品注释,可以用"-"分隔多行.不加入这一行则不显示.
ENCHANTMENT	显示物品所带的附魔,不会自动显示在物品注释里.
COMMAND	点击物品时执行的指令.使用";(默认情况下)"分隔多条指令. 不加入这一项或这一项留空则不执行任何指令.
PRICE	使用这个选项时需要的金钱,若余额足够则扣除金钱并直接执行,不足则向玩家发送"no-money"消息,若无经济插件则会报错. 不加入这一行则不需要金钱
LEVELS	使用这个选项所需的经验等级,若经验等级足够则扣除经验等级并直接执行,不足则向玩家发送"no-exp"消息. 不加入这一行则不需要经验等级.
POINTS	使用这个选项所需的点券,若点券足够则扣除点券并直接执行,不足则向玩家发送"no-exp"消息,若无点券插件则会报错不加入这一行则不需要点券.
REQUIRED-ITEM	使用这个选项所需的物品,若背包里有足够的物品则扣除物品并直接执行,不足则向玩家发送"no-required-item"消息. 不加入这一行则不需要任何物品.
KEEP-OPEN	点击该选项时菜单是否保持打开,true为保持打开,false为点击后关闭.不加入这一行默认为false.
PERMISSION	点击该项所需的权限,若有该权限则直接执行,权限不足则发送自定义的"PERMISSION-MESSAGE"消息, 若无权限也无"PERMISSION-MESSAGE"消息则发送"default-no-icon-permission"消息. 不加入这一行则执行这个选项之前不进行额外的权限检查.
VIEW-PERMISSION	看见这个选项所需的权限,若玩家无该权限则此选项不显示.不加入这一行则无需任何权限就能看见这个选项.
PERMISSION-MESSAGE	自定义权限不足消息,用于无权限时向玩家发出自定义消息.不加入这一行则使用"default-no-icon-permission"消息.

此外,还有两个特殊的节点:

节点	作用
SKULL-OWNER	当"ID"节点为头颅(skull:3/player_skull)时,指定头颅的主人(必须是正版玩家的ID)
COLOR	当"ID"节点为皮革装备(皮革头盔,皮革胸甲,皮革护腿,皮靴)时指定该物品的RGB颜色值. 格式为<RED>,<GREEN>,<BLUE>,如蓝色(0,0,255),黄色(255,255,0). 想要获得自定义颜色的RGB值请点这儿

可以像这样:

menu2.yml:

menu-settings:
name: '&lTest'
rows: 6
headtest:
ID: PLAYER_HEAD
SKULL-OWNER: "Zapic"
POSITION-X: 1
POSITION-Y: 1
leathertest:
ID: leather_helmet
COLOR: 234,56,78
POSITION-X: 2
POSITION-Y: 1

复制代码

*这个示例仅适用于1.13.x,1.12.x及以下请把"player_head"改为"skull:3".

然后就会像这样:

此外的此外,"COMMAND"节点下有几个特殊的指令:

指令	作用
op: <指令>	无视权限执行指令(谨慎使用).
console: <指令>	在后台执行指令,无视权限(谨慎使用).
give: <物品>,<数量>	给予玩家一定数量的物品.
give-money: <数量>	给予玩家指定数量的金钱(需要Valut前置与兼容的经济插件).
give-points: <数量>	给予玩家指定数量的点券(需要Valut前置与点券插件).
tell: <消息>	向该玩家发送一条消息,只有该玩家可见.
boardcast: <消息>	向全服玩家发送一条消息.
sound: <声音>	向该玩家播放一个声音,仅该玩家可听见,声音请参见这里.
open: <菜单>	打开一个存在的菜单,如"menu.yml".若无打开该菜单的权限则发送"no-open-permission"消息.
server: <服务器>	跳转到一个BungeeCord子服(需要BungeeCord支持).
bossbar: <时间> \| <消息>	以顶端血条的形式发送一条消息(需要BarAPI支持).

这些东西就不再赘述,会在下面的实例中一点一点介绍.其实就是要偷懒

此外的此外的此外(1.13的腐竹注意了!)

物品的数据值在1.13被取消了! 物品的数据值在1.13被取消了! 物品的数据值在1.13被取消了!

所以你不能直接用类似于"leather_helmet:20"来给物品附上特殊的数据值.

你需要在"ID"行下添加一行"DATA-VALUE"并附上数据值就OK了.

如:

leathertest:
ID: leather_helmet
DATA-VALUE: 20
POSITION-X: 1
POSITION-Y: 1

复制代码

2.应用(简单篇)

2.应用(中级篇)

啥?你的玩家觉得菜单太垃圾?用它不如打指令?或者只能代替指令不够用?快过来看这里!

1.收费指令

觉得一些功能免费给玩家用太(减)影(少)响(收)平(入)衡了?这样!

costcommands:
NAME: '&6随机传送'
LORE:
- '点击随机传送.'
- '&a500'
PRICE: 500
ID: ENDER_PEARL
COMMAND: 'op: randomtp'
POSITION-X: 1
POSITION-Y: 3

复制代码

这样,当玩家想要进行随机传送时会从他的账户扣除500$,如果他的钱不够,那他将收到"no-money"消息并不能进行随机传送.当然,你要避免他使用指令进行随机传送,这时只要不给普通玩家进行随机传送的权限就好了.这里因为玩家没有进行随机传送的权限,所以要以"op: <指令>"的形式来执行随机传送.

同理,也可以收点贵一点的东西:

costpoints:
NAME: '&6飞行'
LORE:
- '我将赋予你飞行的权利'
- '&c飞行期间不会受到掉落伤害'
- '&a10点券'
POINTS: 10
ID: feather
POSITION-X: 2
POSITION-Y: 3
COMMAND: 'op: fly'

复制代码

这个也与收费随机传送是一个道理,在这里就不赘述了.

也可以收好几样东西:

costalot:
NAME: '&f煤炭&6换&b钻石'
LORE:
- '煤炭2:3换钻石'
- '只要299,只要299!'
PRICE: 299
REQUIRED-ITEM: coal, 2
COMMAND: 'give: diamond, 3;tell: "成功兑换了3钻石"'

复制代码

这样,可以同时收取玩家两个煤炭和299$,向玩家发送消息,并给予玩家3个钻石.如果这还看不懂你就去从头再读一遍吧

2.商店

建造实体商店太费时间?玩家懒得到处跑?用上你的菜单吧!

收购商店:

buy:
ID: coal
AMOUNT: 32
LORE:
- '价格>200'
- '数量> 32'
REQUIRED-ITEM: coal,32
COMMAND: 'give-money:200;tell: 出售成功,获得200'
KEEP-OPEN: true

复制代码

这样,当玩家点击这个菜单项时,就会扣除玩家背包内的32个煤炭,同时向玩家账户内增加200游戏币,以及一条消息.当然,玩家背包物品不足时什么都不会发生.同时,使用"KEEP-OPEN"项使菜单保持打开,以便玩家快速反复点击.

出售商店:

sell:
ID: diamond
AMOUNT: 16
LORE:
- '售价>500'
- '数量>8'
PRICE: 500
COMMAND: "give: diamond ,8;tell: 购买成功"
KEEP-OPEN: true

复制代码

同理,这里使用"PRICE"指定点击此项时扣除的游戏币,使用"give:"来给予玩家物品.

3.应用(高级篇)

4.如何美化你的菜单

5.如何使你的菜单更易用

可能是完结了,正在查缺补漏.

(2019.6.14,7:30)

新年快乐!(跨年鸽子叫)

如果觉得这篇帖子写的还行那就在底下评分吧~

评分是不会扣自己人气的你造吗

ChestCommands从入门到精(入)通(坟)[1.7+~1.13]

回复: