Minecraft插件百科 - 用户贡献 [zh-cn]

Essentials/教程

2015-11-30T03:37:27Z

Hookbin：/* 建筑控制相关设置 */

===教程===
====备份相关设置====
在保存服务器地图方面，我们一般会使用AutoSaveWorld这个插件，但是其实Essentials本身就有地图备份相关的功能，此功能已经能满足大部分服主的要求，而不需要去安装新的插件。
为了使用Essentials的备份功能我们首先得在config文件中开启相关功能
代码:
backup:
# 时间间隔,以分钟为单位.
interval: 30
# 除非你在这加入一个有效的备份命令或脚本,否则这个功能是无用的.
# 使用命令 'save-all' 简单的强制保存世界,而不使用备份.
# 命令: 'rdiff-backup World1 backups/World1'
这里我是用的是汉化过的config.yml中默认状态的配置
为了能使用Essentials的地图备份功能你需要新建一个bat文件，不过如果你不想这么麻烦，而是只要简单地保存地图，你可以这么设置。
代码:
backup:
interval: 60
command: 'save-all'
这样每过一小时服务器就会自动save all
如果你想更进一步的对地图进行备份，你首先得在服务端根目录 (注意不是Essentials目录或者plugin目录) 新建一个bat文件。
然后粘贴如以下内容
代码:
@echo off
"C:\Program Files\7-Zip\7z.exe" a "backups/%date:~0,4%-%date:~5,2%-%date:~8,2%-%time:~0,2%-%time:~3,2%-%time:~6,2%".7z -r world world_nether
pause
注意：我在测试中使用的是7zip压缩工具，前面为文件路径请根据各自情况修改（如果使用其他压缩工具不保证能否压缩成功）
-r 后面的内容为要备份的世界，如果你要添加更多的世界，输入世界的名字当中以空格间隔。
启动后的效果就是在服务器根目录新建backup文件夹，压缩文件的文件名为当前服务器日期。
例：
[图]
年-月-日-小时-分钟-秒
====help指令相关设置====
/help对于玩家来说是个比较有用的指令，当你忘记某个指令时可以输入这个来查询，但是现在help指令渐渐成为了一个比较鸡肋的指令，因为过多的插件导致help列出的指令过多，因而当你要想查找某个指令时你得花费大量的时间一页一页的找。如今Essentials插件的help设置能让你的help列表彻底脱胎换骨。
Essentials插件提供了3种设置方式以提供不同的/help显示效果。Essentials会尽可能的遍历所有服务器插件然后获取其中所有的指令，但是如果插件未按标准编写，即在plugin.yml中没有注册过的指令是不会出现在help列表中的。
1.
代码:
non-ess-in-help: true
hide-permissionless-help: true
这种模式下help会显示所有玩家有权限使用的指令。你同样也可以通过给予玩家
代码:
essentials.help.<插件名>
此权限使得玩家可以在help菜单中查看该插件所有指令。
2.
代码:
non-ess-in-help: true
hide-permissionless-help: false
在此模式下所有的指令都将在help中显示，无论玩家是否有权限执行这些指令。
3.
代码:
non-ess-in-help: false
在此模式下玩家只能看到一些基础的并且玩家有权限使用的指令。
=====高级定制=====
如果这样的设置你还不满足，你想更进一步的定制/help指令，Essentials提供了一个更加强大的功能。
你可以通过在Essentials插件目录中添加一个help.txt来自定义/help指令显示的内容。help.txt中的内容将会完全取代默认的help指令列表。
例子
代码:
#欢迎
欢迎你{PLAYER}
来自: {ADDRESS}
服务器IP：{IP}
你现在的存款：{BALANCE}
欢迎代表章节名称（每个章节名称前面必须加#）玩家输入/help 欢迎
则会显示
[图]
(help.txt必须以UTF-8无BOM编码保存)
你可以定义多个章节来做到不同的章节显示不同的插件指令
而且完美支持所有颜色代码
这样玩家就不用面对那杂乱无章的指令列表了
在编辑help.txt时可以添加如下变量
代码:
玩家展示名称: {PLAYER}
用户名: {USERNAME}
服务器IP: {IP}
玩家IP: {ADDRESS}
金钱: {BALANCE}
未读email: {MAILS}
当前世界名: {WORLD}
世界列表: {WORLDS}
在线玩家数: {ONLINE}
特殊玩家: {UNIQUE}
玩家列表: {PLAYERLIST}
服务器时间: {TIME}
服务器日期: {DATE}
游戏中PM/AM: {WORLDTIME12}
游戏中时间: {WORLDTIME24}
游戏中日期: {WORLDDATE}
插件列表: {PLUGINS}
bukkit版本: {VERSION}
====kits工具包相关设置====
kit工具包是Essentials的一个重要功能，你可以用它来发放新手礼包，发放奖励甚至用它来做个系统商店都是可以的。
熟练的使用kit相关功能可以使你避免在服务器中再安装不必要的插件。
首先先是kit每个工具包的格式
代码:
kits:
<kit name>:
delay: <delay between usage>
items:
- <item number> <amount> <meta>
- <item number> <amount> <meta>
另附上中文config文件内容
代码:
kits:
tools:
delay: 10
items:
- 272 1
- 273 1
- 274 1
- 275 1
dtools:
delay: 600
items:
- 278 1 efficiency:1 durability:1 fortune:1 name:&4Giga_Drill_Breaker lore:这钻头是突破天际的钻头
- 277 1 digspeed:3 name:矮人 lore:挖掘|挖掘|挖洞
- 298 1 color:255,255,255 name:白色的帽子 lore:美好的一天,美好的一天
- 279:780 1
notch:
delay: 6000
items:
- 397:3 1 player:Notch
color:
delay: 6000
items:
- 387 1 title:&4书_&9与_&6颜色 author:Essentials lore:游戏内的颜色代码 book:颜色
firework:
delay: 6000
items:
- 401 1 name:愤怒的苦力帕 color:red fade:green type:creeper power:1
- 401 1 name:星空 color:yellow,orange fade:blue type:star effect:trail,twinkle power:1
- 401 2 name:太阳风 color:yellow,orange fade:red shape:large effect:twinkle color:yellow,orange fade:red shape:ball effect:trail color:red,purple fade:pink shape:star effect:trail power:1
1. delay代表的是领取此工具包的延迟如果你设置为3600那么这个工具包只能每小时领一次如果你设置为 -1 那么这个工具包只能领取一次。
2.你可以可以在config中对每个工具包定义他的使用价格如
代码:
kit-tools: 100
那么使用tools这个工具包将花费玩家100$
3.由以上两个示例我们可以看到kit工具包指令支持几乎mc中所有的道具。不过你也许不知道kit工具包中的道具也是支持变量的如
代码:
- 278 1 efficiency:1 durability:1 fortune:1 name:&4Giga_Drill_Breaker lore:{PLAYER}的超级钻石镐
效果就是
[图]
其余变量可参考 help相关指令设置中的变量
4.kit工具包同样也支持在工具包中包含金钱
设置格式如下
代码:
- $500
注意 $符号不要更改。
另附 essentials自带的nbt代码
5.关于kit工具包中书本的相关设置
你可以在Essentials插件根目录新建一个book.txt
内容可按如下示例
代码:
#Colors
Minecraft colors:
&0 &&0 &1 &&1 &2 &&2 &3 &&3
&4 &&4 &5 &&5 &6 &&6 &7 &&7
&8 &&8 &9 &&9 &a &&a &b &&b
&c &&c &d &&d &e &&e &f &&f
&0
&&k &kMagic&r &&l &lBold
&&m &mStrike&r &&n &nUline
&&o &oItalic&r &&r &rReset
#Colors 代表了书本的章节名字
我们可以看到在kit包中要调用一本书的格式如下
代码:
- 387 1 title:&4书_&9与_&6颜色 author:Essentials lore:游戏内的颜色代码 book:颜色
下面给出每个项的介绍
代码:
Title
书本的标题，支持颜色代码，与book.txt中的章节名无关
格式
title:<title>
Author
书本作者，支持颜色代码
格式
author:<author>
Lore
书本的描述。
格式
lore:<description>
Book
这里填写的书本的章节名，对应book.txt中#后面的章节名字。
格式
book:<section name>
6.kit工具包的权限设定也非常的方便，你可以给予玩家以下权限，来单独限制玩家可使用的工具包
代码:
essentials.kits.<kitname>
=====Essentials的木牌控制相关=====
领取工具包需要一个个输入指令，这样子未免有些太麻烦了，不过不要紧Essentials提供了完整的木牌系统来简化你的操作。
为了启用木牌领取工具包你首先得在config文件中找到
代码:
enabledSigns:
并将 - kit 前面的#去除，然后重启插件。
牌子输入格式如下
[Kit]
<KitName>
[Group]
[Cost]
<kitName>代表了工具包名称，如tools
[group]代表了可使用这个牌子的用户组，如果不设置那么根据玩家是否拥有
essentials.kits.<kitname> 权限来判断玩家是否可以使用牌子获取工具包.或者你可以在这一项输入 Everyone 代表所有玩家都可以使用。
[cost]代表了使用的花费如果不设置默认为免费
[Kit]
dtools
builder
$10
以上为示例（花费前面必须加$）
====建筑控制相关设置====
权限系统基本是每个服主的必修课，Essentials的建筑控制正是基于权限系统对玩家一切使用方块的行为进行限制，从而可以使服主完全限制玩家的行为，包括放置，破坏，扔掉，拾取，使用指定方块，并且可以限制玩家与指定方块交互，如限制玩家使用按钮，开关等。
首先是最基本的建筑权限
代码:
essentials.build 
给予玩家此权限代表了玩家可以使用并放置所有方块。 
如果当一个玩家没有 Essentials.build权限或者 build: false那么Essentials接着会检查如下权限 
代码: 
essentials.build.place.<id> 
essentials.build.place.<id>:<data> 
essentials.build.break.<id> 
essentials.build.break.<id>:<data> 
essentials.build.interact.<id> 
essentials.build.interact.<id>:<data> 
essentials.build.craft.<id> 
essentials.build.craft.<id>:<data> 
essentials.build.pickup.<id> 
essentials.build.pickup.<id>:<data> 
essentials.build.drop.<id> 
essentials.build.drop.<id>:<data> 
以上都是最基础的英文单词，相信大家都看的懂我就不一个个翻译了。 
唯一需要解释的是 interact 权限这代表了玩家与方块交互例如使用按钮等。 
但是放置方块，或者破坏方块也属于交互的一种，所以如果你想让一个玩家能放置或者破坏一个方块你需要同时给予那个玩家与此方块交互和放置两个权限。 
通过给予玩家以上权限你就可以做到例如单独让玩家可以破坏某个方块，或者玩家只可以按按钮不能破坏方块之类的功能。 
那如果你想单独让玩家不能破坏某个方块该如何设置呢 
这里首先得说明一下groupmanager的权限设置格式 
大家都知道如果我输入 
代码: 
/mangaddp builder essentials.build.place.1 
就是给予builder用户组放置石头的权限 
而如果我输入 
代码: 
/mangaddp builder -essentials.build.place.1 
这两个指令之间只相差了一个 - 但是效果完全相反，添加了此权限玩家将不能放置石头。 - 代表了移除玩家的此权限。
当一个玩家同时拥有 
代码: 
essentials.build.place.1 
-essentials.build.place.1 
这两个权限时玩家将无法放置石头 
因为在groupmanager判断权限时优先判断 -权限这意味着就算你拥有建筑权限你被加入了-essentials.build.place.1 那么你也是无法放置石头的。 
以此为基础我们可以单独设置玩家不可以放置，使用的方块。 
如果你想一次设定多个方块你可以用 * 来代替如羊毛方块的ID是35 一直到35:15 
你可以给予玩家 Essentials.build.place.35:* 来给予玩家所有羊毛方块的放置权限 

