BackInPack - 便携背包

BackInPack 是一款能为玩家提供额外存储空间与更多可能性的插件。它支持高度自定义配置，并提供了多种实用选项，让服务器管理更加灵活。

💡主要功能

• 额外存储空间：为玩家提供一个完整的双层箱子空间。管理员可以自由设定玩家可用的背包大小。
• 权限控制：可通过权限系统为特定玩家或玩家组分配不同大小的背包空间。
• 死亡物品处理：管理员可配置玩家死亡后背包内物品的处理方式：
• save - 物品保留在背包中
• delete - 物品从背包中删除
• drop - 物品从玩家身上掉落
• 音效与视觉效果：插件包含开启背包时的音效和视觉反馈。
• 便携背包物品：背包可设置为实物道具，玩家无需输入指令，手持物品即可直接打开。
• 合成与多背包：玩家可通过合成获得背包，并可同时拥有多个不同装备的背包。

✨扩展插件（可选但推荐）

• PlaceholderAPI
• 启用后可使用丰富的占位符。
• 为 /backpack-userinfo 等指令和消息系统提供支持。
• 可获取玩家及其背包的相关信息。

• Vault
• 提供经济系统支持。
• 安装后，玩家可通过购买获得背包，拓展了插件的玩法。

🎮指令列表

基础指令

• /backinpack [help/commands/permissions/placeholders/reload/sync]
• 显示插件帮助信息。

• /backpack [backpack] | /backpack <player> [backpack]
• 打开背包菜单。管理员可通过指定玩家参数打开他人的背包。
• 别名：b, bck, bip, backpacks

管理指令

• /backpack-name-edit <旧背包名> <新背包名>
• 修改背包名称。

• /backpack-set-size <player/all> <backpack/all> <size>
• 为指定玩家或所有玩家设置背包大小。

• /backpack-give <player> <backpack> [true/false - 是否以物品形式给予]
• 创建背包并/或将其作为物品给予玩家。

• /backpack-userinfo <player>
• 查看玩家的背包信息。

🔧权限节点

主要权限

• backinpack.* - 拥有所有插件权限。
• backinpack.admin - 访问管理员帮助。
• backinpack.userinfo - 允许查看其他玩家的背包最大容量。
• backinpack.setsize - 允许更改指定玩家的背包大小。
• backinpack.reload - 允许重载插件配置。
• backinpack.give - 允许向玩家添加背包。
• backinpack.open - 允许打开其他玩家的背包。
• backinpack.backpack-save - 允许玩家死亡后保留背包物品。
• backinpack.sync - 允许使用同步数据库数据的指令。
• backinpack.backpack-access - 当配置要求时，打开背包需要此权限。

额外权限

• backpack.size.<size> - 为指定玩家或组设置所有背包的大小。
• 推荐权限管理插件：LuckPerms

❓兼容性与语言

版本支持

• 插件基于 Minecraft 1.20 版本开发，但也兼容更早的版本。
• 仅在最新版 Spigot 服务器上进行测试，旧版本上的正常运行无法完全保证。

多语言支持

• 插件内置多种语言版本，默认语言为英语。
• 可在配置文件 (config.yml) 中修改语言设置：

  language: en

• 目前支持的语言包括：德语 (de)、英语 (en)、西班牙语 (es)、法语 (fr)、波兰语 (pl)、土耳其语 (tr)、越南语 (vi)、简体中文 (zh_si)、繁体中文 (zh_tr)。
• 您可以编辑现有语言文件或基于 en.yml 创建新的语言文件。

⭐文件结构与支持

主要文件目录

backpacks/        # 背包类型配置文件
backup/           # 备份存档
data/             # 数据文件 (如 inventories.yml)
GUI/              # 图形界面配置文件
languages/        # 语言文件
config.yml        # 主配置文件
database.yml      # 数据库配置文件

获取帮助与资源

• 如遇到问题、有建议或疑问，请访问作者 Discord 服务器获取支持。
• 如需干净的未修改文件，可从 GitHub 下载。
• 请注意：在因插件问题给予差评前，请先联系作者，您遇到的问题可能并非插件本身导致。

---

CC Creative Commons 2022-2023 Attribution-NoDerivatives 4.0 International Author olios

