## 关于
你是否曾想过为什么 Minecraft 中的书架不能用来存放书？现在你可以了！
通过这个插件，你将能够**像打开箱子一样打开书架**并**在里面存放书**。
## 截图
*^指示书架正在打开的粒子效果*
*^书架内容，行数可以自定义*
## 特性
### 1. 书架！
- 右键点击书架以打开类似箱子的物品栏
- 当玩家打开书架时，书架会发出粒子（可在 config 中启用）*[1.13 或以上]*
- 自定义每个书架的行数（默认在 config 中为 2 行）
- 玩家在书架中放置或移除物品时播放放置图书的声音
- 限制可以放置到书架中的物品类型（默认在 config 中仅允许图书类型的物品）
- 支持活塞和粘性活塞移动书架
- 支持命名书架！*(类似于当你命名一个箱子并放置它时，物品栏保留箱子的物品名称)*
- 支持投掷器 ***(需要在 config 中启用)***
- _实验性_ 支持漏斗和漏斗矿车 ***(需要在 config 中启用)*** *(请注意，如果你的书架太多，资源消耗会很大)*
- 支持创造模式下使用 Shift + 中键点击方块来复制带物品的书架
### 2. 附魔台增强！*[1.11 或以上]*
- 用周围放置了带有你选择的附魔的书籍的书架来增强附魔台！
- 更多的书，更高的几率！
- 例如，如果所有书架的所有插槽都包含锋利 5 的书，你将保证获得锋利附魔！
- 此功能始终可以在 config 中启用
## 支持的插件
- 支持 [Bolt](https://modrinth.com/plugin/bolt) 保护
- 支持 [LWCX](https://www.spigotmc.org/resources/69551/) 保护 (需要最新版本)
- 支持 [BlockLocker](https://www.spigotmc.org/resources/3268/) 容器锁定
- 支持 [WorldGuard](https://enginehub.org/worldguard/) 区域 (需要至少版本 7.0.0)
- 支持 [GriefPrevention](https://www.spigotmc.org/resources/1884/) 土地声索保护
- 支持 [RedProtect](https://www.spigotmc.org/resources/15841/) 土地声索保护
- 支持 [Residence](https://www.spigotmc.org/resources/11480/) 土地声索保护
- 支持 [Towny](https://townyadvanced.github.io/) 土地声索保护
- 支持 [Lands](https://www.spigotmc.org/resources/lands-land-claim-plugin-grief-prevention-protection-gui-management-nations-wars-1-17-support.53313/') 土地声索保护 (需要最新版本)
- 支持 [ASkyBlock](https://www.spigotmc.org/resources/1220/) 岛屿保护
- 支持 [BentoBox](https://www.spigotmc.org/resources/73261/) 岛屿保护
- 支持 [SuperiorSkyblock2](https://www.spigotmc.org/resources/63905/) 岛屿保护
- 支持 [GriefDefender](https://www.spigotmc.org/resources/1-12-2-1-17-1-griefdefender-claim-plugin-grief-prevention-protection.68900/) 土地保护
- 支持 [PlotSquared](https://www.spigotmc.org/resources/plotsquared-v4-v5-out-now.1177/) 地块保护 (需要 v4, v5, 或 v6)
- 支持 [OpenInv](https://dev.bukkit.org/projects/openinv) 隐形箱子
- 支持 [Essentials](https://www.spigotmc.org/resources/essentialsx.9089/) 玩家隐身
- 支持 [CMI](https://www.spigotmc.org/resources/cmi-270-commands-insane-kits-portals-essentials-economy-mysql-sqlite-much-more.3742/) 玩家隐身
- 支持 [SuperVanish](https://www.spigotmc.org/resources/supervanish-be-invisible.1331/) 玩家隐身
- 支持 [PremiumVanish](https://www.spigotmc.org/resources/premiumvanish-stay-hidden-bungee-support.14404/) 玩家隐身
- 支持 [InteractionVisualizer](https://www.spigotmc.org/resources/77050) 书架互动动画 (需要最新开发版本)
*(大多数插件中，书架被视为箱子)*
## 依赖
- 无！
## 安装
1. 将 Bookshelf.jar 放入插件文件夹，以及所需的依赖项
2. 启动服务器
3. *编辑 config (如果需要)*
4. *更改 config 中的内容后重启服务器 (在步骤 3 中)*
## 开发版本
[**Jenkins**](https://ci.loohpjames.com/job/Bookshelf/)
## 展示服务器
想试用这个插件吗？
```
IP: mc.loohpjames.com
```
## 指令
/bookshelf reload - 重新加载插件
/bookshelf update - 检查更新
## 问答
### 漏斗和投掷器无法工作！我该怎么办？
你需要在 config 中启用 "EnableHopperSupport" 和/或 "EnableDropperSupport"！
*(请注意，如果你的书架太多，资源消耗会很大)*
### 附魔台增强功能无法工作，并且没有错误，我已经在了 config 中启用了它，为什么会这样？
如果你运行的是 Minecraft 版本 1.8 - 1.10.2，不幸的是，这些版本不支持附魔台增强功能。
如果你运行的是 Minecraft 版本 1.11 或更高版本，请仔细检查你的设置和权限或联系我！
### 使用 Shift + 拾取方块功能不起作用，我已经给予了自己权限，这是怎么回事？
目前，此功能仅在 Minecraft 1.15+ 中进行过测试。 如果在其他版本中不起作用，这很正常，并且正在进行开发。 感谢你的耐心！
### 附魔台增强功能是如何计算的？
查看 wiki 页面：https://github.com/LOOHP/Bookshelf/wiki/Enchantment-Table-Boosting
## API
**Bookshelf 为开发者提供一个 API 来自定义其功能或使用其功能**
- 当漏斗或漏斗矿车与书架交换物品时，将触发 **InventoryMoveItemEvent**，就像任何其他 bukkit 事件一样，只需监听它即可。
- 当玩家打开或关闭书架时，将触发 **PlayerOpenBookshelfEvent** 或 **PlayerCloseBookshelfEvent**。 如果玩家没有权限访问该书架（包括来自其他插件的保护），则它将以 _已取消_ 的状态触发 (优先级最低)。
**https://github.com/LOOHP/Bookshelf/tree/master/src/main/java/com/loohp/bookshelf/API**
有关更多信息，请访问以上链接
## 权限
bookshelf.use - 允许玩家使用书架 [默认：false]
bookshelf.reload - 重新加载插件 [默认：op]
bookshelf.copynbt - 允许你在创造模式下使用 Shift + 中键点击复制带物品的书架 [默认：op]
bookshelf.update - 允许你接收更新消息 [默认：op]
## 默认配置
**[最新配置及描述](https://github.com/LOOHP/Bookshelf/blob/master/common/src/main/resources/config.yml)**
## 限制
- 书架不会通过红石比较器输出红石信号，我将尝试添加该功能 *一旦我找到一种有效的方法 :/*
- 核心保护等方块记录器不会拾取书架交易，我将在未来尝试添加或创建自己的日志系统。
## 数据使用
使用统计信息位于 https://bstats.org/plugin/bukkit/InteractiveChat， 公开可见，包含你服务器在统计数据中。 你的服务器没有任何私密信息被发送。
更新检查也通过 https://api.loohpjames.com 进行，以通知您每次发布新版本。 你的服务器没有任何私密信息被发送。
