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

Multiverse-Core

2016-12-04T07:40:59Z

Lzs：/* 上传你的存档 */

{{Bukkit Plugin Infobox
|插件名= Multiverse-Core
|版本= 2.5-b717
|兼容服务端版本=1.9
|作者= MultiverseTeam
|網址= http://dev.bukkit.org/bukkit-plugins/multiverse-core/
}}
==基础==
===介绍===
Multiverse-Core提供世界的创建功能。它可以控制怪物生成，环境类型，可自定义的地形特征，还有许多功能。
尽管Multiverse-Core能够做到这些，但是请注意Multiverse-Core自身是无法创建世界的，它只是简单的调用了Bukkit-API来
创建新的世界。如果同时存在其它创建世界类型的插件，很有可能会与本插件发生冲突。
（很明显地，Multiverse-Core能够与一些插件共存，但与其它插件则不一定兼容。）
附带说一句，Bukkit仍监控着创建的世界；Multiverse会尽其所能来控制世界的行为，但最终，其它插件或是Bukkit服务端所发生的意外都有可能覆盖、重置已有的设置。

===上传你的存档===
如果你是服务器的一名OP，当你在安装Multiverse-Core后首次登入，你将会看到以下的提示信息：

You don't have any worlds imported into Multiverse!
You can import your current worlds with /mv import or you can create new ones with /mvcreate
If you just wanna see all of the Multiverse Help,type:/mv

这些信息表示，尽管你可能已经在服务端上传了存档，本插件并不能直接调用。告知Multiverse-Core的操作很简单。输入：
/mv import WORLD ENV
你可以将WORLD替换为你的文件夹名称，将ENV替换为环境类型。三个可选的环境类型为：normal(普通), nether(地狱)和 end(末地)。
如果你忘记类型名称，你可以使用/mv env来查看这些选项。
大多数服务器会将主世界的文件夹命名为world(即默认)。这里是我输入的一个示例：
/mv import world normal
你将会看到的结果是：
Staring world import...
Complete!
现在你只需要重复以上过程，上传你所有的世界即可完成载入。
（不喜欢你的文件夹名称？不需要重命名文件夹，只需要简单地设置一个Multiverse世界别名！）

===创建新的世界===
现在，你已经上传了你的主世界与副世界，但是你想要一个创造模式使用的世界？世界的创建是一个十分简单的过程，调用指令如下：
/mv create {NAME} {ENV} -s [SEED] -g [GENERATOR[:ID]]

不要担心所有的这些参数，你只需要知道{}之中的内容是必填的，[]中的内容则是选填的。在我们的示例中，我们要做的很简单：
/mv create creative NORMAL
这个过程所需要的时间比上传存档要长一些，你可以在服务器的控制台看到整个创建的过程。
这个命令创建了一个名为"creative"的世界，整个世界的环境类型为normal。你也可以在命令中输入世界生成器
的种子代码，或是将环境类型改为nether、end，再或者你也可以思考如何设置生成器代码来
创建各种炫酷的地形(例如, -g BukkitFullOfMoon)。
经过以上的命令调用，你的世界现在已经创建完毕。

=== 传送至新的世界 ===
嗯，现在你已经拥有了自己所创建的世界。去往这个世界同样很简单，只需要输入：
/mv tp testworld
嗯，现在你应该已经到达了新世界。如果你想要带你的朋友过来，只需要输入：
/mv tp YOURMATE testworld

=== 设置新世界的出生点 ===
新世界的0.0坐标并不总是完美的出生点，你也不想玩家在传送到新世界或在新世界重生时坠入虚空吧？
走、攀爬、挖掘，无论以任何方式，站在你想要设置为出生点的方块上面，输入：
/mv setspawn
即可完成新世界出生点的设置。

=== 回到出生点 ===
回到出生点：
/mv spawn
完成。

=== 修改某些参数 ===
嗯，你对苦力怕爆炸造成的物品丢失感到厌烦？想要关闭敌对生物的生成？
/mv modify set monsters false
你可以很容易的修改其他设置的负载情况（阀值）（例如关闭动物生成和PvP）

=== 清除怪物以及其它实体 ===
只需要输入以下命令即可清除指定世界的所有动物：
/mv purge testworld animals
你也可以将testworld替换为ALL来对全部世界执行清理命令。
除了动物，你还可以指定一个列表中的怪物来清除。将animals替换为monsters或all即是清除所有怪物。

=== 移除你的世界 ===
移除世界，只需要输入：
/mv delete testworld
你有十秒钟的时间来确认这个命令，通过输入以下命令来确认操作：
/mv confirm
记住，一旦确认执行命令，这个世界将会被完全地移除。

=== 总结 ===
以上就是本节的全部内容。
想了解更多详情，请在游戏中输入/mv或是查看[[Multiverse-Core/Command Reference]]
这里值得一提的是，我们已经在本教程中讲解了很多冗长的命令。
想要了解某个具体的命令，只需要在游戏中输入：
/COMMAND ?
游戏中，插件将会为你展示详细内容。
注意：90%的Multiverse命令可以在控制台执行。只有部分需要指定其它变量的命令才无法在
控制台使用，例如:/mv setspawn（需要脚下方块作为选定点，所以无法在控制台中使用。）

=== 部分名词说明 ===
阀值 -------- true开启 false关闭

== 权限 ==

•帮助权限
multiverse.help——允许拥有该权限的用户使用/mv查看指令帮助

•访问权限
multiverse.access.NAME——允许拥有该权限的用户去指定的世界
multiverse.exempt.NAME——允许拥有该权限的用户去指定的世界无需access权限
mv.bypass.gamemode.NAME- - -允许拥有该权限的用户可以保持模式去往各个世界，如果一个玩家拥有mv.bypass.gamemode.*权限，可以保持他的创造模式去往生存模式的世界.

•传送的权限
multiverse.teleport.self.NAME——允许拥有该权限的用户可以使用/mv tp [PLAYER] {WORLD}传送自己进入一个指定世界
multiverse.teleport.other.NAME——允许拥有该权限的用户可以使用/mv tp [PLAYER] {WORLD}传送自己和他人进入一个指定的世界

•信息权限
multiverse.core.confirm——拥有该权限的用户使用/mv confirm可以确认使用上一个指令
multiverse.core.coord——拥有该权限的用户可以使用/mv coord显示当前坐标
multiverse.core.info——拥有该权限的用户可以使用/mv info显示当前世界
multiverse.core.list.environments——拥有该权限的用户可以使用/mv env显示有效的环境
multiverse.core.list.who——拥有该权限的用户可以使用/mv who显示目前世界
multiverse.core.list.worlds——拥有该权限的用户可以使用/mv list显示你可以进入的世界
multiverse.core.version——允许拥有该权限的用户可以使用/mv version 查看版本信息
multiverse.core.generator——允许拥有该权限的用户可以使用/mv generators 列出生成器插件

•出生点的权限
multiverse.core.spawn.other——允许拥有该权限的用户可以使用/mv spawn *把别人传送去出生点
multiverse.core.spawn.self——允许拥有该权限的用户可以使用/mv spawn 把自己传送去出生点
multiverse.core.spawn.set——允许拥有该权限的用户可以使用/mv spawn set设置世界的出生点

•编辑世界的权限
multiverse.core.create——允许拥有该权限的用户可以使用/mv create创建世界
multiverse.core.delete——允许拥有该权限的用户可以使用/mv delete {WORLD}删除世界
multiverse.core.load——允许拥有该权限的用户可以使用/mv load加载世界
multiverse.core.unload——允许拥有该权限的用户可以使用/mv unload {WORLD}暂时卸载世界
multiverse.core.remove——允许拥有该权限的用户可以使用/mv remove {WORLD}从 Multiverse 中卸载一个世界并移除worlds.yml内相应世界信息, 这个指令不会删除该世界文件夹.
multiverse.core.import——允许拥有该权限的用户可以使用/mv import转换一个世界为指定类型

multiverse.core.modify——允许拥有该权限的用户可以使用/mv modify修改世界各个方面的设置
multiverse.core.modify.add——允许拥有该权限的用户可以使用/mv modify add 添加世界参数
multiverse.core.modify.clear——允许拥有该权限的用户可以使用/mv modify clear 移除所有设置的值. 设置将在所有包含的列表里生效
multiverse.core.modify.modify——未知
multiverse.core.modify.remove——允许拥有该权限的用户可以使用/mv modify remove 移除世界参数
multiverse.core.modify.set——允许拥有该权限的用户可以使用/mv modify set 设置世界参数
multiverse.core.purge——允许拥有该权限的用户可以使用/mv purge [WORLD|all] {all|animals|monsters|MOBNAME}从指定世界清除掉指定类型的生物

multiverse.core.reload——允许拥有该权限的用户可以使用/mv reload重新加载配置文件

•设置的权限
multiverse.core.config——允许拥有该权限的用户可以使用/mv config 修改全局配置
multiverse.core.debug——允许拥有该权限的用户可以使用/mv debug切换调试模式
multiverse.core.silent——允许拥有该权限的用户可以使用/mv silent 切换沉默模式

•有待编辑的权限
multiverse.core.anchor
multiverse.core.sleep
multiverse.core.spout
multiverse.core.tp.*
multiverse.core.tp.self
=== '''<big>Config</big>''' ===
下面是Multiverse-Core（2.9版本）默认Config.yml文件，我们会尽可能地保持和Multiverse-Core更新同步.
*<big>首先，请确保你的Multiverse-Core已经是最新版本.</big>
在后台输入这个指令<code>/mv version</code>即会弹出下列数据：
<nowiki>
...</nowiki> 
XX:XX:XX [INFO] [Multiverse-Core] [Multiverse-Core] Dumping Config Values: (version 2.9) 
...
后面显示的，就是你当前Multiverse-Core的正确版本.如果'''你的版本号与下面例子中的版本（2.9）不一致'''，请立即更新你的'''Multiverse-Core''' 
（当然，如果大同小异的话用也没什么不合适）以及所有'''有关Multiverse的插件'''.
*<big>Config.</big>
'''#这是一个内部设置，请不要动它.''' 
multiverse-configuration: 
:'''# 这是一个让Multiverse-Core更加高效运行的设置.请不要动它.''' 
:==: com.onarandombox.MultiverseCore.MultiverseCoreConfiguration
:'''# 如果设置为false，那么Multiverse-Core将不会强制管理'''
:'''# 每个世界的通过权限.(在其它多世界插件范围内）'''
:enforceaccess: 'false'
:'''# 如果这个设置为true，那么Multiverse-Core就会在聊天名称前加上'''
:'''# 你定义的多彩世界前缀；如果这个设置为空，那么Multiverse-Core就会'''
:'''# 在聊天名称前加上白色单调的世界前缀；如果这个设置为false，那么'''
:'''# Multiverse-Core将不会干预聊天窗口.'''
:prefixchat: 'true'
:'''# 如果这个设置为true，那么Multiverse-Core将强制管理每个'''
:'''# 世界的通过权限.（在所有插件范围内）'''
:teleportintercept: 'true'
:'''# 如果这个设置为true，玩家将会被提示他们可以使用多世界的哪些命令.'''
:'''# 如果设置为false，他们将不会知道自己能使用什么命令.'''
:displaypermerrors: 'true'
:'''# 如果这个设置为true，将应用Multiverse-Core出生点设置'''
:'''# 设置为false应用其它出身点管理插件的设置（如果你有的话）'''
:firstspawnoverride: 'true'
:'''# 以下是你想让新玩家出生的世界名.'''
:'''# 如果这个世界名没有对应文件,将会被自动创建.'''
:firstspawnworld: Lobby_World
:'''# 给玩家发送信息的时间间隔'''
:'''# 单位：毫秒 - 5000=5秒'''
:messagecooldown: '5000'

:'''# 玩家使用'''<code>/MVTP</code>'''时间间隔'''
:'''# 单位：毫秒 - 1000=1秒'''
:'''# 如果你上面的'teleportintercept'设置为'true','''
:'''# 那么所有插件的TP（例如/tpa）都会受到限制.'''
:teleportcooldown: '1000'
:'''# 调试模式设置.值为0~3'''
:'''# 除非你是wiki编译者或者插件开发者，否则不要动.'''
:globaldebug: '0'
:'''# 版本号
:'''# 请不要修改这个值
:version: '2.9'
:'''# 搜索传送门范围.这是Bukkit服务端原生功能'''
:'''# 如果设置为true，将允许Multiverse-Core接替Bukkit掌管这一功能'''
:'''# 并应用自己的搜索半径.如果设置为false，Bukkit就会'''
:'''# 使用自己的默认搜索半径.'''
:defaultportalsearch: 'false'
:'''# 如果上面的设置为true，就会应用下面这个搜索半径.
:'''# 注意，搜索传送门范围这一功能仅对Vanilla类型的传送门有效.
:'''# 当然也包括支持Multiverse-NetherPortals的传送门.
:portalsearchradius: '16'

Sentinel

2016-11-18T03:48:19Z

Lzs：/* 可以使用的武器类型 */

{{Bukkit Plugin Infobox
|版本=0.6
|兼容服务端版本=Spigot 1.10
|網址=[http://ci.citizensnpcs.co/job/Sentinel 下载地址] [https://www.spigotmc.org/resources/sentinel.22017/ 下载地址(Spigot)] [http://dev.bukkit.org/bukkit-plugins/sentinel/ 下载地址(Bukkit)]
}}
[[Category:信息]][[Category:角色]][[Category:综合]][[Category:其他]][[Category:娱乐]]
 
<pre>
[信息|角色|综合|其他|娱乐]Sentry—— 强大神奇的自定义NPC扩展! [内附教程][全版本]
http://www.mcbbs.net/forum.php?mod=viewthread&tid=488928
看了这个这个帖子，你应该能大体明白这个插件的作用
本地化介绍
Sentry最新版: 支持 Spigot 1.10
</pre>
 
===注意事项===
* 如果你的NPC没有近战伤害,请您把配置文件config.yml里的workaround damage 改为true

===使用教程===
* 下载:Citizens与Sentinel并放入plugins文件夹
* 重启服务器

* 首先创建一个NPC
* 使用/npc sel 命令选择NPC，或使用/npc create name 命令新建NPC
* 接着输入/trait Sentinel，设置NPC为哨兵
* 再输入/npc equip 设置NPC装备
* 手持要给NPC装备的护甲或武器，对着NPC右键。
* 输入/sentinel addtarget MONSTERS，给哨兵添加攻击目标的类型。
* 输入/sentinel help 显示帮助界面

* 注意：在没有开无敌的模式下，不要给哨兵添加攻击玩家的命令！

===游戏命令===

* /sentinel help - Shows help info.
* /sentinel addtarget TYPE - Adds a target.
* /sentinel removetarget TYPE - Removes a target.
* /sentinel addignore TYPE - Ignores a target.
* /sentinel removeignore TYPE - Allows targetting a target.
* /sentinel range RANGE - Sets the NPC's maximum attack range.
* /sentinel damage DAMAGE - Sets the NPC's attack damage.
* /sentinel armor ARMOR - Sets the NPC's armor level.
* /sentinel health HEALTH - Sets the NPC's health level.
* /sentinel attackrate RATE - Changes the rate at which the NPC attacks, in ticks.
* /sentinel healrate RATE - Changes the rate at which the NPC heals, in ticks.
* /sentinel respawntime TIME - Changes the time it takes for the NPC to respawn, in ticks.
* /sentinel chaserange RANGE - Changes the maximum distance an NPC will run before returning to base.
* /sentinel guard (PLAYERNAME) - Makes the NPC guard a specific player. Don't specify a player to stop guarding.
* /sentinel invincible - Toggles whether the NPC is invincible.
* /sentinel fightback - Toggles whether the NPC will fight back.
* /sentinel needammo - Toggles whether the NPC will need ammo.
* /sentinel safeshot - Toggles whether the NPC will avoid damaging non-targets.
* /sentinel chaseclose - Toggles whether the NPC will chase while in 'close quarters' fights.
* /sentinel chaseranged - Toggles whether the NPC will chase while in ranged fights.
* /sentinel drops - Changes the drops of the current NPC.
* /sentinel spawnpoint - Changes the NPC's spawn point to its current location, or removes it if it's already there.
* /sentinel forgive - Forgives all current targets.
* /sentinel enemydrops - Toggles whether enemy mobs of this NPC drop items.
* /sentinel info - Shows info on the current NPC.
* /sentinel stats - Shows statistics about the current NPC.
* /sentinel targets - Shows the targets of the current NPC.
* /sentinel kill - Kills the NPC.
* /sentinel respawn - Respawns the NPC.
* /sentinel targettime TIME - Sets the NPC's enemy target time limit.
* /sentinel speed - Sets the NPC's movement speed modifier.
* /sentinel autoswitch - Toggles whether the NPC automatically switches items.
* /sentinel targettime TIME - Sets the NPCs enemy target time limit.
* /sentinel greeting GREETING - Sets a greeting message for the NPC to say.
* /sentinel warning WARNING - Sets a warning message for the NPC to say.
* /sentinel greetrange RANGE - Sets how far a player can be from an NPC before they are greeted.
* /sentinel accuracy OFFSET - Sets the accuracy of an NPC.
* Sentry user?
*
* Type "/sentinel sentryimport" on a server running both Sentry and Sentinel to instantly transfer all data to Sentinel!
===权限===

* sentinel.basic for the /sentinel command
* sentinel.admin to edit other player's Sentinel NPCs.
* sentinel.greet for commands: greeting, warning, greetrange
* sentinel.info for commands: info, stats, targets
* Everything else is "sentinel.X" where "X" is the command name, EG "sentinel.damage".
===攻击目标的类型列表===

* 主要:
* NPCS,其他NPC
* OWNER,拥有者
* PASSIVE_MOB,被动怪物
* MOBS,主动怪物
* MONSTERS,怪物
* PLAYERS,玩家
* PIGS,猪
* OCELOTS,猫
* COWS,牛
* RABBITS,兔
* SHEEP,羊
* CHICKENS,鸡
* HORSES,马
* MUSHROOM_COW,蘑菇牛
* IRON_GOLEMS,铁傀儡
* SQUIDS,鱿鱼
* VILLAGER,村民
* WOLF,狼
* SNOWMEN,雪人
* WITCH,女巫
* GUARDIANS,守护者
* SHULKERS,潜影贝
* CREERERS,苦力怕
* SKELETONS,骷髅
* ZOMBIES,僵尸
* MAGMA_CUBES,岩浆怪
* ZOMBIE_PIGMEN,僵尸猪人
* SILVERFISH,蠹虫
* BATS,蝙蝠
* BLAZES,烈焰人
* GHASTS,恶魂
* GIANTS,巨人
* SLIME,史莱姆
* SPIDER,蜘蛛
* CAVE_SPIDERS,洞穴蜘蛛
* ENDERMEN,末影人
* ENDERMITES,末影螨
* WITHER,凋灵
* ENDERDRAGON,末影龙
*
* player:NAME(REGEX),某个玩家
* npc:NAME(REGEX),某个NPC
* entityname:NAME(REGEX),某个实体
* helditem:MATERIALNAME(REGEX),手持某个物品的实体
* group:GROUPNAME(EXACT),某个组
* event:pvp/pvnpc/pve,某个事件状态
* Some random supported things,随机支持一些事情

===可以使用的武器类型===

* Fists,拳头
* Swords,剑
* Tools,工具
* Bow,弓
* 可以为NPC设置各种类型的箭！
* 火焰棒(发射火球)
* 药水(飞溅,持续)
* 下界之星(闪电袭击)
* 光灵箭(使目标发光,而不破坏它)
* (要使目标发光并伤害它, equip a bow + arm it with spectral arrows!)
* 雪球
* Respawning can be set to "-1" to cause the NPC to delete itself on death, or "0" to prevent respawn.
* Sentinels will guard a point or path if either is set using the command "/npc path"
* To make a ghast or blaze fire fireballs, give them a blazerod!

Sentinel

2016-11-18T03:40:38Z

Lzs：/* 可以设置成为目标的类型 */

{{Bukkit Plugin Infobox
|版本=0.6
|兼容服务端版本=Spigot 1.10
|網址=[http://ci.citizensnpcs.co/job/Sentinel 下载地址] [https://www.spigotmc.org/resources/sentinel.22017/ 下载地址(Spigot)] [http://dev.bukkit.org/bukkit-plugins/sentinel/ 下载地址(Bukkit)]
}}
[[Category:信息]][[Category:角色]][[Category:综合]][[Category:其他]][[Category:娱乐]]
 
<pre>
[信息|角色|综合|其他|娱乐]Sentry—— 强大神奇的自定义NPC扩展! [内附教程][全版本]
http://www.mcbbs.net/forum.php?mod=viewthread&tid=488928
看了这个这个帖子，你应该能大体明白这个插件的作用
本地化介绍
Sentry最新版: 支持 Spigot 1.10
</pre>
 
===注意事项===
* 如果你的NPC没有近战伤害,请您把配置文件config.yml里的workaround damage 改为true

===使用教程===
* 下载:Citizens与Sentinel并放入plugins文件夹
* 重启服务器

* 首先创建一个NPC
* 使用/npc sel 命令选择NPC，或使用/npc create name 命令新建NPC
* 接着输入/trait Sentinel，设置NPC为哨兵
* 再输入/npc equip 设置NPC装备
* 手持要给NPC装备的护甲或武器，对着NPC右键。
* 输入/sentinel addtarget MONSTERS，给哨兵添加攻击目标的类型。
* 输入/sentinel help 显示帮助界面

* 注意：在没有开无敌的模式下，不要给哨兵添加攻击玩家的命令！

===游戏命令===

* /sentinel help - Shows help info.
* /sentinel addtarget TYPE - Adds a target.
* /sentinel removetarget TYPE - Removes a target.
* /sentinel addignore TYPE - Ignores a target.
* /sentinel removeignore TYPE - Allows targetting a target.
* /sentinel range RANGE - Sets the NPC's maximum attack range.
* /sentinel damage DAMAGE - Sets the NPC's attack damage.
* /sentinel armor ARMOR - Sets the NPC's armor level.
* /sentinel health HEALTH - Sets the NPC's health level.
* /sentinel attackrate RATE - Changes the rate at which the NPC attacks, in ticks.
* /sentinel healrate RATE - Changes the rate at which the NPC heals, in ticks.
* /sentinel respawntime TIME - Changes the time it takes for the NPC to respawn, in ticks.
* /sentinel chaserange RANGE - Changes the maximum distance an NPC will run before returning to base.
* /sentinel guard (PLAYERNAME) - Makes the NPC guard a specific player. Don't specify a player to stop guarding.
* /sentinel invincible - Toggles whether the NPC is invincible.
* /sentinel fightback - Toggles whether the NPC will fight back.
* /sentinel needammo - Toggles whether the NPC will need ammo.
* /sentinel safeshot - Toggles whether the NPC will avoid damaging non-targets.
* /sentinel chaseclose - Toggles whether the NPC will chase while in 'close quarters' fights.
* /sentinel chaseranged - Toggles whether the NPC will chase while in ranged fights.
* /sentinel drops - Changes the drops of the current NPC.
* /sentinel spawnpoint - Changes the NPC's spawn point to its current location, or removes it if it's already there.
* /sentinel forgive - Forgives all current targets.
* /sentinel enemydrops - Toggles whether enemy mobs of this NPC drop items.
* /sentinel info - Shows info on the current NPC.
* /sentinel stats - Shows statistics about the current NPC.
* /sentinel targets - Shows the targets of the current NPC.
* /sentinel kill - Kills the NPC.
* /sentinel respawn - Respawns the NPC.
* /sentinel targettime TIME - Sets the NPC's enemy target time limit.
* /sentinel speed - Sets the NPC's movement speed modifier.
* /sentinel autoswitch - Toggles whether the NPC automatically switches items.
* /sentinel targettime TIME - Sets the NPCs enemy target time limit.
* /sentinel greeting GREETING - Sets a greeting message for the NPC to say.
* /sentinel warning WARNING - Sets a warning message for the NPC to say.
* /sentinel greetrange RANGE - Sets how far a player can be from an NPC before they are greeted.
* /sentinel accuracy OFFSET - Sets the accuracy of an NPC.
* Sentry user?
*
* Type "/sentinel sentryimport" on a server running both Sentry and Sentinel to instantly transfer all data to Sentinel!
===权限===

* sentinel.basic for the /sentinel command
* sentinel.admin to edit other player's Sentinel NPCs.
* sentinel.greet for commands: greeting, warning, greetrange
* sentinel.info for commands: info, stats, targets
* Everything else is "sentinel.X" where "X" is the command name, EG "sentinel.damage".
===攻击目标的类型列表===

* 主要:
* NPCS,其他NPC
* OWNER,拥有者
* PASSIVE_MOB,被动怪物
* MOBS,主动怪物
* MONSTERS,怪物
* PLAYERS,玩家
* PIGS,猪
* OCELOTS,猫
* COWS,牛
* RABBITS,兔
* SHEEP,羊
* CHICKENS,鸡
* HORSES,马
* MUSHROOM_COW,蘑菇牛
* IRON_GOLEMS,铁傀儡
* SQUIDS,鱿鱼
* VILLAGER,村民
* WOLF,狼
* SNOWMEN,雪人
* WITCH,女巫
* GUARDIANS,守护者
* SHULKERS,潜影贝
* CREERERS,苦力怕
* SKELETONS,骷髅
* ZOMBIES,僵尸
* MAGMA_CUBES,岩浆怪
* ZOMBIE_PIGMEN,僵尸猪人
* SILVERFISH,蠹虫
* BATS,蝙蝠
* BLAZES,烈焰人
* GHASTS,恶魂
* GIANTS,巨人
* SLIME,史莱姆
* SPIDER,蜘蛛
* CAVE_SPIDERS,洞穴蜘蛛
* ENDERMEN,末影人
* ENDERMITES,末影螨
* WITHER,凋灵
* ENDERDRAGON,末影龙
*
* player:NAME(REGEX),某个玩家
* npc:NAME(REGEX),某个NPC
* entityname:NAME(REGEX),某个实体
* helditem:MATERIALNAME(REGEX),手持某个物品的实体
* group:GROUPNAME(EXACT),某个组
* event:pvp/pvnpc/pve,某个事件状态
* Some random supported things,随机支持一些事情

===可以使用的武器类型===

* Fists
* Swords/tools
* Bow
* 可以为NPC设置各种类型的箭！
* Blaze rod (shoots fire balls!)
* Potions (splash, lingering)
* Nether star (strikes lightning!)
* Spectral arrow (makes the target glow, without damaging it.)
* (To make a target glow ++ damage it, equip a bow + arm it with spectral arrows!)
* Snowballs
* Respawning can be set to "-1" to cause the NPC to delete itself on death, or "0" to prevent respawn.
* Sentinels will guard a point or path if either is set using the command "/npc path"
* To make a ghast or blaze fire fireballs, give them a blazerod!

Sentinel

2016-11-18T03:25:34Z

Lzs：/* 使用教程 */

{{Bukkit Plugin Infobox
|版本=0.6
|兼容服务端版本=Spigot 1.10
|網址=[http://ci.citizensnpcs.co/job/Sentinel 下载地址] [https://www.spigotmc.org/resources/sentinel.22017/ 下载地址(Spigot)] [http://dev.bukkit.org/bukkit-plugins/sentinel/ 下载地址(Bukkit)]
}}
[[Category:信息]][[Category:角色]][[Category:综合]][[Category:其他]][[Category:娱乐]]
 
<pre>
[信息|角色|综合|其他|娱乐]Sentry—— 强大神奇的自定义NPC扩展! [内附教程][全版本]
http://www.mcbbs.net/forum.php?mod=viewthread&tid=488928
看了这个这个帖子，你应该能大体明白这个插件的作用
本地化介绍
Sentry最新版: 支持 Spigot 1.10
</pre>
 
===注意事项===
* 如果你的NPC没有近战伤害,请您把配置文件config.yml里的workaround damage 改为true

===使用教程===
* 下载:Citizens与Sentinel并放入plugins文件夹
* 重启服务器

* 首先创建一个NPC
* 使用/npc sel 命令选择NPC，或使用/npc create name 命令新建NPC
* 接着输入/trait Sentinel，设置NPC为哨兵
* 再输入/npc equip 设置NPC装备
* 手持要给NPC装备的护甲或武器，对着NPC右键。
* 输入/sentinel addtarget MONSTERS，给哨兵添加攻击目标的类型。
* 输入/sentinel help 显示帮助界面

* 注意：在没有开无敌的模式下，不要给哨兵添加攻击玩家的命令！

===游戏命令===

* /sentinel help - Shows help info.
* /sentinel addtarget TYPE - Adds a target.
* /sentinel removetarget TYPE - Removes a target.
* /sentinel addignore TYPE - Ignores a target.
* /sentinel removeignore TYPE - Allows targetting a target.
* /sentinel range RANGE - Sets the NPC's maximum attack range.
* /sentinel damage DAMAGE - Sets the NPC's attack damage.
* /sentinel armor ARMOR - Sets the NPC's armor level.
* /sentinel health HEALTH - Sets the NPC's health level.
* /sentinel attackrate RATE - Changes the rate at which the NPC attacks, in ticks.
* /sentinel healrate RATE - Changes the rate at which the NPC heals, in ticks.
* /sentinel respawntime TIME - Changes the time it takes for the NPC to respawn, in ticks.
* /sentinel chaserange RANGE - Changes the maximum distance an NPC will run before returning to base.
* /sentinel guard (PLAYERNAME) - Makes the NPC guard a specific player. Don't specify a player to stop guarding.
* /sentinel invincible - Toggles whether the NPC is invincible.
* /sentinel fightback - Toggles whether the NPC will fight back.
* /sentinel needammo - Toggles whether the NPC will need ammo.
* /sentinel safeshot - Toggles whether the NPC will avoid damaging non-targets.
* /sentinel chaseclose - Toggles whether the NPC will chase while in 'close quarters' fights.
* /sentinel chaseranged - Toggles whether the NPC will chase while in ranged fights.
* /sentinel drops - Changes the drops of the current NPC.
* /sentinel spawnpoint - Changes the NPC's spawn point to its current location, or removes it if it's already there.
* /sentinel forgive - Forgives all current targets.
* /sentinel enemydrops - Toggles whether enemy mobs of this NPC drop items.
* /sentinel info - Shows info on the current NPC.
* /sentinel stats - Shows statistics about the current NPC.
* /sentinel targets - Shows the targets of the current NPC.
* /sentinel kill - Kills the NPC.
* /sentinel respawn - Respawns the NPC.
* /sentinel targettime TIME - Sets the NPC's enemy target time limit.
* /sentinel speed - Sets the NPC's movement speed modifier.
* /sentinel autoswitch - Toggles whether the NPC automatically switches items.
* /sentinel targettime TIME - Sets the NPCs enemy target time limit.
* /sentinel greeting GREETING - Sets a greeting message for the NPC to say.
* /sentinel warning WARNING - Sets a warning message for the NPC to say.
* /sentinel greetrange RANGE - Sets how far a player can be from an NPC before they are greeted.
* /sentinel accuracy OFFSET - Sets the accuracy of an NPC.
* Sentry user?
*
* Type "/sentinel sentryimport" on a server running both Sentry and Sentinel to instantly transfer all data to Sentinel!
===权限===

* sentinel.basic for the /sentinel command
* sentinel.admin to edit other player's Sentinel NPCs.
* sentinel.greet for commands: greeting, warning, greetrange
* sentinel.info for commands: info, stats, targets
* Everything else is "sentinel.X" where "X" is the command name, EG "sentinel.damage".
===可以设置成为目标的类型===

* Primary set:
* NPCS, -殴打其他NPC
* OWNER,-殴打你！
* PASSIVE_MOB,
* MOBS,
* MONSTERS, -怪物
* PLAYERS, 殴打玩家
* PIGS, 殴打猪
* OCELOTS, 殴打猫
* COWS, 殴打牛
* RABBITS, 殴打兔子-残忍啊
* SHEEP, 殴打羊-为啥啊
* CHICKENS, 殴打鸡-有必要吗
* HORSES, 殴打马-几个意思啊·马也打
* MUSHROOM_COW, 殴打蘑菇牛-哨兵真能碰到这个么。。
* IRON_GOLEMS, 殴打铁傀儡 -这是要进攻村庄吗
* SQUIDS, -殴打鱿鱼
* VILLAGER, 殴打村民-犯法你知道吗
* WOLF, 殴打狼
* SNOWMEN, 殴打雪人
* WITCH, 殴打女巫
* GUARDIANS, 殴打守护者-新版生物
* SHULKERS,
* CREERERS,
* SKELETONS,
* ZOMBIES,
* MAGMA_CUBES,
* ZOMBIE_PIGMEN,
* SILVERFISH, BATS,
* BLAZES,
* GHASTS,
* GIANTS,
* SLIME,
* SPIDER,
* CAVE_SPIDERS,
* ENDERMEN,
* ENDERMITES,
* WITHER,
* ENDERDRAGON
*
* 还有
* player:NAME(REGEX), --玩家名
* npc:NAME(REGEX), -NPC名字
* entityname:NAME(REGEX),
* helditem:MATERIALNAME(REGEX),
* group:GROUPNAME(EXACT),
* event:pvp/pvnpc/pve
* Some random supported things

===可以使用的武器类型===

* Fists
* Swords/tools
* Bow
* 可以为NPC设置各种类型的箭！
* Blaze rod (shoots fire balls!)
* Potions (splash, lingering)
* Nether star (strikes lightning!)
* Spectral arrow (makes the target glow, without damaging it.)
* (To make a target glow ++ damage it, equip a bow + arm it with spectral arrows!)
* Snowballs
* Respawning can be set to "-1" to cause the NPC to delete itself on death, or "0" to prevent respawn.
* Sentinels will guard a point or path if either is set using the command "/npc path"
* To make a ghast or blaze fire fireballs, give them a blazerod!

Sentinel

2016-11-18T03:10:36Z

Lzs：/* 注意事项 */

{{Bukkit Plugin Infobox
|版本=0.6
|兼容服务端版本=Spigot 1.10
|網址=[http://ci.citizensnpcs.co/job/Sentinel 下载地址] [https://www.spigotmc.org/resources/sentinel.22017/ 下载地址(Spigot)] [http://dev.bukkit.org/bukkit-plugins/sentinel/ 下载地址(Bukkit)]
}}
[[Category:信息]][[Category:角色]][[Category:综合]][[Category:其他]][[Category:娱乐]]
 
<pre>
[信息|角色|综合|其他|娱乐]Sentry—— 强大神奇的自定义NPC扩展! [内附教程][全版本]
http://www.mcbbs.net/forum.php?mod=viewthread&tid=488928
看了这个这个帖子，你应该能大体明白这个插件的作用
本地化介绍
Sentry最新版: 支持 Spigot 1.10
</pre>
 
===注意事项===
* 如果你的NPC没有近战伤害,请您把配置文件config.yml里的workaround damage 改为true

===使用教程===
*首先，让我怀着激动的心，颤抖的手，来介绍下如何使用这个插件吧！
* 安装
* 下载:Citizens 插件
* 上面已经给出了地址
* 然后下载本插件
* 把Citizens 和本插件，一起放进服务端插件文件夹里(叫什么我不用告诉你了吧，都玩NPC这么高端的东西了，这位腐竹，你应该懂的)
* 为了保险起见，请关闭你的服务器重启吧! 来死狗，跟我走吧！向快乐出发
* 首先，你得创建一个NPC，这个我们略过(你可以去看我帖子上留的那个帖子里的介绍-PS 这话感觉有点像顺口溜)
* 选择你要成为哨兵的NPC (选择输入/npc sel 或者新建立一个输入 /npc create Bob)
* 接着请输入: /trait Sentinel
* 接着再请输入 /npc equip
* 为啥要输入/npc equip 呢。这是为了给你的哨兵穿装备！
* 大哥，你东北的啊！哎呀，你咋知道的呢! 你瞅啥！)
* 手里拿着你要给NPC装备的护甲和武器！！看好了，是手持！然后对着NPC右键！.
* ---（看，你能分清哪个是NPC，哪个是我不！{:695:}围观群众:当然分得清拉,穷吊哪来的皮肤-哎呀少年，你很机智,今天保护费交了么--）
*
*
* 我们接着说！
* {:cb_side:}然后输入 /sentinel addtarget MONSTERS
* 这么做的目的是干啥呢？听好了！这么做的目的是给哨兵添加目标，
* 后面的MONSTERS 是类型！你也可以输入成玩家，那你小心了！连你一起切了！{:diamond_sword:}
* 来，让我们召唤一只[zombie]，我们的哨兵是否会干它呢！这里我们卖个关子!(吊人胃口- 吊人？这句成语是这么说的么，我用的搜狗没错吧！)
* 接着我们再输入: /sentinel help
* 输入后会出现一大波英文!你如果看不懂，还是看我的帖子吧！
* 看了这个你看起来简短，但是打字并不简短的教程！
* 你应该能够自由的玩转这个哨兵了！
* 但是，然后我得提醒你以下！在没有开无敌的模式下！不要给哨兵添加攻击玩家的命令！
* 否则后果自负！
* 一个自由玩转的栗子:
* 我在我服里创建了一个剧情，作为主角的你要去城堡里见美丽的公主！
* 作为公主当然有守卫，而作为主角的你整天手持无敌神剑晃荡,
* 那么这一点不符合宫廷礼仪！然后当你手持无敌贱在哨兵面前走过时，哨兵会认为你是剑人，于是就会来攻击你！
* 曾么做到的！你只需要输入！ /sentinel addtarget helditem:.*sword
===游戏命令===

* /sentinel help - Shows help info.
* /sentinel addtarget TYPE - Adds a target.
* /sentinel removetarget TYPE - Removes a target.
* /sentinel addignore TYPE - Ignores a target.
* /sentinel removeignore TYPE - Allows targetting a target.
* /sentinel range RANGE - Sets the NPC's maximum attack range.
* /sentinel damage DAMAGE - Sets the NPC's attack damage.
* /sentinel armor ARMOR - Sets the NPC's armor level.
* /sentinel health HEALTH - Sets the NPC's health level.
* /sentinel attackrate RATE - Changes the rate at which the NPC attacks, in ticks.
* /sentinel healrate RATE - Changes the rate at which the NPC heals, in ticks.
* /sentinel respawntime TIME - Changes the time it takes for the NPC to respawn, in ticks.
* /sentinel chaserange RANGE - Changes the maximum distance an NPC will run before returning to base.
* /sentinel guard (PLAYERNAME) - Makes the NPC guard a specific player. Don't specify a player to stop guarding.
* /sentinel invincible - Toggles whether the NPC is invincible.
* /sentinel fightback - Toggles whether the NPC will fight back.
* /sentinel needammo - Toggles whether the NPC will need ammo.
* /sentinel safeshot - Toggles whether the NPC will avoid damaging non-targets.
* /sentinel chaseclose - Toggles whether the NPC will chase while in 'close quarters' fights.
* /sentinel chaseranged - Toggles whether the NPC will chase while in ranged fights.
* /sentinel drops - Changes the drops of the current NPC.
* /sentinel spawnpoint - Changes the NPC's spawn point to its current location, or removes it if it's already there.
* /sentinel forgive - Forgives all current targets.
* /sentinel enemydrops - Toggles whether enemy mobs of this NPC drop items.
* /sentinel info - Shows info on the current NPC.
* /sentinel stats - Shows statistics about the current NPC.
* /sentinel targets - Shows the targets of the current NPC.
* /sentinel kill - Kills the NPC.
* /sentinel respawn - Respawns the NPC.
* /sentinel targettime TIME - Sets the NPC's enemy target time limit.
* /sentinel speed - Sets the NPC's movement speed modifier.
* /sentinel autoswitch - Toggles whether the NPC automatically switches items.
* /sentinel targettime TIME - Sets the NPCs enemy target time limit.
* /sentinel greeting GREETING - Sets a greeting message for the NPC to say.
* /sentinel warning WARNING - Sets a warning message for the NPC to say.
* /sentinel greetrange RANGE - Sets how far a player can be from an NPC before they are greeted.
* /sentinel accuracy OFFSET - Sets the accuracy of an NPC.
* Sentry user?
*
* Type "/sentinel sentryimport" on a server running both Sentry and Sentinel to instantly transfer all data to Sentinel!
===权限===

* sentinel.basic for the /sentinel command
* sentinel.admin to edit other player's Sentinel NPCs.
* sentinel.greet for commands: greeting, warning, greetrange
* sentinel.info for commands: info, stats, targets
* Everything else is "sentinel.X" where "X" is the command name, EG "sentinel.damage".
===可以设置成为目标的类型===

* Primary set:
* NPCS, -殴打其他NPC
* OWNER,-殴打你！
* PASSIVE_MOB,
* MOBS,
* MONSTERS, -怪物
* PLAYERS, 殴打玩家
* PIGS, 殴打猪
* OCELOTS, 殴打猫
* COWS, 殴打牛
* RABBITS, 殴打兔子-残忍啊
* SHEEP, 殴打羊-为啥啊
* CHICKENS, 殴打鸡-有必要吗
* HORSES, 殴打马-几个意思啊·马也打
* MUSHROOM_COW, 殴打蘑菇牛-哨兵真能碰到这个么。。
* IRON_GOLEMS, 殴打铁傀儡 -这是要进攻村庄吗
* SQUIDS, -殴打鱿鱼
* VILLAGER, 殴打村民-犯法你知道吗
* WOLF, 殴打狼
* SNOWMEN, 殴打雪人
* WITCH, 殴打女巫
* GUARDIANS, 殴打守护者-新版生物
* SHULKERS,
* CREERERS,
* SKELETONS,
* ZOMBIES,
* MAGMA_CUBES,
* ZOMBIE_PIGMEN,
* SILVERFISH, BATS,
* BLAZES,
* GHASTS,
* GIANTS,
* SLIME,
* SPIDER,
* CAVE_SPIDERS,
* ENDERMEN,
* ENDERMITES,
* WITHER,
* ENDERDRAGON
*
* 还有
* player:NAME(REGEX), --玩家名
* npc:NAME(REGEX), -NPC名字
* entityname:NAME(REGEX),
* helditem:MATERIALNAME(REGEX),
* group:GROUPNAME(EXACT),
* event:pvp/pvnpc/pve
* Some random supported things

===可以使用的武器类型===

* Fists
* Swords/tools
* Bow
* 可以为NPC设置各种类型的箭！
* Blaze rod (shoots fire balls!)
* Potions (splash, lingering)
* Nether star (strikes lightning!)
* Spectral arrow (makes the target glow, without damaging it.)
* (To make a target glow ++ damage it, equip a bow + arm it with spectral arrows!)
* Snowballs
* Respawning can be set to "-1" to cause the NPC to delete itself on death, or "0" to prevent respawn.
* Sentinels will guard a point or path if either is set using the command "/npc path"
* To make a ghast or blaze fire fireballs, give them a blazerod!

PlayerPoints

2016-11-18T03:06:45Z

Lzs：/* 特点 */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.4
|前置插件=-
|兼容服务端版本=1.9
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以给予玩家点券。
:*可以扣除玩家点券。
:*向玩家支付点券。
:*查看其他玩家点券数量
:*查看自己点券数量
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])

=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: 是否使用Votifier监听器(默认: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)

=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== 概述 ===
新的API允许开发人员对是否交易得到反馈.而你仍然可以使用旧的方法调用
控制台命令,这些方法可以让你完成同样的事情,而不必通过控制台.
在你的plugin.yml中,确保PlayerPoints添加依赖关系.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
该API中的所有方法都有JavaDoc.以下是引用的副本.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.

== Event ==
每当玩家点券数量被修改PlayerPoints将发出事件.
事件可以进行修改与取消.
=== 玩家点券更改事件 ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
当玩家的点会被改变。得到目标玩家的名称和数量,它将会改变。

=== 玩家点券重置事件 ===
Called when the player's points will be reset.
当玩家的点数将被重新设置。

== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-11-18T03:06:34Z

Lzs：/* 特点 */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.4
|前置插件=-
|兼容服务端版本=1.9
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以给予玩家点券。
:*可以扣除玩家点券。
:*向玩家支付点券。
:*查看其他玩家点券数量
:*查看自己有多少点券数量
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])

=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: 是否使用Votifier监听器(默认: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)

=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== 概述 ===
新的API允许开发人员对是否交易得到反馈.而你仍然可以使用旧的方法调用
控制台命令,这些方法可以让你完成同样的事情,而不必通过控制台.
在你的plugin.yml中,确保PlayerPoints添加依赖关系.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
该API中的所有方法都有JavaDoc.以下是引用的副本.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.

== Event ==
每当玩家点券数量被修改PlayerPoints将发出事件.
事件可以进行修改与取消.
=== 玩家点券更改事件 ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
当玩家的点会被改变。得到目标玩家的名称和数量,它将会改变。

=== 玩家点券重置事件 ===
Called when the player's points will be reset.
当玩家的点数将被重新设置。

== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

AutoMessage

2016-11-18T03:01:15Z

Lzs：/* 配置 */

{{Plugin
|version=v2.5.5
|URL=http://dev.bukkit.org/bukkit-plugins/AutoMessage/
}}
[[Category:聊天]]
[[Category:信息]]
==综述==
===介绍===
AutoMessage是一个易于使用的聊天栏公告插件。
这个插件非常适合那些想要将一些设定的信息以广播形式重复发布的服务器管理员们。
这个插件的特性在于，你可以在游戏中使用命令编辑一切配置。
这是一个轻量级的插件，并不会影响服务器的性能。
AutoMessages会自动检测更新以确保插件处于最新版本。

===特性===
完全可自定义的配置系统!
游戏中功能多样的配置编辑器!
快速无损的重载机制.
可选的随机公告.
支持颜色代码.
在信息中运行命令.

===安装===
将jar文件拖入plugins文件夹并重启服务端即可.

==常见问题及解答==
Q:为什么我使用"/am add 公告"添加了一个叫"公告"的组后，显示的信息十分杂乱？

A:新的分组后会内置一些默认的公告内容，只需连续执行命令"/am remove 公告 0"删除公告组内序号为0的公告内容连续5次即可删除默认信息。

Q：为什么玩家看不见公告？

A：你需要把权限节点：automessage.receive.default添加进玩家组里面，default为默认组，详细请看下面的权限一栏。

==权限==
AutoMessage 使用权限来允许用户和组来执行特定的指令。你可以使用例如PermissionsEx or bPermissions等权限管理插件来管理这些权限。在下方你将会找到个列表来查看权限。

automessage.commands.reload:

重新载入配置文件的权限

automessage.commands.update:

当插件不是最新版本时，升级插件的权限。

automessage.commands.add:

创建一个公告列表，或者添加消息到现有的公告列表。

automessage.commands.edit:

编辑一条现有的公告

automessage.commands.remove:

删除一个公告列表，或者从一个现有的公告列表中删除一条公告

automessage.commands.enabled:

切换到一个指定的公告列表，这个公告列表会始终可以编辑，但是在这段期间，这个列表内的公告将不会被播出。

automessage.commands.interval:

设置公告列表内的时间间隔

automessage.commands.random:

设置一个列表的播出顺序，例如:随机播放

automessage.commands.prefix:

设置公告的前缀

automessage.commands.suffix:

设置公告的后缀

automessage.commands.broadcast:

从一个特定的列表中广播一条消息

automessage.commands.list:

列出所有的公告列表或列出指定一个公告列表的所有公告；查看所有公告

automessage.receive.message-list:

Receive broadcasts from a list. Replace message-list with the name of the message list in your config. ；接收来自某列表的公告

==命令==
==配置==
Config:
settings:
enabled: true ；是否启用 true为是，false为否
min-players: 5 ；最小听见广播的玩家数量？我的理解应该是当有这个数值的玩家或以上在线时才开始播放这个公告
log-to-console: true ；是否显示在控制台
message-lists: ；公告列表
regular: ；公告列表的名字
enabled: true ；是否启用
random: false ；是否随机
interval: 45 ；间隔时间
expiry: -1 ；到期时间(-1为不会到期
messages: ；公告内容
- '&1First&r message \nin the default list!'
- '&2Second&r message \nin the default list!'
- '&3Third&r message \nin the default list!'
- 'These messages will be displayed to users with \nautomessage.receive.default!'
json: ；又是一个公告列表的名字下面的内容和上面的一样
enabled: true
random: false
interval: 45
expiry: -1
messages:
- '{text:"Hover over me!",hoverEvent:{action:show_text,value:[{text:"Woah, you just hovered over me!",color:blue}]}}'
- '{text:"Click me to run a command!",clickEvent:{action:run_command,value:"/say Clicked."}}'
- '{text:"Click me to open Google!",clickEvent:{action:open_url,value:"http://google.com"}}'

==其他==
'''代码:''' 
配设文件内可以添加变量，颜色以及指令等. 如果你的信息前面加入 / 系统会默认为是一条指令. 如果你编辑时想换行请输入 \n. 颜色代码可以随时加入. 同时也可以添加变量. 这些设定会美化你的信息/公告。 
 

'''变量列表'''
{| class="wikitable"
|-
! 变量 !! 列子 !! 效果
|-
| {NAME} || Hey {NAME} || Hey ELCHILEN0!
ELCHILEN0是原作者ID
|-
| {DISPLAYNAME} || Hey {DISPLAYNAME}! || Hey ELCHILEN0!
|-
| {WORLD} || 你在{WORLD}! || 你在XX世界!
|-
| {BIOME} || 你在{BIOME}生物群系! || 你在XX生物群系!
|-
| {ONLINE} || 目前有{ONLINE}玩家在线! || 目前有XX玩家在线!
|-
| {MAX_ONLINE} || 服务器最大人数{MAX_ONLINE}! || 服务器最大人数XX!
|-
| {YEAR} || 今年是{YEAR}年! || 今年是XX年!
|-
| {MONTH} || 现在是{MONTH}月! || 现在是XX月!
|-
| {WEEK_OF_MONTH} || 本月第{WEEK_OF_MONTH}个星期! || 本月第XX个星期!
|-
| {WEEK_OF_YEAR} || 今年第{WEEK_OF_YEAR}个星期! || 今年第XX个星期!
|-
| {DAY_OF_WEEK} || 这个星期已经过了{DAY_OF_WEEK}天! || 这个星期已经过了XX天!
|-
| {DAY_OF_MONTH} || 这个月已经过了{DAY_OF_MONTH}天! || 这个月已经过了XX天!
|-
| {DAY_OF_YEAR} || 今年已经过了{DAY_OF_MONTH}天! || 今年已经过了XX天!
|-
| {HOUR} || 现在是{HOUR}点 || 现在是XX点
|-
| {HOUR_OF_DAY} || It is {HOUR_OF_DAY} hundred hours! || It is XX hundred hours!
|-
| {MINUTE} || 已经过了{MINUTE}分钟! || 已经过了XX分钟!
|-
| {SECOND} || 已经过了{MINUTE}秒! || 已经过了XX秒!
|-
|}
 
'''颜色代码''' 

==GitHub Repo==
==Scheduled Messages Ideas==

EasyKits

2016-11-18T02:51:37Z

Lzs：/* 功能特色 */

[[Category:管理]]
[[Category:娱乐]]
{{Bukkit Plugin Infobox
|插件名=EasyKits
|版本=v2.0.4
|前置插件=Vault
|兼容服务端版本=1.6.x-1.8.x
}}
==EasyKits==
'''版本: v2.0.4'''
===简介===
这是一个可以快速编辑礼包的插件。
====功能特色====
*轻松创建和删除礼包
*第一次加入游戏自动获得礼包
*在游戏中查看礼包和物品的清单.
*需要经济插件[Vault]支持
*支持指示牌
*兼容1.8.x-1.9.x
*有GUI列表
*支持各种物品

====安装====
1.将EasyKits.jar移动到插件根目录

2.运行服务器

3.编辑config.yml文件[你喜欢的话]

4.输入/kit reload

5.享受游戏吧!

===使用===
1.8 指令
http://dev.bukkit.org/bukkit-plugins/easykits/pages/easy-kits-pre-1-8-instructions/

创建一个礼包, 简单的从你背包里收入礼包的物品.
/kit create [礼包名字]

设置一个礼包运行如下:
/kit price [礼包名字] [价格]

设置礼包领取时间的间隔:
例如：1s/1m/1h/1d
/kit cooldown [礼包名字] [时间]

设置礼包每个玩家最高领取次数:
/kit limit [礼包名称] [次数]

给所有有权限的人一本书，查看可领取的礼包:
/kit book

重置玩家的领取冷却时间和玩家的最大领取次数:
/kit reset cooldown [礼包名字] [玩家]
/kit reset limit [礼包名字] [玩家]

====笔记====
你可以使用这个命令显示礼包列表:

/kit list

展示一个礼包:

/kit view [礼包名字]

领取一个礼包:

/kit [礼包名字]

运行以下得到帮助的命令:

/kit

-or-

/kit help

运行下面的指令可以获得一个特定的命令信息:

/kit help [命令]

====牌子====
创建一个牌子第一行写[kit]然后下一行写礼包名字[这里用kitname代替]
http://i.imgur.com/wUunLhM.png

假如你做了正确的话牌子会是这样的:
http://i.imgur.com/iYL4Hgt.png

右击使用牌子.

===权限===
EasyKits.* - 完全权限.

EasyKits.cmd.* - 使用指令的完全权限(和上一个没什么区别).

EasyKits.kits.* - 可领取所有礼包.

EasyKits.kits.[kitname] - 可领取指定的礼包.

EasyKits.cmd.reload - 可以使用指令 /kit reload

EasyKits.cmd.create - 可以使用指令 /kit create

EasyKits.cmd.remove - 可以使用指令 /kit remove

EasyKits.cmd.cooldown - 可以使用指令 /kit cooldown

EasyKits.cmd.limit - 可以使用指令 /kit limit

EasyKits.cmd.price - 可以使用指令 /kit price

EasyKits.cmd.give - 可以使用指令 /kit give

EasyKits.cmd.list - 可以使用指令 /kit list

EasyKits.cmd.view - 可以使用指令 /kit view

EasyKits.cmd.help - 可以使用指令 /kit reset

EasyKits.cmd.reset - 可以使用指令 /kit reset

EasyKits.bypass.cooldown - 给这权限之后才会受到冷却时间的限制[1.8版本不给才会受到限制]

EasyKits.bypass.limit - 给这权限之后才会受到最大领取次数的限制[1.8版本不给才会受到限制]

EasyKits.bypass.price - 可以设置礼包的价格.

EasyKits.sign.create - 可以创建一个礼包牌子

EasyKits.sign.remove - 可以移除一个礼包牌子

EasyKits.sign.use - 可以使用一个礼包牌子

===命令===
/kit create [礼包名称]

/kit remove [礼包名称]

/kit cooldown [礼包名称] [冷却时间]

/kit limit [礼包名称] [最大领取次数]

/kit price [礼包名称] [价格]

/kit book

/kit list

/kit view [礼包名称]

/kit reset [冷却时间/最大领取次数] [礼包名称] [玩家]

/kit [礼包名称]

/kit give [礼包名称] [玩家]

/kit help

/kit reload

===下载===
详见:
http://dev.bukkit.org/bukkit-plugins/easykits/files/
====关于汉化版====
{{Hide|标题=看不见窝|内容=这是我的汉化版[版本v1.4.7]适合1.7.x[http://pan.baidu.com/s/1bnlZO1T 提取密码txy5]--Men_yu 2015年9月29日 (二) 21:03 (HKT)}}

===漏洞[BUG]===
所有的错误都被报道在GitHub上的项目页面
你可以点击[https://github.com/trentech/EasyKits/issues 这里查看]

Dynmap

2016-11-18T02:51:03Z

Lzs：

{{Bukkit Plugin Infobox
|版本=v1.5.5.7
|前置插件=[[Vault]]
|兼容服务端版本=全版本
|原帖=https://dev.bukkit.org/bukkit-plugins/dynmap/
}}

{{待翻译}}{{待完善}}
来源：[https://github.com/webbukkit/dynmap/wiki/ wiki], [https://dev.bukkit.org/bukkit-plugins/dynmap/ bukkit]

[[Category:管理]] [[Category:网页]] [[Category:信息]]

=简介=

Dynmap是一个可以用网页浏览的、像谷歌地图一样的动态地图插件。Dynmap的网页结构是建立在整个MineCraft游戏之外的，非常实用和易用，Dynmap也可应用于基于Apache类软件的网页。 
Dynmap可以用不同的渲染图层渲染你的服务器世界地图, 有些适合于展示, 有些有着更多的地图细节。

这个插件的原始项目是由 k-zed.开发给 hMod 的。

插件的部件可供你按照自己的需要添加/删除功能，使用Dnymap支持的部件,包括聊天泡泡, 网页-游戏聊天, 和可配置的标记, 标签, 下换线。

[[文件:Dynmap.png]]

==功能==
* 每个游戏世界深度可设置的地图
* 实时更新：地图总是和服务器世界实时同步，当你打开着你的网页时更新一直会显示
* 玩家和他们的头像在地图上可见
* 地图上的聊天信息可见 (显示在聊天泡泡或者聊天框里)
* 地图浏览者能和游戏内的玩家聊天
* 实时Minecraft时间在地图上可见
* 实时Minecraft季节在地图上可见
* WorldGuard, Residence, Towny 和 Factions regions 插件都能在地图上可见 (需要相应版本的 Dynmap-* 补丁)

总的来说高度可配置和可定制化

==安装==

复制dynmap-*.jar 进你的补丁文件夹. 如果用于更新, 删除之前安装的 dynmap-*.jar - 你不需要删除任何补丁/地图文件夹或者它的文件。

如果你正在运行一个独立网页服务器 (比如 Apache) 你可能需要先复制文件'plugins/dynmap/web/' 到你的http-root的一个文件夹，里然后再执行此教程。升级时，请确保你也升级了被复制的文件。

==首次使用==

当你开启 CraftBukkit 时, 你应该可以在浏览器里跳转到 http://yourserverip:8123/（http://你服务器的IP:8123/）。如果你是用你现在正在使用的PC来运行 CraftBukkit, 你可以跳转到 http://localhost:8123/。 
你应该能够看到在游戏内的玩家。需要注意的是此时地图还未被渲染, 所以背景应该是黑色的。 

如果你计划使用高清渲染, 现在你就可以着手做这件事了。开启configuration.txt顶端的 'deftemplatesuffix: hires' 。更多关于deftemplatesuffix的信息可在基础补丁设置查看。 

如果你只是想让Dynmap有效, 在游戏里使用这个命令 /dynmap fullrender。 wiki上有更多关于命令和权限的内容。 
地图此时应该会显露出来，给它一些时间。程序信息之后会显示 Dynmap 正在工作 (Dynmap is working) 和渲染已完成（render is completed)。

==相关==

[http://forums.bukkit.org/threads/misc-dynmap-v0-12-1-realtime-minecraft-maps-314.489/ Bukkit论坛 (已失效）]
[http://dev.bukkit.org/server-mods/dynmap/ Bukkit项目页面]
IRC: irc://irc.esper.net/#dynmap (via web)

=如何使用=

==在无内部网页服务器环境使用==

本页适用于

*你对你正在使用的独立网页服务器有着有丰富的经验
*你的CraftBukkit和独立网页服务器运行在同一个机器上
*你的网页服务器支持PHP（用于网页-Minecraft 聊天）
*如果是基于Linux环境，你应该知道如何使用terminal（终端）和chmod（命令）。

以下代码

- class: org.dynmap.InternalClientUpdateComponent
sendhealth: true
allowwebchat: true
webchat-interval: 5
#- class: org.dynmap.JsonFileClientUpdateComponent
# writeinterval: 1
# sendhealth: true
# allowwebchat: false

改变为:

#- class: org.dynmap.InternalClientUpdateComponent
# sendhealth: true
# allowwebchat: true
# webchat-interval: 5
- class: org.dynmap.JsonFileClientUpdateComponent
writeinterval: 1
sendhealth: true
allowwebchat: false

用于取消内部（internal）更新机制，开启json-file更新机制。
这样做会将其写入你的网页路径文件standalone/dynmap_world.json，并指定向writeinterval。 
(?)(This will write to the file standalone/dynmap_world.json in your web-path at an interval that is specified with writeinterval.)

复制你的文件进网页服务器中的plugins/dynmap/web。更改configuration.txt让其指向到你*nix放置网页文件的地方，同时包括tilespath及webpath。

tile-files放在路径
.tilespath: /path/to/web/server/dynmap/web/tiles

webpath放在路径
.webpath: /path/to/web/server/dynmap/web

或者，在Windows环境下

tile-files放在路径
c:\\path\\to\\web\\server\\dynmap\\web\\tiles

webpath放在路径
c:\\path\\to\\web\\server\\dynmap\\web

现在重启你的Minecraft服务器，加入你的Minecraft服务器随机放置一些方块以触发dynmap的tiles。你也可以在后台输入dynmap全渲染（fullrender）世界名来用新的世界名渲染世界。

现在重启你的浏览器，在http://mywebserver/dynmap/上会显示你的在线玩家并保持更新。

=== 故障处理 ===
 

如果你没有看到任何tiles(地块）显示在地图上，检查tiles（地块）目录，看看他们有没有真正的启动。如果里面没有tiles（地块），可能是Minecraft没有权限将tiles（地块）写入你选择的web-path地址。另一个可能是你的tilespath没有填写正确。

如果你没有看到任何玩家或者没有看到玩家在移动，前往 http://mywebserver/standalone/dynmap_world.json (把 world 替换为你的世界的名字)。每隔几秒，你应该可以看到一些代码刷新，（比如服务器时间应该在一直更新），如果你没有看到这个文件，或者看看不到文件有任何刷新和改变，你可能在配置文件里填错了webpath的地址。

在Linux环境下，如果网页-Minecraft 聊天（web-to-mc-chat）不工作，你需要对775或者777独立文件进行chmod。

chmod -R 775 standalone

这样做可以允许sendmessage.php 创建 jsonfile. 这个步骤是必须的，因为是你的网页服务器创建的文件，而不是minecraft服务器创建文件。

如果网页-Minecraft 聊天（web-to-mc-chat）在IIS不工作, 你可能需要安装 php.

==在Linux环境使用==

阅读本页面的前提是:

* 你的Minecraft服务器放在: /opt/minecraft_server/ 。
* 你安装了最新的CraftBukkit。
* 你的Minecraft服务器开在在本地（localhost)。

安装与测试dynmap的步骤为:

*复制文件dynmap.jar和dynmap文件夹至/opt/minecraft_server/plugins/。
*（重）开启你的Minecraft服务器。
* 加入你的Minecraft服务器。
* 放置几个方块（译者注：即Blocks）。
* 打开你的浏览器。
* 前往http://localhost*:8123/。

在左上角你应该能看到你的地图和名字。点击了你的名字，地图会跳转到你的位置，就能看到一部分已启动的地图了。

===向公众开放===

如果你想让其他人也能使用地图，有两个方法可以实现：

* 用TCP端口8123指向一个外部端口到你的内部Minecraft服务器，更多关于端口映射的信息请前往： http://portforward.com/ 查看
* 将你的大型网页服务器作为部分地图的主机。特别需要注意的是，网页服务器必须已有权使用Minecraft服务器，详见以下指导。

===大型网页服务器===

如果你正使用Apache或者Lighttpd服务器作为主机，若想让Dynmap地址与你网页地址url一致（译者注：即关联网页url），如 http://www.yourwebsite.com/dynmap/ 而不是 http://www.yourwebsite.com:8123/。你可以使用以下列表的网站服务器地址

* 在Debian/Ubuntu系统的apache2环境下设置: 在Debian下用 Apache2 设定你的Dynamic Map
* 在Arch Linux系统的apache/httpd环境下设置: 在Arch Linux用apache/httpd 设定你的Dynamic Map
* 在Arch Linux系统的lighttpd环境下设置: 在Arch Linux用lighttpd 设定你的Dynamic Map
* 在Centos系统的Nginx环境下设置:nginx Setting-up-with-Nginx-server-on-Centos (LukeHandle的courtesy)

==在Windows环境使用==

本页面适用于:

*你的Minecraft服务器路径为D:\minecraft_server\。
*你安装了最新的CraftBukkit 。
*你的Minecraft服务器主机在本地。

安装和测试:

*从压缩文件中复制文件dynmap.jar 和dynmap的文件夹并粘贴至D:\minecraft_server\plugins\.
*启动或是重启你的Minecraft服务器。
*加入你的Minecraft服务器
*放置几个方块
*打开浏览器
*前往http://localhost:8123/。

在左上角你应该能看到你的地图和名字。点击了你的名字，地图会跳转到你的位置，就能看到一部分已启动的地图了。

===向公众开放===

如果你想让其他人也能使用地图，有两个方法可以实现：

用TCP端口8123指向一个外部端口到你的内部Minecraft服务器，更多关于端口映射的信息请前往： http://portforward.com/ 查看
将你的大型网页服务器作为部分地图的主机。特别需要注意的是，网页服务器必须已有权使用Minecraft服务器，详见以下指导。

大型网页服务器

如果你正使用IIS或者其他环境下的服务器作为主机，若想让Dynmap地址与你网页地址url一致（译者注：即关联网页url），如 http://www.yourwebsite.com/dynmap/ 而不是 http://www.yourwebsite.com:8123/。
你能在下面给出的列表中挑选你要用的网站服务器

*IIS: 在IIS环境下用 URL 设置Dynamic Map,rewrite and ApplicationRequestRouting (thanks to Kekec852!)
*IIS: 在IIS环境下用 URL 设置Dynamic Map

(这还算不上一个列表嘛?如果你有另一台服务器并知道如何去配置它，请将其添加至Wiki)

==在虚拟主机环境使用==

总的来说，在虚拟主机环境下无法使用， Dynmap提供的主机网页服务器标题文件需要文件系统权限.(相对于FTP或者SFTP基础的文件,它们的大多数主机传输服务是被允许的). 以下是一些链接到非官方创作者的地址,一些我们的用户成功将其用来作为特定的hosting解决方案.

Dynmap On Xenon Hosting Service, courtesy of mavbear

==插件设置==
在这里，我们将描述如何结构化你的配置，以及如何编辑配置。

配置文件存放于 plugins/dynmap/configuration.txt ，为YAML格式。它是一个被indentation定义的等级制结构。Indentation 在配置文件里不能包含任何的标签，只包含空格。it has a hierarchical structure that is defined using indentation. The indentation in the configuration may NOT contain any tabs, only spaces. 这也意味着你需要准确的将正确的空格数量填入配置行之前。This also means that you need to be sure to put the correct number of spaces in front of configuration-lines.

你可以参考这个地址的默认配置：https://github.com/webbukkit/dynmap/blob/recommended/src/main/resources/configuration.txt.

设置文件包括四个部分：组件（components）, 全局设置(global settings), 世界模板与世界（world-templates and worlds）。全局设置改变渲染和Dynmap网页服务器（交互）行为。易看出，这些部件是如何运行的。给出一个全局设置（global setting）的例子如下：

# tile得到渲染的频率（单位：秒）
renderinterval: 1 （渲染区间：1）
注意：版本为v0.20时，默认配置文件是被分开的，
Note: As of v0.20, the default configuration.txt file has been split, with the templates: section being moved to the templates/ directory and the worlds: section being moved to the worlds.txt file. Users are NOT required to change their existing configuration.txt - templates or worlds defined in configuration.txt are still processed, and templates found there supersede those of the same name from the templates/ directory. It is recommended the existing users, at their convenience, move their worlds: section (if they have one defined) from configuration.txt to worlds.txt, to prevent future impacts on that configuration due to future updates of configuration.txt. Likewise, it is suggested that existing users move their templates: section from configuration.txt to a new file, templates/custom-templates.txt.

===Components===

组件部分一般看起来是这样的:

components:
- class: org.dynmap.ClientConfigurationComponent

- class: org.dynmap.InternalClientUpdateComponent
sendhealth: true
allowwebchat: true
webchat-interval: 5
...
Each component can be thought of as an separate feature of Dynmap, which can be disabled and enabled individually. Some components depend on others, but we won't get into that. Each component starts in the configuration with a - class: ... followed by the properties of that component.

As an example we're going to disable the component that handles chat-balloons. This component looks like this:

...
- class: org.dynmap.ClientComponent
type: chatballoon
focuschatballoons: false
...
We can disable it by just deleting these lines, but a safer way is to comment them. For this example I've added the lines before and after the component to give a better impression:

...
- class: org.dynmap.ClientComponent
type: chat
#- class: org.dynmap.ClientComponent
# type: chatballoon
# focuschatballoons: false
- class: org.dynmap.ClientComponent
type: chatbox
showplayerfaces: true
messagettl: 5
...
Be sure to have still the correct number of spaces in front of the #. After saving the configuration, reloading Dynmap and refreshing the browser, chat balloons won't pop up anymore. The same method can be used to enable already disabled components.

For details on all components, and their settings, see Component Configuration.

===Worlds and templates===

In the configuration you'll also see a worlds section (since 0.20, this is found in the worlds.txt file; previously, it was found near the bottom of the configuration,txt file). This section can be left empty - Dynmap will automatically find all worlds defined for a server, and provide them with a default map configuration, based on using templates, as defined in the templates: section. Since 0.20, the templates definitions have been moved from configuration.txt into separate files found in the templates/ directory, but otherwise function as they have previously.

For a comprehensive description of all world settings, see World And Template Settings.

====Templates====

By default there are three templates: normal, nether and skylands. The template that is chosen for a certain world depends on the environment of the world - normal for normal worlds, nether for nether worlds, skylands for skyland worlds. As of 0.20, these definitions are found in files under the templates/ directory, with filenames corresponding to the template's name: templates/normal.txt, templates/nether.txt, and templates/skylands.txt, respectively.

In 0.20, the names of the templates chosen can be modified by using the deftemplatesuffix setting in configuration.txt. If defined, the name of the template used for a world with a given environment will have a hyphen followed by the value of the deftemplatesuffix setting added: so, setting deftemplatesuffix to hires causes the template normal-hires to be used for normal worlds, nether-hires to be used for nether worlds, and skylands-hires to be used for skylands worlds. This allows dynmap (and other users) to supply matched "sets" of templates, with a common suffix, that can be easily selected using the deftemplatesuffix setting. In 0.20, 3 sets of templates are provided:

the default (normal,nether,skylands)

lowres template set (normal-lowres, nether-lowres, skylands-lowres - which provide HD maps with the 'lowres' resolution - about 2x the default maps)

hires template set (normal-hires, nether-hires, skylands-hires - which provide HD surface maps with the 'hires' resolution - about 8x the default maps - and 'lowres' versions of the flat and cave maps)

In all cases, the template definition can be found in the file under the templates/ directory with the corresponding name, plus .txt (e.g. normal-hires is found in templates/normal-hires.txt).

====Worlds====

Next to the templates we also have a worlds section in the configuration. As of 0.20, the preferred location for this section is the worlds.txt file. Here we can specify options for each individual world. We'll describe the uses by examples.

Basically each world has a few default values. title is set to the name of the world, template is set to the environment of the world (with a hyphen and the value of the deftemplatesuffix appended, if deftemplatesuffix is defined in configuration.txt) and enabled is by default true (the meaning of these values are explained below). The template of the world can override these values, but the properties in the world-section can in turn override the values of the template.

If you have 3 worlds with the names world, nether and alternative, and you want to show them in a particular order, you can put the following in your configuration:

worlds:
- name: world
- name: alternative
- name: nether
So that they are ordered like world, alternative, nether.

To change the title of a certain world that is shown on the map, you can add a title property for that world:

worlds:
- name: world
title: "My Super Awesome World"
- name: alternative
- name: nether
Of course you can do this for all your worlds.

If you want to disable a certain world, for example the world alternative, you can do so by adding the property enable: false:

worlds:
- name: world
title: "My Super Awesome World"
- name: alternative
enabled: false
- name: nether
You can also use this property in your templates to (for example) disable all worlds of a certain environment.

If you want to change some of the properties for one specific world, you can do so specifying that property. This includes the maps: property, so you can specify the maps for a specific world:

- name: world
title: "My Super Awesome World"
center:
x: 100
y: 64
z: 0
maps:
- class: org.dynmap.flat.FlatMap
name: flat
title: "Flat"
prefix: flat
colorscheme: default
This will, for this particular world, set the center of the world to (100,64,0) and shows only flatmap in the sidebar.

Finally if you have multiple worlds that have the same configuration in common, you can add a template to the templates: section (or, better yet, as a custom template file under the templates/ directory) and specify for those worlds in particular the name of that template.

templates:
mycustomtemplate:
enabled: true
maps:
- class: org.dynmap.flat.FlatMap
name: flat
title: "Flat"
prefix: flat
colorscheme: ovocean
...
worlds:
- name: world
template: mycustomtemplate
- name: nether
template: mycustomtemplate
- name: alternative
Here world and nether both use the mycustomtemplate template, but alternative will still use the normal template (since alternative has an normal environment in this example).

As you can see above, for each FlatMap or KzedMap map, a certain colorscheme can be set. The colorschemes can be found in plugins/dynmap/colorschemes/, as seen here https://github.com/webbukkit/dynmap/tree/recommended/colorschemes. An overview of how these look like can be found here Color Schemes.

As of 0.20, a new type of map definition has been provided - the HDMap. This map type, besides supporting higher resolution map rendering and use of texture packs, also supports all existing FlatMap and KzedMap features, but with more flexibility (allowing customized direction of view, angle of view, scale, etc). For details on configuring HDMaps, see HD Map Configuration.

===基础补丁设置===

These settings are the top-level settings defined within the configuration.txt file. These settings, in general, cover the common behaviors of the plugin, independent of specific components, worlds, or maps. For component settings, see Component Configuration.

The core settings defined include the following:

*deftemplatesuffix : this optional setting, a string value, is used to modify the names of the templates associated with worlds. If undefined, normal worlds use the normal template, nether worlds use the nether template, and 'the end" worlds use the the_end template. When defined and non-blank, the name of the template used will be the default name, followed by and underscore, followed by the value of the deftemplatesuffix setting (e.g. if deftemplatesuffix is set to XXX, normal worlds will use the template normal_XXX instead of normal, nether worlds will use nether_XXX, ans 'the end' will use the_end_XXX). See HD Map Configuration for more details. Default template sets are included for vlowres, lowres, hires, and "" (blank).

*display-whitelist : if false (default), users are assumed to be visible until they've specifically been set to hidden using the /dynmap hide command. If true, users are assumed to be hidden until they've specifically been set to visible using the /dynmap show command.

*renderinterval : this setting, a floating point value in seconds, is used to control how often tiles needing to be updated (due to changes by players, for example) are processed. Setting this too low can cause extra load on the server, due to recalculation of repeatedly updated tiles. Default is 0.5 seconds. Most servers will perform without issue down to 0.2 seconds.

*renderacceleratethreshold : this setting, an integer, defines the size of the tile update queue allowed before the rate that tiles are processed shifts from the rate in renderinterval to the rate in renderaccelerateinterval. This is intended to prevent large tile backlogs from accumulating (which can happen when players are causing large amounts of new map territory to be generated) without requiring routine updates to be processed at a quick pace.

*renderaccelerateinterval : this setting, a floating point value in seconds, is used as the renderinterval value when the length of the tile update queue exceeds renderacceleratethreshold tiles in length.

*tiles-rendered-at-once : this setting controls the maximum number of update tiles that will be rendered concurrently. If not defined, the value defaults to 1/2 the number of processor cores. Settting this to lower values can reduce peek CPU use when large tile update load occur (from newly generated chunks, for example).

*usenormalthreadpriority : this setting, when set to true, causes the render threads to run with normal priority (versus minimum priority). This can help render performance on busy Windows boxes (preventing rendering from starving on busy boxes), but may result in competition for CPU with other processes. Most Linux JVMs ignore priority.

*zoomoutperiod : this setting, an integer value in seconds, specifies how often update processing of zoomed-out tiles is done. This done to prevent unneeded regeneration of the tiles due to repeated changes by players (such as when mining). Default value is 60 seconds.

*enabletilehash : this setting, a boolean, is used to enable the use of tile content hash codes, which are used to avoid re-encoding tiles that have not changed in value after re-rendering (such as due to changes in blocks that are not visible on the tile). This reduces processing load, zoom-out processing, and communications traffic with web clients.

*render-triggers : this setting, a list of strings, is used to enable various mechanisms for detecting the need to generate or update map tiles. The defined triggers are as follows:
**chunkloaded : this trigger causes tiles to be updated based on the loading of map chunks. This trigger is no longer recommended - use chunkgenerated instead, as chunkloaded can cause significant and unnecessary tile recalculation. Retired in v0.31.
**playermove : this trigger causes tiles to be updated based on the movement of players. This trigger is not recommended, as it will cause significant and unneeded tile recalculation.
**playerjoin : this trigger causes tiles to be updated around the position where a player logs in.
**blockplaced : this trigger causes tiles to be updated when a player places a block (recommended).
**blockbreak : this trigger causes tiles to be updated when a player breaks a block (recommended).
**leavesdecay : this trigger causes tiles to be updated when leaves decay due to the cutting of a tree (recommended)
**blockburn : this trigger causes tiles to be updated when a block is destroyed by fire (recommended)
**blockfaded : this trigger causes tiles to be updated when a block has faded (such as melted snow or ice) (recommended)
**blockspread : this trigger causes tiles to be updated when a block has spread (lava or water) (recommended)
**chunkgenerated : this trigger causes tiles to be updated when new map chunks are generated (recommended)
**pistonmoved : this trigger causes tiles to be updated when pistons extend or retract (recommended)
**explosion : this trigger causes tiles to be updated when blocks are destroyed by an explosion (recommended)
**blockfromto : this trigger causes tiles to be updated when blocks are flowing into new blocks (lova, water) (recommended)
**blockphysics : this trigger causes tiles to be updated when blocks move due to physics events (falling gravel, water, lava, sand) (recommended)
**structuregrow : this trigger causes tiles to be updated when saplings grow into trees, or mushrooms grow into giant mushrooms.
**blockgrow : this trigger causes tiles to be updated when blocks grow, such as crops and mushrooms
**blockredstone : this trigger causes tiles to be updated when redstone currents change on a block (be very careful with this if you have redstone machines that run constantly)

*webpage-title : this setting, a string, is used to specify the title for the Dynmap maps web page. If not specified, it will attempt to use the 'server-name' property from server.properties. If that is undefined or set to 'Unknown Server', the title will default to 'Minecraft Dynamic Map'.

*tilespath : this setting, a string, specifies the path (either relative to the Dynmap plugin directory, or absolute) of where map tiles are to be generated (and where they are found by the internal web server).

*webpath : this setting, a string, specifies the root path for the internal web server. All files served by the internal web server (with the exception of the map tiles) are based on this path. The path can be relative to the Dynmap plugin directory, or absolute.

*webserver-bindaddress : this setting, an IP address, controls which network interfaces the internal web server will bind to. The default, 0.0.0.0, will cause the server to bind to ALL interfaces (which should be correct for most configurations). Setting to 127.0.0.1 will cause it to bind to only the localhost (which may be appropriate if an external web server located on the same box is being used). Other values need to match the address of the interface ON THE BOX (not public addresses outside a firewall or proxy).

*webserver-port : this setting, an integer, specifies which port the internal web server binds to. This defaults for 8123. Note: many operating systems require a process to run with root privileges in order to bind to a port below 1024.

*max-sessions : this setting, an integer, sets the limit on the number of concurrent sessions that the internal web server will allow to be active (limiting the resources used by the sessions and threads associated with those sessions). Default value is 30.

*http-response-headers : this setting, a set of attribute/value pairs, provides a way to have the internal web server include custom header values in all HTTP responses. The values under the attribute are formatted with the header field ID as the attribute ID, and the value of the header field as the string value of the attribute. For example:

*http-response-headers:
Access-Control-Allow-Origin: "http://mydomain.com"
X-Another-Header: "Another Header Value"
*disable-webserver : if set to true, the internal web server is disabled (this requires using an external web server, and the JSONFileClientUpdateComponent). Other configuration options require this setting to be false.

*allow-symlinks : if set to true, the directories under webpath or tilespath are allowed to contain symbolic links. If false, the internal web server will not follow symbolic links (this is a recommended practice that is followed by nearly all external web servers).

*timesliceinterval : this setting, a floating point in seconds, specifies a minimum time period between tile processing during /dynmap fullrender processing. Default value is 0.0 (no delay). Non-zero values can be used to reduce server load during full-renders, but will significantly lengthen processing time.

*maxchunkspertick : this setting, an integer, limits the number of map chunks loaded during a given server tick (50ms). As loading of map chunks is the main source of load on the Bukkit server's main thread, this can be used to limit any lag that may be resulting from map processing.

*progressloginterval : this setting, an integer, is the interval used for reporting progress on fullrender requests. The default (and minimum) value is 100.

*parallelrendercnt : this setting, an integer, is optional, and can be used to allow full-render processing to be done by more than one thread. The setting indicates the number of concurrent threads that will be used, and should be limited to the number of physical cores on the server (or less). Note: setting this will result in much more intensive CPU use, some additional memory use. Caution should be used when setting this to equal or exceed the number of physical cores on the system.

*updaterate : this setting, an integer in milliseconds, specifies how often the web clients should poll the server for updates (whether it be tile updates, chat messages, or player position updates). Setting this to a higher value can reduce web server traffic.

*fullrenderplayerlimit : this optional setting defines an option for suspending fullrender/radiusrender processing when the number of active player logins reach or exceed a given limit. Default is 0 (disabled), while a setting of 1 will result in fullrender/radiusrender processing being suspended while any players are logged in.

*showplayerfacesinmenu : this setting, a boolean, is used to control whether to show online players in the tray meny on the web clients. Default is to show the players (true).

*sidebaropened : this setting, a string, is used to optionally pin the sidebar menu permanently open ('true'), pinned by default ('pinned') or closed by default ('false'). Default is false.

*joinmessage : this setting, a string, is used to control the message reported in web chat when a player logs in to the server. The substitution macro, %playername%, is used to provide the player's name.

*quitmessage : this setting, a string, is used to control the message reported in web chat when a player logs off ofthe server. The substitution macro, %playername%, is used to provide the player's name.

*spammessage : this setting, a string, is used to control the message reported to web chat users that attempt to send messages too often.

*webprefix : this setting, a string, is used to provide a prefix for chat messages received from web clients. The escape sequence '&color;' can be used in place of the Bukkit color escape sequence.

*websuffix : this setting, a string, is used to provide a suffix for chat messages received from web clients. The escape sequence '&color;' can be used in place of the Bukkit color escape sequence.

*showlayercontrol : this setting, a boolean, is used to control whether the layer control is shown (setting this to false will cause it to not be shown, even if marker layers are defined). Default is true.

*check-banned-ips : this setting, a boolean, is used to control whether the internal web server checks the banned-ips.txt file to block access to the web client by banned IP addresses.

*persist-ids-by-ip : if true, player IP addresses and the associated player IDs are persistent, and will be saved on server shutdown and reloaded on server startup (allowing known IP address to player ID associations to accumulate). Default is true (0.29 or later).

*defaultzoom : this setting, an integer, specifies the default zoom level for the web client when it is first loaded by a user.

*defaultworld : this setting, a string, specifies the name of the default world for the web client when it is first loaded by a user.

*defaultmap : this setting, a string, specifies the name of the default map for the web client when it is first loaded by a user.

*followzoom : this optional setting, an integer, specifies the default zoom level for the web client when a player is selected to be followed.

*followmap : this ootional setting, a stirng, specifies the name of the default map for the web client to switch to, if needed, when a player is selected to be followed

*verbose : this setting, a boolean, controls how verbose the messages are for the Dynmap plugin during startup. Setting to false will significantly reduce reported messages and details.

*hideores : this setting, a boolean, controls the option to hide any ore blocks, making them appear the same as solid stone (preventing maps from being used to find exposed ores). Default is false.

*better-grass : this setting, a boolean, controls the option to render the sides of grass and snow blocks as they are done with the BetterGrass client mod (if set to true). Default is false.

*smooth-lighting : this setting, a boolean, provides the default setting for the smooth lighting option on all maps supporting the feature. Setting it to 'true' is a convenient way to enable smooth lighting on all maps that can use it. The setting is also defined on a per-shader basis, which can be used to control the feature on an individual map level. Enabling this feature will add approximately 10% to rendering processing cost.

*use-generated-textures: this setting, if defined and set to 'true', will cause texturepack based HD map renders to use generated textures for water, lava, and fire equivalent to those used by the Minecraft client. If false, the legacy textures in the texture.png and misc/water.png are used (pre-0.29 behavior). Setting this will require a full map render to see the proper results.

*correct-water-lighting: this setting, if defined and set to 'true', will cause texturepack based HD map renders to process lighting of water equivalently to the Minecraft client. If false, the legacy behavior - which results in darker water - is used (pre-0.29 behavior). Setting this will require a full map render to see the proper results.

*fetchskins : this setting, a boolean, controls whether the server will attempt to fetch skins for players during login. If set to false, no skins are fetched, and the default skin is assumed for all players. Default is true.

*refreshskins : this setting, a boolean, controls whether faces and other images derived from a player's skin are refreshed each login. If set to false, existing files are never refreshed (which can be useful if faces are locally managed or updated by the server administrator or another plugin). Default is true.

====User Login Security Settings for Web Interface====

The support for login-based security on the web interface can be controlled through the following settings:

*login-enabled : this setting, a boolean, enables login security support (if the setting is defined and set to 'true').

*login-required : this setting, a boolean, forces all web users to log in, in order to access the web interface (if the setting is defined and set to 'true').

===部件配置===

The interface for Dynmap is defined via a set of components. Not all components can be enabled at once, and some are required. Details on the defined compnents, and their attributes, are in the following sections.

====Core Client Components====

The following components defined the core of the client's interface with the Dynmap server. The Client Configuration Component, and at least one of the Client Update Components is required for any client functionality.

=====Client Configuration Component=====

This component is defined by the following lines in the components section:

- class: org.dynmap.ClientConfigurationComponent
This component is required, and has no settings.

=====Internal Client Update Component=====

This component defines the primary interface for the web client via Dynmap's internal web server (which must be enabled for this component to function). It defines URLs for the client to use under the http://address:port/up/ path, including both fetching configuration data, and fetching map updates, player status and chat messages. The component is configured via the following lines in the components section:

- class: org.dynmap.InternalClientUpdateComponent
sendhealth: true
sendposition: true
allowwebchat: true
webchat-interval: 5
hidewebchatip: false
trustclientname: false
use-player-login-ip: true
require-player-login-ip: false
block-banned-player-chat: true
webchat-requires-login: false
webchat-permissions: false
includehiddenplayers: false
hideifshadow: 15
hideifundercover: 15
hideifsneaking: false
protected-player-info: false
The settings are defined as follows:

*sendhealth : this controls whether or not the health data for players is reported to the web client. If it is disabled, other components that report player health will not have the needed data to do so, but player health information is also safe from being inspected. If enabled, health information may still be hidden for players located on specific worlds via the sendhealth: false setting on those worlds.

*sendpostiion : this controls whether or not the position data for players is reported to the web client. If it is disabled, other components that report position will not have the needed data to do so, but player position information is also safe from being inspected. If enabled, position information may still be hidden for players located on specific worlds via the sendposition: false setting on those worlds.

*allowwebchat : this setting controls whether or not the interface to allow chat messages to be sent from the web client to the server is enabled. If false, no web messages may be sent from the client.

*webchat-interval : this controls the minimum period, in seconds, between consecutive chat messages from a given web client.

*hidewebchatip : if set to true, this causes web chat messages to be reported via generic names versus the IP address of the sender.

*trustclientname : if set to true, this causes the hostname/IP reported by the web client (which may be falsified) to be reported as the sender's address (versus using the address seen by the web server).

*use-player-login-ip : if set to true, web chat messages will be matched with current or previous player IDs having connected from the same IP address - if a match is found, the most recent player ID is used to identify the sender of the web chat message. Default is true (0.29 or later)

*require-player-login-ip : if use-player-login-ip is true, and this setting is true, web chat messages not matching a current or previous player connection address will be ignored. Default is false (0.29 or later).

*block-banned-player-chat : if use-player-login-ip is true, and this setting is true, web chat messages that match a previous player address of a currently banned player will be ignored. Default is true (0.29 or later). Note: does not work with plugins that implement their own ban independent of Bukkit/Minecraft's ban (currently, this is true of CommandBook).

*webchat-requires-login : if login-enabled is true, and this setting is trye, web chat messages can only be sent from web users that have successfully logged in.

*webchat-permissions : if defined and set to 'true', web chat requests tied to players (via login or ID-by-IP) will be checked for the dynmap.webchat permission, with those not possessing the permission being denied the right to send. This requires a permission system that supports reading permissions for offline players - currently PermissionsEx and bPermissions - in order to work for web users that are not currently logged in using the Minecraft client, as well.

*includehiddenplayers : if set to true, players that are hidden (via the /dynmap hide command) will be reported to the UI as online, but with their position, health, and messages still hidden. They will appear in the player list.

*hideifshadow : if set to a value below 15, each player's position and health are hidden if the light level of the current location of the player is at or below the given value (0=total darkness, 4=under sky at night, 15=full daylight).

*hideifundercover : if set to a value below 15, each player's position and health are hidden if the current position of the player is under cover. Due to a current Bukkit limitation (pending acceptance of a pull request we issued), any block will obstruct the view of the player (once updated, this will shift to be based on the relative shadow level of the location - corresponding to how much the location would be in shadow during full daylight).

*hideifsneaking : if set to true, players that are sneaking will be hidden.

*protected-player-info : if set to true, access to player position and health information is protected. Players without the dynmap.playermarkers.seeall permission (operators have this by default) will only see their own player marker, while those with the permission will see all player positions. If this setting is not provided, or is false, all player position and health information is available to all map viewers.

====JSON File Client Update Component====

The alternative to using the internal web server is for all communications between Dynmap and the web client to be done via files served through an external web server. As this is done with files formatted using JSON (JavaScript Object Notation), this mode of operation is often referred to as "JSON File Mode". This mode allows the internal web server to be disabled, and is the alternative to using the Internal Client Update Component (only one of them may be enabled at a time). The component is defined by the following lines in the components section:

- class: org.dynmap.JsonFileClientUpdateComponent
writeinterval: 1
sendhealth: true
sendposition: true
allowwebchat: false
webchat-interval: 5
hidewebchatip: false
trustclientname: false
use-player-login-ip: true
require-player-login-ip: false
block-banned-player-chat: true
webchat-requires-login: false
webchat-permissions: false
includehiddenplayers: false
hideifshadow: 15
hideifundercover: 15
hideifsneaking: false
protected-player-info: false
The definitions of the attributes are the same as the corresponding attributes in the Internal Client Update Component. The additional attributes are as follows:

*writeinterval : this is the period, in seconds, used by the component for writing updated configuration and map update files to the webpath/standalone directory. These are the files loaded by the web client via the external web server to receive the map configuration, as well as notifications of map updates, player position and health data, and chat messages.

====Markers Component====

This component, added in v0.22, provides built-in support for map markers, both through the /dmarker commands and through an API published for use by other plugins. The component is configured via the following lines in the components section:

- class: org.dynmap.MarkersComponent
type: markers
showlabel: false
enablesigns: false
showspawn: false
spawnicon: world
spawnlabel: "Spawn"
showofflineplayers: false
offlinelabel: "Offline"
offlineicon: offlineuser
offlinehidebydefault: true
offlineminzoom: 0
maxofflinetime: 30
showspawnbeds: false
spawnbedlabel: "Spawn Beds"
spawnbedicon: "bed"
spawnbedhidebydefault: true
spawnbedminzoom: 0
spawnbedformat: "%name%'s bed"
The settings for the component include the following:

showlabel : if defined and set to true, this causes the labels for map markers to be shown all the time, versus only being shown when the user's mouse is hovering over the icon.

enablesigns : If defined and set to true, this enables support for defining markers using signs. If enabled, and if the player has the dynmap.marker.sign privilege, a player can make a marker by creating a sign with '[dynmap]' as the first line, with the label being derived from the first non-blank line after that (that is not a setting). The icon will be the 'sign' icon, unless one of the lines is 'icon:'. The marker set for the marker will be the default 'markers' set, unless one of the lines is 'set:'. Once accepted, the '[dynmap]' line and any settings lines will be blanked, leaving the sign with the label line and any remaining lines. Destroying the sign will delete the corresponding marker.

showspawn : if defined and set to true, this causes the spawn points of each world to be shown with an appropriate marker (the default being the 'world' marker) and label (the default being "Spawn").

spawnicon : if defined, provides the ID of the icon to use for the spawn points (if showspawn is true). Default is 'world'.

spawnlabel : if defined, provides the label for the spawn point markers (if showspawn is true). Default is "Spawn".

showofflineplayers : if defined and set to true, a marker layer is defined to show the positions of offline players (markers will be added as players log off).

offlinelabel : Label used for the offline player marker layer - default is 'Offline'

offlineicon : Name of the marker icon used for offline players - default is 'offlineuser'

offlinehidebydefault : if defined and set true, offline marker layer is hidden by default. Default is 'true'.

offlineminzoom : if set to non-zero, this specifies the minimum zoom in level before offline player markers are displayed.

maxofflinetime : if set above zero, this specifies the number of minutes after a player logs off before their offline icon should be removed (<= 0 means never). All offline player markers are reset on a server restart, independent of this setting.

showspawnbeds : If defined and set to true, a marker layer is defined to show the positions of the online players' spawn beds (markers will be removed when players log off).

spawnbedlabel : Label for player spawn bed marker layer, if enabled. Default is "Spawn Beds".

spawnbedicon : Icon to use for any spawn bed markers. Default is 'bed' marker.

spawnbedhidebydefault : If true, spawn bed marker layer will be hidden, by default.

spawnbedminzoom : If set to non-zero, this specifies the minimum zoom in level before spawn bed markers are displayed.

====Server-Side Chat Components====

These components control the server-side implementation of chat, including the sending of chat messages from the server to the client, as well as particulars of how chat messages from the client to the server are delivered to players on the server. Only one of these components should be defined at a time.

====Simple Chat Component====

This component implements access to the standard Bukkit/Minecraft server's chat channel. When active, all chat messages are shared with the web client, and all messages received from the web client are sent to all players on the server (as well as all other web clients). This component is configured via the following lines in the components section:

- class: org.dynmap.SimpleWebChatComponent
allowchat: true

The settings for the component include:

allowchat : if enabled, this setting determines if chat messages on the server are to be sent to the web clients. If set to 'false', no chat messages are sent to the web clients.

====HeroChat Chat Component (Deprecated - not functional with HeroChat 5)====

The HeroChat plugin implements channels and other behaviors that require special treatment. This component interfaces with HeroChat, and allows the selection of which HeroChat channels have their messages reported to the web clients, and which channel messages from the web clients are reported on. This component is configured via the following lines in the components section:

- class: org.dynmap.herochat.HeroWebChatComponent
herochatwebchannel: Global
herochatchannels:
- Global
The settings for the component are as follows:

herochatwebchannel : this is the name of the HeroChat channel that will be used for any chat messages received from the web clients. Default value is 'Global'

herochatchannels : this is the list of HeroChat channel names that will be monitored for chat messages, which will then be shared with the web clients. Zero or more channels may be listed. The default is a single channel list containing 'Global'.

====Client-Side Chat Components====

These components control the behavior and availability of the components of the web client used to support sending and receiving of chat messages. These components depend upon the corresponding server-side components being enabled and allowing the requested functions. The components can be defined individually or in any combination.

=====Chat Client Component=====

This component enables the input field for chat messages, allowing the users to enter and send chat messages to the server from the web client. It is defined by the following lines:

- class: org.dynmap.ClientComponent
type: chat
allowurlname: false
The component supports the following settings:

allowurlname : if true (and if trustclientname is true in the corresponding ClientUpdateComponent), the user of the web console can supply a chat name using the chatname URL parameter.
=====Chat Balloon Client Component=====

This component implements support for pop-up balloon messages, with the balloon being placed above the location of the sending player on the map, if any. The component is defined via the following lines in the components section:

- class: org.dynmap.ClientComponent
type: chatballoon
focuschatballoons: false
The component supports the following settings:

focuschatballoons : if enabled, this causes the map to pan to the chat balloon, if it is not currently visible on the map.
Note that placement of the word balloons requires that the position data for the speaking player is known, which may not be the case if sendposition: false has been set for the player's current world, or globally via the active Client Update Component.

=====Chat Box Client Component=====

This implements the box for viewing chat messages received from players on the server, as well as from other web clients. The component is defined via the following lines in the components section:

- class: org.dynmap.ClientComponent
type: chatbox
showplayerfaces: true
messagettl: 5
scrollback: 100
sendbutton: false
The settings for this component are as follows:

showplayerfaces : if enabled, the face icons for the player that sent a given chat message will be shown next to the message.

messagettl : this controls the number of seconds that a received chat message is shown on the screen before fading. If scrollback is defined, this setting is ignored.

scrollback : if defined, this specifies the number of messages to keep in the scrollable message list. If specified, messages will not age out (messagettl is ignored) and will only be dropped as the number of messages exceeds the scrollback count.

sendbutton : if defined and set to true, this causes a send button to appear on the web UI, allowing messages to be sent without requiring the pressing of the return key.

====Map Controls Components====

These define additional map content, such as player markers, clocks, logos, etc. Any set of these components can be defined.

=====Player Markers Component=====

This component is used to show player positions and names as markers on the displayed map. The player's position can only be shown if it is available (see the sendposition setting, above). The component is defined by the following lines in the components section:

- class: org.dynmap.ClientComponent
type: playermarkers
showplayerfaces: true
showplayerhealth: true
showplayerbody: false
smallplayerfaces: false
hidebydefault: false
layerprio: 0
label: "Players"
The settings for the component include the following:

*showplayerfaces : if enabled, this causes the client to attempt to load the custom skin for the player (if any) and to show the face portion of that skin as the icon for the player. Otherwise, a small generic marker is shown instead.

*showplayerhealth : if enabled, the client will attempt to show health and armor attributes for the player, as two rows of small icons below the player's name. This requires that the player's health information be available (see sendhealth, above).

*smallplayerfaces : if enabled, player faces are shown (assuming showplayerfaces is true), but at 1/2 the normal size (equivalent to the small generic markers used when showplayerfaces is false).

*showplayerbody : if enabled, whole body icons will be show instead of just faces. Only applicable if showplayerfaces is true and smallplayerfaces is false.

*hidebydefault : this optional parameter, if defined and set to true, changes the default visibility state for the map layer with the player markers to be hidden. The layer can still be made visible with the layer control on the web client UI.

*layerprio : this optional parameter provides an ordering weight for the layer in the layer selection control, which orders from lowest to highest layerprio (and then alphabetically for equal priority layers). Default is 0.

*label : this optional parameter provides the label used for the layer selection control for this layer set. Default is 'Players'.

=====Digital Clock Component=====

This is used to display a simple digital clock, corresponding to the time on the world being displayed. The component is defined by the following lines in the components section:

- class: org.dynmap.ClientComponent
type: digitalclock
Only one clock component can be enabled at a time.

=====Time Of Day Clock Component=====

This is a more sophisticated clock component, showing day and night via sun and moon icons that rise and set to match the time in the world being shown. The component is defined via the following lines in the components section:

- class: org.dynmap.ClientComponent
type: timeofdayclock
showdigitalclock: true
showweather: true
The settings for the component include the following:

*showdigitalclock : if enabled, the digital clock is displayed (in addition to the sun and moon display)

*showweather : if enabled, an icon is shown to indicate weather (rain, thunder) on the world being shown by the map.

=====Coord Component=====

This component is used to show the world coordinates corresponding to the position of the mouse pointer. The component is defined via the following lines in the components section:

- class: org.dynmap.ClientComponent
type: coord
label: "Location"
hidey: false
show-mcr: false
The settings for the component are as follows:

label : this allows control of the label used on the control presenting the coordiates. Default is 'x,y,z'.

hidey : this option, if defined and set to true, makes the coordinate control only show X,Z coordinates.

show-mcr : this option, if defined and set to true, causes the display of the Mincraft Region file ID for the current location.

=====Logo Component=====

This component is used to allow an optional logo and link to be shown on the map. The component is defined via the following lines in the components section:

- class: org.dynmap.ClientComponent
type: logo
text: "Dynmap"
linkurl: "http://forums.bukkit.org/threads/dynmap.489/"
The settings for the component are as follows:

*text : the label shown for the logo

*linkurl : the URL associated with the link tied to the displayed label

=====Link Component=====

This component is used to provide a 'link to' button on the web UI. This button, when clicked, will navigate the view to a URL with all the needed settings to preserve the world, map, zoom, and coordinates of the current view - allowing a view to be shared, bookmarked, or otherwise linked. The component is defined via the following lines in the components section:

- class: org.dynmap.ClientComponent
type: link
There are no settings currently defined.

===世界及模板设置===
There are an extensive set of configurable settings for controlling the map and interface definitions for the worlds on a user's server. Nearly all of these settings are also settable on templates - which is appropriate, since templates are essentially a collection of settings used to define any settings not defined for the worlds that use them.

Logically, any defined world will have a default set of settings, derived from the template that is associated with its environment type (normal, nether, skylands) - the settings are inherited from the template of the same name as the environment, by default. If the deftemplatesuffix is defined, the name of the template inherited from is modified by appending a hyphen ('-') and the value of the setting. So, setting deftemplatesuffix to hires causes the template automatically used by a normal world to be normal-hires, and for nether worlds to be nether-hires.

Beyond the values inherited from the template, settings for a given world can always be provided by defining a section for the world in the worlds: section (in worlds.txt, or in configuration.txt). When a section exists for a given world, any setting provided there will override any corresponding setting inherited from the world's template.

With the exception of the world's name and maps, all other world settings are optional and have defined defaults, and the maps are typically provided through templates. Consequently, a world definition under the worlds: section can consist of nothing but the world's name:

worlds:
- name: world1
- name: world2
This can be used to control the order of the worlds, as defined worlds are always listed in their order of definition, and automatically selected worlds are listed after those.

An example of a more comprehensive set of world settings are shown below:

worlds:
- name: world
title: "My Great World"
enabled: true
template: mycustomtemplate
sendposition: true
sendhealth: true
fullrenderlocations:
- x: 100
y: 64
z: 2000
visibilitylimits:
- x0: -1000
z0: -1000
x1: 1000
z1: 1000
hiddenlimits:
- x0: 100
z0: 0
x1: 200
z1: 0
hidestyle: stone
center:
x: 0
y: 64
z: 0
bigworld: false
extrazoomout: 0
maps:
- class: org.dynmap.flat.FlatMap
....
The available settings are defined as follows:

*name : this defines the name of the world within Bukkit, and must be unique. This can not be inherited from a template.

*title : if defined, this string is used as a human-friendly label for the world. The default value is blank.

*enabled : if defined, this allows mapping for a given world to be enabled (by setting true) or disabled (by setting false). All worlds are enabled by default, so defining a worlds entry for a world and setting enabled to false is the only way to prevent a world from being displayed and mapped.

*template : if defined, this overrides the name of the template used to provide the default settings for the world. If not set, the default is based on the world's environment (normal, nether, or skylands), with a '-' and the deftemplatesuffix value added if deftemplatesuffix is defined. This value cannot be inherited from a template.

*sendposition : if defined and set to false, this allows the option to have the position information for any players located on this world to be hidden on the UI, even if such information is enabled otherwise. Setting this attribute to true will NOT cause player information to be displayed if the global sendposition setting is false. If not defined, this setting defaults to true.

*sendhealth : if defined and set to false, this allows the option to have the armor and health information for any players located on this world to be hidden on the UI, even if such information is enabled otherwise. Setting this attribute to true will NOT cause player information to be displayed if the global sendhealth setting is false. If not defined, this setting defaults to true.

*fullrenderlocations : if defined, this list of world coordinates (each consisting of an x, y, and z coordinate) defines a set of additional locations (beyond x=0, y=64, z=0, or the player's current location, if a /dynmap fullrender command is issued by an in-game player) to be used to seed a full-render. Logically, fullrender is implemented like a flood fill in a paint program - if a map has gaps in its areas of defined chunks, such as can happen if maps are explored via teleporting or portals, a fullrender seeded from one point may not reach all the patches of the world that have been generated: adding example locations within the other patches to the fullrenderlocations list will cause those patches to be rendered, as well.

*visibilitylimits : if defined, this list of rectangles can be used to restrict the area of the world to be rendered: areas outside of these rectangles will not be rendered with accurate map data, but instead some form of filler will be used (depending on the hidestyle setting, below). If the list is empty (the default), no limits are implemented, and maps will be rendered to the edge of the generated chunks for the world. Each rectangle consists of two coordinate pairs - x0, z0, and x1, z1. As of 1.5-alpha-3, circular areas can also be defined, by providing an x, z value for the center and a r value for the radius, in blocks.

*hiddenlimits : if defined, this list of rectangles that are the opposite of 'visibilitylimits' - they define specific areas of the world to be hidden (rendered based on the hidestyle setting, below). If both 'visibilitylimits' and 'hiddenlimits' are defined, the 'visibilitylimits' are applied first (determining which areas are visible), and then the 'hiddenlimits' are used to further restrict that. Each rectangle consists of two coordinate pairs - x0, z0, and x1, z1. As of 1.5-alpha-3, circular areas can also be defined, by providing an x, z value for the center and a r value for the radius, in blocks.

*hidestyle : If the visibilitylimits and/or hiddenlimits settings have restricted the visible areas of a world, the hidestyle setting is used to control how the chunks of map data being hidden are presented. 3 settings are supported: stone, which causes a stone plain to fill the hidden areas; ocean, which causes a deep ocean to fill the hidden areas; or air, which causes the hidden area to be empty (like the edge of the generated portion of the world map). The default value is stone.

*center : If defined, this provides the default center-of-focus for the view of the maps of this world. The coordinate includes the x, y and z coordinate of the center point, in world coordinates. If not defined, the center defaults to the spawn point for the given world.

*bigworld : If defined, this enables the use by the FlatMap and KzedMap map types of an alternate file system structure, better suited to use by large worlds that may have tens or even hundreds of thousands of tiles. HDMaps always use this format, and are not affected by this settings. The default value is false, while a value of true enables the alternate layout. If the setting is changed, a /dynmap fullrender will be needed to initialize the new layout.

*extrazoomout : If defined, this specifies how many additional levels of zoom out the maps for this world should have, beyond their default. This results in both offering more levels of zoom on the map viewer, and in additional levels of map tiles being generated (based on the original tiles generated for the maps): each level is 2 x 2 the scale of the previous level, so 4 tiles on one level become 1 tile with less resolution on the next. Enabling this setting, by setting the value to an integer above 0, will add from 25% to 33% to the number of tile files, and total disk space used, by the maps for the given world, but will allow easier navigation of mid-sized to large worlds. The default value is 0 (no extra zoom out).

*maps : if defined, the maps section provides all the definitions for the maps to be rendered for the world, in the order that they are presented on the map viewer. If defined in a world's section in worlds:, any map definitions provided by the world's template are replaced. For details on map definition, see Map Configuration and HD Map Configuration.

===高清地图配置===

With their introduction in v0.20, the HDMap map type provides a new, more flexible, and (arguably) more complex means of defining and customizing the maps a user can make available on their server. Several details on how HDMaps are defined and structured are intended to offset the additional complexity - but it is important to understand the basic "theory of operations" behind an HDMap definition, in order to know what you need to do to get what you want out of your maps (and not have to work any harder than necessary to get it).

====Getting Started Quickly: Enabling the default HD templates====

*Dynmap includes 3 sets of templates, each providing map definitions for the various types of worlds (normal, nether, and the_end). To select between the three template sets, edit the configuration.txt file, and change the setting of the deftemplatesuffix setting (found near the top of the default configuration.txt file). The currently defined values for this setting include:

*deftemplatesuffix: "" : This causes dynmap to use the 'classic' default templates - these are low resolution and very quick to render, but are far from the most attractive maps. The template files used for this mode are templates/normal.txt, templates/nether.txt, and templates/the_end.txt. This was the default for 0.23 and earlier.

*deftemplatesuffix: vlowres : this selects the "very-low-res" HD maps. These maps are similar to the 'classic' defaults (a surface map, an isometric view from the south-east, and a cave map), but they are rendered using the HD renderer. Also, by default the standard Minecraft texture pack will be used to color the blocks, yielding a much more accurate representation of the map. The template files used for this mode are in templates/normal-vlowres.txt, templates/nether-vlowres.txt, and templates/the_end-vlowres.txt. As of 0.24, these are the default templates.

*deftemplatesuffix: lowres : this selects the "low-res" HD maps. These maps are similar to the 'classic' defaults (a surface map, an isometric view from the south-east, and a cave map), but they are rendered using the HD renderer with about 2-3x the resolution of the "classic" maps. Also, by default the standard Minecraft texture pack will be used to color the blocks, yielding a much more accurate representation of the map. Rendering these maps will take 4-6 times as long as the default 'classic' maps, and about 4x the disk space. The template files used for this mode are in templates/normal-lowres.txt, templates/nether-lowres.txt, and templates/the_end-lowres.txt.

*deftemplatesuffix: hires : this selects the "high-res" HD maps. These maps are the same as the lowres HD maps, except that the surface map (the isometric map) is much higher resolution (4x higher than on lowres, about 8x higher than classic), and rendered from a lower view angle (30 degrees from horizontal versus 60 degrees). The resulting view is VERY nice, but will take quite some time to render (approximately 16x the render time of the lowres map, and about 64x that of the classic map), and much more space (about 16x that of lowres, 64x that of classic). The template files used for this mode are in templates/normal-hires.txt, templates/nether-hires.txt, and templates/the_end-hires.txt.

Once a template set has been selected, the maps can be further customized by editing the template files in use. The following sections describe all the details needed to fully control the map definitions.

====The Basics: How to add an HDMap to templates or worlds====

Defining an HDMap is, at the high level, the same as it is for the existing map type. As with other maps, an HDMap definition is provided under the maps: section of either a template (in either configuration.txt or one of the files in the templates/ directory) or in a world definition under the worlds: section (in either configuration.txt or the worlds.txt file). The following is a complete example of an HDMap definition:

maps:
- class: org.dynmap.hdmap.HDMap
name: myhdmap
title: "My HD Map"
prefix: hdm1
perspective: iso_S_90_lowres
shader: stdtexture
lighting: default
*As with all maps, an HDMap definition needs 3 basic parameters:

*A class: setting - this identifies the general type of map: for HDMaps, this is org.dynmap.hdmap.HDMap

*A name: setting - this is a unique name for the map (unique among the other maps on a given world). This is used for identifying the map, including when selecting the map using the defaultmap setting, or in the URL parameters.

*A prefix: setting - if not provided, the name setting is used for this. This is used as part of the file and directory names used for the map - so it also needs to be unique among the other prefix values for the other maps on a given world.

Now, the settings specific to HDMaps are used to define three specific aspects of how a map is drawn:

*How do we determine what we see in the scene?

*How do we decide how to color what we see?

*What effect does lighting have on the colors we see?

With HDMaps, the answer to these three questions is determined by the next three settings:

*The perspective: setting provides the name of the perspective definition we use to show the map. The perspective controls the type of projection (currently, only an isometric projection), the direction of view into the map (both angle from North, and angle from horizontal), and the scale of the view (how many pixels per block edge).

*The shader: setting provides the name of the shader definition we use to color the map - how we decide the color of what the -perspective- shows us. This can include shaders that work with specific Minecraft Texture Packs, shaders that use the legacy colorschemes (like those used on the FlatMap and KzedMap definitions), shaders that present biome-based coloring, or shaders for cave rendering.

*The lighting: setting provides the name of the lighting definition we used to modify the colors of the map, based on lighting conditions. This can include rendering shadows, rendering night views, or both night and day views.

To simplify the configuration of these settings, Dynmap comes with a number of predefined perspectives, shaders, and lightings. These definitions can be modified, if needed, or used as examples to allow creation of new definitions specific to a user's needs.

====Predefined Perspectives====

There are quite a few predefined perspectives, which can be found in perspectives.txt. The names of the predefined settings follow a strict naming pattern, to make it easier to tell which setting to use:

projection _ direction _ angle _ scale

Where:

*projection is the type of viewpoint: currently, only iso (isometric) is supported.

*direction is the direction of view: each of the 8 cardinal directions are supported (N, NE, E, SE, S, SW, W, NW)

*angle is the angle from horizontal of the view: 30 (30 degrees) and 60 (60 degrees) are supported for all cardinal directions, 90 (90 degrees - top-down) is defined for N (from North), S (from South), E (from East) and W (from West) view directions.

*scale is the scale of magnification or detail of the view: vlowres corresponds to 2 pixels per block edge (similar to KzedMap resolution), lowres corresponds to 4 pixels per block edge (about 2x the KzedMap resolution), medres corresponds to 8 pixels per block edge, and hires corresponds to 16 pixels per block edge.

[https://github.com/webbukkit/dynmap/wiki/Full-list-of-predefined-perspectives/ Full List of Predefined Perspectives]

====Predefined shaders====

The predefined shader settings (which are found in shaders.txt) include the following:

*default : the default shader, which uses the standard Minecraft Texture Pack for coloring maps

*defaultscheme : this uses the 'default' colorscheme (as defined in colorschemes/default.txt) for coloring maps

*ovocean : this uses the 'ovocean' colorscheme (as defined in colorschemes/ovocean.txt) for coloring maps

*flames : this uses the 'flames' colorscheme (as defined in colorschemes/flames.txt) for coloring maps

*sk89q : this uses the 'sk89q' colorscheme (as defined in colorschemes/sk89q.txt) for coloring maps

*biome : this uses the biome types for coloring the maps

*temperature : this uses the biome temperature data for coloring the maps

*rainfall : this uses the biome rainfall/humidity data for coloring the maps

*no_transparency : this uses the 'default' colorscheme (as defined in colorschemes/default.txt) for coloring maps, and disables all transparency processing (water, glass, leaves are solid)

*cave : this renders the 'cave view' - showing the boundaries between non-air and air below the ground, color coded from green to blue, based on depth

*stdtexture : this uses the standard Minecraft Texture pack (in texturepack/standard/) to color the maps

*stdtexture-nobiome : this uses the standard Minecraft Texture pack (in texturepack/standard/) to color the maps, but disables biome-based shading of grass and leaves

*topo : this creates a color-coded topographical map, based on altitude : oriented around 128 high generated worlds

*topo256 : this creates a color-coded topographical map, based on altitude : scaled to 256 high worlds

*topo-noplants : this creates a color-coded topographical map, based on altitude : oriented around 128 high generated worlds, with all normal plants and trees hidden

*topo256-noplants : this creates a color-coded topographical map, based on altitude : oriented around 256 high generated worlds, with all normal plants and trees hidden

====Predefined lightings====

The predefined lighting configuration, which can be found in lightings.txt, include the following:

*default : this is the default: no special processing, no shadows, full daylight

*shadows : this uses full daylight, with shadow and emitted light processing enabled

*night : this uses standard moon-light, with shadow and emitted light processing enabled

*brightnight : this uses an extra bright moon-light (which makes unlit terrain more visible), with shadow and emitted light processing enabled

*nightandday : this causes two sets of tiles to be rendered, one for daytime (corresponding to the shadows settings) and one for night (corresponding to the night settings), which will be automatically presented based on what the time of day is on the corresponding world

*brightnightandday : this is the same as nightandday, except the night tile set is rendered using the same settings as brightnight.

The choice of perspective has a VERY significant impact on both the ultimate size of the map rendered, and the quality of the rendered map. Specifically, the -scale- will radically impact this: as each block on a map will be shown with more pixels, the number of tiles needed to render will go up as the -scale- goes up. lowres maps will involve about 4x as many tiles as a KzedMap (since its about 2x the resolution horizontally and vertically - 2 x 2 = 4). medres is twice the resolution, so another 4x the number of tiles (or 16x from Kzed), hires is twice the resolution again - so 64x the KzedMap tile population! -hires- maps look VERY nice, but be prepared for the initial -fullrender- of the map to take some time (hours to a day or more for larger maps). Low view angles (the 30 degree angle) results in fewer tiles that take a bit more processing to render (a low view angle means more chunks of map needed to render a given tile - as the view cuts more -across- the map than a more vertical view does). Other settings - -shader- and -lighting- have little to no impact on map size, and very small impacts on render time.

====Customizing perspectives, shaders, and lightings====

For details on defining custom perspectives, shaders or lightings, see the following pages:

[https://github.com/webbukkit/dynmap/wiki/Defining-custom-perspectives/ Defining Custom Perspectives]

[https://github.com/webbukkit/dynmap/wiki/Defining-custom-shaders/ Defining Custom Shaders]

[https://github.com/webbukkit/dynmap/wiki/Defining-custom-lightings/ Defining Custom Lightings]

Once a custom perspective, shader or lighting is defined, maps can use them by name, the same as any of the predefined configurations.

====Additional HDMap Settings====

HDMaps support a number of additional, optional settings, that allow more control of how the map is presented and used by the user. These settings include:

*title : this setting controls the presentation label on the web interface for the map.

*icon : this setting allows control of the URI of the image file used for the map icon on the web interface. If not defined, the value used is images/block_name.png.

*background : this setting provides a color value for the background on the map. Color values are formatted as typical for CSS styles: #rrggbb. If undefined, the background is black (#000000).

*backgroundday : this setting provides a color value for the background of the map during daytime - it overrides the background setting, if defined, when daytime maps are shown. Formatting is CSS style: #rrggbb. Only applicable to night-and-day type maps.

*backgroundnight : this setting provides a color value for the background of the map during nighttime - it overrides the background setting, if defined, when nighttime maps are shown. Formatting is CSS style: #rrggbb. Only applicable to night-and-day type maps.

*mapzoomin : this setting controls the number of zoom-in steps offered for the map beyond the 'native' resolution of the map. These zoom levels stretch the map without showing more map data - the same pixels are shown larger (2x bigger for one step, 4x for two steps, 8x for three steps, etc). By default, the value is 2 (allowing 2 extra zoom ins, corresponding to 2x and 4x).

*image-format : this setting controls the format of the tiles generated for the map. The default is PNG, which is a lossless compression format that maximizes quality, but can yield large files that use significant bandwidth. JPG is a lossy compression option that can trade quality for file size. At very high quality levels, JPG will still tend to be significantly smaller than PNG - 2x is common - with little loss of quality. Lower quality levels can still yield very good map quality and MUCH lower file sizes (6x-10x). The supported values are:

**png : lossless (but potentially big) PNG (this is the default)
**jpg : good quality JPG (85% quality) - same as jpg-q85
**jpg-q75 : fair quality JPG (75% quality)
**jpg-q80 : fair quality JPG (80% quality)
**jpg-q85 : good quality JPG (85% quality)
**jpg-q90 : good quality JPG (90% quality)
**jpg-q95 : very good quality JPG (95% quality)
**jpg-q100 : very good quality JPG (100% quality)

Note: As JPEG does not support transparency, the background color for the tiles is rendered into the tiles (particularly for pixels that pass through the scene to the background). If the backgroundday or backgroundnight colors are changed, all tiles will need to be rerendered. Also, if the day and night colors are not the same, a night-and-day enabled lighting option (e.g. the nightandday or brightnightandday lightings) must be used to generate the two tile sets needed (each with the corresponding night and day backgrounds).

===对基于MinecraftForge的mod的支持===

The following specific mods are supported, although some older versions may not function, and some blocks in current versions may not yet be supported:

*Advanced Machines for IC2
*Advanced Power Management for IC2
*Advanced Solar Panels for IC2
*BetterWorlds
*BuildCraft
*Charging Bench for IC2
*Compact Solars for IC2
*ComputerCraft
*Equivalent Exchange 2
*Ender Storage
*ExtraBees
*Extrabiomes XL (v2.x and v3.x)
*Extrabiomes - Bunyan
*Forestry (updated in 1.4)
*Forgotten Nature
*Greg's Lighting
*IndustrialCraft 2
*Iron Chest
*LC Trees++
*Millenaire
*MystCraft
*Metallurgy 2
*NetherOres
*RailCraft
*Red Power 2
*SuperSlopes
*TerraFirmaCraft
*ThaumCraft
*Thermal Expansion
*Tubestuff
*Twilight Forest
*XyCraft

===基于CraftBukkit外其他服务端的支持===

Dynmap不仅仅只支持CraftBukkit. 有关最新可用版本都可以在这里找到.以下有现在主要支持的三个平台:

*Bukkit Dynmap (https://github.com/webbukkit/dynmap/)
*DynmapForge (https://github.com/webbukkit/DynmapForge/)
*DynmapSpout (https://github.com/webbukkit/DynmapSpout/)

====Spigot====

Spigot完全支持Bukkit版Dynmap.

====MinecraftForge====

Various version of MinecraftForge are supported, via the DynmapForge project. As with all Forge mods, each supported version requires its own binary, and upgrading Forge to a new version will require upgrading to the appropriate version of the DynmapForge mod. In both the case of upgrades and initial installation, the following procedure used for installation:

*Download the corresponding ZIP file, appropriate for the MC version.
*Unzip the ENTIRE ZIP file, including all subdirectories, into the base directory of the server (NOT the mods directory).
*If upgrading, delete the older 'Dynmap-x.y.zip' from the 'mods' directory.

====MCPC+====
Current versions of MCPC+ (v1.4.7 or later) are ONLY supported via the DynmapForge mods for the corresponding Forge version. The CraftBukkit version is NOT supported. To install, follow the above procedure. In order to support compatibility with Bukkit-based mods that use the API for the Bukkit-based Dynmap, you can download and install the DynmapCBBridge mod (found here. This is a Bukkit plugin, so must be installed in the 'plugins' directory, and is ONLY supported on Forge-based servers that also provide Bukkit compatibility (MCPC+ and BukkitForge).

====BukkitForge====

The BukkitForge mod, which is a Forge-based mod that adds Bukkit API compatibility to a Forge server, is NOT supported by the Bukkit version of Dynmap. It IS supported via the DynmapForge deliverable, and can provide API compatibility to other Bukkit-based plugins that use the Dynmap API by installing the DynmapCBBridge plugin. Installation procedures are the same as for MCPC+, above.

====Tekkit Classic====

Tekkit Classic, and the older MCPC (no plus - for v1.2.5), were supported via the Bukkit version of Dynmap. These should continue to function using version of the Bukkit Dynmap that continue to support v1.2.5.

====Tekkit-Lite====

Tekkit-Lite is supported via DynmapForge, not Bukkit Dynmap. Follow all procedures appropriate for Forge.

====Spout====

The Spout server is supported in a development mode via the DynmapSpout project (the ongoing refactoring of Spout has made proper production support impractical so far). Installation on Spout is the same procedure as used for Bukkit (unzip into the plugins directory). Note: This is for Spout (the server), not SpoutPlugin (the Bukkit plugin). SpoutPlugin is supported via the Bukkit Dynmap.

====Moving a Bukkit Dynmap installation to a Forge Dynmap installation====

To migrate an existing Bukkit configuration to a Forge server (including MCPC+ or BukkitForge), do the following:

*Move the /plugins/dynmap directory (and all its contents and subdirectories) to /dynmap on the Forge server
*Edit configuration.txt: replace the lines for 'render-triggers' with the following:
render-triggers:
- blockupdate
#- blockupdate-with-id
#- lightingupdate
- chunkpopulate
- chunkgenerate
#- none
*Delete /plugins/dynmap.jar
*Follow the installation procedure, above, for installing/upgrading the appropriate Forge version

==[https://github.com/webbukkit/dynmap/wiki/Commands/ 命令]==

{{Hide|标题=命令列表 |内容=
Hiding and showing players 

/dynmap hide: Hides the player from the map. 
/dynmap hide thedude: Hides the player thedude from the map. 
/dynmap show: Shows the player on the map again. 
/dynmap show thedude: Shows the player thedude on the map again. 
Rendering

/dynmap render: renders one tile of the map where you are standing. 
/dynmap fullrender: Attempts to render all maps of the entire world from your location (or from the center of that world, if issued from the server console). 
/dynmap fullrender world: Attempts to render all maps of the world named world from the center of that world. 
/dynmap fullrender world:surface: Attempts to render the map named surface for the world named world from the center of that world. 
/dynmap radiusrender radius: attempts to render at least a radius block area, centered on your current location. 
/dynmap radiusrender radius mapname: attempts to render at least a radius block area, centered on your current location of map 'mapname' 
/dynmap radiusrender world x z radius: attempts to render at least a radius block area, centered on 'x,64,z' on world 'world'. 
/dynmap updaterender: attempts to render tiles needing updating, starting at current location, for all maps. Stops at edge of map and at tiles that don't need updating. 
/dynmap updaterender mapname: attempts to render tiles needing updating, starting at current location, for given map. Stops at edge of map and at tiles that don't need updating. 
/dynmap updaterender world x z: attempts to render tiles needing updating, starting at given location on given world, for all maps. Stops at edge of map and at tiles that don't need updating. 
/dynmap updaterender world x z mapname: attempts to render tiles needing updating, starting at given location on given world, for given map. Stops at edge of map and at tiles that don't need updating. 
/dynmap cancelrender world: cancels any active fullrender or radiusrender on the given world. 
/dynmap purgequeue: clears the tile update queue 
/dynmap purgeworld world: purge all the map files for world 'world' 
/dynmap purgemap world map: purge all the map files for map 'map' on world 'world' 
/dynmap pause all: pause all map rendering (updates and full/radius renders) 
/dynmap pause none: resume all map rendering 
Statistics 
 
/dynmap stats: shows rendering statistics for all maps on all worlds. 
/dynmap stats world : shows rendering statistics for maps on world world. 
/dynmap triggerstats : shows triggered render statistics for all worlds. 
/dynmap resetstats : resets rendering statistics for all maps on all worlds. 
/dynmap resetstats world : resets rendering statistics for maps on world world. 
Markers 
 
These commands are only available if the Markers Component has been enabled (v0.22 or later required). 
 
/dmarker add <label> icon:<icon> set:<set-id> : adds a new marker at the player's current location, with a given label and optional icon and optional marker set 
/dmarker add id:<id> <label> icon:<icon> set:<set-id> : adds a new marker at the player's current location, with the given ID, the given label and optional icon and optional marker set 
/dmarker add id:<id> <label> icon:<icon> set:<set-id> x:<x-coord> y:<y-coord> z:<z-coord> world:<Worldname> : adds a new marker at the given location, with the given ID, the given label and optional icon and optional marker set 
/dmarker movehere <label> : updates the location of the first marker matching the given label to match the current player's position 
/dmarker movehere id:<id> : updates the location of the marker with the given ID to match the current player's position 
/dmarker update <label> icon:<newicon> newlabel:<newlabel> : updates the icon and/or label of the first marker matching the given label 
/dmarker update id:<id> icon:<newicon> newlabel:<newlabel> : updates the icon and/or label of the marker with the given ID 
/dmarker delete <label> : deletes the first marker matching the given label 
/dmarker delete id:<id> : deletes the marker with the given ID 
/dmarker list : lists the attributes of all the defined markers in the default marker set 
/dmarker list set:<set-id> : lists the attributes of all the defined markers in the given marker set 
/dmarker icons : lists the attributes of all the icons defined for use by markers 
/dmarker addset <label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : add new marker set with given label (ID = label) 
/dmarker addset id:<id> <label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : add new marker set with given ID and label 
/dmarker updateset <label> newlabel:<new-label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : update marker set with given label (ID = label) 
/dmarker updateset id:<id> newlabel:<new-label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : update marker set with given ID 
/dmarker deleteset <label> : delete marker set with given label 
/dmarker deleteset id:<id> : delete marker set with given ID 
/dmarker listsets : list all markers 
/dmarker addicon id:<id> <label> file:"filename" : Install new icon, with given ID and label, and using given file (path is handled relative to MC server directory, and file contents are copied). 
/dmarker updateicon id:<id> newlabel:<label> file:"filename" : Update icon, replacing existing settings with provided new values. 
/dmarker deleteicon id:<id> : delete icon with given ID 
/dmarker addcorner : add corner to corner list using current location 
/dmarker addcorner <x> <z> <world> : add corner with given x and z coordinate on given world to corner list 
/dmarker clearcorners : clear corner list 
/dmarker addarea <label> : add new area with given label using corner list 
/dmarker addarea id:<id> <label> : add new area with given ID using corner list 
/dmarker deletearea <label> : delete area with given label 
/dmarker deletearea id:<id> <label> : delete area with given ID 
/dmarker listareas : list details of all areas 
/dmarker updatearea <label> <arg>:<value> ... : update attributes of area with given label 
/dmarker updatearea id:<id> <arg>:<value> ... : update attributes of area with given ID 
/dmarker addline <label> : add new line with given label using corner list 
/dmarker addline id:<id> <label> : add new line with given ID using corner list 
/dmarker deleteline <label> : delete line with given label 
/dmarker deleteline id:<id> <label> : delete line with given ID 
/dmarker listlines : list details of all lines 
/dmarker updateline <label> <arg>:<value> ... : update attributes of line with given label 
/dmarker updateline id:<id> <arg>:<value> ... : update attributes of line with given ID 
Map/World Configuration Commands 
 
/dmap worldlist : list all worlds configured (enabled or disabled) 
/dmap worldset worldname enabled:<true|false> : Set world 'worldname' enabled or disabled 
/dmap worldset worldname center:<x/y/z|here|default> : Set map center position for world 'worldname' 
/dmap worldset worldname extrazoomout:<N> : set extra zoom out levels for world 'worldname' 
/dmap worldset worldname title:<label> : set title for world 'worldname' 
/dmap worldset worldname sendposition:<true|false> sendhealth:<true|false> : set send-position and/or send-health flags for world 'worldname' 
/dmap worldset worldname order:<N> : set position of world 'worldname' to Nth position in world list 
/dmap worldreset worldname : Reset world 'worldname' to its default template configuration 
/dmap worldreset worldname templatename : Reset world 'worldname' to template 'templatename' configuration 
/dmap maplist worldname : List details of all maps for world 'worldname' 
/dmap mapdelete worldname:mapname : Delete map 'mapname' of world 'worldname' 
/dmap mapadd worldname:mapname attrib:val attrib:val : Create new map 'mapname' on world 'worldname', with given attributes (all 'mapset' parameters are usable) 
/dmap mapset worldname:mapname order:<N> : Set position of map 'mapname' to Nth in the list of maps for world 'worldname' 
/dmap mapset worldname:mapname prefix:<prefix> : Set filename prefix for map 'mapname' of world 'worldname' 
/dmap mapset worldname:mapname title:<label> : Set title for map 'mapname' of world 'worldname' 
/dmap mapset worldname:mapname icon:<icon-file> : Set icon filename for map 'mapname' of world 'worldname' (relative to 'webpath' directory) 
/dmap mapset worldname:mapname mapzoomin:<N> : Set the map zoom in level for map 'mapname' of world 'worldname' 
/dmap mapset worldname:mapname perspective:<perspective> shader:<shader> lighting:<lighting> : Set perspective, shader and/or lighting for map 'mapname' of world 'worldname' 
/dmap mapset worldname:mapname img-format:<format> : Set the image format for map 'mapname' of world 'worldname' (png, jpg, jpg-q90, jpq-q95, etc). 
/dmap perspectivelist : List all defined perspectives 
/dmap shaderlist : List all defined shaders 
/dmap lightinglist : List all defined lightings 
Miscellaneous 
 
Various other commands. 
 
/dynmap sendtoweb message ... : Send a message to the web UIs only 
/dynmap ids-for-ip ip-address : List player IDs that have logged in from given IP address (most recent to least) 
/dynmap ips-for-id player-id : List IP addresses that have been used to connect to server by given player ID 
/dynmap add-id-for-ip player-id ip-address : Add given player ID to front of list of known IDs for given IP address 
/dynmap del-id-for-ip player-id ip-address : Remove given player ID from list of known IDs for given IP address. 
/dynmap webregister : Start registration of own account for login on web interface 
/dynmap webregister player-id : Start registration of another user's account for login on web interface 
}}

===用dmap配置地图和世界===

As of v0.31, dynmap provides the option of configuring many of the features of maps and worlds using console commands issued by a user with operator privileges or via the server console. When any of the editing commands are used, the existing configuration will be transferred into the 'worlds.txt' file (whether or not the existing maps were based on worlds.txt or on the default templates). New worlds will still be initialized using templates, but once the configuration has been migrated to 'worlds.txt', further updates to the templates will not automatically be reflected to the existing worlds. Also, all map editing commands are limited to HDMap maps - legacy KzedMap and FlatMap maps cannot be edited using /dmap commands.

To start, the /dmap editing commands (all the commands besides the /dmap worldlist, /dmap maplist, /dmap perspectivelist, /dmap shaderlist, or /dmap lightinglist commands) cannot be used while map rendering is active. So, to start, the operator must issue the '/dynmap pause all' command. This will suspend all fullrender and update render processing - DO NOT FORGET TO UNPAUSE PROCESSING WHEN DONE, USING '/dynmap pause none`. FAILING TO UNPAUSE WILL PREVENT PROCESSING, AND RESULT IN A GROWING BACKLOG OF PROCESSING, WITH THE ASSOCIATED MEMORY USE.

Once rendering is paused, the /dmap commands can be used to add, remove, reorder, or modify existing map definitions. The order and many of the settings for the list of worlds can also be controlled. The following are a sample of the sorts of actions that can be done:

*To disable/hide a world: /dmap worldset _worldname_ enabled:false

*To reset a world's settings and maps to its default template: /dmap worldreset _worldname_

*To reset a world's settings and maps to a specific template (replacing all existing maps): /dmap worldreset _worldname_ _templatename_

*To make a world first in the list of worlds: /dmap worldset _worldname_ order:1

*To set the title of a world: /dmap worldset _worldname_ title:_"title string"_

*To hide the reporting of player positions and health on a world: /dmap worldset _worldname_ sendposition:false sendhealth:false

*To set the default center position of a world to the player's current location: /dmap worldset _worldname_ center:here

*To set the default center position of a world to a given location: /dmap worldset _worldname_ center:_X_/_Y_/_Z_

*To set the number of extra zoom out levels of a world to N: /dmap worldset _worldname_ extrazoomout:_N_

*To list the maps for a given world: /dmap maplist _worldname_

*To delete a map from a given world: /map mapdelete _worldname_:_mapname_

*To add a new map to a given world (with a given title, perspective, shader, and lighting): /dmap mapadd _worldname_:_mapname_ title:_"map-title"_ perspective:_perspective-id_ shader:_shader-id_ lighting:_lighting-id_

*To edit the order/position of a map in the list of maps for a world to be Nth: /dmap mapset _worldname_:_mapname_ order:_N_

*To edit the title of a map: /dmap mapset _worldname_:_mapname_ title:_"new-title"_

*To change the perspective of a map (new scale, new point of view): /dmap mapset _worldname_:_mapname_ perspective:_perspective-id_

*To change the filename prefix of a map: /dmap mapset _worldname_:_mapname_ prefix:_prefix_

*To set the icon file for a map (relative path under 'webpath' - e.g. images/block_skylands.png) : /dmap mapset _worldname_:_mapname_ icon:images/block_skylands.png

*To set the map zoom in level for a map to N: /dmap mapset _worldname_:_mapname_ mapzoomin:_N_

*To change the image format used for a map to JPG: /dmap mapset _worldname_:_mapname_ img-format:jpg

*To change the default cave map to use the new 'textured cave view': /dmap mapset _worldname_:_mapname_ shader:stdtexture-cave

*To list the available perspectives: /dmap perspectivelist

*To list the availale shaders: /dmap shaderlist

*To list the available lightings: /dmap lighinglist

*To set a map to appear on the same line as maps of another world: /dmap mapset _worldname_:_mapname_ append-to-world:_another_worldname_

Note: any attributes settable using 'mapset' can also be set on a new map using 'mapadd'.

As with other map edits, many of these changes will require the modified map to be re-rendered to fully implement the changes.

Once all map edits are completed, remember to run '/dynmap pause none` to resume normal render processing.

==[https://github.com/webbukkit/dynmap/wiki/Permissions/ 权限]==

{{Hide|标题=权限列表 |内容=
SuperPerms-based access control, including specific support for PermissionsEx, BukkitPermissions, bPermissions, and classic Permissions. The following nodes are defined: 
dynmap.render - allows /dynmap render command 
dynmap.show.self - allows /dynmap show (on self) 
dynmap.show.others - allows /dynmap show 
dynmap.hide.self - allows /dynmap hide (on self) 
dynmap.hide.others - allows /dynmap hide 
dynmap.fullrender - allows /dynmap fullrender or /dynmap fullrender 
dynmap.radiusrender - allows /dynmap radiusrender 
dynmap.updaterender - allows /dynmap updaterender 
dynmap.cancelrender - allows /dynmap cancelrender 
dynmap.pause - allows /dynmap pause 
dynmap.reload - allows /dynmap reload 
dynmap.stats - allows /dynmap stats or /dynmap stats or /dynmap triggerstats 
dynmap.resetstats - allows /dynmap resetstats or /dynmap resetstats 
dynmap.sendtoweb - allows /dynmap sendtoweb 
dynmap.purgequeue - allows /dynmap purgequeue 
dynmap.ids-for-ip - allows /dynmap ids-for-ip 
dynmap.ips-for-id - allows /dynmap ips-for-id 
dynmap.add-id-for-ip - allows /dynmap add-id-for-ip 
dynmap.del-id-for-ip - allows /dynmap del-id-for-ip 
dynmap.marker.add - allows /dmarker add 
dynmap.marker.movehere - allows /dmarker movehere 
dynmap.marker.update - allows /dmarker update 
dynmap.marker.delete - allows /dmarker delete 
dynmap.marker.list - allows /dmarker list 
dynmap.marker.icons - allows /dmarker icons 
dynmap.marker.addset - allows /dmarker addset 
dynmap.marker.updateset - allows /dmarker updateset 
dynmap.marker.deleteset - allows /dmarker deleteset 
dynmap.marker.listsets - allows /dmarker listsets 
dynmap.marker.addicon - allows /dmarker addicon 
dynmap.marker.updateicon - allows /dmarker updateicon 
dynmap.marker.deleteicon - allows /dmarker deleteicon 
dynmap.marker.addarea - allows /dmarker addarea 
dynmap.marker.updatearea - allows /dmarker updatearea 
dynmap.marker.deletearea - allows /dmarker deletearea 
dynmap.marker.listareas - allows /dmarker listareas 
dynmap.marker.addline - allows /dmarker addline 
dynmap.marker.updateline - allows /dmarker updateline 
dynmap.marker.deleteline - allows /dmarker deleteline 
dynmap.marker.listlines - allows /dmarker listlines 
dynmap.dmap.worldlist - allows /dmap worldlist 
dynmap.dmap.worldset - allows /dmap worldset 
dynmap.dmap.worldreset - allows /dmap worldreset 
dynmap.dmap.mapdelete - allows /dmap mapdelete 
dynmap.dmap.mapset - allows /dmap mapset 
dynmap.dmap.mapadd - allows /dmap mapadd 
dynmap.dmap.perspectivelist - allows /dmap perspectivelist 
dynmap.dmap.shaderlist - allows /dmap shaderlist 
dynmap.dmap.lightinglist - allows /dmap lightinglist 
dynmap.webregister - allows /dynmap webregister 
dynmap.webregister.other - allows /dynmap webregister player-id 
dynmap.webchat - allows sending of chat messages from web interface (login or id-by-ip required) 
dynmap.playermarkers.showall - allows user to see all player positions when protected-player-info has been set to restrict access 
dynmap.world.<world-name> - allows user to see maps on world if that world has been set to protected. 
dynmap.map.<world-name>.<map-name> - allows user to see specific map on specific world , if that map has been set to be protected. 
}}

===网页UI登陆支持和权限===

Dynmap offers the option of limiting the availability of the information that can be access through the web user interface. To enable login support, the following setting must be configured in configuration.txt:

login-enabled: true
Once enabled, user accounts can be registered. Registration can be done by users themselves (using the /dynmap webregister command), if the users have the dynmap.webregister permissions. Alternately, registration can be done by administrators on behalf of users using the /dynmap webregister <userid> (which requires the dynmap.webregister.other permission). In either case, the user is supplied with a passcode, which can then be used on the web interface login panel to create a web user account.

Once defined, the web user account will use the permissions associated with the Minecraft user account to control access through the web interface.

If desired, the web interface can be restricted to only logged in users. To do this, set the setting:

login-required: true
Otherwise, guest access to the interface is permitted - which will only allow access to unprotected features.

====Web Interface Restriction Options====

=====World Protection=====

If the operator wants to restrict access to all map data on a specific world, this can be done by setting the 'protected' attribute on the world in worlds.txt (or, equivalently, by setting it using the command /dmap worldset <world-id> protected:true). Once set, only logged in users that also have the permission dynmap.world.<world-id> will be able to see any of the maps for the world .

=====Map Protection=====

If the operator wants to restrict access to specific maps on specific worlds, this can be done by setting the 'protected' attribute on the map in worlds.txt (or, equivalently, by setting it using the command /dmap mapset <world-id>:<map-id> protected:true). Once set, only logged in users that also have the permissions dynmap.map.<world-id>.<map-id> will be able to see the protected map. Note: if the map and the world are both protected, both permissions are needed.

=====Chat Protection=====

If the operator wants to restrict access for sending messages from the web interface, this can be done by setting the 'webchat-permissions' setting on the ClientUpdateComponent. Once set to 'true', only logged in users that have the dynmap.webchat permission are allowed to send chat messages from the web interface.

=====Player Positions and Information=====

If the operator wants to restrict visibility of the position and status of players, this can be done by setting the 'protected-player-info' setting on the ClientUpdateComponent. Once set to 'true', only logged in users that have the dynmap.playermarkers.seeall permission will be able to see the position and/or health information of all visible players. Logged-in players without the permission will only see their own position, while guests will see no players.

==网页UI参数==

The URL used to launch the web user interface supports a number of parameters, which may be used to override the default view presented to the user. This can be used to launch the UI with a given world or map selected, a given zoom level selected, and/or have the map centered on a given set of world coordinates.

The parameters are provided as a sequence of attribute-value pairs, with each parameter formatted as follows:

attribute-id=value

The base URL must have a question-mark (?) before the first parameter, and each additional parameter must be separated from the previous one by an ampersand (&). So, if the default URL for the map web is:

http://mygreatserver:8123/

then, launching the site with the world named 'fred' selected, and with the map 'surface' being shown, would be formatted as:

http://mygreatserver:8123/?worldname=fred&mapname=surface

If you're using an external server, the same format applies - add '?' and the corresponding parameters, seperated by ampersands:

http://mycoolapacheserver.com/dynmap?worldname=fred&mapname=surface

The parameters available are as follows:

* worldname - this specifies the name (not the title) of the world to be selected. If not provided, the first world defined will be shown (unless defaultworld has been set in configuration.txt, in which case that world is shown).

* mapname - this specifies the name (not the title) of the map to be selected. If not provided, the first map for the selected world is shown (unless defaultmap has been set in configuration.txt, in which case that map is shown).

* zoom - this specifies the zoom level to be selected (0 = highest zoom out). If not provided, a zoom level of zero is used (unless defaultzoom has been set in the configuration.txt).

* x - this specifies the X coordinate (in the coordinate system of the world being shown) of the center point of the map view. If not specified, this defaults to the value of the x attribute of the center attribute of the selected world (typically 0).

* y - this specifies the Y coordinate (in the coordinate system of the world being shown) of the center point of the map view. If not specified, this defaults to the value of the y attribute of the center attribute of the selected world (typically 64).

* z - this specifies the Z coordinate (in the coordinate system of the world being shown) of the center point of the map view. If not specified, this defaults to the value of the z attribute of the center attribute of the selected world (typically 0).

* nopanel - if defined and set to 'true', the sidebar menu on the map will be removed

* chatname - if defined and set to a string, the web UI will pass this value as the suggested name of the sender for any chat messages. This will only be accepted by the internal web server if the 'trustclientname' setting has been set to true, in addition to the 'allowurlname' parameter for the 'chat' component. Supported on 0.28 and later.

* playername - if defined and set to a player's account name, the web UI will initialize following the position of the given player, if the are online when the UI starts, or come online sometime after.

* hidechat - if defined and set to 'true', the web UI will disable all chat input and output components (balloons, input fields, and chat box).

* nogui - if defined and set to 'true', the web UI will disable ALL controls, panels and the like, just presenting the map layer itself.

* nocompass - if defined and set to 'true', the compass rose on the UI will be hidden (v2.2-alpha-1)

==使用标记==

Dynmap supports mechanisms for adding content to maps, above what is rendered by the maps. This content is collectively referred to as Markers, and consist of markers (marker icons), marker areas, and marker poly-lines.

===Marker Sets===

Markers are collected and organized as collections, referred to as Marker Sets. Each Marker Set is a labelled layer, selectable using the web UIs layer selector. Every marker is contained within a specific marker set. By default, there is always at least one marker set, labelled Markers, that will be used to contain any markers that are not specifically assigned to another marker set. Deleting a marker set will delete all markers within the set.

New marker sets can be created using the /dmarker addset <markerset-label> or /dmarker addset id:<markerset-id> commands. Additional parameters can be used to refine the set's behavior: prio:<N> is used to control the order of the layer in the layer control, relative to other sets; hide:<true|false> is used to control whether the set is visible (checked) or hidden (unchecked) by default; 'minzoom:` is used to make the markers in the set hidden until a specific zoom level is selected.

Settings on existing marker sets can be altered using the /dmarker updateset <markerset-label> or /dmarker updateset id:<markerset-id> commands, with prio:<N>, hide:<true|false> or newlabel:<new-label> as parameters.

As of 0.32, the setting 'showlabels:` is supported. This setting, when true or false, enables or disables the visibility of marker labels (disabled visibility causes labels to only show when the mouse cursor is hovering over the marker). The value null uses the global default behavior (defined by the showlabels setting in the markers component in configuration.txt.

Marker sets (except for the default marker set, Markers) can be deleted using the /dmarker deleteset <markerset-label> or /dmarker deleteset id:<markerset-id> commands.

===Marker===

Markers are the most common map markers - simple icons with an associated label and/or an associated description popup. Each marker has a defined location in world coordinates (X, Y, Z and a world ID), a marker icon ID, a label, and an optional description. The marker icon ID can be one of the standard marker IDs (shown at the bottom of this page), or can correspond to an installed icon (see Marker Icons section, below).

Markers can be added one of a couple of ways:

* /dmarker add <marker-label> icon:<icon-id> set:<markerset-id> - this must be issued by a logged-in player, and will cause a marker to be defined at the player's current location. If set is not provided, the marker will be created in the default marker set, Markers. If icon is not defined, the default marker icon is used (default, a house).

* /dmarker add id:<marker-id> <marker-label> icon:<icon-id< set:<markerset-id> - Same as above, except that the unique ID of the marker is specified.

* Using a sign: If the enablesigns setting on the markers component is true, users with the appropriate privilege (dynmap.marker.sign) can create markers using specially labelled signs. To use these, the first line of the sign MUST be [dynmap]. After that, any non-blank line will be included in the label of the marker, except for lines formatted as set:<markerset-id> (which allows the marker to be added to a specific marker set) or icon:<icon-id> (which allows the marker to be set to use a specific icon - if not specified, the icon sign is used). If the marker is successfully created, the sign's text will erase the [dynmap], set: and icon: lines. If the sign is later deleted, the corresponding map marker is deleted.

Once created, markers can be edited using one of a couple of commands:

* /dmarker movehere <marker-label> set:<markerset-id> or /dmarker movehere id:<marker-id> set:<markerset-id>: This will move the existing marker to the player's current location. Note: the markerset-id is required to select a marker not in the default marker set (markers).

* /dmarker update <marker-label> set:<markerset-id> icon:<icon-id> newlabel:<new-label> or /dmarker update id:<marker-id> set:<markerset-id> icon:<icon-id> newlabel:<new-label>. Note: the markerset-id is required to select a marker not in the default marker set (markers) - the marker set ID is not editable.

Markers can be deleted using the /dmarker delete <marker-label> set:<markerset-id> or /dmarker delete id:<marker-id> set:<markerset-id> command.

Existing markers, and their attributes, can be shown using the /dmarker list set:<markerset-id> command.

===Marker Icons===

Marker Icons are image resources used to provide the images for markers. Dynmap supplies a number of standard marker icons, shown below, that are always present and defined, and are not deletable. The list of availabile icons can be found by running the /dmarker icons command.

New marker icons can be installed by doing the following:

* Copy the image file, in PNG format, to the bukkit server's file system. The image in the file should be 8x8, 16x16 or 32x32 pixels in size.

* Run the command /dmarker addicon id:<icon-id> <icon-label> file:<path-to-image-file> - if successful, the image file will be imported (so it doesn't need to be left where it was first copied).

To update the image for an existing icon, run the /dmarker updateicon id:<icon-id> newlabel:<new-label> file:<path-to-image-file>.

To delete an existing image, run the /dmarker deleteicon id:<icon-id>.

[[文件:Build_in_mark_icons.png]]

===Area Markers===

Area markers are used to place 2-D or 3-D outlines on the world maps. The area defined by an area marker is defined by a sequence of 2 or more X,Z coordinates, defining a rectangle (if 2 points, they are opposite corners of the rectangle) or a polygon (if 3 or more points, they define the ordered sequence of points for the polygon, with the last point connecting to the first). Optionally, the minimum and maximum Y coordinates can be supplied, to extend the 2-D shape into a 3-D volume (flat on the top and bottom).

The appearance of the edges of the outline can be controlled by setting the color attribute (#RRGGBB), line weight (0-N), and opacity (0.0-1.0). The appearance of the filled area within the outlines can be controled by setting the fill color attribute (#RRGGBB), and fill opacity (0.0-1.0).

To create an area, a list of corners needs to be supplied. Corners can be entered as follows:

*Running /dmarker addcorner to add the player's current position as a corner.

*Running /dmarker addcorner <x> <y> <z> or /dmarker addcorner <x> <y> <z> <world> to add a specific coordinate as a corner.

If needed, the corner list can be reset using the /dmarker clearcorners.

Once all the corners are entered, an area marker can be created using the /dmarker addarea <area-label> set:<markerset-id> or /dmarker addarea id:<area-id> <area-label> set:<markerset-id> commands. Additional attributes can be set with these commands, or later updated using the /dmarker updatearea id:<area-id> set:<markerset-id> or /dmarker updatearea <area-label> set:<markerset-id> command. These settings include:

*color - outline color (#RRGGBB format)

*fillcolor - fill color (within the outlines) (#RRGGBB format)

*'opacity` - Opacity of the outline strokes (0.0 = transparent, 1.0 = solid)

*'fillopacity` - Opacity of the filled color areas (0.0 = transparent, 1.0 = solid)

*weight - Stroke weight of outline (0=minimum, higher=thicker)

*ytop - Y coordinate of the top of the area (default=64)

*ybottom - Y coordinate of the bottom of the area (default=64)

Note: The corners in an existing area cannot currently be updated - delete the existing area and add a new area to update these. Also, the corner list is reset after they are used to create a new area using the /dmarker addarea command.

To delete an area marker, use the /dmarker deletearea id:<area-id> set:<markerset-id> command.

Existing areas, and their attributes, can be shown using the /dmarker listareas set:<markerset-id> command.

===Circle Markers===

Circle markers are used to place 2-D circular (or elliptical) outlines on the world maps. The area defined by a circle marker is defined by a center point (x, y, z) and either a radius (for a circle, via radius setting) or an X vs Z radius (for an ellipse, via radiusx and radiusz setting).

The appearance of the edges of the outline can be controlled by setting the color attribute (#RRGGBB), line weight (0-N), and opacity (0.0-1.0). The appearance of the filled area within the outlines can be controled by setting the fill color attribute (#RRGGBB), and fill opacity (0.0-1.0).

A circle marker can be created using the /dmarker addcircle <circle-label> set:<markerset-id> or /dmarker addcircle id:<circle-id> <circle-label> set:<markerset-id> commands. Additional attributes can be set with these commands, or later updated using the /dmarker updatecircle id:<circle-id> set:<markerset-id> or /dmarker updatecircle <circle-label> set:<markerset-id> command. These settings include:

*x - X coordinate of center (default is current location of player issuing command)

*y - Y coordinate of center (default is current location of player issuing command)

*z - Z coordinate of center (default is current location of player issuing command)

*radius - radius of circle (default is 1)

*'radiusx' - radius of ellipse on X axis (default is 1)

*'radiusz' - radius of ellipse on Z axis (default is 1)

*world - world of center (default is current location of player issuing command)

*color - outline color (#RRGGBB format)

*fillcolor - fill color (within the outlines) (#RRGGBB format)

*'opacity` - Opacity of the outline strokes (0.0 = transparent, 1.0 = solid)

*'fillopacity` - Opacity of the filled color areas (0.0 = transparent, 1.0 = solid)

*weight - Stroke weight of outline (0=minimum, higher=thicker)

To delete a circle marker, use the /dmarker deletecircle id:<circle-id> set:<markerset-id> command.

Existing circles, and their attributes, can be shown using the /dmarker listcircles set:<markerset-id> command.

===Poly-Line Markers===

Poly-line markers are used to place a sequence of connected line segments on the world maps. Each poly-line marker is defined by a sequence of 1 or more X,Y,Z coordinates, along with a label, an optional description popup, and associated line color, weight, and opacity settings.

The appearance of the lines can be controlled by setting the color attribute (#RRGGBB), line weight (0-N), and opacity (0.0-1.0).

To create a poly-line, a list of corners needs to be supplied. Corners can be entered as follows:

*Running /dmarker addcorner to add the player's current position as a corner.

*Running /dmarker addcorner <x> <y> <z> or /dmarker addcorner <x> <y> <z> <world> to add a specific coordinate as a corner.

If needed, the corner list can be reset using the /dmarker clearcorners.

Once all the corners are entered, a poly-line marker can be created using the /dmarker addline <line-label> set:<markerset-id> or /dmarker addline id:<line-id> <line-label> set:<markerset-id> commands. Additional attributes can be set with these commands, or later updated using the /dmarker updateline id:<line-id> set:<markerset-id> or /dmarker updateline <line-label> set:<markerset-id> command. These settings include:

*color - outline color (#RRGGBB format)

*'opacity` - Opacity of the outline strokes (0.0 = transparent, 1.0 = solid)

*weight - Stroke weight of outline (0=minimum, higher=thicker)

Note: The corners in an existing poly-line cannot currently be updated - delete the existing poly-line and add a new poly-line to update these. Also, the corner list is reset after they are used to create a new poly-line using the /dmarker addline command.

To delete an existing poly-line, use the /dmarker deleteline id:<line-id> set:<markerset-id> command.

Existing lines, and their attributes, can be shown using the /dmarker listlines set:<markerset-id> command.

==自定义方块定义==

Dynmap supports a data-driven method for defining support for new Minecraft Blocks, which may be used to support customized block types, such as those provided via certain plugins and client modifications. These definitions are VERY sensitive to the internal implementation of the Dynmap ray tracer, and may change or become obsolete on future releases with little or no notice - when practical, this will be avoided, but do understand this before investing too heavily in this.

===How blocks are rendered===

The rendering of block in Dynmap is accomplished via a number of distinctive mechanisms, reflecting the needs of the different types of blocks defined by Minecraft and by its mods. In all cases, the rendering of a block consists of two core elements: a model defining the shape of the block to be rendered, and a set of textures used to apply color to the various surfaces of that shape. Thanks to the very 'blocky' nature of Minecraft, the majority of blocks are shaped like simple cubes: consequently, most blocks do not need a custom model, and can instead be assumed to be a simple solid cube.

Support files for custom blocks defined by add-on mods are provided through the definition of two files for each mod: one defining the texture mapping (following the naming convention '*-texture.txt', and placed in the 'renderdata' directory (or in a subdirectory under that directory)), and a second defining the models for blocks that are not simple cubes (following the naming convention '*-models.txt', and also placed in the 'renderdata' directory, or a subdirectory). For mods that have nothing but simple cubes, no *-models.txt file is required (as the model for any block without a model defined is assumed to be a simple cube).

===Creating Texture and Model Definition Files===

*For features common to both texture and model definitions files, see Common Features for Texture and Model Definition Files
*For details on the format of texture definition files, see Texture Definition Files
*For details on the format of model definition files, see Model Definition Files

===Defining Blocks===

*To define a simple, solid cube block, see Defining a Simple Block
*To define a cuboid block, see Defining a Cuboid Block
*To define a block based on a custom block renderer, see Defining a Block using a Custom Block Renderer
*To define a block based on a volumetric block model, see Defining a Block using a Volumetric Block Model

==用Wavefront OBJ格式传输世界数据==
As of v1.9.3, Dynmap has incorporated support for generating and exporting externally renderable files in Wavefront OBJ format. This feature, inspired by the standalone jmc-2-obj tool, allows operators within the server (or, optionally, from the server console) to select and export portions of their world data as model files that can then be imported into various tools that support Wavefront OBJ format - including Blender (a free, open source rendering and animation suite), Cinema 4D, Maya, 3D Studio Max, and others. These exported models can be render, using these packages, in ways that Dynmap does not support (including advanced lighting, reflections, and the like). As the OBJ output produced by Dynmap is very similar to that which mcobj or jmc-2-obj would produce, guides and wikis for importing and processing output from these tools are likely to be useful for Dynmap OBJ output.

The definition and execution of the export process is controlled using the new /dynmapexp command. This command allows setting of a number of attributes controlling the export:

*x0, y0, z0 : these are the minimum X, Y, and Z coordinates of the cuboid/rectangular prism to be exported
*x1, y1, z1 : these are the maximum X, Y, and Z coordinates of the cuboid/rectangular prism to be exported
*world : this is the name of the world to be exported from
*byChunk : if set to true, this causes the generation of an object for all the blocks in a given chunk
*byBlockID : if set to true, this causes the generation of an object for all the blocks of a given block ID
*byBlockIDData : if set to true, this causes the generation of an object for all the blocks of a given block ID and metadata value
*byTexture : if set to true, this causes the generation of an object for all the block faces using a given texture
*shader : This specifies the shader to be used as a source for the textures for the export. By default, 'stdtexture' is used. Only Texture Pack based shaders are currently supported.

The subcommands for the /dynmapexp command include:

*/dynmapexp set : this allows setting of the export attributes (above). Additional and pairs can be specified on the same command (e.g. /dynmapexp set x0 0 y0 0 z0 100)
*/dynmapexp radius : this command can only be used by a player in-game: it allows specifying of an export on the current world, with a radius of from the player's current position (in the X and Z axes), and from Y=0 to Y=255 vertically.
*/dynmapexp info : displays the current values of the export attributes
*/dynmapexp pos0 : this command can only be used by a player in-game: it sets the x0, y0, z0, and world attributes to the current position of the player.
*/dynmapexp pos1 : this command can only be used by a player in-game: it sets the x1, y1, z1, and world attributes to the current position of the player.
*/dynmapexp reset : resets the export attributes to their default
*/dynmapexp export : this initiates an export, creating a file named .zip in the export directory on the server (this defaults to a directory named 'export' under the dynmap directory, but can be changed using the 'exportpath' setting in configuration.txt). This process runs asynchronously, and can take from a few seconds to many minutes to complete, depending upon the size of the area selected for export.
*/dynmapexp purge : this deletes an previous export from from the export directory.

Once completed, an exported ZIP file will contain the following:

*A minecraft.obj file, containing the exported model (this can potentially be VERY big)
*A .mtl file, containing the material library (corresponding to the minecraft textures) used for coloring the model in minecraft.obj
*A directory, containing the texture files used by the material library
*To use the file, extract the ZIP file and load the 'minecraft.obj' file into the rendering tool.

=其他=

为了展示API，同时也为了协助管理这个已经非常庞大的补丁，我们已经开始了为Dynmap增加额外补丁的进程。所有这些工作都依赖于经由API的Dynmap和接口，只有对这些功能感兴趣的人们才会添加这些附加功能，这些功能有: 
 

dynmap-mobs: 在dynmap地图上提供指定生物的实时位置。

dynmap-residence: 继承 'regions' （地区）以支持Residence在Dynmap中的使用, 实时更新Residence的改变。

Dynmap-WorldGuard: 继承 'regions' （地区）以支持WorldGuard 在Dynmap中的使用, 实时更新WorldGuard的改变。

Dynmap-Towny: 继承 'regions' （地区）以支持Towny在Dynmap中的使用, 实时更新Towny的改变。

Dynmap-Factions: 继承 'regions' （地区）以支持Factions在Dynmap中的使用, 实时更新Factions的改变。

Dynmap-CommandBook: 使用CommandBook，添加对显示/home和/warp 位置的支持。

Dynmap-Essentials: 使用Essentials，添加对显示/home和/warp 位置的支持。

Dynmap-GriefPrevention: 添加对显示Grief Protection claims（保护占领）的支持。

Dynmap2CraftIRC3: 通过CraftIRC，将Dynmap的网页聊天与IRC相结合。

Dynmap-SimpleClans: Dynmap的网页聊天与SimpleClans 相结合。

Dynmap-HeroChat: 结合Herochat v5.5+ 与Dynmap。

Dynmap-PhysicalShop

Dynmap-pyLandmarks

Dynmap-PreciousStones: 结合PreciousStones 与Dynmap。

Dynmap-AdminCmd: 结合AdminCmd与Dynmap。

Dynmap-PlayerWarp

Dynmap-Citizens: 结合Citizens与Dynmap。

=开发者相关=

Dynmap 插件由多个部件组成，用于支持多平台服务器，同时为了让我们的“已发布API”能被更好的理解。组成dynmap插件的必须部件（用于Bukkit的Dynmap 补丁）在下文列出：

DynmapCoreAPI - 这是用于Dynmap的 neutral API 平台: 插件开发者能以此作为 Dynmap与任何平台的接口（通过指向dynmap 补丁实例 org.dynmap.DynmapCoreAPI 实现）

DynmapCore - 这是Dynmap的 server-neutral 核心: 几乎所有Dynmap的网页和渲染逻辑都在这（尽我们所能的放进去）。这样开发的结果就是不可运行 - 所以他们都被放进了 'dynmap' 及其他部件开发里(例如 'DynmapSpout', 是用于 Spout 服务端的).

dynmap-api - 这是dynmap专用于Bukkit（Bukkit-specific）的 API 库 - 它定义了 org.dynmap.DynmapAPI 的接口,包括对 Bukkit-specific 的调用。还包括 DynmapCoreAPI ( DynmapCoreAPI 是 DynmapAPI 的拓展), 即将补丁实例为 'dynmap' 之后指向 org.dynmap.DynmapAPI 然后接入公共接口。

dynmap - 这个部件让 dynmap-for-Bukkit 真正的可用, 只包含了不可运行为server-neutral的代码。

=兼容性=

The following mods are known to support dynmap integration without needing an add-on:

DeathTPPlus
xWarp
Vanish No Packet
Ultimate Core
Also, for the best response to questions and such, please post comments to our main forum thread - http://www.minecraftforum.net/topic/1543523-dynmap-dynamic-web-based-maps-for-minecraft/. Once again, having more than one place just isn't helpful, and this is where the 'Dynmap Community' already operates.

=被公开的信息=

This plugin utilizes Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

A unique identifier
The server's version of Java
Whether the server is in offline or online mode
The plugin's version
The server's version
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version

How to compile Dynmap
还有许多页面没有搬运,会尽快补充请谅解

CoreProtect

2016-11-18T02:47:41Z

Lzs：/* API Documentation */

{{Bukkit Plugin Infobox
|图标=[[文件:Coreprotect.png]]
|插件名=CoreProtect
|版本=v2.13.1
|前置插件=无
|兼容服务端版本=1.10
}}
===综述===
[[文件:Coreprotect.png]]

CoreProtect - 快速，高效的方块记录，回滚和恢复

CoreProtect是一种快速，高效的数据记录和防止恶意破坏的工具。可以回滚和恢复破坏。为大型服务器设计，CoreProtect将记录和管理数据，而不会影响服务器性能。
CoreProtect是最常用的服务器保护的插件，并自2012年年初得到了大力发展。
====特性简介====
*快速高效的数据日志记录.
*快速回档 - 回档/恢复时没有延迟.
*多线程以确保服务器执行操作时没有延迟.
*无需配置配置文件.将插件放入服务器就可以运行.
*基于SQLite的数据储存.
*支持MySQL数据库.
*简单的命令.
*可以执行回档及恢复功能.随时撤销回档命令.
*使用（方块记录查询）操作简单.
*高效的搜索式查询工具.
*页面形式的日志记录查询.
*自动升级检测.
*支持多世界.
*支持在配置文件中自由开启/关闭任何一个记录类型.
*回档某个人的方块操作，或是全图恢复一定区域内的所有方块.
*支持回档/恢复时略过指定类型的方块.
*限定回档/恢复的特定方块类型.
*记录基本的玩家操作. (例如当玩家打开一扇门时，记录操作)
*液体追踪.记录放置水源/岩浆源的玩家.
*树木追踪.记录树苗的放置者.
*限定回档/恢复操作所作用的半径范围.
*支持水桶/岩浆桶的权限系统.
*支持查询从另一个方块掉落下来的方块记录.
*如果玩家破坏了放置有木牌的方块，回档时支持恢复方块与其上的木牌.
*支持删除旧有记录数据.
*安全的默认参数.
*支持同时对多个玩家进行回档/恢复操作.
*每个世界拥有独立的配置文件.
*限定执行回档、恢复时所作用的动作范围.
*执行操作时支持跳过多个玩家或方块.
*预览回档/恢复操作.
*支持使用WorldEdit选择.
*支持API.
*适用于Tekkit服务器
*还有更多特性.

====日志事件====
记录被玩家破坏的方块.
记录被玩家放置的方块.
记录自然的方块破坏事件. (例如：木牌放置在一个泥土方块，泥土方块被破坏后，木牌会自然弹出变为掉落的物品形式.)
记录桶的使用.
记录液体的流动.
记录树木的生长.
记录蘑菇的生长.
记录藤蔓的生长.
记录爆炸事件. (包括TNT,苦力怕, 恶魂等)
记录打火石和火焰弹的使用.
记录被火点燃的方块.
记录在火中烧掉的方块.
记录实体对方块的变动. (末影人/末影龙)
记录方块的移动行为. (掉落沙/沙砾)
记录树叶的掉落行为.
记录玩家的动作.
记录地狱门的生成.
记录被活塞移动的方块.
记录被玩家收割的小麦.
记录雪傀儡生成的雪.
记录容器中物品的变更. (容器包括箱子,熔炉,发射器等.)
记录画与展示框的变更. (支持回档命令.)
记录被玩家杀死的实体. (动物/怪物)
记录玩家发送的聊天信息与使用过的命令.
记录玩家的登录、登出行为.
记录WorldEdit插件所造成的地形变更.
记录范围仍在不停的拓展...

====使用说明====
当你开启查询模式时(输入"/core inspect"或是"/co i")
你可以使用以下方式查询 :
左键一个方块来查看放置信息.
右键一个方块来查看临近的方块的移除信息.
右键放置一个方块来查看该位置的方块的移除信息.
右键放置一个方块取代原有方块来查看原有方块的放置信息.
(例如，将泥土放置在水中来查看水源的相关信息)
右键门、按钮、拉杆、箱子等可交互的方块来查看其使用信息.

====一些反馈====
"使用回档命令既简单又快速."
"自从Bukkit开发以来，我就一直在运行服务器，所以我用过几乎所有的记录插件.CoreProtect是其中最好的，同时也是最快速的."
"使用CoreProtect吧.快速、更新快并且能够记录WorldEdit的操作."
"Overall it felt more natural, simpler, and much faster to use CoreProtect than Prism, which just doesn't compare."
"CoreProtect brings complex logging and rollbacks, whilst at the same time keeping a low profile."
编写者注：以上内容主观性较强，故只翻译部分，与插件使用无关紧要。

===命令===
你可以通过输入 "/coreprotect", "/core", 或是 "/co"来调用指令.
{| border="1"
|+命令概览
|-
|/co help
|显示命令列表
|-
|/co inspect
|开启查询模式
|-
|/co rollback <params>
|回档方块数据
|-
|/co restore <params>
|取消回档操作
|-
|/co lookup <params>
|方块记录翻页
|-
|/co purge <params>
|删除旧有数据
|-
|/co reload
|重载配置文件
|-
|/co version
|查看当前插件版本信息
|}

{| border="1"
|+简短命令
|/co near
|查看半径五格内的方块记录
|-
|/co undo
|撤销回档/恢复操作，即进行相反的动作（下面列出详细的命令信息.）
|-
|/co help
|在游戏中列出所有命令.
|-
|/co inspect
|开启查询模式.再次输入则关闭查询模式.缩写"/co i".
|}
/co rollback u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
几乎所有的参数都是可以设置的. 短命令: "/co rb".
参数说明:
u:<user> - 指定一名用户进行回档操作.
例子: u:Notch
t:<time> - 指定回档的时间变量.你可以指定周、天、小时、分钟、秒数.
例子 t:2w,5d,7h,2m,10s
你可以指定更具体的时间变量.
例子: t:5d2h
你也可以使用小数
例子: t:2.50h (两个半小时)
r:<radius> - 指定作用的半径范围.
你可以利用这个变量只恢复你附近的方块.
你可以直接指定一个数字(例如 r:5),一个世界（例如 r:#world_the_end), 全局回档(r:#global), 或是一个WorldEdit的选区(r:#worldedit 或者 r:#we)
举个例子来说,下面这个变量意味着只恢复你周围半径为十格的方块【注：此处是半径抑或就是方块数？】: r:10
a:<action> - 限定操作的动作范围
举个例子来说，如果你只想恢复放置的方块，输入 a:+block
以下是所有动作的变量代码:
a:block (方块放置/破坏)
a:+block (方块放置)
a:-block (方块破坏)
a:click (玩家交互)
a:container (物品拿出或放入箱子等容器.)
a:+container (物品放入箱子等容器.)
a:-container (物品拿出箱子等容器.)
a:kill (被杀死的怪物/动物)
a:chat (聊天栏中的信息)
a:command (用过的命令)
a:session (玩家登入/登出)
a:+session (玩家登入)
a:-session (玩家登出)

b:<blocks> - 限定回档时作用的方块类型.
举个例子来说,如果你只想回档石头方块，你可以输入b:1
你也可以指定多个物品，像这样b:1,5,7
你可以在这里找到方块ID
http://www.minecraftwiki.net/wiki/Data_values

e:<exclude> - 排除回档时作用的方块类型.
举个例子来说，如果你不想要TNT在回档后恢复，你可以输入e:46

#<hashtag> - 添加一个标签在你的指令末端来执行额外的操作.
举个例子来说，如果需要执行预览“回档”操作，你可以输入#preview
以下是可用的标签列表:
#preview (预览回档/恢复操作)
#count (返回一个查看记录的行数)
#verbose (在执行回档/恢复操作时显示额外的调试信息)
#silent (在执行回档/恢复操作时显示少量的调试信息)

/co restore u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co rs".
/restore同样可以作用于回退/rollback操作.
/co lookup u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co l".
本命令也可以用于搜索查看方块记录.
/co purge t:<time>
清除旧的方块数据. 如果你不需要旧的数据，可以用这个命令来释放你的硬盘储存空间.
举个例子来说, "/co purge t:30d" 将会删除所有一个月前的旧数据，仅保留最近30天的数据.
在游戏中输入命令，将只有30天以后的数据可以被清除;如果在控制台输入命令，则是24小时以后的数据都可以被清除.
回档命令示例:
>>默认情况下，如果指令中并未指定范围(radius)变量,插件将会自动代入10这个数据，限制操作的作用范围是你周围半径10格的区域.使用"r:#global"来执行全局回档.
对玩家Notch一小时内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:1h
预览“对玩家Notch一小时内的所有操作进行回档(默认范围10)”:
/co rollback u:Notch t:1h #preview
对玩家Notch23小时17分钟内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:23h17m
对玩家Notch最近一小时内的石头放置/破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1
对玩家Notch最近一小时内的石头破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1 a:-block
对玩家Notch最近一小时内除了石头放置/破坏以外的所有操作进行回档(全局):
/co rollback u:Notch t:1h r:#global e:1
对玩家Notch最近一小时内的地形修改操作进行回档(半径20):
/co rollback u:Notch t:1h r:20
对玩家Notch最近一小时内的地形修改操作进行回档(限制在Nether世界):
/co rollback u:Notch t:1h r:#nether
对所有玩家最近15分钟内的所有操作进行回档(半径30):
/co rollback t:15m r:30
对在WorldEdit选区内最近15分钟内的所有操作进行回档:
/co rollback t:15m r:#worldedit
查看命令示例:
>>查询命令与回档命令的使用基本一样.唯一的区别在于查询命令默认的范围是全局.
查看最近一小时内所有钻石原矿的挖掘记录:
/co lookup b:56 t:1h a:-block
查看最近30分钟内玩家Notch发送的所有聊天信息:
/co lookup u:Notch t:30m a:chat
查看玩家Notch的所有登陆操作:
/co lookup u:Notch a:login

===权限===
coreprotect.*
允许使用全部命令.
coreprotect.inspect
允许使用inspect命令.
coreprotect.lookup
允许使用lookup命令.
coreprotect.rollback
允许使用rollback命令.
coreprotect.restore
允许使用restore命令.
coreprotect.purge
允许使用purge命令.
coreprotect.reload
允许使用reload命令.
coreprotect.help
允许使用help命令.
====子权限====
coreprotect.lookup.block
可以使用否定节点来限制方块记录查询.
coreprotect.lookup.click
可以使用否定节点来限制动作记录查询.
coreprotect.lookup.container
可以使用否定节点来限制容器记录查询.
coreprotect.lookup.kill
可以使用否定节点来限制实体死亡记录查询.
coreprotect.lookup.chat
可以使用否定节点来限制聊天记录查询.
coreprotect.lookup.command
可以使用否定节点来限制命令记录查询.
coreprotect.lookup.session
可以使用否定节点来限制选区(限定范围)查询.

特殊名词说明:
否定节点指的是权限节点搭配-的组合，与GroupManager插件中的概念相同。
如添加-essentials.build则为禁止建筑，详情参照 [[GroupManager]] [http://www.twodam.net/wiki/GroupManager#.E5.90.A6.E5.AE.9A.E8.8A.82.E7.82.B9 GM:否定节点]

===指导与资源===
====相关链接====
兼容的第三方插件与工具列表.[https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/compatible-third-party-plugins-tools/ 点击查看]

====独立世界配置文件====
如果你想要独立特定世界的记录设置，只需要按下面这样做:

#复制 config.yml 文件的所有内容，创建并粘贴到以对应世界名命名的文件中(例如: world_nether.yml)
#在新文件中自定义你的设置.
#同时重启服务端, 或是在游戏中输入"/co reload" .
举个例子来说, 如果你不想记录"The End"的所有日志, 复制 config.yml 文件中的所有内容并粘贴到 "world_the_end.yml" (匹配对应的世界名).

之后，在新的文件中，调整设置你所期望的选项即可.

====取消记载指定用户的记录====
如果你想取消记录一些用户, 你可以这样做
#在CoreProtect插件根目录下创建一个名为“blacklist.txt”的文件.
#输入需要禁用的用户名称 (每个用户名一行)
#重新启动服务器, 或者在游戏输入指令“/co reload”
这可以用于禁用非玩家的记录, 如“#tnt”. 如果你想禁用记录用户“Notch”, 和TNT爆炸, blacklist.txt文件需要这样写:
<code>Notch
#tnt</code>

====CoreProtect 2.00 升级向导====
由CoreProtect 1 升级到 2？这里有些你需要知道的信息.[https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/core-protect-2-00-upgrade-guide/ 点击查看]

===API Documentation===
给开发者的API.[http://minerealm.com/community/viewtopic.php?f=32&t=14070/ 点击查看]

===IRC===
===其它===
[[Category:安全]]
[[Category:管理]]

CoreProtect

2016-11-18T02:46:44Z

Lzs：/* CoreProtect 2.00 升级向导 */

{{Bukkit Plugin Infobox
|图标=[[文件:Coreprotect.png]]
|插件名=CoreProtect
|版本=v2.13.1
|前置插件=无
|兼容服务端版本=1.10
}}
===综述===
[[文件:Coreprotect.png]]

CoreProtect - 快速，高效的方块记录，回滚和恢复

CoreProtect是一种快速，高效的数据记录和防止恶意破坏的工具。可以回滚和恢复破坏。为大型服务器设计，CoreProtect将记录和管理数据，而不会影响服务器性能。
CoreProtect是最常用的服务器保护的插件，并自2012年年初得到了大力发展。
====特性简介====
*快速高效的数据日志记录.
*快速回档 - 回档/恢复时没有延迟.
*多线程以确保服务器执行操作时没有延迟.
*无需配置配置文件.将插件放入服务器就可以运行.
*基于SQLite的数据储存.
*支持MySQL数据库.
*简单的命令.
*可以执行回档及恢复功能.随时撤销回档命令.
*使用（方块记录查询）操作简单.
*高效的搜索式查询工具.
*页面形式的日志记录查询.
*自动升级检测.
*支持多世界.
*支持在配置文件中自由开启/关闭任何一个记录类型.
*回档某个人的方块操作，或是全图恢复一定区域内的所有方块.
*支持回档/恢复时略过指定类型的方块.
*限定回档/恢复的特定方块类型.
*记录基本的玩家操作. (例如当玩家打开一扇门时，记录操作)
*液体追踪.记录放置水源/岩浆源的玩家.
*树木追踪.记录树苗的放置者.
*限定回档/恢复操作所作用的半径范围.
*支持水桶/岩浆桶的权限系统.
*支持查询从另一个方块掉落下来的方块记录.
*如果玩家破坏了放置有木牌的方块，回档时支持恢复方块与其上的木牌.
*支持删除旧有记录数据.
*安全的默认参数.
*支持同时对多个玩家进行回档/恢复操作.
*每个世界拥有独立的配置文件.
*限定执行回档、恢复时所作用的动作范围.
*执行操作时支持跳过多个玩家或方块.
*预览回档/恢复操作.
*支持使用WorldEdit选择.
*支持API.
*适用于Tekkit服务器
*还有更多特性.

====日志事件====
记录被玩家破坏的方块.
记录被玩家放置的方块.
记录自然的方块破坏事件. (例如：木牌放置在一个泥土方块，泥土方块被破坏后，木牌会自然弹出变为掉落的物品形式.)
记录桶的使用.
记录液体的流动.
记录树木的生长.
记录蘑菇的生长.
记录藤蔓的生长.
记录爆炸事件. (包括TNT,苦力怕, 恶魂等)
记录打火石和火焰弹的使用.
记录被火点燃的方块.
记录在火中烧掉的方块.
记录实体对方块的变动. (末影人/末影龙)
记录方块的移动行为. (掉落沙/沙砾)
记录树叶的掉落行为.
记录玩家的动作.
记录地狱门的生成.
记录被活塞移动的方块.
记录被玩家收割的小麦.
记录雪傀儡生成的雪.
记录容器中物品的变更. (容器包括箱子,熔炉,发射器等.)
记录画与展示框的变更. (支持回档命令.)
记录被玩家杀死的实体. (动物/怪物)
记录玩家发送的聊天信息与使用过的命令.
记录玩家的登录、登出行为.
记录WorldEdit插件所造成的地形变更.
记录范围仍在不停的拓展...

====使用说明====
当你开启查询模式时(输入"/core inspect"或是"/co i")
你可以使用以下方式查询 :
左键一个方块来查看放置信息.
右键一个方块来查看临近的方块的移除信息.
右键放置一个方块来查看该位置的方块的移除信息.
右键放置一个方块取代原有方块来查看原有方块的放置信息.
(例如，将泥土放置在水中来查看水源的相关信息)
右键门、按钮、拉杆、箱子等可交互的方块来查看其使用信息.

====一些反馈====
"使用回档命令既简单又快速."
"自从Bukkit开发以来，我就一直在运行服务器，所以我用过几乎所有的记录插件.CoreProtect是其中最好的，同时也是最快速的."
"使用CoreProtect吧.快速、更新快并且能够记录WorldEdit的操作."
"Overall it felt more natural, simpler, and much faster to use CoreProtect than Prism, which just doesn't compare."
"CoreProtect brings complex logging and rollbacks, whilst at the same time keeping a low profile."
编写者注：以上内容主观性较强，故只翻译部分，与插件使用无关紧要。

===命令===
你可以通过输入 "/coreprotect", "/core", 或是 "/co"来调用指令.
{| border="1"
|+命令概览
|-
|/co help
|显示命令列表
|-
|/co inspect
|开启查询模式
|-
|/co rollback <params>
|回档方块数据
|-
|/co restore <params>
|取消回档操作
|-
|/co lookup <params>
|方块记录翻页
|-
|/co purge <params>
|删除旧有数据
|-
|/co reload
|重载配置文件
|-
|/co version
|查看当前插件版本信息
|}

{| border="1"
|+简短命令
|/co near
|查看半径五格内的方块记录
|-
|/co undo
|撤销回档/恢复操作，即进行相反的动作（下面列出详细的命令信息.）
|-
|/co help
|在游戏中列出所有命令.
|-
|/co inspect
|开启查询模式.再次输入则关闭查询模式.缩写"/co i".
|}
/co rollback u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
几乎所有的参数都是可以设置的. 短命令: "/co rb".
参数说明:
u:<user> - 指定一名用户进行回档操作.
例子: u:Notch
t:<time> - 指定回档的时间变量.你可以指定周、天、小时、分钟、秒数.
例子 t:2w,5d,7h,2m,10s
你可以指定更具体的时间变量.
例子: t:5d2h
你也可以使用小数
例子: t:2.50h (两个半小时)
r:<radius> - 指定作用的半径范围.
你可以利用这个变量只恢复你附近的方块.
你可以直接指定一个数字(例如 r:5),一个世界（例如 r:#world_the_end), 全局回档(r:#global), 或是一个WorldEdit的选区(r:#worldedit 或者 r:#we)
举个例子来说,下面这个变量意味着只恢复你周围半径为十格的方块【注：此处是半径抑或就是方块数？】: r:10
a:<action> - 限定操作的动作范围
举个例子来说，如果你只想恢复放置的方块，输入 a:+block
以下是所有动作的变量代码:
a:block (方块放置/破坏)
a:+block (方块放置)
a:-block (方块破坏)
a:click (玩家交互)
a:container (物品拿出或放入箱子等容器.)
a:+container (物品放入箱子等容器.)
a:-container (物品拿出箱子等容器.)
a:kill (被杀死的怪物/动物)
a:chat (聊天栏中的信息)
a:command (用过的命令)
a:session (玩家登入/登出)
a:+session (玩家登入)
a:-session (玩家登出)

b:<blocks> - 限定回档时作用的方块类型.
举个例子来说,如果你只想回档石头方块，你可以输入b:1
你也可以指定多个物品，像这样b:1,5,7
你可以在这里找到方块ID
http://www.minecraftwiki.net/wiki/Data_values

e:<exclude> - 排除回档时作用的方块类型.
举个例子来说，如果你不想要TNT在回档后恢复，你可以输入e:46

#<hashtag> - 添加一个标签在你的指令末端来执行额外的操作.
举个例子来说，如果需要执行预览“回档”操作，你可以输入#preview
以下是可用的标签列表:
#preview (预览回档/恢复操作)
#count (返回一个查看记录的行数)
#verbose (在执行回档/恢复操作时显示额外的调试信息)
#silent (在执行回档/恢复操作时显示少量的调试信息)

/co restore u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co rs".
/restore同样可以作用于回退/rollback操作.
/co lookup u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co l".
本命令也可以用于搜索查看方块记录.
/co purge t:<time>
清除旧的方块数据. 如果你不需要旧的数据，可以用这个命令来释放你的硬盘储存空间.
举个例子来说, "/co purge t:30d" 将会删除所有一个月前的旧数据，仅保留最近30天的数据.
在游戏中输入命令，将只有30天以后的数据可以被清除;如果在控制台输入命令，则是24小时以后的数据都可以被清除.
回档命令示例:
>>默认情况下，如果指令中并未指定范围(radius)变量,插件将会自动代入10这个数据，限制操作的作用范围是你周围半径10格的区域.使用"r:#global"来执行全局回档.
对玩家Notch一小时内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:1h
预览“对玩家Notch一小时内的所有操作进行回档(默认范围10)”:
/co rollback u:Notch t:1h #preview
对玩家Notch23小时17分钟内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:23h17m
对玩家Notch最近一小时内的石头放置/破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1
对玩家Notch最近一小时内的石头破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1 a:-block
对玩家Notch最近一小时内除了石头放置/破坏以外的所有操作进行回档(全局):
/co rollback u:Notch t:1h r:#global e:1
对玩家Notch最近一小时内的地形修改操作进行回档(半径20):
/co rollback u:Notch t:1h r:20
对玩家Notch最近一小时内的地形修改操作进行回档(限制在Nether世界):
/co rollback u:Notch t:1h r:#nether
对所有玩家最近15分钟内的所有操作进行回档(半径30):
/co rollback t:15m r:30
对在WorldEdit选区内最近15分钟内的所有操作进行回档:
/co rollback t:15m r:#worldedit
查看命令示例:
>>查询命令与回档命令的使用基本一样.唯一的区别在于查询命令默认的范围是全局.
查看最近一小时内所有钻石原矿的挖掘记录:
/co lookup b:56 t:1h a:-block
查看最近30分钟内玩家Notch发送的所有聊天信息:
/co lookup u:Notch t:30m a:chat
查看玩家Notch的所有登陆操作:
/co lookup u:Notch a:login

===权限===
coreprotect.*
允许使用全部命令.
coreprotect.inspect
允许使用inspect命令.
coreprotect.lookup
允许使用lookup命令.
coreprotect.rollback
允许使用rollback命令.
coreprotect.restore
允许使用restore命令.
coreprotect.purge
允许使用purge命令.
coreprotect.reload
允许使用reload命令.
coreprotect.help
允许使用help命令.
====子权限====
coreprotect.lookup.block
可以使用否定节点来限制方块记录查询.
coreprotect.lookup.click
可以使用否定节点来限制动作记录查询.
coreprotect.lookup.container
可以使用否定节点来限制容器记录查询.
coreprotect.lookup.kill
可以使用否定节点来限制实体死亡记录查询.
coreprotect.lookup.chat
可以使用否定节点来限制聊天记录查询.
coreprotect.lookup.command
可以使用否定节点来限制命令记录查询.
coreprotect.lookup.session
可以使用否定节点来限制选区(限定范围)查询.

特殊名词说明:
否定节点指的是权限节点搭配-的组合，与GroupManager插件中的概念相同。
如添加-essentials.build则为禁止建筑，详情参照 [[GroupManager]] [http://www.twodam.net/wiki/GroupManager#.E5.90.A6.E5.AE.9A.E8.8A.82.E7.82.B9 GM:否定节点]

===指导与资源===
====相关链接====
兼容的第三方插件与工具列表.[https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/compatible-third-party-plugins-tools/ 点击查看]

====独立世界配置文件====
如果你想要独立特定世界的记录设置，只需要按下面这样做:

#复制 config.yml 文件的所有内容，创建并粘贴到以对应世界名命名的文件中(例如: world_nether.yml)
#在新文件中自定义你的设置.
#同时重启服务端, 或是在游戏中输入"/co reload" .
举个例子来说, 如果你不想记录"The End"的所有日志, 复制 config.yml 文件中的所有内容并粘贴到 "world_the_end.yml" (匹配对应的世界名).

之后，在新的文件中，调整设置你所期望的选项即可.

====取消记载指定用户的记录====
如果你想取消记录一些用户, 你可以这样做
#在CoreProtect插件根目录下创建一个名为“blacklist.txt”的文件.
#输入需要禁用的用户名称 (每个用户名一行)
#重新启动服务器, 或者在游戏输入指令“/co reload”
这可以用于禁用非玩家的记录, 如“#tnt”. 如果你想禁用记录用户“Notch”, 和TNT爆炸, blacklist.txt文件需要这样写:
<code>Notch
#tnt</code>

====CoreProtect 2.00 升级向导====
由CoreProtect 1 升级到 2？这里有些你需要知道的信息.[https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/core-protect-2-00-upgrade-guide/ 点击查看]

===API Documentation===
这是一些给开发看的API
[http://minerealm.com/community/viewtopic.php?f=32&t=14070]

===IRC===
===其它===
[[Category:安全]]
[[Category:管理]]

CoreProtect

2016-11-18T02:45:38Z

Lzs：/* CoreProtect 2.00 升级向导 */

{{Bukkit Plugin Infobox
|图标=[[文件:Coreprotect.png]]
|插件名=CoreProtect
|版本=v2.13.1
|前置插件=无
|兼容服务端版本=1.10
}}
===综述===
[[文件:Coreprotect.png]]

CoreProtect - 快速，高效的方块记录，回滚和恢复

CoreProtect是一种快速，高效的数据记录和防止恶意破坏的工具。可以回滚和恢复破坏。为大型服务器设计，CoreProtect将记录和管理数据，而不会影响服务器性能。
CoreProtect是最常用的服务器保护的插件，并自2012年年初得到了大力发展。
====特性简介====
*快速高效的数据日志记录.
*快速回档 - 回档/恢复时没有延迟.
*多线程以确保服务器执行操作时没有延迟.
*无需配置配置文件.将插件放入服务器就可以运行.
*基于SQLite的数据储存.
*支持MySQL数据库.
*简单的命令.
*可以执行回档及恢复功能.随时撤销回档命令.
*使用（方块记录查询）操作简单.
*高效的搜索式查询工具.
*页面形式的日志记录查询.
*自动升级检测.
*支持多世界.
*支持在配置文件中自由开启/关闭任何一个记录类型.
*回档某个人的方块操作，或是全图恢复一定区域内的所有方块.
*支持回档/恢复时略过指定类型的方块.
*限定回档/恢复的特定方块类型.
*记录基本的玩家操作. (例如当玩家打开一扇门时，记录操作)
*液体追踪.记录放置水源/岩浆源的玩家.
*树木追踪.记录树苗的放置者.
*限定回档/恢复操作所作用的半径范围.
*支持水桶/岩浆桶的权限系统.
*支持查询从另一个方块掉落下来的方块记录.
*如果玩家破坏了放置有木牌的方块，回档时支持恢复方块与其上的木牌.
*支持删除旧有记录数据.
*安全的默认参数.
*支持同时对多个玩家进行回档/恢复操作.
*每个世界拥有独立的配置文件.
*限定执行回档、恢复时所作用的动作范围.
*执行操作时支持跳过多个玩家或方块.
*预览回档/恢复操作.
*支持使用WorldEdit选择.
*支持API.
*适用于Tekkit服务器
*还有更多特性.

====日志事件====
记录被玩家破坏的方块.
记录被玩家放置的方块.
记录自然的方块破坏事件. (例如：木牌放置在一个泥土方块，泥土方块被破坏后，木牌会自然弹出变为掉落的物品形式.)
记录桶的使用.
记录液体的流动.
记录树木的生长.
记录蘑菇的生长.
记录藤蔓的生长.
记录爆炸事件. (包括TNT,苦力怕, 恶魂等)
记录打火石和火焰弹的使用.
记录被火点燃的方块.
记录在火中烧掉的方块.
记录实体对方块的变动. (末影人/末影龙)
记录方块的移动行为. (掉落沙/沙砾)
记录树叶的掉落行为.
记录玩家的动作.
记录地狱门的生成.
记录被活塞移动的方块.
记录被玩家收割的小麦.
记录雪傀儡生成的雪.
记录容器中物品的变更. (容器包括箱子,熔炉,发射器等.)
记录画与展示框的变更. (支持回档命令.)
记录被玩家杀死的实体. (动物/怪物)
记录玩家发送的聊天信息与使用过的命令.
记录玩家的登录、登出行为.
记录WorldEdit插件所造成的地形变更.
记录范围仍在不停的拓展...

====使用说明====
当你开启查询模式时(输入"/core inspect"或是"/co i")
你可以使用以下方式查询 :
左键一个方块来查看放置信息.
右键一个方块来查看临近的方块的移除信息.
右键放置一个方块来查看该位置的方块的移除信息.
右键放置一个方块取代原有方块来查看原有方块的放置信息.
(例如，将泥土放置在水中来查看水源的相关信息)
右键门、按钮、拉杆、箱子等可交互的方块来查看其使用信息.

====一些反馈====
"使用回档命令既简单又快速."
"自从Bukkit开发以来，我就一直在运行服务器，所以我用过几乎所有的记录插件.CoreProtect是其中最好的，同时也是最快速的."
"使用CoreProtect吧.快速、更新快并且能够记录WorldEdit的操作."
"Overall it felt more natural, simpler, and much faster to use CoreProtect than Prism, which just doesn't compare."
"CoreProtect brings complex logging and rollbacks, whilst at the same time keeping a low profile."
编写者注：以上内容主观性较强，故只翻译部分，与插件使用无关紧要。

===命令===
你可以通过输入 "/coreprotect", "/core", 或是 "/co"来调用指令.
{| border="1"
|+命令概览
|-
|/co help
|显示命令列表
|-
|/co inspect
|开启查询模式
|-
|/co rollback <params>
|回档方块数据
|-
|/co restore <params>
|取消回档操作
|-
|/co lookup <params>
|方块记录翻页
|-
|/co purge <params>
|删除旧有数据
|-
|/co reload
|重载配置文件
|-
|/co version
|查看当前插件版本信息
|}

{| border="1"
|+简短命令
|/co near
|查看半径五格内的方块记录
|-
|/co undo
|撤销回档/恢复操作，即进行相反的动作（下面列出详细的命令信息.）
|-
|/co help
|在游戏中列出所有命令.
|-
|/co inspect
|开启查询模式.再次输入则关闭查询模式.缩写"/co i".
|}
/co rollback u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
几乎所有的参数都是可以设置的. 短命令: "/co rb".
参数说明:
u:<user> - 指定一名用户进行回档操作.
例子: u:Notch
t:<time> - 指定回档的时间变量.你可以指定周、天、小时、分钟、秒数.
例子 t:2w,5d,7h,2m,10s
你可以指定更具体的时间变量.
例子: t:5d2h
你也可以使用小数
例子: t:2.50h (两个半小时)
r:<radius> - 指定作用的半径范围.
你可以利用这个变量只恢复你附近的方块.
你可以直接指定一个数字(例如 r:5),一个世界（例如 r:#world_the_end), 全局回档(r:#global), 或是一个WorldEdit的选区(r:#worldedit 或者 r:#we)
举个例子来说,下面这个变量意味着只恢复你周围半径为十格的方块【注：此处是半径抑或就是方块数？】: r:10
a:<action> - 限定操作的动作范围
举个例子来说，如果你只想恢复放置的方块，输入 a:+block
以下是所有动作的变量代码:
a:block (方块放置/破坏)
a:+block (方块放置)
a:-block (方块破坏)
a:click (玩家交互)
a:container (物品拿出或放入箱子等容器.)
a:+container (物品放入箱子等容器.)
a:-container (物品拿出箱子等容器.)
a:kill (被杀死的怪物/动物)
a:chat (聊天栏中的信息)
a:command (用过的命令)
a:session (玩家登入/登出)
a:+session (玩家登入)
a:-session (玩家登出)

b:<blocks> - 限定回档时作用的方块类型.
举个例子来说,如果你只想回档石头方块，你可以输入b:1
你也可以指定多个物品，像这样b:1,5,7
你可以在这里找到方块ID
http://www.minecraftwiki.net/wiki/Data_values

e:<exclude> - 排除回档时作用的方块类型.
举个例子来说，如果你不想要TNT在回档后恢复，你可以输入e:46

#<hashtag> - 添加一个标签在你的指令末端来执行额外的操作.
举个例子来说，如果需要执行预览“回档”操作，你可以输入#preview
以下是可用的标签列表:
#preview (预览回档/恢复操作)
#count (返回一个查看记录的行数)
#verbose (在执行回档/恢复操作时显示额外的调试信息)
#silent (在执行回档/恢复操作时显示少量的调试信息)

/co restore u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co rs".
/restore同样可以作用于回退/rollback操作.
/co lookup u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co l".
本命令也可以用于搜索查看方块记录.
/co purge t:<time>
清除旧的方块数据. 如果你不需要旧的数据，可以用这个命令来释放你的硬盘储存空间.
举个例子来说, "/co purge t:30d" 将会删除所有一个月前的旧数据，仅保留最近30天的数据.
在游戏中输入命令，将只有30天以后的数据可以被清除;如果在控制台输入命令，则是24小时以后的数据都可以被清除.
回档命令示例:
>>默认情况下，如果指令中并未指定范围(radius)变量,插件将会自动代入10这个数据，限制操作的作用范围是你周围半径10格的区域.使用"r:#global"来执行全局回档.
对玩家Notch一小时内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:1h
预览“对玩家Notch一小时内的所有操作进行回档(默认范围10)”:
/co rollback u:Notch t:1h #preview
对玩家Notch23小时17分钟内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:23h17m
对玩家Notch最近一小时内的石头放置/破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1
对玩家Notch最近一小时内的石头破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1 a:-block
对玩家Notch最近一小时内除了石头放置/破坏以外的所有操作进行回档(全局):
/co rollback u:Notch t:1h r:#global e:1
对玩家Notch最近一小时内的地形修改操作进行回档(半径20):
/co rollback u:Notch t:1h r:20
对玩家Notch最近一小时内的地形修改操作进行回档(限制在Nether世界):
/co rollback u:Notch t:1h r:#nether
对所有玩家最近15分钟内的所有操作进行回档(半径30):
/co rollback t:15m r:30
对在WorldEdit选区内最近15分钟内的所有操作进行回档:
/co rollback t:15m r:#worldedit
查看命令示例:
>>查询命令与回档命令的使用基本一样.唯一的区别在于查询命令默认的范围是全局.
查看最近一小时内所有钻石原矿的挖掘记录:
/co lookup b:56 t:1h a:-block
查看最近30分钟内玩家Notch发送的所有聊天信息:
/co lookup u:Notch t:30m a:chat
查看玩家Notch的所有登陆操作:
/co lookup u:Notch a:login

===权限===
coreprotect.*
允许使用全部命令.
coreprotect.inspect
允许使用inspect命令.
coreprotect.lookup
允许使用lookup命令.
coreprotect.rollback
允许使用rollback命令.
coreprotect.restore
允许使用restore命令.
coreprotect.purge
允许使用purge命令.
coreprotect.reload
允许使用reload命令.
coreprotect.help
允许使用help命令.
====子权限====
coreprotect.lookup.block
可以使用否定节点来限制方块记录查询.
coreprotect.lookup.click
可以使用否定节点来限制动作记录查询.
coreprotect.lookup.container
可以使用否定节点来限制容器记录查询.
coreprotect.lookup.kill
可以使用否定节点来限制实体死亡记录查询.
coreprotect.lookup.chat
可以使用否定节点来限制聊天记录查询.
coreprotect.lookup.command
可以使用否定节点来限制命令记录查询.
coreprotect.lookup.session
可以使用否定节点来限制选区(限定范围)查询.

特殊名词说明:
否定节点指的是权限节点搭配-的组合，与GroupManager插件中的概念相同。
如添加-essentials.build则为禁止建筑，详情参照 [[GroupManager]] [http://www.twodam.net/wiki/GroupManager#.E5.90.A6.E5.AE.9A.E8.8A.82.E7.82.B9 GM:否定节点]

===指导与资源===
====相关链接====
兼容的第三方插件与工具列表.[https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/compatible-third-party-plugins-tools/ 点击查看]

====独立世界配置文件====
如果你想要独立特定世界的记录设置，只需要按下面这样做:

#复制 config.yml 文件的所有内容，创建并粘贴到以对应世界名命名的文件中(例如: world_nether.yml)
#在新文件中自定义你的设置.
#同时重启服务端, 或是在游戏中输入"/co reload" .
举个例子来说, 如果你不想记录"The End"的所有日志, 复制 config.yml 文件中的所有内容并粘贴到 "world_the_end.yml" (匹配对应的世界名).

之后，在新的文件中，调整设置你所期望的选项即可.

====取消记载指定用户的记录====
如果你想取消记录一些用户, 你可以这样做
#在CoreProtect插件根目录下创建一个名为“blacklist.txt”的文件.
#输入需要禁用的用户名称 (每个用户名一行)
#重新启动服务器, 或者在游戏输入指令“/co reload”
这可以用于禁用非玩家的记录, 如“#tnt”. 如果你想禁用记录用户“Notch”, 和TNT爆炸, blacklist.txt文件需要这样写:
<code>Notch
#tnt</code>

====CoreProtect 2.00 升级向导====
由CoreProtect 1.# 升级到 2.#? [https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/core-protect-2-00-upgrade-guide/ 这里]有些你需要知道的信息.

===API Documentation===
这是一些给开发看的API
[http://minerealm.com/community/viewtopic.php?f=32&t=14070]

===IRC===
===其它===
[[Category:安全]]
[[Category:管理]]

CoreProtect

2016-11-18T02:44:00Z

Lzs：/* 下面是与CoreProtect运行有关的页面链接 */

{{Bukkit Plugin Infobox
|图标=[[文件:Coreprotect.png]]
|插件名=CoreProtect
|版本=v2.13.1
|前置插件=无
|兼容服务端版本=1.10
}}
===综述===
[[文件:Coreprotect.png]]

CoreProtect - 快速，高效的方块记录，回滚和恢复

CoreProtect是一种快速，高效的数据记录和防止恶意破坏的工具。可以回滚和恢复破坏。为大型服务器设计，CoreProtect将记录和管理数据，而不会影响服务器性能。
CoreProtect是最常用的服务器保护的插件，并自2012年年初得到了大力发展。
====特性简介====
*快速高效的数据日志记录.
*快速回档 - 回档/恢复时没有延迟.
*多线程以确保服务器执行操作时没有延迟.
*无需配置配置文件.将插件放入服务器就可以运行.
*基于SQLite的数据储存.
*支持MySQL数据库.
*简单的命令.
*可以执行回档及恢复功能.随时撤销回档命令.
*使用（方块记录查询）操作简单.
*高效的搜索式查询工具.
*页面形式的日志记录查询.
*自动升级检测.
*支持多世界.
*支持在配置文件中自由开启/关闭任何一个记录类型.
*回档某个人的方块操作，或是全图恢复一定区域内的所有方块.
*支持回档/恢复时略过指定类型的方块.
*限定回档/恢复的特定方块类型.
*记录基本的玩家操作. (例如当玩家打开一扇门时，记录操作)
*液体追踪.记录放置水源/岩浆源的玩家.
*树木追踪.记录树苗的放置者.
*限定回档/恢复操作所作用的半径范围.
*支持水桶/岩浆桶的权限系统.
*支持查询从另一个方块掉落下来的方块记录.
*如果玩家破坏了放置有木牌的方块，回档时支持恢复方块与其上的木牌.
*支持删除旧有记录数据.
*安全的默认参数.
*支持同时对多个玩家进行回档/恢复操作.
*每个世界拥有独立的配置文件.
*限定执行回档、恢复时所作用的动作范围.
*执行操作时支持跳过多个玩家或方块.
*预览回档/恢复操作.
*支持使用WorldEdit选择.
*支持API.
*适用于Tekkit服务器
*还有更多特性.

====日志事件====
记录被玩家破坏的方块.
记录被玩家放置的方块.
记录自然的方块破坏事件. (例如：木牌放置在一个泥土方块，泥土方块被破坏后，木牌会自然弹出变为掉落的物品形式.)
记录桶的使用.
记录液体的流动.
记录树木的生长.
记录蘑菇的生长.
记录藤蔓的生长.
记录爆炸事件. (包括TNT,苦力怕, 恶魂等)
记录打火石和火焰弹的使用.
记录被火点燃的方块.
记录在火中烧掉的方块.
记录实体对方块的变动. (末影人/末影龙)
记录方块的移动行为. (掉落沙/沙砾)
记录树叶的掉落行为.
记录玩家的动作.
记录地狱门的生成.
记录被活塞移动的方块.
记录被玩家收割的小麦.
记录雪傀儡生成的雪.
记录容器中物品的变更. (容器包括箱子,熔炉,发射器等.)
记录画与展示框的变更. (支持回档命令.)
记录被玩家杀死的实体. (动物/怪物)
记录玩家发送的聊天信息与使用过的命令.
记录玩家的登录、登出行为.
记录WorldEdit插件所造成的地形变更.
记录范围仍在不停的拓展...

====使用说明====
当你开启查询模式时(输入"/core inspect"或是"/co i")
你可以使用以下方式查询 :
左键一个方块来查看放置信息.
右键一个方块来查看临近的方块的移除信息.
右键放置一个方块来查看该位置的方块的移除信息.
右键放置一个方块取代原有方块来查看原有方块的放置信息.
(例如，将泥土放置在水中来查看水源的相关信息)
右键门、按钮、拉杆、箱子等可交互的方块来查看其使用信息.

====一些反馈====
"使用回档命令既简单又快速."
"自从Bukkit开发以来，我就一直在运行服务器，所以我用过几乎所有的记录插件.CoreProtect是其中最好的，同时也是最快速的."
"使用CoreProtect吧.快速、更新快并且能够记录WorldEdit的操作."
"Overall it felt more natural, simpler, and much faster to use CoreProtect than Prism, which just doesn't compare."
"CoreProtect brings complex logging and rollbacks, whilst at the same time keeping a low profile."
编写者注：以上内容主观性较强，故只翻译部分，与插件使用无关紧要。

===命令===
你可以通过输入 "/coreprotect", "/core", 或是 "/co"来调用指令.
{| border="1"
|+命令概览
|-
|/co help
|显示命令列表
|-
|/co inspect
|开启查询模式
|-
|/co rollback <params>
|回档方块数据
|-
|/co restore <params>
|取消回档操作
|-
|/co lookup <params>
|方块记录翻页
|-
|/co purge <params>
|删除旧有数据
|-
|/co reload
|重载配置文件
|-
|/co version
|查看当前插件版本信息
|}

{| border="1"
|+简短命令
|/co near
|查看半径五格内的方块记录
|-
|/co undo
|撤销回档/恢复操作，即进行相反的动作（下面列出详细的命令信息.）
|-
|/co help
|在游戏中列出所有命令.
|-
|/co inspect
|开启查询模式.再次输入则关闭查询模式.缩写"/co i".
|}
/co rollback u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
几乎所有的参数都是可以设置的. 短命令: "/co rb".
参数说明:
u:<user> - 指定一名用户进行回档操作.
例子: u:Notch
t:<time> - 指定回档的时间变量.你可以指定周、天、小时、分钟、秒数.
例子 t:2w,5d,7h,2m,10s
你可以指定更具体的时间变量.
例子: t:5d2h
你也可以使用小数
例子: t:2.50h (两个半小时)
r:<radius> - 指定作用的半径范围.
你可以利用这个变量只恢复你附近的方块.
你可以直接指定一个数字(例如 r:5),一个世界（例如 r:#world_the_end), 全局回档(r:#global), 或是一个WorldEdit的选区(r:#worldedit 或者 r:#we)
举个例子来说,下面这个变量意味着只恢复你周围半径为十格的方块【注：此处是半径抑或就是方块数？】: r:10
a:<action> - 限定操作的动作范围
举个例子来说，如果你只想恢复放置的方块，输入 a:+block
以下是所有动作的变量代码:
a:block (方块放置/破坏)
a:+block (方块放置)
a:-block (方块破坏)
a:click (玩家交互)
a:container (物品拿出或放入箱子等容器.)
a:+container (物品放入箱子等容器.)
a:-container (物品拿出箱子等容器.)
a:kill (被杀死的怪物/动物)
a:chat (聊天栏中的信息)
a:command (用过的命令)
a:session (玩家登入/登出)
a:+session (玩家登入)
a:-session (玩家登出)

b:<blocks> - 限定回档时作用的方块类型.
举个例子来说,如果你只想回档石头方块，你可以输入b:1
你也可以指定多个物品，像这样b:1,5,7
你可以在这里找到方块ID
http://www.minecraftwiki.net/wiki/Data_values

e:<exclude> - 排除回档时作用的方块类型.
举个例子来说，如果你不想要TNT在回档后恢复，你可以输入e:46

#<hashtag> - 添加一个标签在你的指令末端来执行额外的操作.
举个例子来说，如果需要执行预览“回档”操作，你可以输入#preview
以下是可用的标签列表:
#preview (预览回档/恢复操作)
#count (返回一个查看记录的行数)
#verbose (在执行回档/恢复操作时显示额外的调试信息)
#silent (在执行回档/恢复操作时显示少量的调试信息)

/co restore u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co rs".
/restore同样可以作用于回退/rollback操作.
/co lookup u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
与/rollback同样的参数设置. 简短命令: "/co l".
本命令也可以用于搜索查看方块记录.
/co purge t:<time>
清除旧的方块数据. 如果你不需要旧的数据，可以用这个命令来释放你的硬盘储存空间.
举个例子来说, "/co purge t:30d" 将会删除所有一个月前的旧数据，仅保留最近30天的数据.
在游戏中输入命令，将只有30天以后的数据可以被清除;如果在控制台输入命令，则是24小时以后的数据都可以被清除.
回档命令示例:
>>默认情况下，如果指令中并未指定范围(radius)变量,插件将会自动代入10这个数据，限制操作的作用范围是你周围半径10格的区域.使用"r:#global"来执行全局回档.
对玩家Notch一小时内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:1h
预览“对玩家Notch一小时内的所有操作进行回档(默认范围10)”:
/co rollback u:Notch t:1h #preview
对玩家Notch23小时17分钟内的所有操作进行回档(默认范围10):
/co rollback u:Notch t:23h17m
对玩家Notch最近一小时内的石头放置/破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1
对玩家Notch最近一小时内的石头破坏操作进行回档(默认范围10):
/co rollback u:Notch t:1h b:1 a:-block
对玩家Notch最近一小时内除了石头放置/破坏以外的所有操作进行回档(全局):
/co rollback u:Notch t:1h r:#global e:1
对玩家Notch最近一小时内的地形修改操作进行回档(半径20):
/co rollback u:Notch t:1h r:20
对玩家Notch最近一小时内的地形修改操作进行回档(限制在Nether世界):
/co rollback u:Notch t:1h r:#nether
对所有玩家最近15分钟内的所有操作进行回档(半径30):
/co rollback t:15m r:30
对在WorldEdit选区内最近15分钟内的所有操作进行回档:
/co rollback t:15m r:#worldedit
查看命令示例:
>>查询命令与回档命令的使用基本一样.唯一的区别在于查询命令默认的范围是全局.
查看最近一小时内所有钻石原矿的挖掘记录:
/co lookup b:56 t:1h a:-block
查看最近30分钟内玩家Notch发送的所有聊天信息:
/co lookup u:Notch t:30m a:chat
查看玩家Notch的所有登陆操作:
/co lookup u:Notch a:login

===权限===
coreprotect.*
允许使用全部命令.
coreprotect.inspect
允许使用inspect命令.
coreprotect.lookup
允许使用lookup命令.
coreprotect.rollback
允许使用rollback命令.
coreprotect.restore
允许使用restore命令.
coreprotect.purge
允许使用purge命令.
coreprotect.reload
允许使用reload命令.
coreprotect.help
允许使用help命令.
====子权限====
coreprotect.lookup.block
可以使用否定节点来限制方块记录查询.
coreprotect.lookup.click
可以使用否定节点来限制动作记录查询.
coreprotect.lookup.container
可以使用否定节点来限制容器记录查询.
coreprotect.lookup.kill
可以使用否定节点来限制实体死亡记录查询.
coreprotect.lookup.chat
可以使用否定节点来限制聊天记录查询.
coreprotect.lookup.command
可以使用否定节点来限制命令记录查询.
coreprotect.lookup.session
可以使用否定节点来限制选区(限定范围)查询.

特殊名词说明:
否定节点指的是权限节点搭配-的组合，与GroupManager插件中的概念相同。
如添加-essentials.build则为禁止建筑，详情参照 [[GroupManager]] [http://www.twodam.net/wiki/GroupManager#.E5.90.A6.E5.AE.9A.E8.8A.82.E7.82.B9 GM:否定节点]

===指导与资源===
====相关链接====
兼容的第三方插件与工具列表.[https://dev.bukkit.org/bukkit-plugins/coreprotect/pages/compatible-third-party-plugins-tools/ 点击查看]

====独立世界配置文件====
如果你想要独立特定世界的记录设置，只需要按下面这样做:

#复制 config.yml 文件的所有内容，创建并粘贴到以对应世界名命名的文件中(例如: world_nether.yml)
#在新文件中自定义你的设置.
#同时重启服务端, 或是在游戏中输入"/co reload" .
举个例子来说, 如果你不想记录"The End"的所有日志, 复制 config.yml 文件中的所有内容并粘贴到 "world_the_end.yml" (匹配对应的世界名).

之后，在新的文件中，调整设置你所期望的选项即可.

====取消记载指定用户的记录====
如果你想取消记录一些用户, 你可以这样做
#在CoreProtect插件根目录下创建一个名为“blacklist.txt”的文件.
#输入需要禁用的用户名称 (每个用户名一行)
#重新启动服务器, 或者在游戏输入指令“/co reload”
这可以用于禁用非玩家的记录, 如“#tnt”. 如果你想禁用记录用户“Notch”, 和TNT爆炸, blacklist.txt文件需要这样写:
<code>Notch
#tnt</code>

====CoreProtect 2.00 升级向导====
由CoreProtect 1.# 升级到 2.#? 这里有些你需要知道的信息.
[http://dev.bukkit.org/bukkit-plugins/coreprotect/pages/core-protect-2-00-upgrade-guide/]

===API Documentation===
这是一些给开发看的API
[http://minerealm.com/community/viewtopic.php?f=32&t=14070]

===IRC===
===其它===
[[Category:安全]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:38:15Z

Lzs：/* 如何创建一个牌子 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、指示牌、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建菜单 ===
复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
(推荐使用小写文件名,因为权限对大小写要求是非常严格的！)

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用带有大写字母、颜色代码或符号的内部名称(读下面)，请记住，在同菜单中项目名称不可重复。
每个项目都是由一个内部名称（对于玩家不可见）和节点组成，可以分配命令，自定义名称与图标。
一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为“节点”，每个项目可以有不同的节点来定制它。点击查看[https://dev.bukkit.org/bukkit-plugins/chest-commands/pages/tutorial/nodes/ 节点列表]。
每个项目必须要有坐标节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建指示牌 ===
放置一个牌子
在牌子的首行输入[Menu](需要权限： "chestcommands.sign"）
在第二行输入菜单名字（需要在名称后加上".yml")

=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息
|-
| /cc help || chestcommands.command.help ||列出所有命令
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单
|-
| - || chestcommands.update || 显示更新信息
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:34:55Z

Lzs：/* 全部权限与命令 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、指示牌、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建菜单 ===
复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
(推荐使用小写文件名,因为权限对大小写要求是非常严格的！)

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用带有大写字母、颜色代码或符号的内部名称(读下面)，请记住，在同菜单中项目名称不可重复。
每个项目都是由一个内部名称（对于玩家不可见）和节点组成，可以分配命令，自定义名称与图标。
一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为“节点”，每个项目可以有不同的节点来定制它。点击查看[https://dev.bukkit.org/bukkit-plugins/chest-commands/pages/tutorial/nodes/ 节点列表]。
每个项目必须要有坐标节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息
|-
| /cc help || chestcommands.command.help ||列出所有命令
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单
|-
| - || chestcommands.update || 显示更新信息
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:22:05Z

Lzs：/* 菜单设置 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、指示牌、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建菜单 ===
复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
(推荐使用小写文件名,因为权限对大小写要求是非常严格的！)

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用带有大写字母、颜色代码或符号的内部名称(读下面)，请记住，在同菜单中项目名称不可重复。
每个项目都是由一个内部名称（对于玩家不可见）和节点组成，可以分配命令，自定义名称与图标。
一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为“节点”，每个项目可以有不同的节点来定制它。点击查看[https://dev.bukkit.org/bukkit-plugins/chest-commands/pages/tutorial/nodes/ 节点列表]。
每个项目必须要有坐标节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:08:57Z

Lzs：/* 特征 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、指示牌、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建菜单 ===
复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
(推荐使用小写文件名,因为权限对大小写要求是非常严格的！)

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:06:05Z

Lzs：/* 创建菜单 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、标志、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建菜单 ===
复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
(推荐使用小写文件名,因为权限对大小写要求是非常严格的！)

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:05:41Z

Lzs：/* 创建一个新菜单 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、标志、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:04:43Z

Lzs：/* 修改一个现有的菜单 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、标志、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T02:04:22Z

Lzs：/* 特征 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多菜单
- 可使用物品、标志、可配置的命令打开菜单
- 自定义占位符和符号
- 高质量代码
- 支持经济插件，可支持Vault（可选）
- 自动检测新版本

== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-11-18T01:58:26Z

Lzs：/* 有用的一些前置插件 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=Chest Commands Gui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|源地址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 扩展插件 ==
Player Points - 额外货币
Scheduled Commands - 定时执行命令
Info Book - 首次登陆赠送教程书

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

PlayerPoints

2016-03-14T16:47:50Z

Lzs：/* vote: */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: 是否使用Votifier监听器(默认: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)

=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== 概述 ===
新的API允许开发人员对是否交易得到反馈.而你仍然可以使用旧的方法调用
控制台命令,这些方法可以让你完成同样的事情,而不必通过控制台.
在你的plugin.yml中,确保PlayerPoints添加依赖关系.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
该API中的所有方法都有JavaDoc.以下是引用的副本.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.

== Event ==
每当玩家点券数量被修改PlayerPoints将发出事件.
事件可以进行修改与取消.
=== 玩家点券更改事件 ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== 玩家点券重置事件 ===
Called when the player's points will be reset.

== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T16:46:46Z

Lzs：/* Overview */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== 概述 ===
新的API允许开发人员对是否交易得到反馈.而你仍然可以使用旧的方法调用
控制台命令,这些方法可以让你完成同样的事情,而不必通过控制台.
在你的plugin.yml中,确保PlayerPoints添加依赖关系.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
该API中的所有方法都有JavaDoc.以下是引用的副本.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.

== Event ==
每当玩家点券数量被修改PlayerPoints将发出事件.
事件可以进行修改与取消.
=== 玩家点券更改事件 ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== 玩家点券重置事件 ===
Called when the player's points will be reset.

== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T16:40:12Z

Lzs：/* JavaDocs */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
该API中的所有方法都有JavaDoc.以下是引用的副本.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.

== Event ==
每当玩家点券数量被修改PlayerPoints将发出事件.
事件可以进行修改与取消.
=== 玩家点券更改事件 ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== 玩家点券重置事件 ===
Called when the player's points will be reset.

== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T16:38:03Z

Lzs：/* Event */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
All the methods in the API have JavaDocs. Here is a copy of that reference.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.
== Event ==
每当玩家点券数量被修改PlayerPoints将发出事件.
事件可以进行修改与取消.
=== 玩家点券更改事件 ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== 玩家点券重置事件 ===
Called when the player's points will be reset.

== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

ParticleMenu

2016-03-14T16:32:11Z

Lzs：/* 命令 & 权限 */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令与权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己ParticleMenu箱子.
|-
| /particlemenu stopall || 清除所有人的粒子效果.
|-
| /particlemenu heart || 爱心效果.
|-
| /particlemenu note || 音符效果.
|-
| /particlemenu flame || 火焰效果.
|-
| /particlemenu water || 雨水效果.
|-
| /particlemenu lava || 岩浆效果.
|-
| /particlemenu enchantment || 魔法效果.
|-
| /particlemenu swirl || 涡状效果.
|-
| /particlemenu redstone || 红石效果.
|-
| /particlemenu witch || 巫术效果.
|-
| /particlemenu witch || 危险效果.
|-
| /particlemenu colorful || 彩色效果.
|-
| /particlemenu smoke || 烟雾效果.
|-
| /particlemenu smoke || 快乐效果.
|-
| /particlemenu angry || 愤怒效果.
|-
| /particlemenu stop || 停止效果.
|-
| /particlemenu update || 检查效果.
|}

{| class="wikitable"
|-
! 权限!! 描述
|-
| ParticleMenu.open || 可开启ParticleMenu GUI.
|-
| ParticleMenu.use.* || 可使用所有ParticleMenu.
|-
| ParticleMenu.reload || 可重载ParticleMenu.
|-
| ParticleMenu.itemOnJoin || 在加入时可获得ParticleMenu箱子.
|-
| ParticleMenu.chest || 在加入时可打开箱子.
|-
| ParticleMenu.stopall || 可停止所有粒子效果.
|-
| ParticleMenu.use.heart || 可使用爱心效果.
|-
| ParticleMenu.use.note || 可使用音符效果.
|-
| ParticleMenu.use.flame || 可使用火焰效果.
|-
| ParticleMenu.use.water || 可使用雨水效果.
|-
| ParticleMenu.use.lava || 可使用岩浆效果.
|-
| ParticleMenu.use.enchantment || 可使用魔法效果.
|-
| ParticleMenu.use.swirl || 可使用涡状效果.
|-
| ParticleMenu.use.redstone || 可使用红石效果.
|-
| ParticleMenu.use.witch || 可使用巫术效果.
|-
| ParticleMenu.use.critical || 可使用危险效果.
|-
| ParticleMenu.use.colorful || 可使用彩色效果.
|-
| ParticleMenu.use.smoke || 可使用烟雾效果.
|-
| ParticleMenu.use.happy || 可使用快乐效果.
|-
| ParticleMenu.use.angry || 可使用愤怒效果.
|-
| ParticleMenu.use.stop || 可停止效果
|-
| ParticleMenu.update || 可检测更新
|}

=配置=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
消息:
activate: '&a你已激活: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'

# ParticleMenu配置
ParticleMenu:
前缀: '&7[&9粒子菜单&7]'
invprefix: '&7[&9粒子菜单&7]'
箱子名称: '&7[&9粒子菜单&7]'
消息:
启用: '&a你已激活: '
爱心: '&4爱心'
音符: '&2音符'
火焰: '&6火焰'
雨水: '&3雨水'
岩浆: '&c岩浆'
魔法: '&f魔法'
涡状: '&f涡状'
红石: '&c红石'
巫术: '&5巫术'
危险: '&f危险'
彩色: '&b彩色'
烟雾: '&8烟雾'
快乐: '&2快乐'
愤怒: '&4愤怒'
停止: '&4粒子效果已清除!'
已停止: '&c你没有效果可以被清除!'
权限: '&c你没有权限!'
重载: '&a配置文件已重载!'
停止所有: '&4已停止所有粒子效果.'
库存消息:
爱心: '&4爱心效果'
音符: '&2音符效果'
火焰: '&6火焰效果'
雨水: '&3雨水效果'
岩浆: '&c岩浆效果'
魔法: '&f魔法效果'
涡状: '&f涡状效果'
红石: '&c红石效果'
巫术: '&5巫术效果'
危险: '&f危险效果'
彩色: '&b彩色效果'
烟雾: '&8烟雾效果'
快乐: '&2快乐效果'
愤怒: '&4愤怒效果'
清楚: '&4清楚效果'
noperm: '&c你没有这个粒子效果的权限!'
设置:
自动更新: '开'
加入物品: '关'
itemSlotOnJoin: '0'
范围: '0.4'
高度: '2.0'
刷新时间: '2'
角度: '4'

=Tickets=
1. 你能重现步骤,直到缺陷发生吗?如果这样的话,怎么做?

是的.这就是你所需要做的所有事.

2. 您正在使用什么版本的ParticleMenu?

v1.0

3. 您正在使用什么版本的Java?

Java 7

4. 预期的输出是什么?

打开ParticleMenu的GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T16:26:49Z

Lzs：/* Configuration */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己ParticleMenu箱子.
|-
| /particlemenu stopall || 清除所有人的粒子效果.
|-
| /particlemenu heart || 爱心效果.
|-
| /particlemenu note || 音符效果.
|-
| /particlemenu flame || 火焰效果.
|-
| /particlemenu water || 雨水效果.
|-
| /particlemenu lava || 岩浆效果.
|-
| /particlemenu enchantment || 魔法效果.
|-
| /particlemenu swirl || 涡状效果.
|-
| /particlemenu redstone || 红石效果.
|-
| /particlemenu witch || 巫术效果.
|-
| /particlemenu witch || 危险效果.
|-
| /particlemenu colorful || 彩色效果.
|-
| /particlemenu smoke || 烟雾效果.
|-
| /particlemenu smoke || 快乐效果.
|-
| /particlemenu angry || 愤怒效果.
|-
| /particlemenu stop || 停止效果.
|-
| /particlemenu update || 检查效果.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=配置=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
消息:
activate: '&a你已激活: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'

# ParticleMenu配置
ParticleMenu:
前缀: '&7[&9粒子菜单&7]'
invprefix: '&7[&9粒子菜单&7]'
箱子名称: '&7[&9粒子菜单&7]'
消息:
启用: '&a你已激活: '
爱心: '&4爱心'
音符: '&2音符'
火焰: '&6火焰'
雨水: '&3雨水'
岩浆: '&c岩浆'
魔法: '&f魔法'
涡状: '&f涡状'
红石: '&c红石'
巫术: '&5巫术'
危险: '&f危险'
彩色: '&b彩色'
烟雾: '&8烟雾'
快乐: '&2快乐'
愤怒: '&4愤怒'
停止: '&4粒子效果已清除!'
已停止: '&c你没有效果可以被清除!'
权限: '&c你没有权限!'
重载: '&a配置文件已重载!'
停止所有: '&4已停止所有粒子效果.'
库存消息:
爱心: '&4爱心效果'
音符: '&2音符效果'
火焰: '&6火焰效果'
雨水: '&3雨水效果'
岩浆: '&c岩浆效果'
魔法: '&f魔法效果'
涡状: '&f涡状效果'
红石: '&c红石效果'
巫术: '&5巫术效果'
危险: '&f危险效果'
彩色: '&b彩色效果'
烟雾: '&8烟雾效果'
快乐: '&2快乐效果'
愤怒: '&4愤怒效果'
清楚: '&4清楚效果'
noperm: '&c你没有这个粒子效果的权限!'
设置:
自动更新: '开'
加入物品: '关'
itemSlotOnJoin: '0'
范围: '0.4'
高度: '2.0'
刷新时间: '2'
角度: '4'

=Tickets=
1. 你能重现步骤,直到缺陷发生吗?如果这样的话,怎么做?

是的.这就是你所需要做的所有事.

2. 您正在使用什么版本的ParticleMenu?

v1.0

3. 您正在使用什么版本的Java?

Java 7

4. 预期的输出是什么?

打开ParticleMenu的GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T16:26:26Z

Lzs：/* Configuration */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己ParticleMenu箱子.
|-
| /particlemenu stopall || 清除所有人的粒子效果.
|-
| /particlemenu heart || 爱心效果.
|-
| /particlemenu note || 音符效果.
|-
| /particlemenu flame || 火焰效果.
|-
| /particlemenu water || 雨水效果.
|-
| /particlemenu lava || 岩浆效果.
|-
| /particlemenu enchantment || 魔法效果.
|-
| /particlemenu swirl || 涡状效果.
|-
| /particlemenu redstone || 红石效果.
|-
| /particlemenu witch || 巫术效果.
|-
| /particlemenu witch || 危险效果.
|-
| /particlemenu colorful || 彩色效果.
|-
| /particlemenu smoke || 烟雾效果.
|-
| /particlemenu smoke || 快乐效果.
|-
| /particlemenu angry || 愤怒效果.
|-
| /particlemenu stop || 停止效果.
|-
| /particlemenu update || 检查效果.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
消息:
activate: '&a你已激活: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'

# ParticleMenu配置
ParticleMenu:
前缀: '&7[&9粒子菜单&7]'
invprefix: '&7[&9粒子菜单&7]'
箱子名称: '&7[&9粒子菜单&7]'
消息:
启用: '&a你已激活: '
爱心: '&4爱心'
音符: '&2音符'
火焰: '&6火焰'
雨水: '&3雨水'
岩浆: '&c岩浆'
魔法: '&f魔法'
涡状: '&f涡状'
红石: '&c红石'
巫术: '&5巫术'
危险: '&f危险'
彩色: '&b彩色'
烟雾: '&8烟雾'
快乐: '&2快乐'
愤怒: '&4愤怒'
停止: '&4粒子效果已清除!'
已停止: '&c你没有效果可以被清除!'
权限: '&c你没有权限!'
重载: '&a配置文件已重载!'
停止所有: '&4已停止所有粒子效果.'
库存消息:
爱心: '&4爱心效果'
音符: '&2音符效果'
火焰: '&6火焰效果'
雨水: '&3雨水效果'
岩浆: '&c岩浆效果'
魔法: '&f魔法效果'
涡状: '&f涡状效果'
红石: '&c红石效果'
巫术: '&5巫术效果'
危险: '&f危险效果'
彩色: '&b彩色效果'
烟雾: '&8烟雾效果'
快乐: '&2快乐效果'
愤怒: '&4愤怒效果'
清楚: '&4清楚效果'
noperm: '&c你没有这个粒子效果的权限!'
设置:
自动更新: '开'
加入物品: '关'
itemSlotOnJoin: '0'
范围: '0.4'
高度: '2.0'
刷新时间: '2'
角度: '4'

=Tickets=
1. 你能重现步骤,直到缺陷发生吗?如果这样的话,怎么做?

是的.这就是你所需要做的所有事.

2. 您正在使用什么版本的ParticleMenu?

v1.0

3. 您正在使用什么版本的Java?

Java 7

4. 预期的输出是什么?

打开ParticleMenu的GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T16:26:03Z

Lzs：

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己ParticleMenu箱子.
|-
| /particlemenu stopall || 清除所有人的粒子效果.
|-
| /particlemenu heart || 爱心效果.
|-
| /particlemenu note || 音符效果.
|-
| /particlemenu flame || 火焰效果.
|-
| /particlemenu water || 雨水效果.
|-
| /particlemenu lava || 岩浆效果.
|-
| /particlemenu enchantment || 魔法效果.
|-
| /particlemenu swirl || 涡状效果.
|-
| /particlemenu redstone || 红石效果.
|-
| /particlemenu witch || 巫术效果.
|-
| /particlemenu witch || 危险效果.
|-
| /particlemenu colorful || 彩色效果.
|-
| /particlemenu smoke || 烟雾效果.
|-
| /particlemenu smoke || 快乐效果.
|-
| /particlemenu angry || 愤怒效果.
|-
| /particlemenu stop || 停止效果.
|-
| /particlemenu update || 检查效果.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
消息:
activate: '&a你已激活: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'

settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'

# ParticleMenu配置
ParticleMenu:
前缀: '&7[&9粒子菜单&7]'
invprefix: '&7[&9粒子菜单&7]'
箱子名称: '&7[&9粒子菜单&7]'
消息:
启用: '&a你已激活: '
爱心: '&4爱心'
音符: '&2音符'
火焰: '&6火焰'
雨水: '&3雨水'
岩浆: '&c岩浆'
魔法: '&f魔法'
涡状: '&f涡状'
红石: '&c红石'
巫术: '&5巫术'
危险: '&f危险'
彩色: '&b彩色'
烟雾: '&8烟雾'
快乐: '&2快乐'
愤怒: '&4愤怒'
停止: '&4粒子效果已清除!'
已停止: '&c你没有效果可以被清除!'
权限: '&c你没有权限!'
重载: '&a配置文件已重载!'
停止所有: '&4已停止所有粒子效果.'
库存消息:
爱心: '&4爱心效果'
音符: '&2音符效果'
火焰: '&6火焰效果'
雨水: '&3雨水效果'
岩浆: '&c岩浆效果'
魔法: '&f魔法效果'
涡状: '&f涡状效果'
红石: '&c红石效果'
巫术: '&5巫术效果'
危险: '&f危险效果'
彩色: '&b彩色效果'
烟雾: '&8烟雾效果'
快乐: '&2快乐效果'
愤怒: '&4愤怒效果'
清楚: '&4清楚效果'
noperm: '&c你没有这个粒子效果的权限!'
设置:
自动更新: '开'
加入物品: '关'
itemSlotOnJoin: '0'
范围: '0.4'
高度: '2.0'
刷新时间: '2'
角度: '4'
=Tickets=
1. 你能重现步骤,直到缺陷发生吗?如果这样的话,怎么做?

是的.这就是你所需要做的所有事.

2. 您正在使用什么版本的ParticleMenu?

v1.0

3. 您正在使用什么版本的Java?

Java 7

4. 预期的输出是什么?

打开ParticleMenu的GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T15:55:04Z

Lzs：/* 命令 & 权限 */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己ParticleMenu箱子.
|-
| /particlemenu stopall || 清除所有人的粒子效果.
|-
| /particlemenu heart || 爱心效果.
|-
| /particlemenu note || 音符效果.
|-
| /particlemenu flame || 火焰效果.
|-
| /particlemenu water || 雨水效果.
|-
| /particlemenu lava || 岩浆效果.
|-
| /particlemenu enchantment || 魔法效果.
|-
| /particlemenu swirl || 涡状效果.
|-
| /particlemenu redstone || 红石效果.
|-
| /particlemenu witch || 巫术效果.
|-
| /particlemenu witch || 危险效果.
|-
| /particlemenu colorful || 多色效果.
|-
| /particlemenu smoke || 烟雾效果.
|-
| /particlemenu smoke || 快乐效果.
|-
| /particlemenu angry || 愤怒效果.
|-
| /particlemenu stop || 停止效果.
|-
| /particlemenu update || 检查效果.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
messages:
activate: '&aYou activated: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'
=Tickets=
1. Can you re-create the steps until the defect occurred? If so, how?

Yes. All you have to do is /pm.

2. What version of ParticleMenu are you using?

v1.0

3. What version of Java are you using?

Java 7

4. What is the expected output?

Open the ParticleMenu GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T15:54:43Z

Lzs：/* 命令 & 权限 */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己ParticleMenu箱子.
|-
| /particlemenu stopall || 清除所有人的粒子效果.
|-
| /particlemenu heart || 爱心效果.
|-
| /particlemenu note || 音符效果.
|-
| /particlemenu flame || 火焰效果.
|-
| /particlemenu water || 雨水效果.
|-
| /particlemenu lava || 岩浆效果.
|-
| /particlemenu enchantment || 魔法效果.
|-
| /particlemenu swirl || 涡状形效果.
|-
| /particlemenu redstone || 红石效果.
|-
| /particlemenu witch || 巫术效果.
|-
| /particlemenu witch || 危险效果.
|-
| /particlemenu colorful || 多色效果.
|-
| /particlemenu smoke || 烟雾效果.
|-
| /particlemenu smoke || 快乐效果.
|-
| /particlemenu angry || 愤怒效果.
|-
| /particlemenu stop || 停止效果.
|-
| /particlemenu update || 检查效果.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
messages:
activate: '&aYou activated: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'
=Tickets=
1. Can you re-create the steps until the defect occurred? If so, how?

Yes. All you have to do is /pm.

2. What version of ParticleMenu are you using?

v1.0

3. What version of Java are you using?

Java 7

4. What is the expected output?

Open the ParticleMenu GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T15:48:17Z

Lzs：/* 自动更新 */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu使用Gravity的更新自动安装到你的服务器.如果您想禁用自动更新,你可以进入配置文件,并根据设置,设置automaticUpdating为false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己 ParticleMenu Chest.
|-
| /particlemenu stopall || 清除所有人的粒子(Particles).
|-
| /particlemenu heart || Heart Effect.
|-
| /particlemenu note || Note Effect.
|-
| /particlemenu flame || Flame Effect.
|-
| /particlemenu water || Water Effect.
|-
| /particlemenu lava || Lava Effect.
|-
| /particlemenu enchantment || Enchantment Effect.
|-
| /particlemenu swirl || Swirl Effect.
|-
| /particlemenu redstone || Redstone Effect.
|-
| /particlemenu witch || Witch Effect.
|-
| /particlemenu witch || Critical Effect.
|-
| /particlemenu colorful || Colorful Effect.
|-
| /particlemenu smoke || Smoke Effect.
|-
| /particlemenu smoke || Happy Effect.
|-
| /particlemenu angry || Angry Effect.
|-
| /particlemenu stop || Stop Effects.
|-
| /particlemenu update || Check for Updates.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
messages:
activate: '&aYou activated: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'
=Tickets=
1. Can you re-create the steps until the defect occurred? If so, how?

Yes. All you have to do is /pm.

2. What version of ParticleMenu are you using?

v1.0

3. What version of Java are you using?

Java 7

4. What is the expected output?

Open the ParticleMenu GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T15:45:00Z

Lzs：/* Plugin Metrics */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==插件指标==
ParticleMenu使用Hidendra插件的指标体系.发送到mcstats.org的信息,是完全匿名的,公开的,并包含以下指标:

* 唯一标识符
* 服务器的Java版本
* 服务器是否处于脱机或联机模式
* 插件版本
* 服务器版本
* 操作系统版本/名称和架构
* CPU核心数量
* 服务器在线人数
* 指标版本

==自动更新==
ParticleMenu uses Gravity's Updater to automatically install updates to your server. If you would like to disable automatic updating, you can go into the configuration file, and under settings, set automaticUpdating to false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己 ParticleMenu Chest.
|-
| /particlemenu stopall || 清除所有人的粒子(Particles).
|-
| /particlemenu heart || Heart Effect.
|-
| /particlemenu note || Note Effect.
|-
| /particlemenu flame || Flame Effect.
|-
| /particlemenu water || Water Effect.
|-
| /particlemenu lava || Lava Effect.
|-
| /particlemenu enchantment || Enchantment Effect.
|-
| /particlemenu swirl || Swirl Effect.
|-
| /particlemenu redstone || Redstone Effect.
|-
| /particlemenu witch || Witch Effect.
|-
| /particlemenu witch || Critical Effect.
|-
| /particlemenu colorful || Colorful Effect.
|-
| /particlemenu smoke || Smoke Effect.
|-
| /particlemenu smoke || Happy Effect.
|-
| /particlemenu angry || Angry Effect.
|-
| /particlemenu stop || Stop Effects.
|-
| /particlemenu update || Check for Updates.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
messages:
activate: '&aYou activated: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'
=Tickets=
1. Can you re-create the steps until the defect occurred? If so, how?

Yes. All you have to do is /pm.

2. What version of ParticleMenu are you using?

v1.0

3. What version of Java are you using?

Java 7

4. What is the expected output?

Open the ParticleMenu GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T15:38:13Z

Lzs：/* 特性 */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* 旋转粒子效果
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！

==Plugin Metrics==
ParticleMenu uses Hidendra's plugin metrics system. The information sent to mcstats.org is completely anonymous, publicly viewable, and includes the following metrics:

* A unique identifier
* The server's version of Java
* Whether the server is in offline or online mode
* The plugin's version
* The server's version
* The OS version/name and architecture
* The core count for the CPU
* The number of players online
* The Metrics version
==自动更新==
ParticleMenu uses Gravity's Updater to automatically install updates to your server. If you would like to disable automatic updating, you can go into the configuration file, and under settings, set automaticUpdating to false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己 ParticleMenu Chest.
|-
| /particlemenu stopall || 清除所有人的粒子(Particles).
|-
| /particlemenu heart || Heart Effect.
|-
| /particlemenu note || Note Effect.
|-
| /particlemenu flame || Flame Effect.
|-
| /particlemenu water || Water Effect.
|-
| /particlemenu lava || Lava Effect.
|-
| /particlemenu enchantment || Enchantment Effect.
|-
| /particlemenu swirl || Swirl Effect.
|-
| /particlemenu redstone || Redstone Effect.
|-
| /particlemenu witch || Witch Effect.
|-
| /particlemenu witch || Critical Effect.
|-
| /particlemenu colorful || Colorful Effect.
|-
| /particlemenu smoke || Smoke Effect.
|-
| /particlemenu smoke || Happy Effect.
|-
| /particlemenu angry || Angry Effect.
|-
| /particlemenu stop || Stop Effects.
|-
| /particlemenu update || Check for Updates.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
messages:
activate: '&aYou activated: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'
=Tickets=
1. Can you re-create the steps until the defect occurred? If so, how?

Yes. All you have to do is /pm.

2. What version of ParticleMenu are you using?

v1.0

3. What version of Java are you using?

Java 7

4. What is the expected output?

Open the ParticleMenu GUI.
[[Category:娱乐]]

ParticleMenu

2016-03-14T15:37:06Z

Lzs：/* Introduction */

{{待翻译}}
{{Bukkit Plugin Infobox
|版本=v.2.2
|前置插件=无
|兼容服务端版本=CraftBukkit 1.7.9-R0.2
}}

=主菜单=
==介绍==
ParticleMenu是一款有趣,轻量,并且EULA友好的插件。可以非常简单得安装到你的服务器上!ParticleMenu添加了一个GUI，能使炫酷的粒子效果在你的眼前旋转! ParticleMenu是完全可定制的,包括消息, 前缀,加入物品,以及更多.

==特性==
* 极好的GUI视图
* Rotating Particle
* 可移动
* 轻量级
* 简单的配置文件
* 自定义消息
* 自定义代码
* 支持颜色代码
* 音效
* 权限
* 可加入物品
* 自定义半径和高度
* 自动更新
* 友好的最终用户协议
* 还有更多！
==Plugin Metrics==
ParticleMenu uses Hidendra's plugin metrics system. The information sent to mcstats.org is completely anonymous, publicly viewable, and includes the following metrics:

* A unique identifier
* The server's version of Java
* Whether the server is in offline or online mode
* The plugin's version
* The server's version
* The OS version/name and architecture
* The core count for the CPU
* The number of players online
* The Metrics version
==自动更新==
ParticleMenu uses Gravity's Updater to automatically install updates to your server. If you would like to disable automatic updating, you can go into the configuration file, and under settings, set automaticUpdating to false.

=安装方法=
# 下载 ParticleMenu 的最新版本
# 关掉服务器
# 把 ParticleMenu.jar 放进插件文件夹内
# 打开服务器
# 成功安装！

=命令 & 权限=
这些命令可以简写为 /pm 或者 /ptm!
{| class="wikitable"
|-
! 命令 !! 描述
|-
| /particlemenu || 打开主菜单.
|-
| /particlemenu reload || 重新加载此插件.
|-
| /particlemenu chest || 给自己 ParticleMenu Chest.
|-
| /particlemenu stopall || 清除所有人的粒子(Particles).
|-
| /particlemenu heart || Heart Effect.
|-
| /particlemenu note || Note Effect.
|-
| /particlemenu flame || Flame Effect.
|-
| /particlemenu water || Water Effect.
|-
| /particlemenu lava || Lava Effect.
|-
| /particlemenu enchantment || Enchantment Effect.
|-
| /particlemenu swirl || Swirl Effect.
|-
| /particlemenu redstone || Redstone Effect.
|-
| /particlemenu witch || Witch Effect.
|-
| /particlemenu witch || Critical Effect.
|-
| /particlemenu colorful || Colorful Effect.
|-
| /particlemenu smoke || Smoke Effect.
|-
| /particlemenu smoke || Happy Effect.
|-
| /particlemenu angry || Angry Effect.
|-
| /particlemenu stop || Stop Effects.
|-
| /particlemenu update || Check for Updates.
|}

{| class="wikitable"
|-
! Permission !! Description
|-
| ParticleMenu.open || Permission to open the ParticleMenu GUI.
|-
| ParticleMenu.use.* || Permission to use all of ParticleMenu.
|-
| ParticleMenu.reload || Permission to reload ParticleMenu.
|-
| ParticleMenu.itemOnJoin || Permission to get the ParticleMenu Chest on join.
|-
| ParticleMenu.chest || Permission to open the Chest on Join.
|-
| ParticleMenu.stopall || Permission to stop all the particles.
|-
| ParticleMenu.use.heart || Permission to use the Heart Effect.
|-
| ParticleMenu.use.note || Permission to use the Note Effect.
|-
| ParticleMenu.use.flame || Permission to use the Flame Effect.
|-
| ParticleMenu.use.water || Permission to use the Water Effect.
|-
| ParticleMenu.use.lava || Permission to use the Lava Effect.
|-
| ParticleMenu.use.enchantment || Permission to use the Enchantment Effect.
|-
| ParticleMenu.use.swirl || Permission to use the Swirl Effect.
|-
| ParticleMenu.use.redstone || Permission to use the Redstone Effect.
|-
| ParticleMenu.use.witch || Permission to use the Witch Effect.
|-
| ParticleMenu.use.critical || Permission to use the Critical Effect.
|-
| ParticleMenu.use.colorful || Permission to use the Colorful Effect.
|-
| ParticleMenu.use.smoke || Permission to use the Smoke Effect.
|-
| ParticleMenu.use.happy || Permission to use the Happy Effect.
|-
| ParticleMenu.use.angry || Permission to use the Angry Effect.
|-
| ParticleMenu.use.stop || Permission to Stop your Effect.
|-
| ParticleMenu.update || Permission to Check for Updates.
|}

=Configuration=

# ParticleMenu Configuration
ParticleMenu:
prefix: '&7[&9ParticleMenu&7]'
invprefix: '&7[&9ParticleMenu&7]'
chestname: '&7[&9ParticleMenu&7]'
messages:
activate: '&aYou activated: '
heart: '&4Heart'
note: '&2Note'
flame: '&6Flame'
water: '&3Water'
lava: '&cLava'
enchantment: '&fEnchantment'
swirl: '&fSwirl'
redstone: '&cRedstone'
witch: '&5Witch'
critical: '&fCritical'
colorful: '&bColorful Effect'
smoke: '&8Smoke'
happy: '&2Happy'
angry: '&4Angry'
stop: '&4Effect Cleared!'
alreadystop: '&cYou do not have an effect to clear!'
permission: '&cYou do not have permission!'
reload: '&aConfiguration Reloaded!'
stopall: '&4All Particles have been stopped.'
inventorymessages:
heart: '&4Heart Effect'
note: '&2Note Effect'
flame: '&6Flame Effect'
water: '&3Water Effect'
lava: '&cLava Effect'
enchantment: '&fEnchantment Effect'
swirl: '&fSwirl Effect'
redstone: '&cRedstone Effect'
witch: '&5Witch Effect'
critical: '&fCritical Effect'
colorful: '&bColorful Effect'
smoke: '&8Smoke Effect'
happy: '&2Happy Effect'
angry: '&4Angry Effect'
stop: '&4Clear Effects'
noperm: '&cYou do not have permission to this effect!'
settings:
automaticUpdating: 'true'
itemOnJoin: 'false'
itemSlotOnJoin: '0'
radius: '0.4'
height: '2.0'
refreshtime: '2'
angle: '4'
=Tickets=
1. Can you re-create the steps until the defect occurred? If so, how?

Yes. All you have to do is /pm.

2. What version of ParticleMenu are you using?

v1.0

3. What version of Java are you using?

Java 7

4. What is the expected output?

Open the ParticleMenu GUI.
[[Category:娱乐]]

PlayerPoints

2016-03-14T15:06:26Z

Lzs：/* : */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
All the methods in the API have JavaDocs. Here is a copy of that reference.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.
== Event ==
PlayerPoints sends out events whenever a player's point amount will be modified.
Events can be modified and cancelled.
=== PlayerPointsChangeEvent ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== PlayerPointsResetEvent ===
Called when the player's points will be reset.
== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T15:05:58Z

Lzs：

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== : ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
All the methods in the API have JavaDocs. Here is a copy of that reference.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.
== Event ==
PlayerPoints sends out events whenever a player's point amount will be modified.
Events can be modified and cancelled.
=== PlayerPointsChangeEvent ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== PlayerPointsResetEvent ===
Called when the player's points will be reset.
== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T15:03:59Z

Lzs：/* Storage(储存): */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== 储存: ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== 版本: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
All the methods in the API have JavaDocs. Here is a copy of that reference.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.
== Event ==
PlayerPoints sends out events whenever a player's point amount will be modified.
Events can be modified and cancelled.
=== PlayerPointsChangeEvent ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== PlayerPointsResetEvent ===
Called when the player's points will be reset.
== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T15:03:47Z

Lzs：/* version: */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage(储存): ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== 版本: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！

=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
All the methods in the API have JavaDocs. Here is a copy of that reference.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.
== Event ==
PlayerPoints sends out events whenever a player's point amount will be modified.
Events can be modified and cancelled.
=== PlayerPointsChangeEvent ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== PlayerPointsResetEvent ===
Called when the player's points will be reset.
== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

PlayerPoints

2016-03-14T15:03:23Z

Lzs：/* storage: */

{{模板:待完善}}
翻译者注：此插件的API和Event部分的翻译，因为水平原因，无法完成，希望有经验的帮忙翻一下=A=
{{Bukkit Plugin Infobox
|插件名=PlayerPoints
|版本=v2.1.3
|前置插件=-
|兼容服务端版本=1.7.4-RO.1
|网址=http://dev.bukkit.org/bukkit-plugins/playerpoints/
}}
== 概览 ==
独立于其他经济插件的点券插件，可作为服务器第二款代币。作者将会增加一些不同的功能，如果你的点券数量足够，你便可以做这些
如果玩家做了一个不错的建筑，管理员便可以给玩家点券以奖励。
如果你的点券达到一定的数量，你将会成为管理员。
Development builds of this project can be acquired at the provided continuous integration server. （不太明白这句） 这些版本没有经过BukkitDev 的批准。需要构建者自己承担风险。
http://mineplugin.org/ChestCommandsGUI
在正版服务器，这个插件将会连接到api.mojang.com来获取玩家的UUID。
=== 特点 ===
:*可以将点券给予玩家。
:*可以从玩家那里拿去点券。
:*向玩家支付点券。
:*查看看其他玩家拥有多少点券？
:*查看你有多少点券？
:*排行榜
:*支持设置权限来限制。
:*可选Vault的支持
:*用点券来购买物品 ([http://dev.bukkit.org/bukkit-plugins/pointshop/ PointShop])
=== 命令 ===
/points pay <玩家名字> <数量> 从你的账户内给予玩家点券。
/points give <玩家名字> <数量> 给予某个玩家点券。
/points take <玩家名字> <数量> 扣除某个玩家的点券。
/points set <玩家名字> <数量> 设置玩家的点券数量。
/points reset <玩家名字> 重置玩家的点券数量。
/points look <玩家名字> 查看某个玩家的点券。
/points me 查看自己的点券数量。
/points lead [next/prev/#]
缩写: /p <give/take/look/me/pay/set/reset>
=== 权限 ===
PlayerPoints.pay 这个权限将会允许你使用pay指令。
PlayerPoints.give 这个权限将会允许你使用give指令。
PlayerPoints.take 这个权限将会允许你使用take指令。
PlayerPoints.set 这个权限将会允许你使用set指令。
PlayerPoints.reset 这个权限将会允许你使用reset指令。
PlayerPoints.look 这个权限将会允许你使用look指令。
PlayerPoints.lead 这个权限将会允许你使用lead指令。
PlayerPoints.me 这个权限将会允许你使用me指令。
=== 视频 ===
请前去官网进行观看

=== 待办事项 ===
得到各国语言的支持。
=== Maven ===
我们支持Maven，只需添加我们的存储库。
<source lang="JavaScript">
<repository>
<id>dakani</id>
<name>Dakani Nexus Repo</name>
<url>http://repo.dakanilabs.com/content/repositories/public</url>
</repository>
</source>
在依赖中加入PlayerPoints。
<source lang="JavaScript">
<dependency>
<groupId>org.black_ixx</groupId>
<artifactId>PlayerPoints</artifactId>
<version>2.1.3</version>
</dependency>
</source>
[https://trello.com/b/Bfy6xx4M/bukkit-plugins Trello开发板]
访问 Trello开发板查看所有项目和待办的事项。
你可以在这里评论和投票所有的主题。
所有的改变都在这里实时呈现。

== Config（配置文件） ==
'''以下选项将出现在Config.yml。'''
=== Storage(储存): ===
这个选项将会定义数据的储存类型，储存方式通常有三种：MySQL、SQLite、YAML。注意这里一定要区分大小写。如果给的是一个无效的选项，将会以默认的YAML
方式处理（这个选项的默认是YMAL）

=== vault: ===
这个选项定义了是否与Vault对接，请注意，任何其他的经济插件都会考虑这一个（这个选项默认的是false）
=== version: ===
这个选项用于标注此配置文件的版本，用于更新的时候使用，注意！请不要修改这个选项！！
=== Mysql: ===
注意这段只有在storage:设置为 MySQL或SQLite的时候才生效
*host:数据库的（ip）地址（这个选项默认参数是localhost）
*port: 数据库的端口（这个选项默认参数是3306）
*database: 数据库名称（这个选项默认参数是minecraft）
*user:登录数据库所使用的用户名（这个选项的默认参数是root）
*password:登录数据库所使用的密码（这个选项的默认参数是pass）
'''其他的一些设置:'''
*use:如果你想设置使用数据库，请设置这项为true（这个选项的默认参数是false）
=== vote: ===
*enabled: Whether or not to use the Votifier listener (Default: false)
*amount: Amount of points to give on a vote event (Default: 100)
*online: Whether the player must be online to receive the points (Default: false)
=== debug: ===
*database: 开启数据库连接的报错显示（这个选项的默认参数是false）
== API ==
=== Overview ===
The new API allows for developers to get feedback on whether or not transactions occurred. While you can still use the old methods of calling
console commands, these methods will allow you to accomplish the same thing without having to go through console.
In your plugin.yml, make sure to add your dependency on PlayerPoints.
Either:
*depend: [PlayerPoints]
Or:
*softdepend: [PlayerPoints]
During enable, you need to grab the PlayerPoints plugin instance and save that reference somewhere as you will be using the API through it.
<source lang="Java">
import org.black_ixx.playerpoints.PlayerPoints;

private PlayerPoints playerPoints;

/**
* Validate that we have access to PlayerPoints
*
* @return True if we have PlayerPoints, else false.
*/
private boolean hookPlayerPoints() {
final Plugin plugin = this.getServer().getPluginManager().getPlugin("PlayerPoints");
playerPoints = PlayerPoints.class.cast(plugin);
return playerPoints != null;
}

/**
* Accessor for other parts of your plugin to retrieve PlayerPoints.
*
* @return PlayerPoints plugin instance
*/
public PlayerPoints getPlayerPoints() {
return playerPoints;
}
</source>
If its not enabled, you're going to have to handle that situation accordingly.

-If it is enabled, then utilizing the API is rather simple. You don't need to get an instance, or hold onto some object. All you have to do
is call the method from static class.- The static access of the API had to be changed in order to service situations where multiple linked
servers are referencing the same MySQL table.

Now, you access the API through the plugin instance that we saved earlier. All the methods of the API are the same as before.
Example:
<source lang="Java">
int balance = playerPoints.getAPI().look("Player");
The above code will return the amount of points that the player named "Player" has.
</source>
Another example:
<source lang="Java">
if(playerPoints.getAPI().take("Player", 100)) {
//Success
} else {
//Failed, probably not enough points
}
</source>
The above code attempts to take 100 points away from the player "Player". As mentioned before, you get feedback on the operation on whether or
not it succeeded in performing the transaction.

=== JavaDocs ===
All the methods in the API have JavaDocs. Here is a copy of that reference.

give(String playername, int amount)
Gives points to specified player
Returns: true if we successfully adjusted points, else false
take(String playername, int amount)
Take points from specified player. If amount given is not already negative, it is done internally.
Returns: true if they had enough points to be removed, else false.
look(String playername)
Look up the current points of a player, if available. If the player is not in the config file, we default to 0.
Returns: integer of the amount of points the player has
pay(String sorce, String target, int amount)
Transfer points from one player to another. Attempts to take the points, if available, from the source player account and then attempts
to give that amount to the target player account. If the give portion fails, the amount taken is returned to the source player account.
Returns: true if the transfer succeeded, else false.
set(String playername, int amount)
Sets a player's points to the given value. This overwrites whatever current amount they had before.
Returns true if successful, else false.
reset(String playername)
Removes the player from the config, effectively removing the points that the player had.
Returns true if successful, else false.
== Event ==
PlayerPoints sends out events whenever a player's point amount will be modified.
Events can be modified and cancelled.
=== PlayerPointsChangeEvent ===
Called when the player's points will be changed. You get the name of the target player and the amount that it will change by.
=== PlayerPointsResetEvent ===
Called when the player's points will be reset.
== GitHub ==
[https://github.com/Mitsugaru/PlayerPoints/ 点击此处去GitHub]
== 相关插件 ==
[http://dev.bukkit.org/bukkit-plugins/bossshop/ BossShop（官网地址）]
[http://dev.bukkit.org/bukkit-plugins/karmiconomy/ Karmiconomy（官网地址）]
[[Category:经济]]
[[Category:修正]]

Essentials

2016-02-18T08:02:50Z

Lzs：/* 相关 */

{{Bukkit Plugin Infobox
|版本=2.13.1
}}
子页面部分内容取自john180原创教程，已获得作者许可。[[File:截图22.png|frame|Essemtials官方图标]]
==简介==
{{待翻译}}
{{:Essentials/Main}} 
Essentials因为指令全面，应用范围广，兼容性强，使用简单等特点因而被广大服务器所使用，国内许多知名服务器都在使用这款插件，

==安装==
[http://wiki.mc-ess.net/wiki/Downloads |下载地址|]
[http://dev.bukkit.org/server-mods/essentials/ |Bukkit内|]
[http://www.mcbbs.net/forum.php?mod=viewthread&tid=155737&highlight=Essentials |MCBBS搬运帖|]
[http://pan.baidu.com/share/init?shareid=2940641890&uk=2601172312 |百度云直通下载_提取码5umq|]
打开/plugins
将下载的文件丢进去
==相关==
[http://mineplugin.org/GroupManager |GorupManager|]是一个权限管理插件。
利用它，你可以创建VIP用户或者做些其他的好玩的事情。
它也是大部分服务器常用的插件，甚至比Essentials还多。

==维基==
[http://wiki.mc-ess.net/wiki/Main_Page '''原地址'''] 
{{:Essentials/维基/命令/标语}}
===命令===
----
[http://wiki.mc-ess.net/wiki/Command_Reference '''原地址''']
<必填>，[选填]，X=无
----
====作弊====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| bigtree || largetree || 生成一颗树 || /bigtree <tree\redwood\jungle>
|-
| break || X || 破坏你看着的方块 || /break
|-
| enchant || enchantment || 附魔手上的物品 || /enchant [附魔类型（输入/enchant查看）] [等级]
|-
| exp || xp || 查看/设置/给与一个玩家经验值 || /exp [玩家]
/exp <show\set\give> [玩家] [经验值\L<等级（值）>]
|-
| feed || eat || 恢复玩家饥饿度 || /feed [玩家](不填默认为自己）
|-
| firework || X || 允许你修改一堆烟花 ||/firework <参数>
/firework <大小|时间> [值]
/firework clear <ref group=c>[[Essentials/firework详解]]</ref>
|-
| fly || X || 让某玩家飞行 (开启/关闭） || /fly [玩家] [on\off]
|-
| gamemode || gm..<ref group=c>还有creative, survival, adventure, gmc, gma, gms, gmt</ref> || 修改玩家的模式 || /gamemode [c\s\a\t\creative\survival\adventure\toggle] [玩家]
|-
| give || X || 给玩家一些物品 （可添加高级属性） || /<command> <player> <item\item:damage value> [amount [enchant:level...]]<ref group=c>[[Essentials/give详解]]</ref>
|-
| god || godmode, tgm || 让某玩家不受伤害 || /god [玩家] [on\off]
|-
| hat || hand || 把手上的物品戴到头上 （方块才有效） \把头上的物品拿下来 || /hat [remove]
|-
| heal || X || 恢复某玩家生命值 || /heal [玩家]
|-
| item || i || 给你一个设置<ref group=c>译者注：原文规则</ref>好的物品 || /item <item\item:damage value> [amount [enchant:level...]]
（后面单独成篇）
|-
| kit || kits || 给某玩家一个礼包 || /<command> [礼包名称] [玩家名称（不填为自己）]
|-
| more || X || 使手上的物品达到最大堆叠 || /more
|-
| ptime || playertime || 改变一个玩家的时间 （即他与其他玩家看到时间不同） || /ptime [list\reset\day\night\dawn\17:30\4pm\4000ticks] <player\*>
|-
| repair || fix || 修复一个或所有物品 || /repair [hand\all]
|-
| skull || playerskull,head || 给与一个玩家的头 || /skull [正版玩家名]
|-
| time || day,night || 改变一个服务器的时间 || /time [day\night\dawn\17:30\4pm\4000ticks] [worldname\all]
|-
| tree || X || 生成一颗树 || /tree
<tree\birch\redwood\redmushroom\brownmushroom\jungle\junglebush\swamp>
|-
| unlimited || ul\unl || 使一个物品得以无限使用 || /unlimited <list\item\clear> [玩家（不填为自己）]
|-
| workbench || wb,wbench || 打开工作台 || /workbench
|-
| speed || flyspeed..<ref group=c>还有walkspeed,fspeed,wspeed</ref> || 改变某玩家的速度 || /speed <速度（值）> [玩家（不填为自己）]
/<command> <walk\fly> <速度（值）> [玩家（不填为自己）]
|}

====经济====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| balance || bal,money || 某玩家的金钱数 || /balance [玩家名（不填为自己）
|-
| balancetop || baltop || 显示财富排行榜 || /balancetop [页数（不填为第一页）]
|-
| eco || economy || 给与\拿走\设置\重置一个玩家的金钱数 || /eco <give\take\reset> <玩家名> [金钱数（值）]
|-
| pay || X || 给某玩家一定量的钱 （从你的账户里提取）<ref group=c>译者注：当值小于0.01时会给0元</ref> || /pay <玩家> <金钱数（值）>
|-
| sell || X || 出售物品 || /sell <物品名\ID> [数量（值）]
/sell <hand\invent\blocks>
|-
| setworth || X || 设置一个物品的价格 || /setworth [物品名\id（不填为手上的物品)] <价格（值）>
|-
| worth || price || 查看一个物品的价格 || /worth [hand\all]
/worth <物品> [数量（值）]
|}

====常用====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| afk || away || 设置是否为AFK状态 || /afk [玩家（不填为自己）]
|-
| book || X || 允许你打开并编辑一本书 || /book [title\author [name]]
|-
| compass || direction || 查看你的朝向 || /compass
|-
| customtext || [make your own] || Allows the creation of custom commands || /<alias> [page]
|-
| depth || height || 查看你的海拔高度 || /depth
|-
| getpos || coords..<ref group=c>还有position, whereami, getlocation, getloc</ref> || 查看（某玩家）坐标 || /getpos [player(不填为自己）]
|-
| help || X || 打开help || /help [页数（设定好的[http://mineplugin.org/Essentials/%E6%95%99%E7%A8%8B#.E9.AB.98.E7.BA.A7.E5.AE.9A.E5.88.B6 help.txt]内容）\插件名\搜索] [页数]
|-
| helpop || amsg,ac || 向在线的op请求帮助 || /helpop <信息>
|-
| ignore || X || 忽略一个玩家 || /ignore <玩家>
|-
| info || ifo..<ref group=c>还有news,about,inform</ref> || 查阅与这个服务器有关的信息!? || /info <page number/chapter>
|-
| itemdb || itemno,durability, dura || 搜索物品 || /itemdb [物品]
|-
| list || who..<ref group=c>还有payerist,online,plist</ref> || [http://mineplugin.org/Essentials/%E6%95%99%E7%A8%8B#list.E7.8E.A9.E5.AE.B6.E5.88.97.E8.A1.A8.E7.9B.B8.E5.85.B3.E8.AE.BE.E7.BD.AE 查看在线的玩家] || /list [用户组]
|-
| mail || email || 发送和查阅短信 || /mail [read\clear\send [to] [信息]]
/mail sendall [信息]
|-
| me || action，describe || （说）你做出动作 || /me <动作>(输出：§1*你的ID 动作）
|-
| motd || X || 查看每日信息 || /motd
|-
| msg || tell..<ref group=c>还有m, t, whisper</ref> || 私聊某玩家 || /msg <玩家> <信息(可带&）>
|-
| near || nearby || 查看附件的玩家 || /near [半径（值）]
/near <玩家名> <半径(值)>
|-
| nick || nickname || 改变玩家的显示名 || /nick [player] [nick\off]
|-
| powertool || pt || 绑定一个命令在你手上的物品 || /powertool [command [arguments]]
（绑定命令）..<ref group=c>非常用格式:
<pre style="white-space: pre-wrap;
white-space: -moz-pre-wrap;
white-space: -pre-wrap;
white-space: -o-pre-wrap;
word-wrap: break-word;">
/powertool c:<消息>
（说出消息）
/powertool [a/r:]<command> <arguments>
（附加命令）
/powertool [d/l]:
（删除命令）
/powertool
（删除全部）
</pre>
</ref>
|-
| powertooltoggle || ptt, pttoggle || 打开或关闭powertool || /powertooltoggle
|-
| r || reply || 快速回复私聊消息 || /r <信息>
|-
| realname || X || 查看一个玩家的原本的用户名 （即nick之前的名字） || /realname <玩家>
|-
| recipe || method, formula, recipes || 查看怎么去合成一个物品 || /recipe <物品> [合成编号!?]
|-
| rules || X || 查看服务器规则 || /rules <页数>
|-
| seen || X || 查看一个玩家最后的下线时间及地点 || /seen <玩家\IP>
|-
| spawner || changms,mobspawner || 改变一个怪物的类型 || /spawner <Mob> <延迟>(为什么后面有一个延迟，我要去试下)
|-
| suicide || X || 传说中的自杀 || /suicide
<ref group=c>权限节点：essentials.suicide
建议在g:essentials_builder组内删除该权限
防止刷饥饿</ref>
|-
| whois || X || 显示一个玩家的信息 || /whois <nickname\playername>
|}

====仲裁====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| antioch || grenade，tnt || bui~手榴弹 || /antioch
|-
| backup || X || 启动回档 || /backup
|-
| ban || X || 禁止一名玩家进入服务器 || /ban <玩家> <理由>
|-
| banip || X || 禁止一个IP进入服务器 || /banip <玩家\IP>
|-
| broadcast || bcast || 发送公告 || /broadcast <信息（可加&)><ref group=c>输出:§2[公告]§4信息</ref>
|-
| burn || X || 使一个玩家着火 || /brun <玩家> <时间（秒）>
|-
| clearinventory || ci, clean, clearinvent || 清空一个玩家的背包 || /clearinventory [玩家]
/clearinventory <玩家> [物品[:<损伤值>]|*|**] [数量]
|-
| deljail || remjail, rmjail || 删除一个监狱 || /deljail <监狱名>
|-
| enderchest || echest,endersee,ec || 查看某玩家的末影箱 || /enderchest [玩家]
|-
| essentials || ess || 回档Ess或重载Ess || /essentials [reload\debug]
/essentials [reset] [玩家]
|-
| ext || extinguish || 熄灭一个玩家身上的火焰 || /ext <玩家>
|-
| fireball || X || 发出一个火球 || /fireball [small]
|-
| gc || lag..<ref group=c>还有mem, memory, uptime, tps, entities</ref> || 查看一个服务器的使用信息 || /gc
|-
| invsee || X || 查看别的玩家的背包 || /invsee <玩家> [加任意字符查看装备]
|-
| jails || X || 监狱列表 || /jails
|-
| kick || X || 把一个玩家提出服务器 || /kick <玩家> <理由>
|-
| kickall || X || 踢出所有非op玩家 || /kickall <理由>
|-
| kill || X || 杀死一枚玩家 || /kill <玩家>
|-
| lightning || strike..<ref group=c>还有smite, thor, shock</ref> || 向你看着的地方放闪电 || /lightning [玩家] [伤害]
|-
| mute || silence || 禁言某玩家 || /mute <玩家> [时间]
|-
| nuke || X || 从天而降许多TNT（不破坏地形) || /nuke [玩家]
|-
| ping || pong,echo || 测试消息<ref group=c>原文Pong！..</ref> || /ping [message（可加&)(不填显示呯！..)]
|-
| remove || butcher, killall, mobkill || 移走世界的特定实体 || /remove <all\drops\xp> [半径\世界]
<ref group=c>
([MineCraftcolor|4|WorldEdit也有相同命令，因为两者格式相同所以不知道是哪个覆盖哪个])
非常用格式：
<pre style="white-space: pre-wrap;
white-space: -moz-pre-wrap;
white-space: -pre-wrap;
white-space: -o-pre-wrap;
word-wrap: break-word;">
/remove <arrows\boats\minecarts\paintings\itemframes\endercrystals> [半径\世界]
/remove <monsters\animals\ambient\mobs\[mobType]> [半径\世界]
</pre>
</ref>
|-
| setjail || createjail || 创建一个新监狱 || /setjail <监狱名>
|-
| socialspy || X || 查看其它玩家的私人消息（例如私聊，附近讲话） || /socialspy [玩家]
|-
| spawnmob || mob|| 生成怪物 || /spawnmob <mob> [数量] [玩家]
<ref group=c>
非常用格式：
<pre style="white-space: pre-wrap;
white-space: -moz-pre-wrap;
white-space: -pre-wrap;
white-space: -o-pre-wrap;
word-wrap: break-word;">
/spawnmob <mob>:<data> [数量] [玩家]
/spawnmob <mob>,<mob>[,<mob>...] [数量 [玩家]
</pre>
</ref>
|-
| sudo || X || 使一个玩家执行一个指令（该玩家需要权限） || /sudo <玩家> <command [args]>
/sudo <玩家> c:<内容>（使玩家强制讲话）
|-
| tempban || X || 临时禁止一个玩家进入服务器 || /tempban <玩家> <时间<ref group=c>（1s=一秒，10m=10分钟，100h=100小时，1000d=1000天）</ref>>
|-
| thunder || X || 是否雷雨天气 || /thunder <true|false> [duration]
|-
| togglejail || tjail, unjail, jail || 变更一个玩家的监狱状态 || /togglejail <玩家> <监狱名> [时间]（进监狱)
/togglejail <玩家> [时间](出监狱）
|-
| unban || pardon || 取消一个玩家的禁止状态 || /unban <玩家>
|-
| unbanip || pardonip || 取消禁止一个IP || /unbanip <玩家名\IP>
|-
| vanish || v || 隐身状态 || /vanish [玩家] [on\off]
|-
| weather || sky..<ref group=c>还有sun, storm, rain</ref> || 改变天气 || /weather <storm\sun> <持续时间>
|}

====主城====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| setspawn || X || 设定出生点（主城） （给一个用户组设定出生点（主城）） || /setspawn [用户组]
|-
| spawn || X || 传送到主城 || /spawn <玩家>
|}

====传送====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| back || return || 返回到上一传送点 || /back
|-
| delhome || remhome,rmhome || 删除一个家 || /delhome <家>
/delhome <玩家>:<家>
|-
| delwarp || remwarp,rmwarp || 删除一个坐标点 || /delwarp <坐标>
|-
| home || homes || 传送到一个家 || /home <家>
/home <玩家>:<家>
|-
| jump || j,jumpto || 传送到你看着的地方|| /jump
|-
| sethome || createhome || 设置一个家 || /sethome <家>
/sethome <玩家>:<家>
|-
| setwarp || createwarp || 建立一个新坐标点 || /setwarp <坐标点>
|-
| top || X || 传送到最高的方块 || /top
|-
| tp || tele, tp2p, teleport || 传送到一个玩家身边 || /tp <玩家>
/tp <玩家1> <玩家2>
|-
| tpa || call,tpask || 请求传送到一个玩家身边 || /tpa <玩家>
|-
| tpaall || X || 向所有人发生一个请求传送你(某玩家)身边来 || /tpaall [玩家]
|-
| tpaccept || tpyes || 同意tpa || /tpacept [玩家]
|-
| tpahere || X || 请求一个玩家传送到你身边来 || /tpahere [玩家]
|-
| tpall || X || 传送所有人到你(某玩家)身边 || /tpall [玩家]
|-
| tpdeny || tpno || 拒绝tpa || /tpdeny
<ref group=c>不知道为什么WiKi后面没加可以拒绝单个玩家的[player],本人亦没试过</ref>
|-
| tphere || s || 将一个玩家传送到你身边 || /tphere [玩家]
|-
| tpo || X || 强行传送到某玩家，无视拒绝传送 || /tpo <玩家>
|-
| tpohere || X || 强行让某玩家传送到自己身边，无视拒绝传送 || /tophere <玩家>
|-
| tppos || X || 传送到某坐标 || /tppos <x> <y> <z> [头左右偏转角度] [头上下倾斜角度]
|-
| tptoggle || X || 开关其他玩家是否能传送到你 || /tptoggle [玩家]
|-
| warp || warps || 传送到坐标点 || /warp [坐标名] [玩家]
|-
| world || X || 允许你传送到其他世界 || /world <nether\normal\0;1;2;3; etc..>
|}

====XMPP====
----
{| class="wikitable"
|-
! 命令 !! 别名 !! 作用 !! 输入格式
|-
| setxmpp || X || 设置你的XMPP地址 || /setxmpp <地址>
|-
| xmpp || X || 发送信息到玩家的XMPP || /xmpp <玩家> <信息>
|-
| xmppspy || X || 开关XMPP监视 || /xmppspy <玩家>
|}

===权限节点===
----
[http://wiki.mc-ess.net/wiki/Command_Reference/Perm '''原地址'''] 
{{:Essentials/维基/命令/标语}}
'''超大当量''','''''慎入'''''

'''这里的绝大多数权限都能对你建设属于你的服务器非常大的帮助！！！'''
{| class="wikitable"
|-
!width=50%| 权限节点
! 作用
|-
! colspan="2"|
==== 作弊 ====
|-
! colspan="2"|bigtree
|-
| essentials.bigtree || 允许使用/bigtree命令
|-
! colspan="2"|break
|-
| essentials.break || 允许使用/break命令
|-
| essentials.break.bedrock || 允许破坏基岩
|-
! colspan="2"|enchant
|-
| essentials.enchant || 允许使用/enchant命令
|-
| essentials.enchantments.[enchantmentname(附魔类型)] || 允许附魔指定的附魔类型
|-
| essentials.enchantments.allowunsafe || 允许附上不安全的附魔
|-
| essentials.exp || 允许使用/exp
|-
| essentials.exp.give || 允许给予经验
|-
| essentials.exp.give.others || 允许给其他人经验
|-
| essentials.exp.others || 允许查看其他人经验
|-
| essentials.exp.set || 允许设置经验
|-
| essentials.exp.set.others || 允许设置其他人经验
|-
! colspan="2"|feed
|-
| essentials.feed || 允许使用feed
|-
| essentials.feed.cooldown.bypass || 跳过feed的冷却
|-
| essentials.feed.others || 允许feed其他人
|-
! colspan="2"|firework
|-
| essentials.firework || 允许使用firework
|-
| essentials.firework.fire || 允许修改手上的烟花
|-
! colspan="2"|fly
|-
| essentials.fly || 允许使用fly
|-
| essentials.fly.others || 允许fly其他人
|-
| essentials.fly.safelogin || 在拥有这个权限并登陆在空中时玩家会自动转换为飞行模式
|-
! colspan="2"|gamemode
|-
| essentials.gamemode || 允许使用gamemode
|-
| essentials.gamemode.others || 允许gamemode其他人
|-
! colspan="2"|give
|-
! colspan="2"|这个命令很可以开发脑洞。。
|-
| essentials.itemspawn.meta-chapter-[chapter] || 允许给与book.txt文件内且只能在其内的book
|-
| essentials.enchantments.[enchantmentname] || 允许给与已经附魔指定的附魔的物品
|-
| essentials.enchantments.allowunsafe || 允许不安全的附魔
|-
| essentials.give || 允许使用give
|-
| essentials.itemspawn.exempt || 允许给与在黑名单中的物品
|-
| essentials.itemspawn.item-<itemname> || 允许给与<物品名>
|-
| essentials.itemspawn.item-[itemid] || 允许给与<物品ID>
|-
| essentials.itemspawn.item-all || 允许给与所有物品
|-
| essentials.itemspawn.meta-author || 允许给与时标记书的作者
|-
| essentials.itemspawn.meta-book || 允许给与预先设置好的book.txt
|-
| essentials.itemspawn.meta-firework || 允许给与设定好的烟花
|-
| essentials.itemspawn.meta-head || 允许给与怪物的头
|-
| essentials.itemspawn.meta-lore || 允许给与时标注Lore属性
|-
| essentials.itemspawn.meta-title || 允许在给与时标注title属性
|-
| essentials.oversizedstacks || 允许在给与时超过自然堆叠数，最多为配置文件内设置的最大堆叠数
|-
! colspan="2"|god
|-
| essentials.god || 允许使用god
|-
| essentials.god.others || 允许god其他人
|-
| essentials.god.pvp || 允许你攻击其他玩家时处于上帝状态
|-
! colspan="2"|hat
|-
| essentials.hat || 允许使用hat
|-
! colspan="2"|heal
|-
| essentials.heal || 允许使用heal
|-
| essentials.heal.cooldown.bypass || 跳过heal的冷却
|-
| essentials.heal.others || 允许heal其他人
|-
! colspan="2"|item
|-
| essentials.itemspawn.meta-chapter-[chapter] || 见give
|-
| essentials.enchantments.[enchantmentname] || 见give
|-
| essentials.enchantments.allowunsafe || 见give
|-
| essentials.item || 允许使用item
|-
| essentials.itemspawn.exempt || 见give
|-
| essentials.itemspawn.item-[itemid] || 见give
|-
| essentials.itemspawn.item-[itemname] || 见give
|-
| essentials.itemspawn.item-all || 见give
|-
| essentials.itemspawn.meta-author || 见give
|-
| essentials.itemspawn.meta-book || 见give
|-
| essentials.itemspawn.meta-book || 见give
|-
| essentials.itemspawn.meta-head || 见give
|-
| essentials.itemspawn.meta-lore || 见give
|-
| essentials.itemspawn.meta-title || 见give
|-
| essentials.oversizedstacks || 见give
|-
! colspan="2"|kit
|-
| essentials.kit || 允许使用/kit命令
|-
| essentials.kit.exemptdelay || 忽略礼包的冷却限制
|-
| essentials.kit.others || 允许赠送其他人礼包
|-
| essentials.kits.* || 允许获得所有礼包
|-
| essentials.kits.[kitname] || 允许获得指定的礼包(指定来源于你设置的[kitname])
|-
! colspan="2"|more
|-
| essentials.more || 允许使用/more命令
|-
| essentials.oversizedstacks || 允许达到配置文件中设置的最大堆叠
|-
! colspan="2"|ptime
|-
| essentials.ptime || 允许使用命令/ptime命令
|-
| essentials.ptime.others || 允许对其他人使用/ptime命令
|-
! colspan="2"|repair
|-
| essentials.repair || 允许使用/repair命令
|-
| essentials.repair.all || 允许在使用/repiar命令时,修复全部物品
|-
| essentials.repair.armor || 允许在使用/repair命令时,修复装甲
|-
| essentials.repair.enchanted || 允许在修复时,修复附魔过的物品
|-
! colspan="2"|skull
|-
| essentials.skull || 允许使用/skull命令
|-
| essentials.skull.modify || 允许修改一个已存在的头
|-
| essentials.skull.others || 允许创造一个属于其他人的头
|-
| essentials.skull.spawn || 允许生成一个头，在玩家没有持有头时
|-
! colspan="2"|speed
|-
| essentials.speed || 允许使用/speed命令
|-
| essentials.speed.bypass || 允许忽略在配置文件|config.fml|中的速度限制
|-
| essentials.speed.fly || 允许修改飞行时的速度
|-
| essentials.speed.others || 允许修改其他玩家的速度
|-
| essentials.speed.walk || 允许修改行走时的速度
|-
! colspan="2"|time
|-
| essentials.time || 允许使用/time命令
|-
| essentials.time.set || 允许设置世界的时间
|-
! colspan="2"|tree
|-
| essentials.tree || 允许使用/tree命令
|-
! colspan="2"|unlimited
|-
| essentials.unlimited || 允许使用/unlimited
|-
| essentials.unlimited.item-[itemid] || 允许通过unlimited无限使用指定的相对应ID的物品(指定来源于你设置的[itemid])
|-
| essentials.unlimited.item-[itemname] || 允许通过unlimited无限使用指定的相对应名称的物品(指定来源于你设置的[itemname])
|-
| essentials.unlimited.item-all || 允许通过unlimited无限使用所有物品
|-
| essentials.unlimited.item-bucket || 允许通过unlimited无限使用桶装的岩浆及水
|-
| essentials.unlimited.others || 允许以其他玩家作为unlimited的目标
|-
! colspan="2"|workbench
|-
| essentials.workbench || 允许使用/workbench命令
|-
! colspan="2"|
==== 经济 ====
|-
! colspan="2"|balance
|-
| essentials.balance || 允许使用/balance命令
|-
| essentials.balance.others || 允许查阅别人的金钱
|-
| essentials.balancetop || 允许使用/balancetop命令
|-
! colspan="2"|eco
|-
| essentials.eco || 允许使用/eco命令
|-
| essentials.eco.loan || 允许透支
|-
! colspan="2"|pay
|-
| essentials.pay || 允许你使用/pay命令
|-
| essentials.pay.multiple || 允许你同时给许多人钱
|-
! colspan="2"|sell
|-
| essentials.sell || 允许使用命令/sell
|-
! colspan="2"|setworth
|-
| essentials.setworth || 允许使用命令/setworth
|-
! colspan="2"|worth
|-
| essentials.worth || 允许使用命令/worth
|-
! colspan="2"|
==== 常用 ====
|-
! colspan="2"|afk
|-
| essentials.afk || 允许使用命令/afk
|-
| essentials.afk.auto || 允许达到配置文件中设置的时间后进入afk状态
|-
| essentials.afk.kickexempt || 免除超过afk限制时间后被踢出
|-
| essentials.afk.others || 允许对其他人使用/afk命令
|-
! colspan="2"|book
|-
| essentials.book || 允许使用/book命令
|-
| essentials.book.author || 允许修改书的作者
|-
| essentials.book.others || 允许编辑其他人的书
|-
| essentials.book.title || 允许修改书本的标题
|-
! colspan="2"|compass
|-
| essentials.compass || 允许使用/compass命令
|-
! colspan="2"|customtext
|-
| essentials.customtext || 允许使用/customtext命令
|-
! colspan="2"|depth
|-
| essentials.depth || 允许使用/depth命令
|-
! colspan="2"|getpos
|-
| essentials.getpos || 允许使用/getpos命令
|-
| essentials.getpos.others || 允许获得其他玩家的坐标
|-
! colspan="2"|help
|-
| essentials.help || 允许使用/help命令
|-
| essentials.help.[pluginname] || 允许查找指定插件的命令(指定来源于你设置的[pluginname])
|-
| essentials.help.[pluginname].[command] || 允许查找指定插件的指定命令(指定来源于你设置的[pluginname]和[command])
|-
! colspan="2"|helpop
|-
| essentials.helpop || 允许使用/helpop命令
|-
| essentials.helpop.receive || 你可以查看helpop的信息
|-
! colspan="2"|chat..[为什么这里有一个chat]
|-
| essentials.chat.ignoreexempt || 允许偷窥你在配置文件中设置的命令的信息[偷窥是我自己加上去的2333]
|-
! colspan="2"|ignore
|-
| essentials.ignore || 允许使用/ignore指令
|-
! colspan="2"|info
|-
| essentials.info || 允许使用/info指令
|-
! colspan="2"|itemdb
|-
| essentials.itemdb || 允许使用/itemdb指令
|-
! colspan="2"|list
|-
| essentials.list || 允许使用/list指令
|-
| essentials.list.hidden || Show出隐身的可爱op
|-
! colspan="2"|mail
|-
| essentials.mail || 允许使用/mail指令
|-
| essentials.mail.send || 允许发送邮件
|-
| essentials.mail.sendall || 允许发送给所有人邮件（所有人用*代替)
|-
! colspan="2"|me
|-
| essentials.me || 允许使用/me命令
|-
! colspan="2"|mote
|-
| essentials.motd || 允许使用/motd命令
|-
! colspan="2"|msg
|-
| essentials.msg || 允许使用/msg命令
|-
| essentials.msg.color || 允许在密语时使用颜色代码
|-
| essentials.msg.format || 允许在密语时使用格式代码
|-
| essentials.msg.magic || 允许在谜语中使用矩阵或幻色？
|-
| essentials.msg.multiple || 允许同时谜语多人
|-
| essentials.msg.url || 允许在谜语时添加url连接
|-
! colspan="2"|near
|-
| essentials.near || 允许使用/near命令
|-
| essentials.near.maxexempt || 允许跳过最大半径的限制
|-
| essentials.near.others || 允许使用/near命令在其他玩家身上
|-
! colspan="2"|nick
|-
| essentials.nick || 允许使用/nick命令
|-
| essentials.nick.color || 允许在昵称内使用颜色代码
|-
| essentials.nick.format || 允许在昵称内使用格式代码
|-
| essentials.nick.magic || 允许在昵称内使用矩阵或幻色？
|-
| essentials.nick.others || 允许给其他人设置昵称
|-
! colspan="2"|powertool
|-
| essentials.powertool || 允许使用/powertool命令
|-
| essentials.powertool.append || 允许添加多个命令在物品上
|-
! colspan="2"|powertooltoggle
|-
| essentials.powertooltoggle || 允许使用/powertooltoggle
|-
! colspan="2"|r
|-
| essentials.msg || 见msg
|-
| essentials.msg.color || 见msg
|-
| essentials.msg.format || 见msg
|-
| essentials.msg.magic || 见msg
|-
| essentials.msg.url || 见msg
|-
! colspan="2"|realname
|-
| essentials.realname || 允许使用/realname命令
|-
| essentials.recipe || 允许使用/repice命令
|-
| essentials.rules || 允许使用/rules命令
|-
! colspan="2"|seen
|-
| essentials.seen || 允许使用/seen命令
|-
| essentials.seen.banreason || 允许查看一个已经被禁止的玩家的禁止原因
|-
| essentials.seen.extra || 允许查看玩家的IP地址和最后一次登录的所在地
|-
| essentials.seen.ipsearch || 允许搜索一个IP地址对应的玩家
|-
! colspan="2"|spawner
|-
| essentials.spawner || 允许使用/spawner命令
|-
| essentials.spawner.* || 允许生成所有怪物
|-
| essentials.spawner.[mob] || 允许生成指定(指定来源于你设置的[mob])
|-
! colspan="2"|suicide
|-
| essentials.suicide || 允许使用/suicide命令
|-
! colspan="2"|whois
|-
| essentials.geoip.show || 显示玩家的ip位置，如果安装了ip模块<s>（ip模块是麻子)</s>
|-
| essentials.whois || 允许使用/whios命令
|-
! colspan="2"|
==== 仲裁 ====
|-
! colspan="2"|antioch
|-
| essentials.antioch || 允许使用/antioch命令
|-
! colspan="2"|backup
|-
| essentials.backup || 允许使用/backup命令
|-
! colspan="2"|ban
|-
| essentials.ban || 允许使用/ban命令
|-
| essentials.ban.exempt || 防止指定的组或玩家被禁止
|-
| essentials.ban.notify || 可以收到ban的通知当拥有这个权限节点时
|-
| essentials.ban.offline || 允许禁止不在线的玩家和已经被防止被禁止的组或玩家
|-
! colspan="2"|banip
|-
| essentials.ban.notify || 见ban
|-
| essentials.banip || 允许使用/banip命令
|-
| essentials.broadcast || 允许还有/broadcast命令
|-
! colspan="2"|burn
|-
| essentials.burn || 允许使用/burn命令
|-
! colspan="2"|clearinventory
|-
| essentials.clearinventory || 允许使用/clearinventory
|-
| essentials.clearinventory.all || 允许清理所有玩家的背包
|-
| essentials.clearinventory.others || 允许清理其他玩家背包
|-
! colspan="2"|deljail
|-
| essentials.deljail || 允许使用/deljail命令
|-
! colspan="2"|enderchest
|-
| essentials.enderchest || 允许使用/enderchest命令
|-
| essentials.enderchest.modify || 允许修改其他玩家的的末影箱
|-
| essentials.enderchest.others || 允许查看其他玩家的末影箱
|-
! colspan="2"|essentials
|-
| essentials.essentials || 允许使用/essentials命令
|-
! colspan="2"|ext
|-
| essentials.ext || 允许还是要/ext命令
|-
! colspan="2"|fireball
|-
| essentials.fireball || 允许使用/fireball命令
|-
! colspan="2"|gc
|-
| essentials.gc || 允许使用/gc命令
|-
! colspan="2"|invsee
|-
| essentials.invsee || 允许使用/invsee命令
|-
| essentials.invsee.modify || 允许修改其他玩家的背包
|-
| essentials.invsee.preventmodify || 防止其他玩家修改你的背包
|-
! colspan="2"|kick
|-
| essentials.kick || 允许使用/kick命令
|-
| essentials.kick.exempt || 避免被踢出服务器
|-
| essentials.kick.notify || 可以看到kick的提示
|-
! colspan="2"|kickall
|-
| essentials.kickall || 允许使用/kickall命令
|-
! colspan="2"|kill
|-
| essentials.kill || 允许使用/kill命令
|-
| essentials.kill.exempt || 避免被其他玩家使用/kill命令杀掉
|-
| essentials.kill.force || 强制玩家死亡,即使他拥有essentials.kill.exempt权限
|-
! colspan="2"|lighting
|-
| essentials.lightning || 允许使用/lightning命令
|-
| essentials.lightning.others || 允许以其他玩家为目标使用闪电(即/lighning [player])
|-
! colspan="2"|mute
|-
| essentials.mute || 允许使用/mute命令
|-
| essentials.mute.exempt || 避免被禁言
|-
| essentials.mute.notify || 可以看到禁言的提示
|-
| essentials.mute.offline || 允许禁言不在线的玩家和防止禁言的玩家
|-
! colspan="2"|nuke
|-| essentials.nuke || 允许使用/nuke命令
|-
! colspan="2"|ping
|-
| essentials.ping || 允许使用/ping命令
|-
! colspan="2"|remove
|-
| essentials.remove || 允许使用/remove命令
|-
! colspan="2"|setjail
|-
| essentials.setjail || 允许使用/setjail命令
|-
! colspan="2"|socialspy
|-
| essentials.socialspy || 允许使用/socoalspy命令
|-
| essentials.socialspy.others || 允许以其他人为目标使用/socialspy命令
|-
! colspan="2"|spawnmob
|-
| essentials.spawnmob || 允许使用/spawnmob命令
|-
| essentials.spawnmob.* || 允许生成所有怪物
|-
| essentials.spawnmob.[mob] || 允许生成指定的怪物(指定来源于你设置[mob])
|-
| essentials.spawnmob.stack || 允许生成多个怪物
|-
! colspan="2"|sudo
|-
| essentials.sudo || 允许使用/sudo命令
|-
| essentials.sudo.exempt || 防止被sudo
|-
! colspan="2"|teamban
|-
| essentials.ban.notify || 见ban
|-
| essentials.tempban || 允许使用/teamban命令
|-
| essentials.tempban.exempt || 防止被临时禁止
|-
| essentials.tempban.offline || 允许禁止不在线的玩家和防止被临时禁止的玩家
|-
| essentials.tempban.unlimited || 禁止的时间可以无限长
|-
! colspan="2"|thunder
|-
| essentials.thunder || 允许使用/thunder命令
|-
! colspan="2"|togglejail
|-
! colspan="2"|togglejail
|-
| essentials.jail.allow.<command> || 允许在监狱里使用指定的命令(指定来源于你设定的[command])
|-
| essentials.jail.exempt || 防止被监狱
|-
| essentials.togglejail || 允许使用/togglejail命令
|-
| essentials.togglejail.offline || 允许监狱不在线的玩家和防止监狱的玩家
|-
! colspan="2"|unban
|-
| essentials.ban.notify || 见ban
|-
| essentials.unban || 允许使用/unban命令
|-
! colspan="2"|unbanip
|-
| essentials.ban.notify || 见ban
|-
| essentials.unbanip || 允许使用/unbanip命令
|-
! colspan="2"|vanish
|-
| essentials.vanish || 允许使用/vanish命令
|-
| essentials.vanish.effect || 有这个权限的人会在隐身时得到隐身2的效果即全身隐身
|-
| essentials.vanish.interact || 允许隐身的玩家与其他玩家互相影响
|-
| essentials.vanish.others || 允许隐身其他人
|-
| essentials.vanish.pvp || 允许子啊隐身时攻击他人
|-
| essentials.vanish.see || 允许在list列表Tab列表(等）中看见隐身的玩家
|-
! colspan="2"|weather
|-
| essentials.weather || 允许使用/weather命令
|-
! colspan="2"|
==== 主城 ====
|-
! colspan="2"|setspawn
|-
| essentials.setspawn || 允许使用/setspawn命令
|-
! colspan="2"|spawn
|-
| essentials.spawn || 允许使用/spawn命令
|-
| essentials.spawn.others || 允许将其他人传送回出生点
|-
! colspan="2"|
==== 传送 ====
|-
! colspan="2"|back
|-
| essentials.back || 允许使用/back命令
|-
| essentials.back.ondeath || 允许返回到死亡的地方
|-
| essentials.keepxp || 防止在在死亡中掉落经验
|-
| essentials.worlds.<worldname> || 允许返回到指定的世界(知道来源于你设定的[worldname])
|-
! colspan="2"|delhome
|-
| essentials.delhome || 允许使用/delhome命令
|-
| essentials.delhome.others || 允许删除别人的家
|-
| essentials.delwarp || 允许使用/delwarp命令
|-
! colspan="2"|home
|-
| essentials.home || 允许使用/home命令
|-
| essentials.home.bed || 允许传送回床的位置<s>（wiki里面居然是香草味的床，能吃吗）</s>
|-
| essentials.home.others || 允许传送到别人的家
|-
| essentials.worlds.<worldname> || 允许传送到指定的世界(知道来源于你设定的[worldname])
|-
! colspan="2"|jump
|-
| essentials.jump || 允许使用/jump命令
|-
! colspan="2"|sethome
|-
| essentials.sethome || 允许使用/sethome命令
|-
| essentials.sethome.bed || 允许玩家在白天右击他的床来设置一个叫做<s>床</s>的家,或更新这个叫做<s>床</s>的家
|-
| essentials.sethome.multiple || 允许玩家设置超过2个自定义名字的家
|-
| essentials.sethome.multiple.[set name] || 允许玩家设置指定多的家{知道来源于你设定的[set name]([setname]来源于你在config.yml中设置的}
|-
| essentials.sethome.multiple.unlimited || 允许设置无限多个家
|-
| essentials.sethome.others || 允许为其它玩家设置家
|-
! colspan="2"|setwarp
|-
| essentials.setwarp || 允许使用/setwarp命令
|-
| essentials.warp.overwrite.* || 允许重新设定所有的坐标
|-
| essentials.warp.overwrite.[warpname] || 允许重写指定的坐标(知道来源于你设置的[warpname])
|-
! colspan="2"|top
|-
| essentials.top|| 允许使用/top命令
|-
| essentials.tp || 允许使用/tp命令
|-
| essentials.tp.others || 允许传送到其他人身边
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tpa || 允许使用/tpa命令
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tpaall || 允许使用命令/tpaall命令
|-
| essentials.worlds.<worldname> || 允许传送到指定的世界
|-
| essentials.tpaccept || 允许使用/tpaccept命令
|-
| essentials.tpahere || 允许使用/tpahere命令
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tpall || 允许使用/tpall命令
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tpdeny || 允许使用/tpdeny命令
|-
| essentials.tphere || 允许使用/tphere命令
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tpo || 允许使用/tpo命令
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tpohere || 允许使用/tpo命令
|-
| essentials.worlds.<worldname> || 允许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.tppos || 允许使用/tppos命令
|-
| essentials.teleport.cooldown.bypass || 忽略使用传送命令在config.yml中设置的冷却限制
|-
| essentials.teleport.timer.bypass || 忽略传送时在config.yml中设置的延时
|-
| essentials.teleport.timer.move || 允许玩家在延时中移动
|-
| essentials.tptoggle || 允许使用/tptoggle
|-
| essentials.tptoggle.others || 允许开关其他玩家的传送状态(我觉得翻译成可以强制让其他玩家是否传送会好点)
|-
| essentials.vanish.interact || 允许玩家传送到一个正处于隐身状态的玩家
|-
| essentials.warp || 允许使用/warp命令
|-
| essentials.warp.list || 允许查阅坐标列表
|-
| essentials.warp.otherplayers || 允许使用/warp命令传送其他玩家
|-
| essentials.warps.* || 允许传送到所有坐标点
|-
| essentials.warps.[warpname] || 允许传送到指定坐标点(指定来源于你设置的[warpname])
|-
| essentials.world || 允许使用/world命令
|-
| essentials.worlds.<worldname> || 许传送到指定世界(指定来源于你设置的[worldname])
|-
| essentials.silentjoin || 防止这个用户登入信息显示
|-
| essentials.build || 允许玩家使用不支持开关建筑权限系统
|-
| essentials.build.break.<id>[:datavalue] || 允许破坏指定的物品（<物品ID>:(损伤值))
|-
| essentials.build.craft.<id>[:datavalue] || 允许合成指定的物品
|-
| essentials.build.drop.<id>[:datavalue] || 允许丢弃指定的物品
|-
| essentials.build.interact.<id>[:datavalue] || 允许交互指定的物品
|-
| essentials.build.pickup.<id>[:datavalue] || 允许拾起指定的物品
|-
| essentials.build.place.<id>[:datavalue] || 允许防止指定的物品
|-
| essentials.chat.color || 允许在聊天时使用颜色代码
|-
| essentials.chat.format || 允许在聊天时使用格式代码
|-
| essentials.chat.magic || 允许在聊天时使用幻色/矩阵
|-
| essentials.chat.question || 允许提问
|-
| essentials.chat.shout || 允许喊话
|-
| essentials.chat.spy || 允许窃听
|-
| essentials.chat.url || 允许在聊天时使用url代码
|-
| essentials.geoip.hide || 防止你的国家和城市被拥有essentials.geoip.show权限的玩家看到
|-
| essentials.geoip.show || 允许看到别人的国家和城市
|-
| essentials.joinfullserver || 当服务器器满人时仍然可以加入
|-
| essentials.nocommandcost.[command] || 免费使用指定的命令
|-
| essentials.nocommandcost.all ||免费使用所有命令
|-
| essentials.protect || 允许保护牌子和其附着的方块
|-
| essentials.protect.admin || 允许破坏牌子和其附着的方块
|-
| essentials.protect.alerts || 允许接收保护警报(哈哈，作者把receive打成了receieve了2333)
|-
| essentials.protect.alerts.notrigger || 拥有此权限的玩家不触发保护警报
|-
| essentials.protect.damage.contact || 防止受到接触伤害(仙人掌等)
|-
| essentials.protect.damage.creeper || 防止受到爬行者的伤害
|-
| essentials.protect.damage.disable || 撤销管理员死亡
|-
| essentials.protect.damage.drowning || 防止溺水伤害
|-
| essentials.protect.damage.fall || 防止掉落伤害
|-
| essentials.protect.damage.fire || 防止火焰伤害
|-
| essentials.protect.damage.fireball || 防止火球伤害
|-
| essentials.protect.damage.lava || 防止岩浆伤害
|-
| essentials.protect.damage.lightning || 防止闪电伤害
|-
| essentials.protect.damage.projectiles || 防止抛射物伤害
|-
| essentials.protect.damage.suffocation || 示例窒息伤害
|-
| essentials.protect.damage.tnt || 防止tnt伤害
|-
| essentials.protect.entitytarget.bypass || Allows a player to be targeted by mobs
|-
| essentials.protect.exemptbreak || 允许玩家忽略防破坏物品列表破坏
|-
| essentials.protect.exemptplacement || 允许玩家忽略防放置物品列表放置
|-
| essentials.protect.exemptusage || 允许玩家忽略防使用物品列表使用
|-
| essentials.protect.ownerinfo || 允许检查保护的物品属于哪个玩家
|-
| essentials.protect.pvp || 当防PVP设置为开，这允许玩家仍然PVP，这需要攻击者和防御者同时拥有这个权限
|-
| essentials.pvpdelay.exempt || 免除在配置文件中设置的pvp延时
|-
| essentials.signs.break.balance || 允许破坏balance牌子
|-
| essentials.signs.break.buy || 允许破坏buy牌子
|-
| essentials.signs.break.disposal || 允许破坏disposal牌子
|-
| essentials.signs.break.enchant || 允许破坏enchant牌子
|-
| essentials.signs.break.free || 允许破坏free牌子
|-
| essentials.signs.break.gamemode || 允许破坏gamemode牌子
|-
| essentials.signs.break.heal || 允许破坏heal牌子
|-
| essentials.signs.break.info || 允许破坏info牌子
|-
| essentials.signs.break.kit || 允许破坏kit牌子
|-
| essentials.signs.break.mail || 允许破坏mail牌子
|-
| essentials.signs.break.protection || 允许破坏protetion牌子
|-
| essentials.signs.break.repair || 允许破坏repair牌子
|-
| essentials.signs.break.sell || 允许破坏sell牌子
|-
| essentials.signs.break.spawnmob || 允许破坏spawnmob牌子
|-
| essentials.signs.break.time || 允许破坏time牌子
|-
| essentials.signs.break.trade || 允许破坏trade牌子
|-
| essentials.signs.break.warp || 允许破坏warp牌子
|-
| essentials.signs.break.weather || 允许破坏weather牌子
|-
| essentials.signs.create.balance || 允许创建balance牌子
|-
| essentials.signs.create.buy || 允许创建buy牌子
|-
| essentials.signs.create.disposal || 允许创建disposal牌子
|-
| essentials.signs.create.enchant || 允许创建enchant牌子
|-
| essentials.signs.create.free || 允许创建free牌子
|-
| essentials.signs.create.gamemode || 允许创建gamemode牌子
|-
| essentials.signs.create.heal || 允许创建heal牌子
|-
| essentials.signs.create.info || 允许创建info牌子
|-
| essentials.signs.create.kit || 允许创建kit牌子
|-
| essentials.signs.create.mail || 允许创建mail牌子
|-
| essentials.signs.create.protection || 允许创建protetion牌子
|-
| essentials.signs.create.repair || 允许创建repair牌子
|-
| essentials.signs.create.sell || 允许创建sell牌子
|-
| essentials.signs.create.spawnmob || 允许创建spawnmob牌子
|-
| essentials.signs.create.time || 允许创建time牌子
|-
| essentials.signs.create.trade || 允许创建trade牌子
|-
| essentials.signs.create.warp || 允许创建warp牌子
|-
| essentials.signs.create.weather || 允许创建weather牌子
|-
| essentials.signs.enchant.allowunsafe || 允许附魔不安全的附魔
|-
| essentials.signs.format || 允许在牌子上使用格式代码
|-
| essentials.signs.magic || 允许在牌子上使用矩阵或幻色
|-
| essentials.signs.protection.override || 重写保护。代表性地给予版主或管理员
|-
| essentials.signs.trade.override || 允许用户重写造物主唯一保护的贸易的牌子。代表性地给予版主或管理员
|-
| essentials.signs.use.balance || 允许使用balance牌子
|-
| essentials.signs.use.buy || 允许使用buy牌子
|-
| essentials.signs.use.disposal || 允许使用disposal牌子
|-
| essentials.signs.use.enchant || 允许使用enchant牌子
|-
| essentials.signs.use.free || 允许使用free牌子
|-
| essentials.signs.use.gamemode || 允许使用gamemode牌子
|-
| essentials.signs.use.heal || 允许使用heal牌子
|-
| essentials.signs.use.info || 允许使用info牌子
|-
| essentials.signs.use.kit || 允许使用kit牌子
|-
| essentials.signs.use.mail || 允许使用mail牌子
|-
| essentials.signs.use.protection || 允许使用protetion牌子
|-
| essentials.signs.use.repair || 允许使用repair牌子
|-
| essentials.signs.use.sell || 允许使用sell牌子
|-
| essentials.signs.use.spawnmob || 允许使用spawnmob牌子
|-
| essentials.signs.use.time || 允许使用time牌子
|-
| essentials.signs.use.trade || 允许使用trade牌子
|-
| essentials.signs.use.warp || 允许使用warp牌子
|-
| essentials.signs.use.weather || 允许使用weather牌子
|-
| essentials.silentquit || 抑制某玩家的加入/退出信息
|-
| essentials.sleepingignored || 用户不需要睡觉，直接跳跃到早上
|-
! colspan="2"|
==== XMPP ====
|-
| essentials.setxmpp || 允许使用/setxmpp命令
|-
| essentials.xmpp || 允许使用/xmpp命令
|-
| essentials.xmppspy || 允许使用/xmppspy命令
|}

===常见问题及其解答===
[http://wiki.mc-ess.net/wiki/FAQ '''原地址''']
====Bukkit====
----
在哪里我可以获得CraftBukkit的最新版本?
点[http://dl.bukkit.org/latest-rb/craftbukkit.jar 这里]获取 
 
这是你一直可以找到最新的推荐版本的craftbukkit. 请记住，CraftBukkit的更新很快，时常可能会获得更好的对插件的兼容性，所以使用推荐的版本总是最好的, 其他CraftBukkit版本可能有一些错误或者你没有意识到的兼容性问题,和不支持很多开发商的插件,有些插件可能只依靠推荐的版本来设计. 
----
我怎么知道CraftBukkit和Essentials的版本?
如果你从上面的连接下载了CraftBukkit,你应该知道他的版本. 如果你看着控制台,那么他会告诉你所有插件的版本. 
----
多久我要升级一次我的插件和CraftBukkit
不同的人会有不同的方法, 但你在任何时间都应该经常升级CraftBukkit和你的任何插件. 插件总是基于最新的版本更新, 所以安装一个新版本的插件和一个旧版本的CraftBukkit很可能会出错.
====Essentials====
----
我如何去取消十秒钟的传送冷却?
这个设定这Essentials的config.yml中. 找到这一行：
<code>teleport-delay: 10</code> 
将10修改为0即可,就像这样：
<code>teleport-delay: 0</code> 
如果他不在这里,那么你这需要添加这一行即可. 
----
Essentials使用了一个错误的语言.我如何去修改它?
这个设定同样在config.yml,[http://wiki.mc-ess.net/wiki/Locale 在这里找到更多区域的语言并设置他]. 
----
我如何使它如此不同的用户有不同的颜色名称?<
你可以配置Essentials去个性化名字和聊天格式.[http://wiki.mc-ess.net/wiki/Chat_Formatting 在这里找到更多聊天格式]. 
----
如果在起点插件时你获得一个'UnsupportedClassVersionError(不支持的类的版本错误)'错误,这是什么?
这个错误提示同城意味着你运行了一个旧的无法支持的Java版本.你需要新的Java6去运行Essentials.[http://wiki.mc-ess.net/wiki/Updating_Java 更多信息在这里]. 
----
在升级到EssentialsChat2.9.2我无法设置我的后缀及无法发出有颜色的信息!
在我们的错误的地方，你可以使用后缀设置插件的颜色信息，造成的问题是固定的。而不是使用格式中的要点config.yml添加消息的颜色. 
----
我不能在2.9版本中创建某一类型的牌子!
在2.9.所有的牌子都是默认不能使用的.大约在264行开始的"enabledsigns"部分。删除你想使用的牌子钱的符号“#”,这样你就可以使用了. 
====Group Manager====
----
我如何给与某个玩家或某个组使用某个命令的能力?
Essentials和GrupManager插件是打包安装的. 想要了解如何解决这个问题的方法, 查看GroupManager指南. 
----
这个组的配置一直保持重载, 我如何去改变他?
GroupManager 它每10分钟的重新载入一次.如果你想要做出改变，你可以禁用自动保存，或者请求手动重载（/ manload） 
See also: Group Manager/Config

====YAML====
----
当我运行服务器时, 发现了YAML错误? 
If the server throws a YAML error to the server console the hint as to what is wrong is detailed in the error. It typically highlights a line number it thinks is wrong. Check your YAML file for typos and indentation errors. 
If you see the log say '\t', then you used tabs. Replace any tabs you have with four spaces. 
If you still need help come to IRC

====Migration====
----
Can I use previously generated warp files in Essentials? 
If the warps are saved to .txt format you can move that file into the plugins/Essentials folder and it will be loaded, but there is no way to convert MyWarp files at this time. 
I currently use a permissions system, can I use Essentials? 
Essentials is compatible with PermissionBukkit/PermissionsEx/BukkitPermissions and other permission plugins, you will simply need to add the correct command nodes and make sure you don't have EssentialsGroupMananger.jar and EssentialsGroupBridge.jar. You could also convert to Group Manager, which comes pre-configured for Essentials.

==教程==
本目录下内容较多，请前往子页面查看。
[[Essentials/教程]]
==脚注==
<references group=c/>
==授权声明==
本页内容翻译/搬运自[http://wiki.mc-ess.net/wiki/Main_Page wiki.mc-ess]
:授权方式为[http://creativecommons.org/licenses/by-nc-sa/3.0/ CC BY-NC-SA 3.0]
[[Category:管理]]
[[Category:聊天]]
[[Category:经济]]
[[Category:综合]]
[[Category:传送]]

NoCheatPlus

2016-02-17T17:03:49Z

Lzs：/* 介绍 */

{{Bukkit Plugin Infobox
|插件名=NoCheatPlus
|版本=3.12.0-BETA2-sASO-b813
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/nocheatplus/
}}
{{待翻译}}
'''Detect and fight the exploitation of various flaws/bugs in Minecraft!'''
[[Category:管理]] [[Category:修正]] [[Category:安全]]
=介绍=

NoCheatPlus通过禁止客户端利用''MineCraft数据传输协议的漏洞''进行作弊来使得你的服务器更加安全可靠. 检测范围包括飞行，加速，战斗作弊, 快速破坏方块与核弹, 背包作弊, 聊天窗广告以及其他的恶意行为. 更全面的介绍请见 [https://github.com/asofold/NCPDocs/blob/master/Features.creole Features Page]（内容已搬至本页面，查看最新内容请点击链接）.

NoCheatPlus将重点放在可配置，当某玩家未通过检查时允许你自定义可执行的操作 (例如 silent cancelling, 执行命令, 只是记录). 白名单权限允许设置检查哪些玩家,全部检测可以在配置文件中被关闭, 也有特殊的世界检查选项. 许多检测允许更详细的配置来调整灵敏度。

当然NoCheatPlus不是一个具有魔法的子弹,它采用了许多启发式机制与猜测机制, 因此你会在各个地方遇到误报并且也不能抓住每一个作弊者. [http://www.youtube.com/watch?v=H8BSpXfrtzI Example video] 如何用NoCheatPlus解决方块作弊(过时的插件版本).

NoCheatPlus由 [http://dev.bukkit.org/profiles/NeatMonster/ NeatMonster] 推出, 基于由[http://dev.bukkit.org/profiles/Evenprime85/ Evenprime]编写的[http://http://dev.bukkit.org/bukkit-plugins/nocheat/ Nocheat]插件.
==功能==
* 玩家行动:
** 禁止飞行(生存/冒险模式下) 或是限制飞行速度(创造模式下)
** 禁止玩家的行走，冲刺，潜行，游泳和破坏方块的速度过快
** 禁止玩家无视掉落伤害
** 禁止玩家进入方块 (穿墙模式)
** 禁止玩家改变服务器时间
** 禁止玩家利用 "safe-respawn" 的缺陷
** 禁止在水和岩浆顶部行走 [尽管现在的作弊者只是在其上保持跳跃]
** 禁止玩家通过非法移动使服务器崩溃 (CraftBukkit 自身并不包含检测模块,但有时这些移动数据会影响到插件.)
** 防止玩家伪造"BedLeave"数据包<ref>数据包意义不明，请各位完善</ref>
** 禁止玩家悬浮在半空中
** 禁止玩家利用 "block jumping"来跳过高墙
** 防止玩家 from V-Clipping or teleporting
** 禁止玩家滥用钓竿来绕开飞行检测 (这只是一个玩笑...) [未测试! 默认关闭!]
** 防止玩家通过飞行进行作弊
** 禁止玩家滥用末影珍珠穿越墙，屋顶和地板
* 方块交互:
** 禁止玩家操作正常接触范围之外的方块
** 强制玩家看着想要操作的方块
** 禁止玩家透过墙对方块进行操作
** 防止玩家通过特定方块来传播广告信息（note-blocks<ref>原文如此</ref>,门,石头,木材等）
* 方块破坏:
** 防止玩家使用 "Survival Nuker", "Smasher", "Click Nuker" 与 "Creative Nuker(创造模式软件?)"
** 防止以不正常速度破坏方块, 防止同时破坏过多方块.
** 限制玩家可破坏方块的距离
** 强制玩家看着方块(破坏方块时，鼠标准星需对准方块)
** 防止 "noswing" 作弊 (玩家破坏方块时手臂没有动作)
** 禁止玩家同时破坏两个及以上的方块
** 禁止创造模式下的玩家破坏水或岩浆
* 方块放置:
** 防止玩家使用 "FastPlace" 和 "Build" 类作弊工具
** 限制玩家可放置方块的距离
** 强制对准方块
** 禁止玩家过快地投掷物品
** 禁止玩家在除了水和岩浆上的地方放置船只
** 利用客户端的AutoSign特征防御防止玩家作弊
** 禁止玩家在半空中放置方块.
** 禁止玩家在流体上放置方块
* 玩家聊天:
** 部分功能受Evenprime的插件启发.
** Fast spam check + tool-box for slower paced annoyances (可考虑到玩家聊天记录和全体聊天记录).
** 限制同一时间内允许加入服务器的玩家的数目
** 禁止短时间内多次重复登陆.
** 清楚玩家信息的颜色
** 支持屏蔽聊天窗内的广告内容
* 背包:
** 禁止玩家短时间内丢出大量物品以避免服务器的卡顿
** 禁止玩家过快地填充，发射弓箭
** 禁止玩家过快地进食
** 禁止玩家以过快的速度管理他们的物品（包括背包，附魔台，信标）
** 禁止玩家将非法的附魔保存为附魔书（此漏洞在1.4.3及以上被修复）
* 战斗:
** 防止玩家同时攻击过多实体(玩家和怪物都算做实体)
** 防止不在视线范围内的敌人的攻击
** 防止没有动作的攻击
** 防止一秒内对生物攻击多次
** 禁止攻击过远的目标
** 防止玩家由于Minecraft的设计缺陷而变得无敌
** Prevent players from knocking back other players when it's not technically possible
** Prevent players from exploiting extremely low jumps to get a pseudo criticals cheat going NEW!
** Prevent players from giving critical hits to other players when it's not technically possible
** Prevent players from hit other players while blocking with their sword
** Penalize players that change their direction by a lot (against force fields)
** Prevent players from doing self hits to fly by using the knockback of those
** Feed combined check to find players that try to execute 2 or more cheats at the same time
** 防止玩家过快地回复血量
* 杂项:
** 禁用 Zombe's mod (飞行, 穿墙, 作弊)
** 禁用e CJB's mod (飞行, 透视, 雷达)
** 禁用 Rei's Minimap (洞穴, 雷达)
** 禁用 Minecraft AutoMap (矿物, 洞穴, 雷达)
** 禁用 Smart Moving (攀爬, 游泳, 爬行, 滑行, 跳跃, 飞行)
** 使"OP"命令只能在服务器控制台内执行（默认禁用）
** Adapts to server sided lag for less false positives on heavy server load
** 提供了一个API，允许让其他插件与NoCheatPlus兼容
** Use of BukkitAPI only if the used CraftBukkit version is not supported

==配置==

==在.yml配置文件的一般注意事项==
* 使用空格缩进。
* 保持缩进级别：永不改变配置文件“config.yml”前面空格的数量。
* 不要插入特殊字符，如制表符缩进。如果你计划写复杂的文本条目,可以写为 '...' or "..."。
* 请参阅默认的配置文件，以供参考。
* 使用[[http://yaml-online-parser.appspot.com/|YAML parser]]以确保您的配置文件的格式正确。
* 插入不受支持的字符或改变缩进级别会破坏配置文件.
* 对于那些使用Notepad++来编辑YAML文件的人：
建议启用"Replace by space" in Settings -> Preferences -> Tab Settings
建议启用"转换为空格" 在设置(T) -> 首选项... -> 制表符设置
[[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#notepad++|Screenshot of Notepad++ preferences]]

==特定世界的配置==
怎样创建一个特定世界的配置文件呢?（不同世界不同管理）:
#首先创建一个空的yml文件根据你的服务器世界的名称。例如：world_config.yml（_是必需的！所有字符都是很敏感的！）
# 在你的服务器安装NocheatPlus或运行 /重新安装NocheatPlus /如果已经在你的服务器运行请重载
# NoCheatPlus should now write every setting available for world specific configuration in that/those empty yaml files
# If you rather prefer to use some settings of your global config.yml then set "savebackconfig" to false and remove them from your world specific configuration file

* End result in your [[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#world-specific-configuration|explorer window]] after successfully creating some world specific config.yml files
* Other examples: WorldName_config.yml, world_nether_config.yml, world_the_end_config.yml, HungerGames_config.yml or BackupWorld_config.yml

Notes:
* The world name is case sensitive (MiningWorld, theWorld etc.).
* You can set savebackconfig to false, in order to not have NoCheatPlus add default values to a config file. Thus you can override just the values you are interested in and keep a minimal world-specific configuration file.
* WorldName_config.yml has always higher priority then config.yml. So NoCheatPlus will first apply all settings from config.yml and then override them for a specific world using WorldName_config.yml
* Some settings can only be used in the global config.yml and aren't multiworld compatible (Please don't just copy config.yml and rename it to WorldName_config.yml or similar.)
* World specific files can be created, changed or removed while your server and NoCheatPlus are running. Just use the /ncp reload or /nocheatplus reload command to let NoCheatPlus reread your configuration file.
* If a world gets unloaded, deleted or renamed then NoCheatPlus will automaticly ignore your world specific configuration files you made for it

==Configversion==
Set {{{notify}}} to false to suppress the messages about outdated configurations. Only the main configuration file is checked at present.
\\The other entries are not meant to be changed by hand, they indicate with which version the config was created and last saved back.

==Logging==

Disable all logging with setting {{{active}}} to false.

Individual logging targets can be configured in the sub sections within {{{backends}}}:
* Set {{{active}}} to false to disable the individual backend.
* The {{{prefix}}} parameter allows to create a custom appearance for the log messages.
* File logging allows specifying a file name.
* For {{{ingamechat}}} you can force NoCheatPlus to check permissions subscriptions, if you use plugins that apply this technique to log to IRC and other for instance.

==Miscellaneous==
* Set {{{opinconsoleonly}}} to true to prevent op and deop commands from in-game chat. [Will be changed to a list of commands.]
* Set {{{managelisteners}}} to true to help us testing :) - this feature lets NCP register all its listeners inside of a ListenerManager that allows more intricate registration order than Bukkit. This is a "future feature" and is not needed, not even sure it improves performance.
* Set {{{reporttometrics}}} to false in order to disable reporting usage-stats to [[http://mcstats.org/plugin/NoCheatPlus|mcstats.org]] (PluginMetrics). Setting this to falss also prevents NoCheatplus from creating the PluginMetrics folder, however other plugins or Spigot could still create that folder.

==Data==
The data section allows you to specify an expiration duration for players data in minutes. If set to something greater than 0, this will periodically remove players data if the players have been logged out for longer than the specified amount of minutes. At present this would also delete set-back locations and current violation levels, if activated, so it should not be set to a too short duration.

**expiration**
|**Config**|**Description**|**Default**|
|**duration**|Duration in minutes after logout, after which data gets erased.|0|
|**history**|Should the players violation history also be deleted?|false|

**consistencychecks**
You can suppress consistency check warnings here and alter intervals for periodic checking (usually not needed).

==Protection==
===Plugins===
Features for this and other plugins.
====Hide====
This section contains configuration for hiding (some of) your plugins better. You can prevent help-contents display and command usage by setting permissions with a permissions plugin, if the command has a default permission set, but NoCheatPlus allows to set the permission message of some commands, which would otherwise reveal the presence of the command/plugin. So the permission message for some commands can be changed to the "Unknown command" message to hide the presence. You do need to also set the aliases of the commands, use lower case rather.
\\This feature allows to change command permissions to not be given by default or add a generic filter permission nocheatplus.filter.command.//(commandname)// to a command that does not have one set yet, the following settings allow configuring lists of commands and the message:
\\**"nopermission":**\\
Display the "no permission" message, default to "plugins" and "version" commands, useful for instance if a plugin does not set a permission for a command.
\\**"unknowncommand":**\\
Display the "unknown command" message, empty by default. This can be used to hide a command from users that don't have the default permission (or the filter permission added by NCP if none was set).

\\TODO: Link docs on how to configure help topics and other.
===Clients===
Features that concern client mods.
Set the {{{active}}} flag to false in the {{{motd}}} section to prevent NoCheatPlus sending any "blank lines" messages to clients on login. Otherwise blank lines can result disregarding if all clients are allowed or not, because some clients use a message to enable features, some need a message to disable features.
\\Note that it is 100% up to the client to decide on enabling or disabling features, a modified version of any client may ignore any sent messages, without that being detectable.

==Configuration of checks==
The checks section contains configuration mostly for checks related to players actions, most can generate violation log messages (few exceptions).

===Checks overview===

See: [[checks/checks.creole|Checks Overview]]

Shortcut links:
\\|
[[checks/blockbreak/blockbreak.creole|blockbreak]] |
[[checks/blockinteract/blockinteract.creole|blockinteract]] |
[[checks/blockplace/blockplace.creole|blockplace]] |
[[checks/chat/chat.creole|chat]] |
[[checks/combined/combined.creole|combined]] |
[[checks/fight/fight.creole|fight]] |
[[checks/inventory/inventory.creole|inventory]] |
[[checks/moving/moving.creole|moving]] |

==Strings section==
This is the section that defines various strings for "log" or "cmd" actions. Each has a name (the part in front of ":") and a definition (the part behind the ":"). Whenever you use a "log" or "cmd" action in one of the "actions: " options of this config file, the string will be taken from this section. Arbitrary many additional strings may be defined here, or existing strings may be changed.
\\ \\
Most messages/commands use place-holders in [ ], which will be replaced at runtime with relevant information. Some of these may only be available in certain circumstances, only "[player]" can be used everywhere, especially in "cmd" actions.|
\\

==Compatibility section==
This section allows to configure details for the case of compatibility issues, for instance with other server mods or custom blocks.

[[compatibility/compatibility.creole|compatibility page]]

==Bleeding Edge: Development builds==
To allow you to keep track with the configuration and permission changes in the latest development versions, we have a simple page set up: **[[../development/dev-pinboard.creole|Development Pinboard]]**
\\
For quick overview over recent builds, see: [[../development/build-infos.creole|Important Changes By Build Number]]
==命令==

=Commands=

NoCheatPlus integrates a lightweight command system. It allows you to quickly exempt players from checks or to access and manage check data about a player.

All commands support tab completion and some even allow shortcuts. The root command is named "nocheatplus", however the alias "ncp" should also work and is used for reference here.

NoCheatPlus also supports aliases from Bukkit [[http://wiki.bukkit.org/Bukkit.yml#aliases|BukkitAliases]] if you wish to have another alias command aside form "nocheatplus" and "ncp".

==Permissions==
Root node for commands:
* **NoCheatPlus 3.10.2** and above: {{{nocheatplus.commands}}}
* //NoCheatPlus 3.10.1// and below: {{{nocheatplus.admin}}}

You can give a player access to a specific command by giving them the sub-node with the commands default name, like {{{nocheatplus.admin.info}}}.
For further information about permissions in NoCheatPlus, we recommend looking at the [[../permissions/permissions.creole|Permissions docs]].

==Administrative commands==
Those commands are used to basically manage NoCheatPlus on your server.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp reload| Reloads, generates and regenerates the configuration file of NoCheatPlus. Run this in-case you changed something on your configuration file while your server was running.|
|/ncp notify on/off| Toggle all in-game notifications/alerts generated by NoCheatPlus.|
|/ncp info (player)| Display the violation levels of a given player.|
|/ncp lag| Show info about server sided latency. The average lag shows the percentage of the server running too slow (0% = 20 tps, 10% = 18 tps) for the last 1 second, 3.33 and 270 seconds, roughly. Also lag spikes are displayed, tracked over at most 1 hour with a resolution of 20 minutes buckets (i.e. not exact) for spikes > 150 ms (3x to 20x) and spikes > 1000 ms (20x +). Be aware that this information is needed to make most NoCheatPlus checks adapt to server sided lag.|
|/ncp removeplayer (player) [check_type]| Remove all the data collected by NoCheatPlus so far for a given player. You can use the [check_type] option to make NoCheatPlus only remove data from a specific check (Default will clean all data of all checks!). To list all check names execute a command such as this: /ncp removeplayer (PlayerName) list. "*" is supported here.
|/ncp exempt (player) [check_type]| Exempt a player from being checked by NoCheatPlus or by a specific check.|
|/ncp unexempt (player) [check_type]| Remove any exemption you given to a specified player. "*" Is supported here.|
|/ncp exemptions (player)| Gives back a list of all check that a specific player has been exempted from.|
|/ncp commands| List all commands, more than shown here. The other commands are mainly for use with actions, such as delaying other commands, kicking with a message, telling players messages in colour, deny login for a players, allow it again and other.|
|/ncp version| Show version information about the server, plugin, compatibility modules and registered hooks.|

==Auxiliary commands==
Those commands are mainly used by NoCheatPlut itself to execute strings or commands over actions on violating players but you can also make use of them if you wish to do so. Most of them have no difference compared to the vanilla commands apart from the delay otion.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp ban [delay=(ticks)] (player) [reason]|Ban a player from your server (banned-players.txt).|
|/ncp kick [delay=(ticks)] (player) [reason]|Kicks a player from your server|
|/ncp unkick (player)|Allows you to remove a tempkick/tempban from a player. "*" is supported here.|
|/ncp kicklist|Lists all players that have been tempkicked/tempbanned on your server by NoCheatPlus actions.|
|/ncp tell [delay=(ticks)] (player) (message)|Send a private message to a specified player.|
|/ncp delay [delay=(ticks)] (command)|Execute a command in delayed time.|
==权限==

**This page describes permissions for NoCheatPlus 3.10.2 and above,**
\\**NoCheatPlus 3.10.2-RC-sMD5NET-b620 adds new permissions for commands and new short-cut permissions, updates following soon.**
\\//For older versions see the [[permissions-3-10-1.creole|permissions page for 3.10.1 and below.]]//

NoCheatPlus supports "SuperPerms", CraftBukkit's official permission framework. You'll need to use a permissions plugin that supports "SuperPerms" to manage all the permissions of NoCheatPlus. Here are some examples:

* PermissionsEx
* bPermissions
* Essentials GroupManager
* Privileges
* zPermissions

By default NoCheatPlus assigns all permissions and gives full rights to players that have been /op-ed on your server. If you don't want to give OPs full access to all NoCheatPlus features then take a look in the configuration of your permissions plugin (Example with PermissionsEx: allowOps: false).\\\\
==Notifications==
|nocheatplus.notify|The player will receive notifications through the in-game chat of players failing NoCheatPlus checks. .|
If you want moderators to be able to toggle notifications, just give the permission nocheatplus.command.notify, which will also give this one then. Mind the ".silent" permission for individual checks permissions (explained on the bottom of this page).

==Administration==
|{{{nocheatplus.admin}}}|Shortcut permission for all administrative commands including ban (do not give lightly). See nocheatplus.shortcut permissions for faster setup for moderators.|
===Debug===
|nocheatplus.admin.debug|Owners of this node will receive debug messages of checks if NoCheatPlus debugging is turned on.|
==命令权限==
|nocheatplus.command.notify|Allow toggling notifications and also to receive them (nocheatplus.notify is included here).|
|nocheatplus.command.info|The player gets access to "/ncp info", which displays all violations that a player has gotten (if any).|
|nocheatplus.command.lag|Gives access to "/ncp lag" which shows informations about your server latency (NoCheatPlus uses this informations to adapt some checks for serversided latency).|
|nocheatplus.command.reload|The player gets access to "/ncp reload", which causes NoCheatPlus to reread its configuration files (This doesn't clear NoCheatPlus data or exemptions!).|
|nocheatplus.command.plugins|Allows the player to execute the "/plugins" or "/pl" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.version|Owners of this node can execute the "/version" or "/ver" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.exemptions|Gives access to execute "/ncp exemptions" which list all exemptions for an specified player (Those exemptions will get reset after every reload/restart! For permanent exemptions use the check permissions!).|
|nocheatplus.command.exempt|Gives access to the "/ncp exempt" command which allows to temporary exempt players for either all (ALL) or specified checks only.|
|nocheatplus.command.unexempt|Allows to unexempt players from checks by using the "/ncp unexempt" command.|
|nocheatplus.command.removeplayer|Gives access to execute "/ncp removeplayer", which causes NoCheatPlus to wipe/clear specified or all collected data from a player including violations and temporary stored check data (This wont wipe exemptions!).|
|nocheatplus.command.commands|Allows the player to use the "/ncp" command which lists all NoCheatPlus commands.|
|nocheatplus.command.ban|Gives permissions to use "/ncp ban" which bans a player on your server.|
|nocheatplus.command.kick|Gives access to "/ncp kick" which kicks a player from your server.|
|nocheatplus.command.tell|Gives access to "/ncp tell" which allows whispering something to a specified player.|
|nocheatplus.command.delay|Gives permissions to use the "/ncp delay" command which has the ability to run a specified command with delayed time execution time.|
|nocheatplus.command.tempkick|Allows the player to tempkick/tempban someone from the server using "/ncp tempkick".|
|nocheatplus.command.kicklist|Gives access to the "/ncp kicklist" command which lists all players that got "tempkicked/tempbanned" from NoCheatplus by either using actions or "/ncp tempkick".|
|nocheatplus.command.unkick|Gives access to remove a tempkick/tempban from a player using "/ncp unkick".|

==Filter permissions (plugin hiding)==
|nocheatplus.filter.command.(commandname)|Allows to use a command protected by command protection, only for the case the command did not have a permission set. Note that (commandname) is just the lower-case command label. In case of incompatibilities of your permission plugin you might have to add nocheatplus.filter.command.nocheatplus to players that are to use /ncp ... commands.|
==Bypass==
Specific bypass permissions.
|nocheatplus.bypass.denylogin|Allows to bypass the login denial, such as exists with the /ncp tempkick command.|
==Checks==
Check permissions, directly related to players actions and associated checks.
|nocheatplus.checks|Parent permission for all checks. TODO: Overview for "full" exemption by permissions (might need few additional permissions?).|
===BlockBreak===
|nocheatplus.checks.blockbreak|Parent permission for the blockbreak checks.|
|nocheatplus.checks.blockbreak.direction|Don't force the player to look at the blocks that he/she wants to break.|
|nocheatplus.checks.blockbreak.fastbreak|Allows the player to break blocks very quickly.|
|nocheatplus.checks.blockbreak.frequency|Allows the player to break 2 or more blocks at the same time.|
|nocheatplus.checks.blockbreak.noswing|Don't force players to swing their arm when breaking blocks.|
|nocheatplus.checks.blockbreak.reach|Allows breaking of blocks that are out of reach distance.|
|nocheatplus.checks.blockbreak.wrongblock|Don't force the player to interact with the block first before he/she is allowed break it (interacting=touching).|
|nocheatplus.checks.blockbreak.break.liquid|Allows the player to break liquids such as water or lava (source blocks) by using a hack in creative gamemode.|
===BlockInteract===
|nocheatplus.checks.blockinteract|Parent permission for this check section.|
|nocheatplus.checks.blockinteract.direction|Don't force the player to look at the blocks that he/she is trying to interact with (levers, doors and other).|
|nocheatplus.checks.blockinteract.reach|Allows the player to interact with blocks that are further away than usual.|
|nocheatplus.checks.blockinteract.speed|Allows the player to spam interaction on blocks such as levers, note blocks, doors and other.|
|nocheatplus.checks.blockinteract.visible|Everyone that owns this node is allowed to interact through walls to open a chest, furnace and other container without actually seeing them (also prevents from entering a minecart, bed or boat through walls).|
===BlockPlace===
|nocheatplus.checks.blockplace|...|
|nocheatplus.checks.blockplace.direction|Don't force the player to look at the block that he/she is trying to place on.|
|nocheatplus.checks.blockplace.boatsanywhere|Allows the player to place boats everywhere and not only in the water.|
|nocheatplus.checks.blockplace.fastplace|Allows the player to place blocks very quickly.|
|nocheatplus.checks.blockplace.noswing|Don't force players to swing their arm when placing a block.|
|nocheatplus.checks.blockplace.reach|Allows the player to place blocks that are too far away.|
|nocheatplus.checks.blockplace.speed|Allows a player to throw projectiles very quickly (snowballs, splash potions and other).|
|nocheatplus.checks.blockplace.against.liquids|Having this permission assigned allows to place block against liquids by using a special hack.|
|nocheatplus.checks.blockplace.against.air|This permission allows a player to place blocks against air.|
===Chat===
|nocheatplus.checks.chat|...|
|nocheatplus.checks.chat.color|Don't filter color codes from messages that get sent by players to allow them using colors in their messages. However nearly every chat plugin will override this.|
|nocheatplus.checks.chat.text|Allows the player to bypass the chat spam check for written text.|
|nocheatplus.checks.chat.commands|Allow players to bypass the command frequency check that protects against command spam.|
|nocheatplus.checks.chat.captcha|Owners of this permission wont be forced to type in a captcha if they fail one of the chat checks (this feature is disabled by default).|
|nocheatplus.checks.chat.relog|Every player that has this permission is allowed to completely bypass the re-log check of NoCheatPlus.|
|nocheatplus.checks.chat.logins|Allows the player to bypass the login check which prevents too many players loging in at the same time.|
===Combined===
|nocheatplus.checks.combined|Parent permission for the combined check group.|
|nocheatplus.checks.combined.improbable|Allows the player to bypass the Combined_Improbable check which fights against kill-auras ,speed hacks and some other combined hacks also. It also prevents the player from using 2 or more hacks at the same time.|
|nocheatplus.checks.combined.bedleave|Allows the player to send bed leave packets from anywhere (can be exploited to confuse some other checks of NoCheatPlus).|
|nocheatplus.checks.combined.munchhausen|Players with this node might be able to use fishing roods for flying (Check is disabled by default in configuration).|
===Fight===
|nocheatplus.checks.fight|Fight check group.|
|nocheatplus.checks.fight.angle|Don't prevent the player from attacking multiple entities at the time.|
|nocheatplus.checks.fight.critical|Don't prevent the player from doing fake critical hits when it's technically not possible to do so.|
|nocheatplus.checks.fight.direction|Don't force the player to look at the targets while fighting them.|
|nocheatplus.checks.fight.godmode|Don't prevent the player from keeping the temporary invulnerability that he/she gets when taking damage.|
|nocheatplus.checks.fight.fastheal|The owner of this node is allowed to regenerate health faster then usually possible.|
|nocheatplus.checks.fight.knockback|Don't prevent the player from doing knockbacks when it's technically not possible to do so.|
|nocheatplus.checks.fight.noswing|Don't force the player to move the arm while fighting against someone or something.|
|nocheatplus.checks.fight.reach|Allows the player to hit players and mobs that are out of allowed distance.|
|nocheatplus.checks.fight.selfhit|Allows the player to do self hits for flying by exploiting the knockback of those hits.|
|nocheatplus.checks.fight.speed|Don't limit the amount of attacks that the player can do per second.|
===Inventory===
|nocheatplus.checks.inventory|Inventory check group.|
|nocheatplus.checks.inventory.drop|Don't limit the amount of items that a player may drop within a short timeframe.|
|nocheatplus.checks.inventory.instantbow|Don't prevent the player from shooting arrows instantly over the bow without taking the usual time to pull the string back.|
|nocheatplus.checks.inventory.instanteat|Don't prevent players from eating their food instantly without taking the usual time to munch on it.|
|nocheatplus.checks.inventory.fastclick|Allows the player to move items around the inventory instantly without using there mouse/keyboard to do so.|
|nocheatplus.checks.inventory.items|Allows the player to use illegal enchantments on signed books (This got fixed now in Minecraft 1.4.3 and higher).|
===Moving===
|nocheatplus.checks.moving|Parent permission for the moving checks group.|
|nocheatplus.checks.moving.creativefly|Allows the player to fly faster in creative mode then usually possible.|
|nocheatplus.checks.moving.morepackets|Allow the player to make a lot more movements than normally possible. Doing more movements will result in faster movement speed and causes the server to spend a lot of additional time for processing these movements.|
|nocheatplus.checks.moving.morepacketsvehicle|Allows players to make a lot more movements in vehicles (boats, minecrats, pigs, ...) than normally possible.|
|nocheatplus.checks.moving.nofall|Allows the player to avoid fall damage by using cheats. Normally NoCheatPlus will keep track of a player's movement and rectify the fall-damage calculations of Minecraft so the player always gets the fall damage he/she is supposed to get.|
|nocheatplus.checks.moving.survivalfly|Allows the player to fly in survival mode. It also treats the player as if he has the ".nofall" permission too.|
|nocheatplus.checks.moving.survivalfly.blocking|Allows the player to block while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sneaking|Allows the player to sneak while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sprinting|Allows the player to sprint backwards.|
|nocheatplus.checks.moving.survivalfly.speeding|Allows the player to bypass the vanilla walk/run/sprint speed limits.|
|nocheatplus.checks.moving.survivalfly.step|Don't check if the player is using the step hack to get faster over blocks then usually possible.|
==Modifications==
These permissions allow to control which feature/mod a player may use. There is no guarantee that players use the original client and obey the request to turn off/on features, though.
===CJB===
|nocheatplus.mods.cjb|All CJB features.|
|nocheatplus.mods.cjb.fly|Don't prevent the player from using CJB's fly mod on the server.|
|nocheatplus.mods.cjb.radar|Gives access to use CJB's radar mod on the server.|
|nocheatplus.mods.cjb.xray|Don't prevent the player from using CJB's xray mod on the server.|
===MinecraftAutoMap===
|nocheatplus.mods.minecraftautomap|All features for MinecraftAutoMap.|
|nocheatplus.mods.minecraftautomap.ores|Don't prevent the player from using the ore detector from Minecraft AutoMap's.|
|nocheatplus.mods.minecraftautomap.cave|Don't prevent the player from using the cave mode feature of the Minecraft AutoMap's mod.|
|nocheatplus.mods.minecraftautomap.radar|Don't prevent the player from using Minecraft AutoMap's inbuilt radar.|
===Rei===
|nocheatplus.mods.rei.cave|Don't prevent the player from using Rei's Minimap's cave mode.|
|nocheatplus.mods.rei.radar|Don't prevent Rei's Minimap mod users from using all kind of available radar hacks.|
|nocheatplus.mods.rei.radar.player|Allows the player to use the radar from Rei's Minimap to track down other players only.|
|nocheatplus.mods.rei.radar.animal|Allows the player to only use the animal radar from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.mob|Gives access to use the mob radar feature from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.slime|Allows the player to track down slimes only by using the radar feature of Rei's Minimap.|
|nocheatplus.mods.rei.radar.squid|Player is allowed to use the Rei's Minimap radar to track down squids only.|
|nocheatplus.mods.rei.radar.other|Allows the player to use all the other features of the Rei's Minimap radar.|
===SmartMoving===
|nocheatplus.mods.smartmoving|All SmartMoving features.|
|nocheatplus.mods.smartmoving.climbing|Don't prevent the player from using Smart Moving's climb feature.|
|nocheatplus.mods.smartmoving.swimming|Don't prevent the player from using Smart Moving's swimming.|
|nocheatplus.mods.smartmoving.crawling|Don't prevent the player from using Smart Moving's crawl.|
|nocheatplus.mods.smartmoving.sliding|Don't prevent the player from using Smart Moving's slide.|
|nocheatplus.mods.smartmoving.jumping|Don't prevent the player from using Smart Moving's jump.|
|nocheatplus.mods.smartmoving.flying|Don't prevent the player from using Smart Moving's fly.|
===Zombe===
|nocheatplus.mods.zombe|All zombe features.|
|nocheatplus.mods.zombe.fly|Don't prevent the player from using Zombe's fly mod.|
|nocheatplus.mods.zombe.noclip|Don't prevent the player from using Zombe's noclip mod on the server.|
|nocheatplus.mods.zombe.cheat|Don't prevent the player from using Zombe's cheat mods.|\\
== Parent Nodes ==
Most permissions have parent nodes, that in fact goes for all check types. Resulting in nocheatplus.admin, nocheatplus.checks.moving, nocheatplus.checks.moving.survivalfly, nocheatplus.checks.fight, etc.
=== Things to know about Permissions ===
You can exclude a specific player from getting logged by appending ".silent" to the relevant permission node of the specific check. E.g.\\

* **nocheatplus.checks.moving.nofall.silent**\\

will prevent NoCheatPlus from recording log messages for that player for the "nofall" check, while still executing all other actions as usual.
==Shortcut permissions==
|nocheatplus.admin| see above (full admin perms except check bypassing).|
|nocheatplus.shortcut.info|info about players|
|nocheatplus.shortcut.monitor|info about players and diagnostic info like version, lag,|
|nocheatplus.shortcut.safeadmin|"Safe" admin perms, no banning or reloading but unkick, exemption, data removal|

More to be added (shortcut.bypass - bypass about everything).

=推荐使用=

以下插件可以配合NCP使用.

[http://dev.bukkit.org/server-mods/compatnocheatplus-cncp/ CompatNoCheatPlus (cncp)]

例如 mcMMO, Citizens, MagicSpells 或 MachinaCraft . 大部分插件还不支持NPC，如果你有任何发现都可以联系我们.

[http://dev.bukkit.org/server-mods/orebfuscator/ Orebfuscator]

Orebfuscator 通过修改从服务器发送到客户端的方块信息文件来实现反矿石射线的作用，简单的说就是防X-ray.

=下载和历史更新=

* 下载正式版本请前往 BukkitDev [http://dev.bukkit.org/server-mods/nocheatplus/files/ Files].
* 下载测试版本请前往 [http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ Jenkins at EcoCityCraft].
* 不要从任何其他来源下载，不要使用别人给你的插件.
* 前往Jenkins查看所有版本的更新记录[http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ changes list].
* 前往GitHub查看所有改动 [https://github.com/NoCheatPlus/NoCheatPlus/commits/master commit history].
* <s>插件统计将不会传送至 mcstats.org.</s>

=帮助=

==其他帮助==

* 你可以到: [https://github.com/asofold/NCPDocs/blob/master/FAQ.creole#faq Frequently asked Questions] 以及 [https://github.com/asofold/NCPDocs/blob/master/Known%20Issues.creole#known-issues Known Issues] 提问.
* [https://github.com/asofold/NCPDocs/blob/master/README.creole#ncpdocs Wiki] (配设文件, 权限介绍, 指令介绍)
* 开发者请查看NoCheatPlus的API.

==联系我们==
你有疑问可以到,
IRC联系我们 (IRC地址: irc.spi.gt | 默认Port: 6667 | SSL-Port: 6697 | 频道: #nocheat | 网页客户端: WebIRC)
 
你可以创造一个提问票 [http://dev.bukkit.org/bukkit-plugins/nocheatplus/create-ticket/ new ticket] 或者查看已存在提问票 [http://dev.bukkit.org/server-mods/nocheatplus/tickets/ existing ticket].
 
你可以私聊原作者[http://dev.bukkit.org/home/send-private-message/ @asofold]和[http://dev.bukkit.org/home/send-private-message/ @MyPictures]，@IceAP (IRC: ICE)
 
请勿联系用户 'NoCheatPlus', 它仅用于管理，不会及时回复你的提问. 转移到 BukkitDev 和 GitHub 获取更多的帮助, 请勿相信BukkitDev以外的 NCP 管理人员 .

ChestCommandsGUI

2016-02-17T16:19:22Z

Lzs：/* 出售物品 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=ChestCommandsGui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|网址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 有用的一些前置插件 ==
Player Points - 允许使用另外的一种货币（点券）。
Scheduled Commands - 当你需要在一段时间后执行命令。
Info Book - 一个管理书籍的插件

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '从系统买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-02-17T16:19:10Z

Lzs：/* 收购物品 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=ChestCommandsGui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|网址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 有用的一些前置插件 ==
Player Points - 允许使用另外的一种货币（点券）。
Scheduled Commands - 当你需要在一段时间后执行命令。
Info Book - 一个管理书籍的插件

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '卖给系统泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-02-17T16:18:47Z

Lzs：/* 收购物品 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=ChestCommandsGui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|网址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 有用的一些前置插件 ==
Player Points - 允许使用另外的一种货币（点券）。
Scheduled Commands - 当你需要在一段时间后执行命令。
Info Book - 一个管理书籍的插件

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: '收购泥土'
ID: 3
POSITION-X: 1
POSITION-Y: 1

== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-02-17T16:17:49Z

Lzs：/* 出售物品 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=ChestCommandsGui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|网址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 有用的一些前置插件 ==
Player Points - 允许使用另外的一种货币（点券）。
Scheduled Commands - 当你需要在一段时间后执行命令。
Info Book - 一个管理书籍的插件

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
以100元/个钻石的价格卖给使用者。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
下面这个例子将会以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: 'Sell dirt'
ID: 3
POSITION-X: 1
POSITION-Y: 1
== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-02-17T16:17:24Z

Lzs：/* 出售物品 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=ChestCommandsGui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|网址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 有用的一些前置插件 ==
Player Points - 允许使用另外的一种货币（点券）。
Scheduled Commands - 当你需要在一段时间后执行命令。
Info Book - 一个管理书籍的插件

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
下面这个例子将会以100元/个钻石的价格卖给点击的玩家。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: '买一颗钻石'
ID: 264
POSITION-X: 1
POSITION-Y: 1

=== 收购物品 ===
下面这个例子将会以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: 'Sell dirt'
ID: 3
POSITION-X: 1
POSITION-Y: 1
== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]

ChestCommandsGUI

2016-02-17T16:16:34Z

Lzs：/* 全部权限与命令 */

{{模板:待完善}}
{{Bukkit Plugin Infobox
|插件名=ChestCommandsGui
|版本=v3.1.2
|前置插件=vault(可选）、PlayerPoints（可选）、任意一款经济插件（可选）。
|兼容服务端版本=1.8
|网址=http://dev.bukkit.org/bukkit-plugins/chest-commands/
}}

== 概览 ==
一个简单而功能强大的插件，可以用来创建GUI界面！

== 特征 ==
- 支持多个菜单
- 打开点击菜单可以实现对应的命令操作
- 自定义占位符和符号。
- 高质量的代码
- 对经济的支持，可以用Vault插件来支持（可选）
- 自动更新新的版本和通知新的版本
== 有用的一些前置插件 ==
Player Points - 允许使用另外的一种货币（点券）。
Scheduled Commands - 当你需要在一段时间后执行命令。
Info Book - 一个管理书籍的插件

== 基础教程 ==
=== 修改一个现有的菜单 ===
路径/plugins/ChestCommands/menu/

=== 创建一个新菜单 ===
最简单的方法:复制和粘贴现有的菜单,更改设置,添加/删除/编辑项目。
推荐使用小写文件名,因为权限对大小写要求是非常严格的！。

=== 菜单设置 ===
''' Menu settings： '''
你可以在菜单的顶部找到这些选项，“Menu settings：”部分
name: '&1Menu' (必须)
在打开菜单的时候将显示这个名称，自定义标题的长度不能超过30个字符(包括颜色字符).

rows：6（必须）
这个设置规定了菜单有多少行，正常显示的上限为6.

command: 'menu'（可选）
这是触发菜单的命令，他将改写现有的指令并且打开菜单，你可以设置多个指令，并用分号隔离，例如：'menu; m; mainmenu'

auto-refresh: 5 (可选)
需要刷新的的菜单将刷新变量。注意金钱和点数在每次交易后都会自动更新。

open-with-item: (可选)
id 'wool:1'— 打开一个菜单用一个特定的物品，可以要求特定的数值！
right-click: true -可以使用右键点击打开菜单！
left-click: false -无法通过左键点击打开菜单！
''' Menu items： '''
不要用大写，内部颜色代码和符号的名字（看下面），记住，他必须在于同一个菜单之内的不同图标不同！
每一个项目都是由一个内部名称（在任何方式中不可见的玩家）和节点组成，可以分配命令，自定义名称，还有更多的图标。一个单独的项目应该这样写：

➦ 内部名称
spawn-item:
ID: bed
COMMAND: 'spawn'
NAME: '&aReturn to spawn'
LORE:
- 'This is the lore of the item.'
- 'These lines appear below the name.'
POSITION-X: 1
POSITION-Y: 1
➥这些节点
NAME, COMMAND, ID, ...被称为节点，每个项目可以有不同的节点来定制它。读取更多的节点（这不是完整的列表）。
每个项目必须要有节点：POSITION-X 和 POSITION-Y.

== 节点教程 ==
此页包含了一个节点列表，他可以用于所有图标！

注：这三个节点严格要求每一项 ID position-x position-y.，

'''ID：'''
图标的项标识。你可以用数字和文字标识，但是我推荐使用文字更好的可读性。文字标识列表：这里（不区分大小写），可以省略下划线。
范例：ID: stone、
你可以使用数据值，但是必须要把数值放在单引号中！数量是可选的并且用逗号隔开。
范例 (10个黑羊毛):
ID: 'wool:15, 10'

'''POSITION-X 和 POSITION-Y：'''
[[文件:chestcommand.png]]
有三个所需的节点。他们设置了图标的位置。你可以很容易地通过这个表找到这个坐标：

范例:
POSITION-X: 5
POSITION-Y: 1

'''NAME：'''
这个节点可以设置图标的显示名称。你可以使用颜色代码和符号。
范例:
NAME: '&6这是一个有颜色的名字！'
'''LORE：'''
该节点显示下方的文字。你可以使用颜色代码和符号。
例子：
Example:
LORE:
- 'Description of the item'
- 'Some other details'
- '&cImportant note'
'''ENCHANTMENT：'''
这个节点设置了结界,将出现在一个项目,主要是用于附魔发光的效果。
范例:
ENCHANTMENT: 'fire aspect, 1'
附魔等级是可选的。您可以使用多种附魔,通过用分号分开它们！
范例:
ENCHANTMENT: 'sharpness, 5; durability, 10; silk touch'
'''Color：'''
这个节点仅限于修改皮革盔甲。颜色的格式的<red>, <green>, <blue>”。每种颜色必须在0到255之间。
范例：
COLOR: '255, 0, 0'
'''SKULL-OWNER：'''
This node sets the skull owner of an item, only if it's a player's head (skull:3). Useful from 1.8 and above, for displaying different head textues.
范例:
SKULL-OWNER: 'filoghost'
'''Command：'''
这个节点设置可以设置命令。它支持各种各样的命令,这将不会列在这里。正常的命令执行(没有前缀，也就是”/“)当玩家点击图标。命令(这应该称为行动在这种情况下)也可以更多的东西
不只是执行命令,看起来这里了解更多信息。
范例:
COMMAND: 'spawn'
'''PRICE：'''
这个节点设置一个物品的价格。玩家没有足够的钱不会执行命令！。
范例:
PRICE: 100.0
'''Leves：'''
这个值设定了点击指定物品所需要的经验值等级。如果玩家点击时没有足够的经验值等级，命令将不会触发。如果触发，对应的经验值等级将被扣除
范例：
LEVELS: 5
'''Points：'''
这个节点是配合点券插件的！他需要一定量的点券来使用物品，点券会被扣除！
POINTS: 50
'''REQUIRED-ITEM'''
这个节点设置点击所需要的物品,没有该物品的命令将不会被执行。格式都是相同的ID。
范例：（三十个橙色染色玻璃）
REQUIRED-ITEM: 'stained glass:1, 30'
'''KEEP-OPEN'''
该节点规定了如果菜单点击后，是否保持打开（默认不保持），值可以是True或者False。
范例：
KEEP-OPEN: true
'''PERMISSION：'''
这个节点设置玩家是否需要一个权限来点击图标，可以选择任意权限，你可以取消他的权限，加一个-在权限之前，那个用户就将没有权限。
范例：
PERMISSION: 'my.custom.permission'
'''VIEW-PERMISSION：'''
就想权限节点，但是玩家在没有权限将无法看到这个图标！可以否定他的权限，比如(e.g.: '-my.custom.permission').
范例：
VIEW-PERMISSION: 'my.custom.permission'
'''PERMISSION-MESSAGE：'''
这个节点设置了玩家没有权限时的提示消息(默认config.yml“没有权限”消息是可配置的)。
范例：
PERMISSION-MESSAGE: '&c你必须是VIP才能购买这个物品!'

== 点击动作教程 ==
本指南教程了点击某个图标时候所发生的动作，没有其他动作！

'''打开其他图形界面的'''
如果一个命令能打开其他插件的图形界面，请设置KEEP-OPEN为True！

'''变量'''
这些变量可以用于点击菜单时候的命令，菜单的叙述列表，菜单的名字。
{player} (使用者名字).
{world} (使用者所在世界).
{online} (在线玩家数量).
{max_players} (服务器玩家上限).
{money} (玩家的金钱，你必须拥有 Vault 插件).

'''一般命令'''
指令前不需要添加“/”，除了WorldEdit的命令。
这个例子演示了如何在点击的时候将强制执行命令/Spawn。
范例：
COMMAND: 'spawn'
'''以控制台的身份执行命令'''
要小心使用这个命令!
若要用控制台的身份执行命令,请在命令前方加入"console:"
范例:
COMMAND: 'console: say Hello world!'
'''以OP的身份执行命令'''
要小心使用这个命令!
若要用op的身份执行命令,请在命令前方加入"op:"
范例：
COMMAND: 'op: say 你好世界!'
'''多个指令'''
用分号分隔多个命令；”。这个例子让玩家执行命令，顺序是先执行 /spawn，然后再执行/me!
范例：
COMMAND: 'spawn; me 我被传送到重生点!'
'''私聊玩家'''
像以前的例子，把tell：后面的内容私聊发送给玩家，你可以使用颜色代码和符号！
在范例中，信息将是红色的！
范例：
COMMAND: 'tell: &c你好!'
'''广播事情'''
每个人都能看到这个消息！
范例：
COMMAND: 'broadcast: {player}太棒了!'
'''播放音乐'''
一个音乐由3个参数构成(只有一个是必须的)这三个参数用逗号分隔。他们的格式是： 'sound: <声音的名字>, [范围], [音量]'
范例：
COMMAND: 'sound: ghast scream, 2.0, 0.5'
'''给予物品'''
这是一个用于给予物品的基础命令，您可以更改给予物品的数量和类型，对于更高级的事情，请使用vanilla命令.
下面是给玩家10个黑色羊毛的指令。
范例：
COMMAND: 'give: wool:15, 10'
'''给予金钱'''
这个命令将会给使用者金钱。
你需要前置插件Vault和一个经济插件。
范例：
COMMAND: 'give-money: 100.0'
'''打开其他菜单'''
就像在控制台的指令，输入“open：文件名”。“文件名”就是菜单的名字。如果菜单不存在将会显示一个错误的信息。
使用者需要相应权限来打开菜单。
范例：
COMMAND: 'open: example.yml'
'''BungeeCord服务器的命令'''
你可以使用“Server：<目标服务器>
这个命令将会使使用者尝试连接到目标服务器。
范例：
COMMAND: 'server: hub'
'''玩家点券(使用PlayerPoint插件)'''
在范例中，50个点券会给使用者，如果你想实现点击扣除点卷的功能，请看节点points。
范例：
COMMAND: 'give-points: 50'
'''Boss血条消息(使用BarApi插件)'''
发送一条boss血条消息, 格式是： 'dragon-bar: <以秒为单位的时间> | <消息>'.
在下面的范例中, 一个boss血条将会出现在点击这个图标的人的视野内10秒, 消息会显示他的名字。
范例:
COMMAND: 'dragon-bar: 10 | &a你好, {player}!'

== 经济插件设置教程 ==
=== 要求 ===
Vault (必须更新到最新的版本。)
一个经济插件 (就像iConomy, BOSEconomy, etc等插件)
=== 安装 ===
放置Vault和经济插件到plugin的文件夹内。
现在你就可以使用点击的价格和命令：“give-money：”

== 牌子设置教程 ==
=== 如何创建一个牌子 ===
创建一个牌子
在牌子的首行输入[Menu](你需要拥有： "chestcommands.sign"的权限）
在第二行输入菜单名字（你需要加入".yml")
=== 验证 ===
如果该菜单已经成功创建，则第一行的[Menu]则会变成蓝色，右键即可打开菜单。
如果该牌子创建有误，则第一行的[Menu]则会变成红色，并且在聊天框里会返回错误信息。
=== 范例 ===
暂无

== 符号教程 ==
这些符号可以运用在文本中。
=== 符号 ===
<3 = ❤
[*] = ★
[**] = ✹
[p] = ●
[v] = ✔
[+] = ♦
[++] = ✦
[x] = █
[/] = ▌
[cross] = ✠
[arrow_right] = →
[arrow_left] = ←
[arrow_up] = ↑
[arrow_down] = ↓
=== 添加新的符号 ===
打开文件placeholders.yml，按照这样的格式添加一行：
名称: 内容
[special]: \u2726 Special Item \u2726
这表示着文中的[special]将会被替换✹ Special Item ✹。
你可以使用任何的Unicode符号，使用java语言。网站：
http://www.fileformat.info/info/unicode/index.htm

== 命令与权限的教程 ==
=== 全部权限与命令 ===

{| class="wikitable"
|-
! 命令 !! 权限 !! 叙述
|-
| /chestcommands 或 /cc || - || 显示插件信息。
|-
| /cc help || chestcommands.command.help ||列出所有命令。
|-
| /cc reload || chestcommands.command.reload || 重载插件
|-
| /cc open <路径> || chestcommands.command.open || 打开指定菜单。(需要相应权限)
|-
| /cc open <路径> [玩家] || chestcommands.command.open.others || 为其他玩家打开菜单。(不需要相应权限)
|-
| /cc list || chestcommands.command.list || 列出所有已加载的菜单。
|-
| - || chestcommands.update || 显示更新信息。
|-
| - || chestcommands.open.XXX.yml || 打开XXX菜单的权限。
|-
| - || chestcommands.economy.bypass || 免费使用
|-
| - || chestcommands.sign || 创建牌子
|}

=== 图标权限 ===
如需查看图标权限，请上翻去看图标教程。
== 购买和出售物品教程 ==
首先，你必须阅读经济的安装和命令的帮助。
=== 出售物品 ===
下面这个例子将会以100元/个钻石的价格卖给点击的玩家。

'''例子：'''
COMMAND: 'give: 264'
PRICE: 100
NAME: 'Buy a diamond'
ID: 264
POSITION-X: 1
POSITION-Y: 1
=== 收购物品 ===
下面这个例子将会以10元/64个泥土的价格从玩家背包里收购。

'''例子'''
COMMAND: 'givemoney: 10'
REQUIRED-ITEM: 3, 64
NAME: 'Sell dirt'
ID: 3
POSITION-X: 1
POSITION-Y: 1
== Github ==
https://github.com/filoghost/ChestCommands
== 捐助 ==
如果你有能力，建议给作者一些捐助
他的paypal链接： [https://www.paypal.com/cgi-bin/webscr?return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&cn=Add+special+instructions+to+the+addon+author%28s%29&business=filoghost%40gmail.com&bn=PP-DonationsBF%3Abtn_donateCC_LG.gif%3ANonHosted&cancel_return=http%3A%2F%2Fdev.bukkit.org%2Fbukkit-plugins%2Fchest-commands%2F&lc=US&item_name=Chest+Commands+GUI+%28from+Bukkit.org%29&cmd=_donations&rm=1&no_shipping=1&currency_code=EUR 点击这里]
[[Category:综合]]
[[Category:娱乐]]
[[Category:管理]]