====list玩家列表相关设置====
在Essentials的list列表设置中服主可以自定义以下内容
引用:
合并:你可以自定义一个展示用户组，将几个用户组的玩家全部显示在一个展示用户组中。
隐藏:你可以完全隐藏你不想显示的用户组。
限制:你可以限制每个用户组在list列表中的数量上限，超过上限的部分将会被隐藏。
这个配置部分允许您覆盖/编辑/list命令,从而显示一个更加整齐，简洁的list列表。
在默认情况下,你可以定义所有用户组的显示顺序，所有未定义的用户组将会按照首字母排序。
在config文件中你可以通过搜索
代码:
list:
来找到相关设定位置
1.合并
代码:
Staff: owner admin moderator
这样设定的话，所有owner admin moderator用户组的玩家在list指令中会全部显示在staff用户组中
2.隐藏
代码:
default: hidden
这样设置的话 default 将会被隐藏，所有此用户组的玩家将不会在list列表中显示
3.限制
代码:
builder: 20
这样设置的话所有builder用户组的玩家只会显示20个，超过的部分会被隐藏。
——————————————————————————————————————————————————————————————————
所有未定义的用户组都将会正常显示
下面给出一个例子包括上述所有设置
代码:
list:
Admin: owner admin
stealth: hidden
builder: 20
default: 0
====chat聊天格式相关设置====
通过Essentials的chat聊天相关设置你可以自定义玩家在聊天过程中名字的前缀等。
注意：要使用这些功能你必须安装Essentialschat插件。
_____________________________________________
=====显示名（display names）=====
在Minecraft中,你的displayname就是你在聊天过程中显示的名字，或者是在tab列表，插件中应用到的名字。
显示名由groupmanager插件决定可以在对应世界文件夹group.yml中修改。
bukkit最多允许显示名有16个字符，所以建议将显示名的前缀+名字+后缀压缩在16个字符以内。
======设置======
在Essentials的config文件中有6个与显示名有关的设定
代码:
# OP名字的颜色代码,填写0~9或a~f其中的一个数字或字母,填写'none'来冻结该功能.(译注:可到http://ess.khhq.net/mc/查看颜色代码)
ops-name-color: 'c'
# 昵称的前缀符号,这样你能知道这不是他们真正的用户名.
nickname-prefix: '昵称:'
# 设置最大昵称长度, 昵称前缀也包括在内.
max-nick-length: 15
# 如果你想用其他的插件来设置玩家名字,将其改为"false".
change-displayname: true
# 当这个选项开启时,在玩家显示的名字上添加的前缀或尾缀,会被显示在在线列表(TAB)中.
# 上面的"change-displayname"必须是true才有效.
change-playerlist: true
# 添加前缀后缀(上面的"change-displayname"必须是true才有效)
# 如果你不设置该项,且essentialschat被安装了,其将会被默认为"true".
add-prefix-suffix: true
这里我就直接复制中文config中的设定了，因为有全部的中文注释了。我在这里就不再赘述了
=====聊天格式=====
这里的设定将会改变玩家在聊天时显示的样式。
下面是一个例子
代码:
{DISPLAYNAME} {MESSAGE} {GROUP} {WORLDNAME} {SHORTWORLDNAME} {TEAMPREFIX} {TEAMSUFFIX} {TEAMNAME}
代码:
{MESSAGE} 聊天的内容.
{GROUP} 玩家所属用户组名称.
{DISPLAYNAME} 显示名包括了玩家的前缀以及后缀.
{WORLDNAME} 玩家所处世界的名字.
{SHORTWORLDNAME} 玩家所处世界的首字母.
{TEAMPREFIX} {TEAMSUFFIX} {TEAMNAME} 计分板团队变量.
你可以按照自己的喜好自由组合以上变量，并且完全支持颜色代码
下面给几个例子
代码:
format: '<{DISPLAYNAME}> {MESSAGE}'
format: '&8[&7{GROUP}&8]&f {DISPLAYNAME}&7:&f {MESSAGE}'
format: '{WORLDNAME} {DISPLAYNAME}&7:&f {MESSAGE}'
format: '{WORLDNAME} &8[&7{GROUP}&7]&f {DISPLAYNAME}&7:&c {MESSAGE}'
下面截图中显示的是最后一种样式游戏中的实际效果
[图]

