Bookshelf - 书架存储插件

💡关于本插件

你是否曾想过，为什么 Minecraft 里的书架不能用来存放书？现在，它可以了！通过此插件，你可以像打开箱子一样打开书架，并在其中存放书籍。

✨主要特性

书架功能

• 右键点击书架即可打开一个类似箱子的物品栏界面。
• 玩家打开书架时会发出粒子效果（可在配置中开关）[需 1.13 或更高版本]。
• 可自定义每个书架的物品栏行数（默认在配置中为 2 行）。
• 玩家在书架中放入或取出物品时会播放放置书本的音效。
• 可限制能放入书架的物品类型（默认配置中仅允许书本类物品）。
• 支持使用活塞和粘性活塞移动书架。
• 支持命名书架！（类似于命名箱子后放置，其物品栏会保留箱子的物品名称）。
• 支持投掷器（需在配置中启用）。
• 实验性支持漏斗与漏斗矿车（需在配置中启用）（注意：如果书架过多，此功能可能相当消耗资源）。
• 支持在创造模式下使用 Shift+中键点击方块来复制内含物品的书架。

附魔台增强 [需 1.11 或更高版本]

• 用装有特定附魔书的书架环绕附魔台，可以提升获得该附魔的几率！
• 书越多，几率越高！
• 例如，如果所有书架的每个槽位都放满了“锋利 V”附魔书，你将必定获得锋利附魔！
• 此功能同样可以在配置中开关。

🎮支持的插件

本插件与以下保护或功能插件兼容（在大多数插件中，书架被视为箱子）：

• 保护插件：Bolt、LWCX（需要最新版）、BlockLocker、WorldGuard（需要至少 v7.0.0）、GriefPrevention、RedProtect、Residence、Towny、Lands（需要最新版）、GriefDefender。
• 空岛插件：ASkyBlock、BentoBox、SuperiorSkyblock2。
• 地块插件：PlotSquared（支持 v4, v5, v6, v7）。
• 隐身与动画：OpenInv 静默箱子、Essentials 玩家隐身、CMI 玩家隐身、SuperVanish 玩家隐身、PremiumVanish 玩家隐身、InteractionVisualizer 书架交互动画（需要最新开发版）。

🔧安装与依赖

依赖

• 无！本插件无需任何依赖。

安装步骤

• 将 Bookshelf.jar 放入服务器的 plugins 文件夹。
• 启动服务器。
• 根据需要编辑配置文件。
• 如果你在第 3 步修改了配置，请重启服务器。

⭐命令与权限

命令

• /bookshelf reload - 重载插件配置。
• /bookshelf update - 检查插件更新。

权限

• bookshelf.use - 允许玩家使用书架。[默认: false]
• bookshelf.reload - 允许重载插件。[默认: op]
• bookshelf.copynbt - 允许在创造模式下使用 Shift+中键点击复制内含物品的书架。[默认: op]
• bookshelf.update - 允许接收更新消息。[默认: op]

❓常见问题 (Q&A)

漏斗和投掷器不起作用！我该怎么办？

• 你必须在配置文件中启用 EnableHopperSupport 和/或 EnableDropperSupport！（注意：如果书架过多，此功能可能相当消耗资源）。

附魔台增强功能不起作用，没有报错，并且我已在配置中启用，为什么？

• 如果你运行的是 Minecraft 1.8 - 1.10.2 版本，很遗憾，这些版本不支持附魔台增强功能。
• 如果你运行的是 1.11 或更高版本，请仔细检查你的设置和权限，或联系我！

Shift + 选取方块复制 NBT 的功能无效，我已经给了自己权限，怎么回事？

• 目前，该功能仅在 Minecraft 1.15+ 版本中经过测试。如果在其他版本中无效，这属于正常情况，我们正在努力解决。感谢你的耐心！

附魔台增强是如何计算的？

• 请查看 Wiki 页面：https://github.com/LOOHP/Bookshelf/wiki/Enchantment-Table-Boosting

🔧开发者 API

Bookshelf 为开发者提供了 API 以自定义或使用其功能：

• 当漏斗或漏斗矿车与书架交换物品时，会触发 InventoryMoveItemEvent，可以像监听其他 Bukkit 事件一样监听它。
• 当玩家打开或关闭书架时，会触发 PlayerOpenBookshelfEvent 或 PlayerCloseBookshelfEvent。如果玩家没有权限访问该书架（包括其他插件的保护），事件将被标记为取消（在 LOWEST 优先级之后触发）。

更多信息请访问

https://github.com/LOOHP/Bookshelf/tree/master/src/main/java/com/loohp/bookshelf/API

💡已知限制与说明

当前限制

• 书架无法通过红石比较器输出红石信号，我将在找到可行方法后尝试添加此功能。
• 书架的物品交易不会被 CoreProtect 等方块记录插件捕捉，未来我将尝试添加此功能或创建自己的日志系统。

重要说明

• 我只保证插件在最新版本的 Spigot 和 Paper 上能完美运行并拥有全部功能。
• 由于我是一名学生，时间有限。旧版本仅为“支持”状态，可能会缺少一些功能或钩子，但通常应该可以正常工作。
• 尽管如此，请像对待论坛上的任何其他插件一样，自行进行测试以确保兼容性。
• 请通过 Discord（推荐）或在讨论区报告问题，而不是在评论中。谢谢！

🔧其他信息

开发构建与测试服务器

• 开发构建：可通过 Jenkins 获取。
• 展示服务器：想试用插件吗？IP: mc.loohpjames.com

配置文件

• 最新配置文件及说明：[请查看此链接](指向原文档中的配置链接)

支持开发

• 考虑捐赠！这能帮助我持续维护这些免费插件！[点击支持！](原捐赠链接)
• 寻找 Minecraft 服务器托管？不妨试试 BisectHosting！使用此链接或点击横幅可获得首月 25% 折扣，同时也能支持我的开发工作！

- 链接：[https://www.bisecthosting.com/loohp](https://www.bisecthosting.com/loohp)

加入社区

• 点击此处加入 Discord 服务器！