InvUnload - 智能物品整理

InvUnload 是一款智能整理插件，它能自动将你背包中的物品放入附近对应的箱子中，帮你告别杂乱无章的储物室和背包。

💡核心功能

• 智能整理：使用 /unload 命令，插件会自动搜索附近箱子，并将你背包中与箱内已有的同类物品存入。
• 快速倾倒：使用 /dump 命令，可将背包内物品（默认排除快捷栏）全部倾倒到附近的任意箱子中。
• 物品搜索：使用 /searchitem 命令，可以快速在附近的箱子中查找指定物品。
• 个人黑名单：通过 /blacklist 命令管理个人黑名单，防止特定物品被自动整理或倾倒。
• 多语言支持：内置中文（简/繁）、英语、德语、法语、日语、俄语、西班牙语、土耳其语、荷兰语。所有消息均可自定义。
• 灵活配置：可自定义默认及最大搜索半径，并支持通过权限组进行更精细的控制。

🎮命令与权限

主要命令

• /unload [半径]

将背包物品（默认排除快捷栏）存入附近匹配的箱子。未指定半径时使用默认值（10格）。最大半径可在配置文件中定义。

• /unload hotbar

切换当前玩家是否在整理时也处理快捷栏物品。

• /dump [半径]

将背包物品（默认排除快捷栏）全部存入附近的任何箱子。半径规则同上。

• /dump hotbar

切换当前玩家是否在倾倒时也处理快捷栏物品。

• /unloadinfo 或 /dumpinfo

显示本次操作摘要，列出哪些物品被存入了哪个箱子。

• /searchitem [物品] 或 /search [物品]

在附近的箱子中搜索指定物品。

• /blacklist [add|remove] [物品]

向你的个人黑名单添加或移除物品。黑名单中的物品不会被整理或倾倒。

• /unload reload

重新加载配置文件。

权限节点

• invunload.use

允许使用 /unload, /dump, /unloadinfo, /dumpinfo 命令。

• invunload.search

允许使用 /searchitem 命令。

• invunload.reload

允许使用 /unload reload 命令重载配置。

🔧使用示例

示例一：智能匹配

• 箱子内容：沙子
• 背包内容：沙子、沙砾
• 执行 /unload 后：沙子存入箱子，沙砾仍留在背包。

示例二：多箱子匹配

• 箱子A内容：沙子、沙砾
• 箱子B内容：金块
• 背包内容：沙子、沙砾、金块、草方块
• 执行 /unload 后：沙子和沙砾存入箱子A，金块存入箱子B，草方块留在背包。

示例三：快速倾倒

• 箱子A内容：半箱泥土
• 箱子B内容：空
• 背包内容：石头、泥土
• 执行 /dump 后：泥土存入箱子A，所有石头存入箱子B。

✨高级功能与集成

自定义分组

你可以在 groups.yml 文件中定义自定义组，为不同玩家设置不同的默认箱子半径和最大半径。玩家需要拥有 invunload.group.<组名> 权限才能生效。

第三方插件兼容

• 插件会尊重领地保护。如果玩家因 WorldGuard、GriefPrevention 等插件而无法访问某个箱子，则不会向该箱子存放物品。
• 插件通过调用 PlayerInteractEvent 和特定 API（如 Spartan Anti-Cheat, PlotSquared）来确保兼容性。

❓注意事项与配置

• 版本要求：此版本仅适用于 Minecraft 1.12.2 及以上版本。
• 开源代码：https://github.com/JEFF-Media-GbR/Spigot-InvUnload
• 统计信息：InvUnload 使用 bStats 收集匿名统计信息。你可以在 plugins/bstats/config.yml 中禁用，或在此查看：https://bstats.org/plugin/bukkit/InvUnload
• 贡献翻译：如果你的语言尚未支持，可以直接在配置文件中修改消息。如果你将翻译发送给我们，我们很乐意在下次更新中纳入。
• 配置文件：配置文件在不存在时会自动生成。每次新版本发布时，配置文件会自动更新以包含新选项，同时保留你的更改。
• 你可以在此查看默认配置文件：https://github.com/JEFF-Media-GbR/Spigot-InvUnload/blob/master/src/main/resources/config.yml

⭐反馈与支持

请将功能请求和错误报告发布在插件讨论区或 GitHub 仓库中。