HavenBags - Shulker-like Player Bound Bags - HavenBags - 玩家绑定储物袋

HavenBags 是一款功能强大的背包插件，允许玩家创建类似潜影盒、可绑定或共享的背包。它提供了丰富的自定义选项、自动化功能和跨服务器支持，是管理物品存储的终极解决方案。

💡依赖与兼容性

本插件需要以下前置插件才能正常运行

• ValorlessUtils (v1.17.0.313 或更高版本)

- 这是一个免费的实用程序库，与作者的所有插件兼容。

- 下载链接：https://www.spigotmc.org/resources/valorlessutils.109586/

兼容插件：

• CustomRecipes：支持为 HavenBags 创建自定义合成配方。
• PlaceholderAPI：支持使用下方列出的占位符。
• PvPManager / PvPManager Lite：可在 PvP 期间禁用背包使用。
• HavenBagsPreview (Fabric Mod)：由 ArturoAtomplay 制作，允许在工具提示中直接预览背包内容，无需打开。

🎮核心特性

自定义背包

• 创建不同大小的背包（9/18/27/36/45/54 格）。
• 背包可绑定给特定玩家，或设置为无主状态供任何人使用。
• 支持通过 CustomRecipes 插件创建自定义合成配方，也保留了简单的内置合成系统。

自动化功能

• 自动拾取：设置背包自动拾取物品，可自定义过滤规则，即使玩家背包已满也能工作。
• 磁力吸收：启用后，背包会吸收附近地面的物品。
• 自动整理：按字母顺序自动整理背包内容，优先级为：显示名称 > 物品名称 > 材料类型。
• 自动补充：当玩家手中最后一个方块被放置时，会自动从背包中取出相同物品进行补充。

管理与保护

• 放置阻止：背包无法被放置，防止数据丢失。
• 复制预防：检测到重复背包时会在控制台警告，并强制关闭其中一个。
• 背包保护：背包不会被火、熔岩、仙人掌等破坏（可在配置中禁用）。
• 灵魂绑定：玩家死亡后保留背包（可能与 GravesX、AngelChest 等插件不兼容）。

自定义与升级

• 按尺寸设置纹理：可根据背包大小和绑定状态设置不同的外观纹理。
• 皮肤令牌：创建自定义的皮肤令牌，让玩家更改背包外观。
• 背包升级：定义普通或自定义物品（通过 ModelData）作为升级材料。
• 升级工作台：右键点击制箭台可打开自定义 GUI，用于升级和更换背包皮肤。

特殊背包类型

• 预定义背包：通过命令生成含有特定物品的背包。
• 虚空背包：仅能通过命令访问和给予的特殊背包，数据存储在独立文件中，不支持跨服务器 MySQL，且不具备普通背包的所有功能。
• 箭袋功能：可将背包作为箭袋，直接从背包中取用箭矢。

高级功能

• 重量限制：为背包设置载重上限，可为不同物品定义重量，并设置超重惩罚。
• 跨服务器背包：使用 “MySQLPlus” 数据库类型时，背包数据可在多个服务器间共享（需使用相同数据库）。
• 无缝数据库转换：支持在 Files（文件）、SQLite（推荐）、MySQL 和 MySQLPlus 四种存储方式间无缝转换。
• 管理员 GUI：提供便捷的 GUI 界面来创建、恢复和预览背包。

🔧命令与权限

玩家命令与权限

• havenbags.player - 拥有所有玩家权限。
• havenbags.use - 允许使用背包。
• havenbags.open.<size> - 允许打开指定大小的背包。
• havenbags.upgrade.<size> - 允许升级指定大小的背包。
• havenbags.carry.X - 设置玩家可携带的背包数量上限。
• havenbags.max.X - 设置玩家可创建的背包数量上限。

常用命令（可用 /bags 或 /bag 缩写）：

• /havenbags gui - 打开 GUI 来恢复或删除自己的背包（若启用）。
• /havenbags rename [名字] - 重命名手中的背包（无 havenbags.bypass 权限时只能重命名自己的）。
• /havenbags empty/explode - 将手中背包的物品倾倒到地上。
• /havenbags autopickup <过滤器> - 设置背包的自动拾取规则。
• /havenbags trust <玩家> - 允许其他玩家打开你绑定的背包。
• /havenbags untrust <玩家> - 取消玩家的使用权限。
• /havenbags autosort <on/off> - 开关背包自动整理。
• /havenbags magnet <on/off> - 开关磁力吸收。
• /havenbags refill <on/off> - 开关自动补充。
• /havenbags open <ID> - 打开一个虚空背包。
• /havenbags help - 查看你有权使用的命令帮助。

管理员命令与权限

• havenbags.admin - 拥有所有管理员权限。
• havenbags.bypass - 绕过背包的所有权限制。

管理命令：