====Essentials丰富多彩的木牌系统====

'''Essentials sign'''

从essentials2.8开始，所有的牌子都默认对普通组（default）关闭，你可以在essentialsconfig.yml中分别开启每一种牌子，来启用牌子们的功能。你需要支持木牌彩色字体的插件（因为牌子功能在游戏中需要用颜色开启，因此服务器要有颜色插件或者其他的能开启木牌颜色&功能的补丁才能使用木牌功能）。
大贴士：这个木牌功能并不是独立插件，它存在于Essentials.jar这个插件中，所以你只要下了Essentials主插件（essentials有一个大家族，主插件就是上面这个名字，如果你以为把jar文件改成这个名字就行了，你可能是一个jar），并成功载入，就能使用这个功能了。（当然，你还要在config里给玩家开启各个牌子的功能和给予玩家使用权限。）
权限节点：？

'''木牌类型介绍'''

''Sign（木牌）''

所有的Essentials木牌类型都应该被书写在牌子的第一行正中于一对英文方括号中 “[]”
如果你写对了，方括号中的内容会变成蓝色的，如果你写错了，方括号中的内容就会变成红色的。（退出书写界面后才会显示。）
下面的cost（花费，可以是花费支出，也可以是花费收入）项，当然它不会出现在第一行的类型中，但作为一个十分有用的项，我们来介绍一下他们：

如果你想使花费为5个货币，请在对应行写上$5；

如果你想要时间，你可以写上；

如果你想要花费为物品，举个例子：2 redstone 或者 2 331（红石的物品id）个人推荐使用物品id。如果你的花费物品有子代码，即冒号后的东西，在冒号前的数字后面打一个英文逗号，再打上冒号后的数字。

如果你想让花费是经验值，举个例子：15 exp

''1、Mail木牌''

这种木牌第一行的书写内容必须是[Mail]，其余可以随意。
Mail木牌提供查看自己的邮箱的功能，当然是Essentials插件自带的邮箱。玩家只需要右键已经建立成功的牌子，就可以查看自己的邮箱，不需要权限。这对不开启mail权限的服务器来说有所帮助。

''2、Free 木牌''

免费木牌第一行的书写内容必须是[Free]，第二行必须是某个物品的名字（以后提到物品的名字，都是英文）或者物品id。其余最好不要填写，如果要填可以自己测试一下是否可以使用。此木牌的功能为让玩家免费领取你书写在牌子上的物品，从某种意义上来讲，这个木牌也是一个箱子，不过当你从木牌中取出东西的时候，物品会自动补充。
（建议免费物品不要太贵重）

''3、Kit 木牌''

Kit是服务器管理员向玩家发放新手礼包的一种主要渠道。Kit的编辑嘛，我们不是教你编辑礼包的……不知道编辑的管理员先去学习。这种木牌的第一行必须是[Kit]，第二行必须是Kit的名字，比如Tools。第三行是组的名字，即哪个组可以领取这个礼包，只能填写一个，当然如果这个礼包是面向所有人的，你要在这一行填写Everyone。第四行是花费，即领取这个礼包要付出什么东西，见上cost的说明，如果免费，可以不填。（在玩家通过木牌领取礼包时，不需要领取礼包的权限）

''4、Disposal 木牌''

这种木牌第一行的书写内容必须是[Disposal]。其余可以随便填，当然有可能用不了。功能很简单，当你手持一样东西右键这个牌子，你的东西不见了，当你用空手右键木牌，什么都不会发生，很简单吧，就这样。

''5、Heal 木牌''

这种木牌第一行的书写内容必须是[Heal]。第二行是花费，即你需要花费什么东西来通过牌子将自己血量补满。Heal木牌的功能等同于heal指令，对象是使用该木牌的玩家，只不过使用Heal木牌不需要heal指令的权限。你永远不应该把放置Heal木牌的权限给普通玩家，以及其他非管理组的组，除非你开的是“创造”类型的服务器。（建议书写花费）

''6、Time 木牌''

这种木牌第一行的书写内容必须是[Time]。第二行是day或者night，即这个木牌可以把该世界的时间调到白天或者黑夜。第三行是花费，即你使用该木牌调整一次时间所需要花费的东西（见上cost的说明）。这种木牌的功能就是给普通玩家调整时间的机会，当然花费不菲。

''7、Weather 木牌''

这种木牌第一行的书写内容必须是[Weather],第二行是sun或者storm，即这个木牌可以调整该世界的天气为晴天或者暴风雨。第三行是花费，即你使用该木牌调整一次天气所需要花费的东西（见上cost的说明）。使用该木牌给玩家提供了跳过坏天气的机会，而且不需要使用调节天气命令的权限，这种木牌最好放在公共场所，但当你看到某个玩家在对着这个木牌狂点时，你要考虑一下收费了。
对于以上两种调整游戏时间和天气的木牌，建议如果要使用就一种创建两个木牌，拿Weather木牌举例，一个木牌第二行是sun，一个木牌第二行是storm，提供一个选择，单个木牌只能调整一种天气。Time木牌也一样。

''8、Warp木牌''

这种木牌第一行的书写内容必须是[Warp]，第二行书写warp名（即你已经创建的warp，并且想要通过木牌来快捷传送。）第三行书写权限组名，不写默认所有玩家。第四行书写花费，即你使用该木牌进行一次warp传送所需要花费的东西。这种木牌的功能就是将warp指令木牌化，能够让玩家快捷使用，当第三行未被书写时，使用木牌的玩家会被检查是否具有warp或者per-warp的权限，当然，你也可以通过在书写权限组的位置书写Everyone来让所有玩家不需要权限就能够通过木牌进行warp传送。（不管需要权限或者不需要权限，传送对象都只是木牌上书写的那个warp名）

''9、Spawnmob 木牌''