BackInPack 插件文档（版本 3.0-BETA），提供更广泛的配置信息与操作指南，以帮助优化插件的运行。

💡更新插件

在使用插件时，你可能会不时看到有关更新可用的信息。

版本标识符说明

更新时，请注意新旧版本的标识符含义

• MAIN - 插件的主版本号。当添加大量新功能，或引入显著改变插件运行方式和目的的功能时变更。
• FUNCTION - 功能更新版本号。代表添加了新功能/新礼包、修复了大量错误或其他可见的变更。
• CORRECTION / BUG FIX - 修正版本号。代表修复了次要错误，且未更改任何文件中的数据或选项。

更新步骤与注意事项

• 下载更新后的插件（.jar 文件）后，仅替换文件有时并不足够。
• 如果 MAIN 或 FUNCTION 位置的版本号发生了变更，则必须重新生成插件的配置文件。
• 重新生成文件的方法：删除现有的 config.yml、语言文件及其他配置文件，让插件在重启时重新创建。
• 重要提示：更新前务必阅读更新日志，其中会包含关于是否需要更新配置文件的关键信息。

🎮占位符

插件提供两种类型的占位符：PLAYER（玩家）和CONFIG（配置）。

类型区别

• 玩家占位符：关联特定玩家，仅能在特定情况下使用。
• 配置占位符：可在插件发送的所有消息中使用，也可在支持占位符的其他插件中使用。

格式

所有占位符均以 % 开始和结束，且第一个单词为 backinpack。

格式示例：%backinpack_placeholder%

部分占位符指向相同的值，但可能有不同的写法。

玩家占位符列表

• %backinpack_player_uuid%
• %backinpack_player_nickname%
• %backinpack_player_username%
• %backinpack_player_name%
• %backinpack_player_backpacks_count%
• %backinpack_player_backpacks_size%
• %backinpack_player_backpacks_list%

配置占位符列表

配置占位符的名称基于 config.yml 文件中的变量名生成。

• %backinpack_can_update%
• %backinpack_config_admin_open_player_backpack%
• %backinpack_config_backpack_access_gui%
• %backinpack_config_backpack_access_item%
• %backinpack_config_backpack_buy_backpack_size%
• %backinpack_config_backpack_buy_cost%
• %backinpack_config_backpack_buy_give_as_item%
• %backinpack_config_backpack_permission%
• %backinpack_config_backpack_texture%
• %backinpack_config_blacklist_items%
• %backinpack_config_check_updates%
• %backinpack_config_clearer_logs%
• %backinpack_config_close_sound%
• %backinpack_config_crafting_1%
• %backinpack_config_crafting_2%
• %backinpack_config_crafting_3%
• %backinpack_config_crafting_4%
• %backinpack_config_crafting_5%
• %backinpack_config_crafting_6%
• %backinpack_config_crafting_7%
• %backinpack_config_crafting_8%
• %backinpack_config_crafting_9%
• %backinpack_config_create_backpack_buy%
• %backinpack_config_create_backpack_crafting%
• %backinpack_config_database%
• %backinpack_config_default_backpack%
• %backinpack_config_disabled_commands%
• %backinpack_config_language%
• %backinpack_config_max_backpacks%
• %backinpack_config_open_sound%
• %backinpack_config_player_dead%
• %backinpack_config_removing-backpacks_enable%
• %backinpack_config_removing-backpacks_refund%
• %backinpack_config_standard_backpack_size%
• %backinpack_players%
• %backinpack_update-link%
• %backinpack_version%

✨添加自定义语言文件

你可以为插件添加包含自定义消息的语言文件。有两种方式：编辑现有文件或创建新文件。

方式一：创建新文件

• 复制一个现有文件（例如 en.yml）。
• 将文件名更改为你想要的名称（建议在此处添加语言代码）。

方式二：编辑现有文件

• 编辑文件内的消息内容。
• 保存更改。

启用自定义语言文件

• 打开 config.yml 文件。
• 将 language 选项的值更改为你的文件名（不要添加 .yml 扩展名）。

- 例如：`en.yml` 对应填写 `en`

• 保存 config.yml 文件。
• 重启服务器。

完成上述步骤后，你就能在插件消息中看到使用自定义文件的效果了。

🔧后续更新

文档的更多内容将随着插件更新或用户提出的议题而逐步添加。