• /havenbags gui - 打开管理员 GUI。
• /havenbags open <玩家> <ID> - 打开指定玩家的虚空背包。
• /havenbags create [无主] <大小> - 创建一个新背包。
• /havenbags give <玩家> [无主] <大小> - 给予玩家一个新背包。
• /havenbags give <玩家> <背包名> - 给予玩家一个预定义的背包。
• /havenbags give <玩家> ethereal <行数> <ID> - 给予玩家一个虚空背包。
• /havenbags restore <玩家> [背包UUID] - 恢复服务器上存储的背包副本给玩家。
• /havenbags preview <玩家> [背包UUID] - 预览服务器上存储的背包。
• /havenbags texture <纹理或base64> - 设置手中背包的纹理（只能更改自己拥有的背包）。
• /havenbags modeldata <值> [材料] - 设置手中背包的 CustomModelData。
• /havenbags itemmodel <值> [材料] - 设置手中背包的 ItemModel。
• /havenbags weight <值> - 设置手中背包的重量限制。
• /havenbags effect <值> - 对背包应用 effects.yml 中定义的效果。
• /havenbags token texture <纹理或base64> [玩家] - 创建一个可改变背包外观的纹理令牌。
• /havenbags token custommodeldata <值> [玩家] - 创建一个可改变背包外观的模型数据令牌。
• /havenbags info - 显示手中背包的信息。
• /havenbags rawinfo - 显示手中背包的原始元数据。
• /havenbags help - 显示完整的命令列表（无视权限）。
• /havenbags convertdatabase <files/sqlite/mysql> - 无缝转换插件的数据存储方式。
• /havenbags reload - 重载所有配置文件。
• /havenbags reload force - 强制重载所有配置并重新从服务器加载所有背包数据（未保存的更改将丢失）。

仅限 OP/控制台命令：

• /havenbags customcontent edit/save/load - 编辑、保存或加载自定义 GUI 库存。
• /havenbags clearcontent <all/玩家/背包UUID> - 清除所有背包、指定玩家背包或特定背包的内容。

✨PlaceholderAPI 占位符

• %havenbags_bags_current% - 玩家拥有的背包数量。
• %havenbags_bags_max% - 玩家可拥有的最大背包数量。
• %havenbags_bags_items_MATERIAL% - 玩家所有背包中特定材料的物品数量（不计无主背包）。
• %havenbags_bags_inv_items_MATERIAL% - 玩家物品栏中所有背包内特定材料的物品数量（计入所有背包）。
• %havenbags_player_has_bag% - 玩家是否拥有背包（返回 true/false）。
• %havenbags_carry% - 玩家当前携带的背包数量。
• %havenbags_carry_max% - 玩家可携带的最大背包数量。
• %havenbags_bags_slots_total% - 玩家物品栏中所有背包的总格子数。
• %havenbags_bags_slots_used% - 玩家物品栏中所有背包已使用的格子数。
• %havenbags_bags_slots_free% - 玩家物品栏中所有背包空闲的格子数。
• %havenbags_bags_others% - 玩家是否有无法使用的背包（返回 true/false）。

❓常见问题

语言与翻译

• 插件内置语言文件 (lang.yml) 可手动翻译，目前支持英语和西班牙语。
• 如需添加新语言，请联系作者并提供语言名称（需在 Minecraft 支持的语言列表中）。

更新与维护

• 作者会定期发布大型更新，并在收到错误报告后尽快修复。
• 更新前请查看更新日志，以决定是否适合当前服务器。

数据与兼容性

• 服务器重启/重载时：插件会记录已打开的背包，并在关闭前强制关闭它们，将背包归还给玩家。
• 物品栏已满时关闭背包：背包会掉落在玩家脚下。
• 服务器文件被删除：游戏内的背包会暂时存在，但玩家尝试打开时会被移除。
• 服务器版本升级/降级：支持在兼容版本范围内升级（新版兼容旧数据）。不支持降级，因为新数据结构与旧版功能不兼容。
• 数据编辑：

- **SQLite**：使用 “DB Browser (SQLite)” 编辑 `.db` 文件。编辑前请关闭插件或服务器。

- **MySQL**：可使用 “MySQL Workbench” 等工具进行编辑。

从其他插件迁移

• Minepacks：自 1.26.0 版本起支持转换。具体方法请查看更新日志。
• EpicBackpacks：自 1.27.0 版本起支持转换。具体方法请查看更新日志。

⭐支持与反馈

如果遇到任何问题或有功能建议

• 提交问题：请访问 GitHub Issues 页面：https://github.com/Valorless/HavenBags/issues
• 加入 Discord：https://discord.gg/yyEPqSeXF9
• 重要：如果您发现任何漏洞或对插件不满意，请不要直接留下差评。请先联系作者，我会尽力修复问题。

💡默认配置文件

本页面列出了由本插件自动生成的默认配置文件。这些文件是插件正常运行所必需的，通常会在插件首次加载时自动创建。

核心配置文件

• config.yml - 主配置文件，包含插件的主要设置和选项。
• messages.yml - 语言文件，存储所有插件发送给玩家的聊天消息，便于自定义和本地化。
• data.yml - 数据存储文件，用于保存插件的运行时数据（如玩家数据、状态等）。

使用说明

首次安装并启动插件后，请检查服务器插件目录下的对应文件夹，上述文件应已自动生成。你可以根据需求编辑这些文件来自定义插件行为。

• 修改配置文件后，通常需要在游戏内使用重载命令（如 /pluginname reload）或在控制台重启服务器以使更改生效。
• 建议在修改前备份原始文件。
• 配置文件采用 YAML 格式，编辑时请注意保持正确的缩进和语法，避免使用 Tab 键，应使用空格。

获取资源

你可以在 GitHub 上找到本插件的完整资源，包括源代码、最新版本和更多文档：

GitHub Resources