这种木牌第一行的书写内容必须是[Spawnmob]。第二行必须是一个整数数字，即你要生成的生物数量，不要过大，因为会卡。（建议为1或2）。第三行是你要生成的生物类型，要为英文名。第四行为花费，即你要通过木牌生成一次木牌上所写的数量的生物所需要花费的东西。这种木牌的功能就是在牌子附近生成生物，但是首先你得给玩家生成该生物的权限，比如狼的：essentials.spawnmob.wolf 可能管理者会有疑问，如果我把这个权限给了玩家，那么玩家不就可以自己用mob指令召唤生物了吗？我们早就准备了答案，如果你不把essentials.spawnmob的权限给玩家，即使玩家有essentials.spawnmob.XXX的权限，玩家也是不能使用spawnmob生成指令的。

''10、Enchant 木牌''

这种木牌第一行的书写内容必须是[Enchant]，第二行需要是一个能被附魔的物品，比如；十字镐，或者剑(英文的)，当然你也可以在第二行写上*或者any来让所有可附魔的物品都能用这个木牌来附魔。第三行需要是附魔的名称，比如：耐久或者锋利（同样是英文的），名称后面一个英文冒号加上一到五的数字，即附魔级数，举个例子，耐久三：silktouch:3第四行为花费，即你使用该木牌进行一次单项附魔所需要的花费。木牌附魔只能实现添加一项附魔到物品上的功能，当然你可以用多个写有不同附魔的木牌来进行添加多项附魔属性。
这种木牌还可以附魔非工具武器类的物品，比如：羽毛。

''11、Gamemode 木牌''

这种木牌第一行的书写内容必须是[gamemode]，第二行需要是游戏模式，比如：生存模式-survival,创造-creative，冒险模式-adventure。第三行需要为花费，即你通过木牌将你现在的游戏模式调整一次为木牌上所书写的游戏模式所需要花费的东西。这种木牌的功能就是切换你的游戏模式，对于多种游戏模式的服务器可能会有用。

''12、Info 木牌''

这种木牌第一行的书写内容必须是[Info]。第二行必须是页或者章节的名字（？），第三行需要是页数，如果章节包含有这页。第四行是花费，即你通过木牌阅读一次资料所需要花费的东西（我想你不会看第二遍一样的东西）。这种木牌的功能就跟/info指令差不多，使用这种木牌不需要info的权限，这种木牌对展示服务器网址或者规则，介绍很有用。

''13、Repair 木牌''

这种木牌第一行的书写内容必须是[Repair],第二行是hand或者all，表示修理的对象是手中所拿物品（就是你拿着右键木牌的物品）还是你的背包及物品栏还有装备栏里的所有物品。第三行是花费，即你使用木牌进行一次修理所需要花费的东西，不管是修理手中的物品还是所有物品。相信你不会带着一堆没有耐久值的东西去点这个木牌。

'''Essentials经济类木牌'''

这些木牌对于你的服务器的经济来说至关重要，玩家能够通过Trade木牌来卖出他们辛苦砍来/挖来/抢来/钓来的东西，为了帮助你的玩家们，你可能会考虑弄一个收购木牌来收购一些玩家的原石，地狱岩，萤石或者钻石之类的东西。
收购/出售商店的权限一般都属于管理者，应为这是些永久商店。而Trade木牌给了玩家一个机会，玩家的背包里需要有他们要卖的东西，这是收购/出售商店不需要的，因为Trade木牌的物品是一个史蒂夫卖给另外一个史蒂夫，而收购/出售商店是数据库卖给所有的史蒂夫。

''1、Trade 木牌''

这种木牌的构成有两种形式，而且比较复杂，请仔细阅读。先说说这种木牌的大概结构，第一行的书写内容统一是[Trade],第二行是你想要什么，第三行是你想给出什么，可能你有点疑惑，嗯，我也是，那就往下看吧。
第一种trade木牌，第一行的书写内容是[Trade],第二行是价格，即你卖出一份物品的价格，格式是这样的，$加上数量，即为多少钱，$和数量之间不用加空格，如$10第三行先写上数量，空格，物品的英文名，英文冒号，总额（即为你要放置于牌子里的物品的数量，请于放置木牌前确定你的背包里有小于等于总额的对应物品，不然放置的木牌没有效果。对应物品就是你上面书写的物品名），数量和物品名构成了一份物品。第四行请空着，如果创建木牌成功，你书写完毕后会在第四行显示你的名字。这种木牌的功能是以对应价格卖出对应数量物品，木牌放置成功后，除了显示名字外，会在第二行的价格后面多出一个冒号，冒号后面的数字暂时为0，意思为你的商品以对应价格卖出了多少份。
第二种trade木牌，第一行的书写内容是[Trade],第二行是数量，空格，加上物品的英文名，即你收购的物品种类和数量（也就是别人一次能卖给你的物品数量）。第三行先打上一个$加上数字，之间不用空格，（这个价格表示你收购一份如第一行所写的数量的物品的报酬），然后一个英文冒号，然后写上总额（即你在这个木牌里放多少组冒号前的价格，确保你有这么多钱，所放入的钱等于一份价格乘以总额。）如果你的木牌创建成功，同样会在第四行显示你的名字并且在第二行的书写内容后面出现一个冒号，冒号后的数字暂时为0，即为你收购到了多少份物品。
这两种木牌都是给普通玩家的日常交易服务的，当木牌所有者右键自己已经放好的木牌时，木牌所有者会收到木牌里的储存的钱或物品（这里的钱和物品是通过交易所得的，并非你原来放入的钱或物品，所以放置木牌的时候要考虑清楚，你是否真的要放这么多东西进去？）当木牌所有者拿着要卖的物品右键第一种木牌，就是往木牌里续存物品。其他非木牌所有者右键木牌就是买卖东西了，如果你背包里有对应的东西的话。物品名可以为物品id，推荐id。

''Buy 木牌（系统售卖木牌）''

这种木牌第一行的书写内容必须是[Buy]，第二行必须是一个数量，而且是整数，这个数量是一次交易系统给予玩家对应物品的数量。第三行需要是物品英文名字或者id，即这个木牌出售哪个物品，这一行也可以只写上exp来让系统出售经验值。第四行是花费，即系统售卖一次对应数量的对应物品玩家应付给系统的钱或物品，钱，$加整数数量，物品，整数数量，空格，物品英文名或者id。与Trade木牌不同，Buy和Sell木牌是一个永久系统商店木牌，不需要任何东西，需要的物品木牌会自动生成，收到的钱只会从玩家账户里扣除。所以Buy和Sell木牌的放置权限永远不应该给玩家，而应该由服务器管理者管理Buy和Sell木牌。

''Sell 木牌（系统收购木牌）''

这种木牌第一行的书写内容必须是[Sell],第二行必须是一个整数数量，这个数量就是玩家一次卖给系统的物品数量。第三行需要写物品名字或者id，即这个木牌收购哪个物品，也可以填写exp，来收购玩家的经验值。（当然玩家得有对应数量的经验值，不然无法交易。经验值的数量就是上面填写的数量，单位是点）第四行是花费，即系统收购一次对应数量的对应物品付给玩家的钱或物品。

''Balance 木牌''

这种木牌第一行的书写内容必须是[Balance]。这种木牌的功能很简单，查看玩家的财富排行榜（就是谁最有钱），而且不需要使用查看排行榜指令的权限，使玩家更容易地查看财富排行榜，而不是输指令。右键使用，财富榜会显示在对话框里。

'''备注：'''
1、所有的功能木牌都是右键使用。
2、有选择地给玩家放置各种木牌的权限。
3、假如一个玩家想放置一种功能木牌，程序有几道？一这种木牌在Eseentials.config中开启了使用，二这个玩家具有放置这种功能木牌的权限，三这个玩家有木牌彩色字体的权限。

