查看“BanItem”的源代码

{{Bukkit Plugin Infobox
|外文名     = BanItem
|作者       = _ForgeUser9327440
|最新版本   = 2.8
|兼容服务端 = 1.5.2-1.7.2
|前置插件   = 无
|源地址     = https://dev.bukkit.org/projects/banitem
}}

'''BanItem'''是一款由_ForgeUser9327440开发的用于禁止特定物品的Bukkit插件。

== 介绍 ==
不想让玩家使用模组中的物品，如机器人，采石场？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 />

[[分类:安全]] [[分类:管理]] [[分类:修正]]