查看“BanItem”的源代码

{{待完善}}
{{Bukkit Plugin Infobox
|插件名=BanItem
|版本=v2.8
|前置插件=无
|兼容服务端版本=1.5.2-1.7.2
|網址=http://dev.bukkit.org/bukkit-plugins/banitem/
}}

不想让玩家使用模组中的物品，如机器人，采石场？BanItem可以根据你的选择禁止任何物品！只需要将物品添加到黑名单中即可实现! 此插件可以在Tekkit或是其它模组服务器上运行，可以用于封禁含有BUG的物品、无视房屋保护机制的物品，服主也可以根据需要对物品进行不同程度的解禁！

推荐使用[[PermissionEx]]插件进行权限管理。

本版本适用于所有模组！

==命令==
{| class="wikitable"
|-
! 命令
! 介绍
|-
|/BanItem clear <玩家>
|Check inventory for items that are banned.<ref>尚不知晓用法，请诸位协助完善。</ref>
|-
|/BanItem add <理由>
|将你手中物品添加至黑名单。
|-
|/BanItem add all <理由>
|将你手中物品的ID所有附加值（":"后面的数字，可代表电量、耐久等）都加入到黑名单。
|-
|/BanItem del
|将手中物品从黑名单中移出。
|-
|/BanItem check
|查看手中物品的封禁状态。
|-
|/BanItem toggle conf
|调整玩家与被封禁物品进行交互时 是否没收该封禁物品的设置。
|-
|/BanItem reload
|重载插件的配置。<ref>此处是指配置文件还是该插件全部配置尚不明确，原文为config。</ref>
|}

==权限节点==
{| class="wikitable"
|-
! 权限
! 介绍
|-
|Banitem.add
|添加封禁物品的权限
|-
|Banitem.del
|移除封禁物品的权限
|-
|BanItem.reload
|重新载入封禁系统的权限
|-
|BanItem.check
|检查手中物品被封禁的权限
|-
|BanItem.toggle
|在玩家与封禁物品交互时中没收被封禁物品的权限
|-
|banitem.clear
|检查物品栏中被封禁物品的权限
|-
|banitem.clear.player
|检查某个玩家物品栏中被封禁物品的权限
|-
|Banitem.*
|所有权限
|}

===无视封禁相关权限节点===
*banitem.int.<物品ID>:<数据值>
*banitem.break.<物品ID>:<数据值>
*banitem.place.<物品ID>:<数据值>
*banitem.click.<物品ID>:<数据值>
*banitem.pickup.<物品ID>:<数据值>
*banitem.bypass.<物品ID>:<数据值>

====示例====
*banitem.bypass.35:* 可以使用全部羊毛即使被ban
*banitem.bypass.35:0 可以使用白色羊毛即使ban

==功能==
*为用户/用户组添加权限
*显示被封禁物品的列表
*将手中所持物品添加至黑名单
*将黑名单中的物品删除(解禁)
*clear，list和help命令可以在控制台使用
*使用命令清除黑名单
*支持带数据值的物品
*越权使用被封禁物品（需要对应权限）（例如banitem.bypass.35:*或是banitem.bypass.35:6）
*可以禁止拾起黑名单物品
*更高级的配置文件
*使用被封禁物品时显示封禁理由

==教程==
===往黑名单中添加物品===

====游戏内指令====
/banitem add <理由>。使用命令时需要手持待操作物品。此方式最为简单。

====通过配置文件====

操作路径：/plugins/banitem/
*打开config.yml
*查看'default-config.yml'来参考配置文件格式
*配置文件写完了保存之后，请使用"/banitem reload"指令来重载配置文件。如果服务器关了重新开服就行。

完毕!

====三款实例====

* '5:-1:木材太可怕' [ -1 即是代表所有数据值]
* '35:6:不要触摸这块羊毛'
<ref>咳咳，作者这里的标题确实是3个实例的意思，卖萌？</ref>

==检查更新==
将"UpdateChecker"后的阀值修改为"false"即可禁用检查更新功能。示例：UpdateChecker: false

==安装插件==
{{模板:安装插件}}

==注释==
<references />

[[Category:安全]] [[Category:管理]] [[Category:修正]]