物品id表
[[File:data value.png|frame|物品id表]]

[[Category:插件教程]]

Essentials/教程

2015-11-30T03:32:35Z

Hookbin：代码的换行

===教程===
====备份相关设置====
在保存服务器地图方面，我们一般会使用AutoSaveWorld这个插件，但是其实Essentials本身就有地图备份相关的功能，此功能已经能满足大部分服主的要求，而不需要去安装新的插件。
为了使用Essentials的备份功能我们首先得在config文件中开启相关功能
代码:
backup:
# 时间间隔,以分钟为单位.
interval: 30
# 除非你在这加入一个有效的备份命令或脚本,否则这个功能是无用的.
# 使用命令 'save-all' 简单的强制保存世界,而不使用备份.
# 命令: 'rdiff-backup World1 backups/World1'
这里我是用的是汉化过的config.yml中默认状态的配置
为了能使用Essentials的地图备份功能你需要新建一个bat文件，不过如果你不想这么麻烦，而是只要简单地保存地图，你可以这么设置。
代码:
backup:
interval: 60
command: 'save-all'
这样每过一小时服务器就会自动save all
如果你想更进一步的对地图进行备份，你首先得在服务端根目录 (注意不是Essentials目录或者plugin目录) 新建一个bat文件。
然后粘贴如以下内容
代码:
@echo off
"C:\Program Files\7-Zip\7z.exe" a "backups/%date:~0,4%-%date:~5,2%-%date:~8,2%-%time:~0,2%-%time:~3,2%-%time:~6,2%".7z -r world world_nether
pause
注意：我在测试中使用的是7zip压缩工具，前面为文件路径请根据各自情况修改（如果使用其他压缩工具不保证能否压缩成功）
-r 后面的内容为要备份的世界，如果你要添加更多的世界，输入世界的名字当中以空格间隔。
启动后的效果就是在服务器根目录新建backup文件夹，压缩文件的文件名为当前服务器日期。
例：
[图]
年-月-日-小时-分钟-秒
====help指令相关设置====
/help对于玩家来说是个比较有用的指令，当你忘记某个指令时可以输入这个来查询，但是现在help指令渐渐成为了一个比较鸡肋的指令，因为过多的插件导致help列出的指令过多，因而当你要想查找某个指令时你得花费大量的时间一页一页的找。如今Essentials插件的help设置能让你的help列表彻底脱胎换骨。
Essentials插件提供了3种设置方式以提供不同的/help显示效果。Essentials会尽可能的遍历所有服务器插件然后获取其中所有的指令，但是如果插件未按标准编写，即在plugin.yml中没有注册过的指令是不会出现在help列表中的。
1.
代码:
non-ess-in-help: true
hide-permissionless-help: true
这种模式下help会显示所有玩家有权限使用的指令。你同样也可以通过给予玩家
代码:
essentials.help.<插件名>
此权限使得玩家可以在help菜单中查看该插件所有指令。
2.
代码:
non-ess-in-help: true
hide-permissionless-help: false
在此模式下所有的指令都将在help中显示，无论玩家是否有权限执行这些指令。
3.
代码:
non-ess-in-help: false
在此模式下玩家只能看到一些基础的并且玩家有权限使用的指令。
=====高级定制=====
如果这样的设置你还不满足，你想更进一步的定制/help指令，Essentials提供了一个更加强大的功能。
你可以通过在Essentials插件目录中添加一个help.txt来自定义/help指令显示的内容。help.txt中的内容将会完全取代默认的help指令列表。
例子
代码:
#欢迎
欢迎你{PLAYER}
来自: {ADDRESS}
服务器IP：{IP}
你现在的存款：{BALANCE}
欢迎代表章节名称（每个章节名称前面必须加#）玩家输入/help 欢迎
则会显示
[图]
(help.txt必须以UTF-8无BOM编码保存)
你可以定义多个章节来做到不同的章节显示不同的插件指令
而且完美支持所有颜色代码
这样玩家就不用面对那杂乱无章的指令列表了
在编辑help.txt时可以添加如下变量
代码:
玩家展示名称: {PLAYER}
用户名: {USERNAME}
服务器IP: {IP}
玩家IP: {ADDRESS}
金钱: {BALANCE}
未读email: {MAILS}
当前世界名: {WORLD}
世界列表: {WORLDS}
在线玩家数: {ONLINE}
特殊玩家: {UNIQUE}
玩家列表: {PLAYERLIST}
服务器时间: {TIME}
服务器日期: {DATE}
游戏中PM/AM: {WORLDTIME12}
游戏中时间: {WORLDTIME24}
游戏中日期: {WORLDDATE}
插件列表: {PLUGINS}
bukkit版本: {VERSION}
====kits工具包相关设置====
kit工具包是Essentials的一个重要功能，你可以用它来发放新手礼包，发放奖励甚至用它来做个系统商店都是可以的。
熟练的使用kit相关功能可以使你避免在服务器中再安装不必要的插件。
首先先是kit每个工具包的格式
代码:
kits:
<kit name>:
delay: <delay between usage>
items:
- <item number> <amount> <meta>
- <item number> <amount> <meta>
另附上中文config文件内容
代码:
kits:
tools:
delay: 10
items:
- 272 1
- 273 1
- 274 1
- 275 1
dtools:
delay: 600
items:
- 278 1 efficiency:1 durability:1 fortune:1 name:&4Giga_Drill_Breaker lore:这钻头是突破天际的钻头
- 277 1 digspeed:3 name:矮人 lore:挖掘|挖掘|挖洞
- 298 1 color:255,255,255 name:白色的帽子 lore:美好的一天,美好的一天
- 279:780 1
notch:
delay: 6000
items:
- 397:3 1 player:Notch
color:
delay: 6000
items:
- 387 1 title:&4书_&9与_&6颜色 author:Essentials lore:游戏内的颜色代码 book:颜色
firework:
delay: 6000
items:
- 401 1 name:愤怒的苦力帕 color:red fade:green type:creeper power:1
- 401 1 name:星空 color:yellow,orange fade:blue type:star effect:trail,twinkle power:1
- 401 2 name:太阳风 color:yellow,orange fade:red shape:large effect:twinkle color:yellow,orange fade:red shape:ball effect:trail color:red,purple fade:pink shape:star effect:trail power:1
1. delay代表的是领取此工具包的延迟如果你设置为3600那么这个工具包只能每小时领一次如果你设置为 -1 那么这个工具包只能领取一次。
2.你可以可以在config中对每个工具包定义他的使用价格如
代码:
kit-tools: 100
那么使用tools这个工具包将花费玩家100$
3.由以上两个示例我们可以看到kit工具包指令支持几乎mc中所有的道具。不过你也许不知道kit工具包中的道具也是支持变量的如
代码:
- 278 1 efficiency:1 durability:1 fortune:1 name:&4Giga_Drill_Breaker lore:{PLAYER}的超级钻石镐
效果就是
[图]
其余变量可参考 help相关指令设置中的变量
4.kit工具包同样也支持在工具包中包含金钱
设置格式如下
代码:
- $500
注意 $符号不要更改。
另附 essentials自带的nbt代码
5.关于kit工具包中书本的相关设置
你可以在Essentials插件根目录新建一个book.txt
内容可按如下示例
代码:
#Colors
Minecraft colors:
&0 &&0 &1 &&1 &2 &&2 &3 &&3
&4 &&4 &5 &&5 &6 &&6 &7 &&7
&8 &&8 &9 &&9 &a &&a &b &&b
&c &&c &d &&d &e &&e &f &&f
&0
&&k &kMagic&r &&l &lBold
&&m &mStrike&r &&n &nUline
&&o &oItalic&r &&r &rReset
#Colors 代表了书本的章节名字
我们可以看到在kit包中要调用一本书的格式如下
代码:
- 387 1 title:&4书_&9与_&6颜色 author:Essentials lore:游戏内的颜色代码 book:颜色
下面给出每个项的介绍
代码:
Title
书本的标题，支持颜色代码，与book.txt中的章节名无关
格式
title:<title>
Author
书本作者，支持颜色代码
格式
author:<author>
Lore
书本的描述。
格式
lore:<description>
Book
这里填写的书本的章节名，对应book.txt中#后面的章节名字。
格式
book:<section name>
6.kit工具包的权限设定也非常的方便，你可以给予玩家以下权限，来单独限制玩家可使用的工具包
代码:
essentials.kits.<kitname>
=====Essentials的木牌控制相关=====
领取工具包需要一个个输入指令，这样子未免有些太麻烦了，不过不要紧Essentials提供了完整的木牌系统来简化你的操作。
为了启用木牌领取工具包你首先得在config文件中找到
代码:
enabledSigns:
并将 - kit 前面的#去除，然后重启插件。
牌子输入格式如下
[Kit]
<KitName>
[Group]
[Cost]
<kitName>代表了工具包名称，如tools
[group]代表了可使用这个牌子的用户组，如果不设置那么根据玩家是否拥有
essentials.kits.<kitname> 权限来判断玩家是否可以使用牌子获取工具包.或者你可以在这一项输入 Everyone 代表所有玩家都可以使用。
[cost]代表了使用的花费如果不设置默认为免费
[Kit]
dtools
builder
$10
以上为示例（花费前面必须加$）
====建筑控制相关设置====
权限系统基本是每个服主的必修课，Essentials的建筑控制正是基于权限系统对玩家一切使用方块的行为进行限制，从而可以使服主完全限制玩家的行为，包括放置，破坏，扔掉，拾取，使用指定方块，并且可以限制玩家与指定方块交互，如限制玩家使用按钮，开关等。
首先是最基本的建筑权限
代码:
essentials.build
给予玩家此权限代表了玩家可以使用并放置所有方块。
如果当一个玩家没有 Essentials.build权限或者 build: false那么Essentials接着会检查如下权限
代码:
essentials.build.place.<id> 
essentials.build.place.<id>:<data> 
essentials.build.break.<id> 
essentials.build.break.<id>:<data> 
essentials.build.interact.<id> 
essentials.build.interact.<id>:<data> 
essentials.build.craft.<id> 
essentials.build.craft.<id>:<data> 
essentials.build.pickup.<id> 
essentials.build.pickup.<id>:<data> 
essentials.build.drop.<id> 
essentials.build.drop.<id>:<data> 
以上都是最基础的英文单词，相信大家都看的懂我就不一个个翻译了。
唯一需要解释的是 interact 权限这代表了玩家与方块交互例如使用按钮等。
但是放置方块，或者破坏方块也属于交互的一种，所以如果你想让一个玩家能放置或者破坏一个方块你需要同时给予那个玩家与此方块交互和放置两个权限。
通过给予玩家以上权限你就可以做到例如单独让玩家可以破坏某个方块，或者玩家只可以按按钮不能破坏方块之类的功能。
那如果你想单独让玩家不能破坏某个方块该如何设置呢
这里首先得说明一下groupmanager的权限设置格式
大家都知道如果我输入
代码:
/mangaddp builder essentials.build.place.1
就是给予builder用户组放置石头的权限
而如果我输入
代码:
/mangaddp builder -essentials.build.place.1
这两个指令之间只相差了一个 - 但是效果完全相反，添加了此权限玩家将不能放置石头。 - 代表了移除玩家的此权限。
当一个玩家同时拥有
代码:
essentials.build.place.1
-essentials.build.place.1
这两个权限时玩家将无法放置石头
因为在groupmanager判断权限时优先判断 -权限这意味着就算你拥有建筑权限你被加入了-essentials.build.place.1 那么你也是无法放置石头的。
以此为基础我们可以单独设置玩家不可以放置，使用的方块。
如果你想一次设定多个方块你可以用 * 来代替如羊毛方块的ID是35 一直到35:15
你可以给予玩家 Essentials.build.place.35:* 来给予玩家所有羊毛方块的放置权限

====list玩家列表相关设置====
在Essentials的list列表设置中服主可以自定义以下内容
引用:
合并:你可以自定义一个展示用户组，将几个用户组的玩家全部显示在一个展示用户组中。
隐藏:你可以完全隐藏你不想显示的用户组。
限制:你可以限制每个用户组在list列表中的数量上限，超过上限的部分将会被隐藏。
这个配置部分允许您覆盖/编辑/list命令,从而显示一个更加整齐，简洁的list列表。
在默认情况下,你可以定义所有用户组的显示顺序，所有未定义的用户组将会按照首字母排序。
在config文件中你可以通过搜索
代码:
list:
来找到相关设定位置
1.合并
代码:
Staff: owner admin moderator
这样设定的话，所有owner admin moderator用户组的玩家在list指令中会全部显示在staff用户组中
2.隐藏
代码:
default: hidden
这样设置的话 default 将会被隐藏，所有此用户组的玩家将不会在list列表中显示
3.限制
代码:
builder: 20
这样设置的话所有builder用户组的玩家只会显示20个，超过的部分会被隐藏。
——————————————————————————————————————————————————————————————————
所有未定义的用户组都将会正常显示
下面给出一个例子包括上述所有设置
代码:
list:
Admin: owner admin
stealth: hidden
builder: 20
default: 0
====chat聊天格式相关设置====
通过Essentials的chat聊天相关设置你可以自定义玩家在聊天过程中名字的前缀等。
注意：要使用这些功能你必须安装Essentialschat插件。
_____________________________________________
=====显示名（display names）=====
在Minecraft中,你的displayname就是你在聊天过程中显示的名字，或者是在tab列表，插件中应用到的名字。
显示名由groupmanager插件决定可以在对应世界文件夹group.yml中修改。
bukkit最多允许显示名有16个字符，所以建议将显示名的前缀+名字+后缀压缩在16个字符以内。
======设置======
在Essentials的config文件中有6个与显示名有关的设定
代码:
# OP名字的颜色代码,填写0~9或a~f其中的一个数字或字母,填写'none'来冻结该功能.(译注:可到http://ess.khhq.net/mc/查看颜色代码)
ops-name-color: 'c'
# 昵称的前缀符号,这样你能知道这不是他们真正的用户名.
nickname-prefix: '昵称:'
# 设置最大昵称长度, 昵称前缀也包括在内.
max-nick-length: 15
# 如果你想用其他的插件来设置玩家名字,将其改为"false".
change-displayname: true
# 当这个选项开启时,在玩家显示的名字上添加的前缀或尾缀,会被显示在在线列表(TAB)中.
# 上面的"change-displayname"必须是true才有效.
change-playerlist: true
# 添加前缀后缀(上面的"change-displayname"必须是true才有效)
# 如果你不设置该项,且essentialschat被安装了,其将会被默认为"true".
add-prefix-suffix: true
这里我就直接复制中文config中的设定了，因为有全部的中文注释了。我在这里就不再赘述了
=====聊天格式=====
这里的设定将会改变玩家在聊天时显示的样式。
下面是一个例子
代码:
{DISPLAYNAME} {MESSAGE} {GROUP} {WORLDNAME} {SHORTWORLDNAME} {TEAMPREFIX} {TEAMSUFFIX} {TEAMNAME}
代码:
{MESSAGE} 聊天的内容.
{GROUP} 玩家所属用户组名称.
{DISPLAYNAME} 显示名包括了玩家的前缀以及后缀.
{WORLDNAME} 玩家所处世界的名字.
{SHORTWORLDNAME} 玩家所处世界的首字母.
{TEAMPREFIX} {TEAMSUFFIX} {TEAMNAME} 计分板团队变量.
你可以按照自己的喜好自由组合以上变量，并且完全支持颜色代码
下面给几个例子
代码:
format: '<{DISPLAYNAME}> {MESSAGE}'
format: '&8[&7{GROUP}&8]&f {DISPLAYNAME}&7:&f {MESSAGE}'
format: '{WORLDNAME} {DISPLAYNAME}&7:&f {MESSAGE}'
format: '{WORLDNAME} &8[&7{GROUP}&7]&f {DISPLAYNAME}&7:&c {MESSAGE}'
下面截图中显示的是最后一种样式游戏中的实际效果
[图]

====Essentials丰富多彩的木牌系统====

'''Essentials sign'''

从essentials2.8开始，所有的牌子都默认对普通组（default）关闭，你可以在essentialsconfig.yml中分别开启每一种牌子，来启用牌子们的功能。你需要支持木牌彩色字体的插件（因为牌子功能在游戏中需要用颜色开启，因此服务器要有颜色插件或者其他的能开启木牌颜色&功能的补丁才能使用木牌功能）。
大贴士：这个木牌功能并不是独立插件，它存在于Essentials.jar这个插件中，所以你只要下了Essentials主插件（essentials有一个大家族，主插件就是上面这个名字，如果你以为把jar文件改成这个名字就行了，你可能是一个jar），并成功载入，就能使用这个功能了。（当然，你还要在config里给玩家开启各个牌子的功能和给予玩家使用权限。）
权限节点：？

'''木牌类型介绍'''

''Sign（木牌）''

所有的Essentials木牌类型都应该被书写在牌子的第一行正中于一对英文方括号中 “[]”
如果你写对了，方括号中的内容会变成蓝色的，如果你写错了，方括号中的内容就会变成红色的。（退出书写界面后才会显示。）
下面的cost（花费，可以是花费支出，也可以是花费收入）项，当然它不会出现在第一行的类型中，但作为一个十分有用的项，我们来介绍一下他们：

如果你想使花费为5个货币，请在对应行写上$5；

如果你想要时间，你可以写上；

如果你想要花费为物品，举个例子：2 redstone 或者 2 331（红石的物品id）个人推荐使用物品id。如果你的花费物品有子代码，即冒号后的东西，在冒号前的数字后面打一个英文逗号，再打上冒号后的数字。

如果你想让花费是经验值，举个例子：15 exp

''1、Mail木牌''

这种木牌第一行的书写内容必须是[Mail]，其余可以随意。
Mail木牌提供查看自己的邮箱的功能，当然是Essentials插件自带的邮箱。玩家只需要右键已经建立成功的牌子，就可以查看自己的邮箱，不需要权限。这对不开启mail权限的服务器来说有所帮助。

''2、Free 木牌''

免费木牌第一行的书写内容必须是[Free]，第二行必须是某个物品的名字（以后提到物品的名字，都是英文）或者物品id。其余最好不要填写，如果要填可以自己测试一下是否可以使用。此木牌的功能为让玩家免费领取你书写在牌子上的物品，从某种意义上来讲，这个木牌也是一个箱子，不过当你从木牌中取出东西的时候，物品会自动补充。
（建议免费物品不要太贵重）

''3、Kit 木牌''

Kit是服务器管理员向玩家发放新手礼包的一种主要渠道。Kit的编辑嘛，我们不是教你编辑礼包的……不知道编辑的管理员先去学习。这种木牌的第一行必须是[Kit]，第二行必须是Kit的名字，比如Tools。第三行是组的名字，即哪个组可以领取这个礼包，只能填写一个，当然如果这个礼包是面向所有人的，你要在这一行填写Everyone。第四行是花费，即领取这个礼包要付出什么东西，见上cost的说明，如果免费，可以不填。（在玩家通过木牌领取礼包时，不需要领取礼包的权限）

''4、Disposal 木牌''

这种木牌第一行的书写内容必须是[Disposal]。其余可以随便填，当然有可能用不了。功能很简单，当你手持一样东西右键这个牌子，你的东西不见了，当你用空手右键木牌，什么都不会发生，很简单吧，就这样。

''5、Heal 木牌''

这种木牌第一行的书写内容必须是[Heal]。第二行是花费，即你需要花费什么东西来通过牌子将自己血量补满。Heal木牌的功能等同于heal指令，对象是使用该木牌的玩家，只不过使用Heal木牌不需要heal指令的权限。你永远不应该把放置Heal木牌的权限给普通玩家，以及其他非管理组的组，除非你开的是“创造”类型的服务器。（建议书写花费）

''6、Time 木牌''

这种木牌第一行的书写内容必须是[Time]。第二行是day或者night，即这个木牌可以把该世界的时间调到白天或者黑夜。第三行是花费，即你使用该木牌调整一次时间所需要花费的东西（见上cost的说明）。这种木牌的功能就是给普通玩家调整时间的机会，当然花费不菲。

''7、Weather 木牌''

这种木牌第一行的书写内容必须是[Weather],第二行是sun或者storm，即这个木牌可以调整该世界的天气为晴天或者暴风雨。第三行是花费，即你使用该木牌调整一次天气所需要花费的东西（见上cost的说明）。使用该木牌给玩家提供了跳过坏天气的机会，而且不需要使用调节天气命令的权限，这种木牌最好放在公共场所，但当你看到某个玩家在对着这个木牌狂点时，你要考虑一下收费了。
对于以上两种调整游戏时间和天气的木牌，建议如果要使用就一种创建两个木牌，拿Weather木牌举例，一个木牌第二行是sun，一个木牌第二行是storm，提供一个选择，单个木牌只能调整一种天气。Time木牌也一样。

''8、Warp木牌''

这种木牌第一行的书写内容必须是[Warp]，第二行书写warp名（即你已经创建的warp，并且想要通过木牌来快捷传送。）第三行书写权限组名，不写默认所有玩家。第四行书写花费，即你使用该木牌进行一次warp传送所需要花费的东西。这种木牌的功能就是将warp指令木牌化，能够让玩家快捷使用，当第三行未被书写时，使用木牌的玩家会被检查是否具有warp或者per-warp的权限，当然，你也可以通过在书写权限组的位置书写Everyone来让所有玩家不需要权限就能够通过木牌进行warp传送。（不管需要权限或者不需要权限，传送对象都只是木牌上书写的那个warp名）

''9、Spawnmob 木牌''

这种木牌第一行的书写内容必须是[Spawnmob]。第二行必须是一个整数数字，即你要生成的生物数量，不要过大，因为会卡。（建议为1或2）。第三行是你要生成的生物类型，要为英文名。第四行为花费，即你要通过木牌生成一次木牌上所写的数量的生物所需要花费的东西。这种木牌的功能就是在牌子附近生成生物，但是首先你得给玩家生成该生物的权限，比如狼的：essentials.spawnmob.wolf 可能管理者会有疑问，如果我把这个权限给了玩家，那么玩家不就可以自己用mob指令召唤生物了吗？我们早就准备了答案，如果你不把essentials.spawnmob的权限给玩家，即使玩家有essentials.spawnmob.XXX的权限，玩家也是不能使用spawnmob生成指令的。

''10、Enchant 木牌''

这种木牌第一行的书写内容必须是[Enchant]，第二行需要是一个能被附魔的物品，比如；十字镐，或者剑(英文的)，当然你也可以在第二行写上*或者any来让所有可附魔的物品都能用这个木牌来附魔。第三行需要是附魔的名称，比如：耐久或者锋利（同样是英文的），名称后面一个英文冒号加上一到五的数字，即附魔级数，举个例子，耐久三：silktouch:3第四行为花费，即你使用该木牌进行一次单项附魔所需要的花费。木牌附魔只能实现添加一项附魔到物品上的功能，当然你可以用多个写有不同附魔的木牌来进行添加多项附魔属性。
这种木牌还可以附魔非工具武器类的物品，比如：羽毛。

''11、Gamemode 木牌''

这种木牌第一行的书写内容必须是[gamemode]，第二行需要是游戏模式，比如：生存模式-survival,创造-creative，冒险模式-adventure。第三行需要为花费，即你通过木牌将你现在的游戏模式调整一次为木牌上所书写的游戏模式所需要花费的东西。这种木牌的功能就是切换你的游戏模式，对于多种游戏模式的服务器可能会有用。

''12、Info 木牌''

这种木牌第一行的书写内容必须是[Info]。第二行必须是页或者章节的名字（？），第三行需要是页数，如果章节包含有这页。第四行是花费，即你通过木牌阅读一次资料所需要花费的东西（我想你不会看第二遍一样的东西）。这种木牌的功能就跟/info指令差不多，使用这种木牌不需要info的权限，这种木牌对展示服务器网址或者规则，介绍很有用。

''13、Repair 木牌''

这种木牌第一行的书写内容必须是[Repair],第二行是hand或者all，表示修理的对象是手中所拿物品（就是你拿着右键木牌的物品）还是你的背包及物品栏还有装备栏里的所有物品。第三行是花费，即你使用木牌进行一次修理所需要花费的东西，不管是修理手中的物品还是所有物品。相信你不会带着一堆没有耐久值的东西去点这个木牌。

'''Essentials经济类木牌'''

这些木牌对于你的服务器的经济来说至关重要，玩家能够通过Trade木牌来卖出他们辛苦砍来/挖来/抢来/钓来的东西，为了帮助你的玩家们，你可能会考虑弄一个收购木牌来收购一些玩家的原石，地狱岩，萤石或者钻石之类的东西。
收购/出售商店的权限一般都属于管理者，应为这是些永久商店。而Trade木牌给了玩家一个机会，玩家的背包里需要有他们要卖的东西，这是收购/出售商店不需要的，因为Trade木牌的物品是一个史蒂夫卖给另外一个史蒂夫，而收购/出售商店是数据库卖给所有的史蒂夫。

''1、Trade 木牌''

这种木牌的构成有两种形式，而且比较复杂，请仔细阅读。先说说这种木牌的大概结构，第一行的书写内容统一是[Trade],第二行是你想要什么，第三行是你想给出什么，可能你有点疑惑，嗯，我也是，那就往下看吧。
第一种trade木牌，第一行的书写内容是[Trade],第二行是价格，即你卖出一份物品的价格，格式是这样的，$加上数量，即为多少钱，$和数量之间不用加空格，如$10第三行先写上数量，空格，物品的英文名，英文冒号，总额（即为你要放置于牌子里的物品的数量，请于放置木牌前确定你的背包里有小于等于总额的对应物品，不然放置的木牌没有效果。对应物品就是你上面书写的物品名），数量和物品名构成了一份物品。第四行请空着，如果创建木牌成功，你书写完毕后会在第四行显示你的名字。这种木牌的功能是以对应价格卖出对应数量物品，木牌放置成功后，除了显示名字外，会在第二行的价格后面多出一个冒号，冒号后面的数字暂时为0，意思为你的商品以对应价格卖出了多少份。
第二种trade木牌，第一行的书写内容是[Trade],第二行是数量，空格，加上物品的英文名，即你收购的物品种类和数量（也就是别人一次能卖给你的物品数量）。第三行先打上一个$加上数字，之间不用空格，（这个价格表示你收购一份如第一行所写的数量的物品的报酬），然后一个英文冒号，然后写上总额（即你在这个木牌里放多少组冒号前的价格，确保你有这么多钱，所放入的钱等于一份价格乘以总额。）如果你的木牌创建成功，同样会在第四行显示你的名字并且在第二行的书写内容后面出现一个冒号，冒号后的数字暂时为0，即为你收购到了多少份物品。
这两种木牌都是给普通玩家的日常交易服务的，当木牌所有者右键自己已经放好的木牌时，木牌所有者会收到木牌里的储存的钱或物品（这里的钱和物品是通过交易所得的，并非你原来放入的钱或物品，所以放置木牌的时候要考虑清楚，你是否真的要放这么多东西进去？）当木牌所有者拿着要卖的物品右键第一种木牌，就是往木牌里续存物品。其他非木牌所有者右键木牌就是买卖东西了，如果你背包里有对应的东西的话。物品名可以为物品id，推荐id。

''Buy 木牌（系统售卖木牌）''

这种木牌第一行的书写内容必须是[Buy]，第二行必须是一个数量，而且是整数，这个数量是一次交易系统给予玩家对应物品的数量。第三行需要是物品英文名字或者id，即这个木牌出售哪个物品，这一行也可以只写上exp来让系统出售经验值。第四行是花费，即系统售卖一次对应数量的对应物品玩家应付给系统的钱或物品，钱，$加整数数量，物品，整数数量，空格，物品英文名或者id。与Trade木牌不同，Buy和Sell木牌是一个永久系统商店木牌，不需要任何东西，需要的物品木牌会自动生成，收到的钱只会从玩家账户里扣除。所以Buy和Sell木牌的放置权限永远不应该给玩家，而应该由服务器管理者管理Buy和Sell木牌。

''Sell 木牌（系统收购木牌）''

这种木牌第一行的书写内容必须是[Sell],第二行必须是一个整数数量，这个数量就是玩家一次卖给系统的物品数量。第三行需要写物品名字或者id，即这个木牌收购哪个物品，也可以填写exp，来收购玩家的经验值。（当然玩家得有对应数量的经验值，不然无法交易。经验值的数量就是上面填写的数量，单位是点）第四行是花费，即系统收购一次对应数量的对应物品付给玩家的钱或物品。

''Balance 木牌''

这种木牌第一行的书写内容必须是[Balance]。这种木牌的功能很简单，查看玩家的财富排行榜（就是谁最有钱），而且不需要使用查看排行榜指令的权限，使玩家更容易地查看财富排行榜，而不是输指令。右键使用，财富榜会显示在对话框里。

'''备注：'''
1、所有的功能木牌都是右键使用。
2、有选择地给玩家放置各种木牌的权限。
3、假如一个玩家想放置一种功能木牌，程序有几道？一这种木牌在Eseentials.config中开启了使用，二这个玩家具有放置这种功能木牌的权限，三这个玩家有木牌彩色字体的权限。

物品id表
[[File:data value.png|frame|物品id表]]

[[Category:插件教程]]