Backpacks额外背包

功能

允许玩家拥有提供额外库存空间的背包。

• 每个玩家可定制的容量（使用权限）
• 死亡时选择丢弃或删除背包物品
• 在地图重置时清除背包内容的选项
• 可选物品限制
• 可选的图形用户界面按钮以访问背包
• 可选择自动将新获得的物品收集到背包中
• 可选择自动从你的背包中获取物品进行制作、建造等。

注意： 要将一个键绑定以打开背包，请使用：bind <key> backpack 在你的F1客户端控制台中。例如，bind b backpack.

快速开始

允许玩家打开背包

允许所有玩家使用背包，请运行以下命令。

o.grant group default backpacks.use

这将允许所有玩家通过/backpack聊天命令或backpack控制台命令打开他们的背包。默认情况下，所有背包的容量为6格（1行），但可以通过配置和分配权限进行更改。

允许玩家使用GUI按钮

允许所有玩家查看背包GUI按钮，请运行以下命令。

o.grant group default backpacks.gui

玩家可以点击该按钮（在他们的腰带旁边）来打开和关闭他们的背包。他们还可以运行/backpackgui聊天命令来隐藏或显示该按钮。如果你想默认禁用该按钮，使玩家必须明确启用，你可以在配置中这样做。

或者，如果您不希望启用此插件中的GUI按钮，请考虑使用Backpack Button插件以获得更高级的功能。

命令

• backpack / backpack.open — 打开你的背包。需要 backpacks.use 权限。如果背包已经打开，这将跳转到下一页，或者如果没有任何更多页面，则会关闭玩家的物品栏。
• backpack.fetch <item short name or id> <amount>— 从你的背包中获取一个物品。
• backpackgui— 切换你是否可以看到背包GUI按钮。
• backpack.setgathermode <All|Existing|Off> <optional page number> — 设置指定背包页面的拾取模式。如果未指定页面编号，则此命令适用于第一页。此命令可快速通过按键更改拾取模式，而无需打开背包。注意：如果您想通过聊天而不是通过控制台一致地接收此命令的反馈，您应该将其绑定为 bind <key> chat.say "/backpack.setgathermode All" 而不是 bind <key> backpack.setgathermode All。

管理员命令

• viewbackpack <name or steam id> — 打开另一个玩家的背包（需要 backpacks.admin 权限）
• backpack.addsize <name or steam id> <amount>— 尝试通过指定的数值更改指定玩家背包的大小，不会超出玩家尺寸配置的范围。可以通过提供负数来减少容量。需要在配置中启用实验性的动态大小功能。
• backpack.setsize <name or steam id> <amount>— 尝试将玩家的背包大小设置为指定的量，不会超出玩家的大小配置。需要在配置中启用实验性的动态大小功能。

服务器命令

• backpack.erase <steam id> — 强制擦除 所有 某个玩家背包的所有内容，即使他们有 backpack.keeponwipe.*通常会使其免受影响的权限。

权限

• backpacks.use— 需要打开自己的背包。
• backpacks.admin — 使用 viewbackpack、backpack.addsize 和 backpack.setsize 命令所需。
• backpacks.admin.protected — 保护你的背包不被其他管理员通过 viewbackpack 命令查看。
• backpacks.gui— 需要查看GUI按钮。
• backpacks.fetch — 使用该backpack.fetch命令所需。
• backpacks.keepondeath— 使你在死亡时不会掉落或失去背包。
• backpacks.gather— 允许您在每个背包页面启用拾取模式，系统会自动将新获得的物品转移到您的背包中。
  • 注意：当您断开与服务器的连接并在稍后重新连接时，直到您至少打开一次背包，聚模式才会被激活。
• backpacks.retrieve — 允许您为每个背包页面启用检索模式。当检索模式启用时，您可以使用指定的背包页面中的物品进行建造、制作等操作。需要 物品检索器 插件。
  • 注意：当您断开与服务器的连接并在稍后重新连接时，取模式不会在您至少打开一次背包之前激活。此外，在重新连接到服务器后，您需要至少访问一次那些特定页面，才能从弹药页、切换弹药、从售货机购买物品以及从NPC vendors购买车辆中提取物品。

大小权限

如果你想授予特定玩家或组比默认更多的背包容量 (Backpack size -> Default size)，那么你可以通过权限来实现。在Backpack size -> Permission sizes配置选项中出现的每个数字都会导致插件生成一个格式为backpacks.size.<number>的权限，该权限将相应的玩家或组分配相应的容量。例如，backpacks.size.18会分配18个槽位的容量（3行）。

以下权限随插件的默认配置一起提供。

• backpacks.size.6— 1 行
• backpacks.size.12— 2 行
• backpacks.size.18— 3 行
• backpacks.size.24— 4 行
• backpacks.size.30— 5 行
• backpacks.size.36— 6 行
• backpacks.size.42— 7 行
• backpacks.size.48— 8 行
• backpacks.size.96— 16 行 (2 页)
• backpacks.size.144— 24 行 (3 页)

可以通过简单地将它们添加到Backpack size -> Permission sizes配置选项并重新加载插件来定义额外的权限。

注意： 如果玩家被授予多个尺寸权限，将应用最高的权限。

动态大小（高级 / 实验性）

如果你想让玩家升级他们的背包大小，可以通过上面的backpacks.size.*权限来实现，只需授予更高的权限，当玩家进行购买或执行获得更大背包大小的操作时（你有责任使用其他插件在适当的时间授予和/或撤销权限）。然而，使用权限来决定背包大小并不适合所有类型的服务器，下面是一些示例问题。

• 如果你想在每次清理开始时重置背包大小，你需要另一个插件来在此时重置权限。
• 如果你想允许玩家通过多种方式增加背包大小，例如通过技能树、商店购买、在玩家之间发现和/或交易的消耗品，这种组合是不可行的，因为每个升级来源可能会覆盖其他来源，或者如果授予的权限对应于玩家当前拥有的较小尺寸，则没有效果。

动态背包大小试图解决这些问题。使用动态大小，你可以定义大小配置文件，这些配置文件声明一个初始大小和最大大小。你通过权限将大小配置文件分配给玩家。在每次清除的开始，每个玩家的背包大小可以选择性地重置为他们配置文件的初始大小。在一次清除期间，玩家可以从各种来源（即，其他插件）获得大小升级，直到他们配置文件中声明的最大大小。例如，如果一个玩家的大小配置文件声明的初始大小为6，最大大小为48，玩家可以逐步获得升级，直到达到大小48，此时，背包将无法再升级。

为了开始动态背包大小，请将Dynamic Size (EXPERIMENTAL) -> Enabled配置选项设置为true并重新加载插件。然后，授予以下权限之一（或您在配置中定义的新权限）

以下权限随插件的默认配置一起提供。可以在配置中定义额外的尺寸配置文件，这将生成额外的权限。

• backpacks.size.profile.6-48— 6到48个插槽
• backpacks.size.profile.6-96— 6到96个插槽
• backpacks.size.profile.6-144— 6到144个插槽

重要提示：

• 如果一个玩家被授予多个 backpacks.size.profile.* 权限，~~根据配置中的配置文件顺序，最后一个将生效。~~ 初始大小和最大大小将是他们可以访问的所有配置文件中的最高值（v3.14.0 版本更改）。
• 如果给玩家授予任何 backpacks.size.profile.* 权限，它将覆盖配置中的默认背包大小，以及玩家被授予的任何 backpacks.size.<number> 权限，因为 背包配置文件的优先级高于所有其他配置/权限。
• 插件会记录玩家收到的奖励大小，而不是确切的大小。这意味着，通常情况下，您可以将玩家从一个配置文件切换到另一个配置文件而不会失去已获得的容量。例如，如果玩家从6-48的配置文件开始，并将容量升级到24（6 18），然后获得升级到48-96的配置文件的权限，他们的容量将是66（48 18）。
• 此插件目前没有内置功能来升级背包容量，因此对于此类用例需要使用其他插件。插件开发者可以参考下面的API文档，了解如何查询和修改背包容量。下面列出了重要的API方法名称。
  • API_IsDynamicCapacityEnabled
  • API_GetBackpackCapacity
  • API_GetBackpackInitialCapacity
  • API_GetBackpackMaxCapacity
  • API_AddBackpackCapacity
  • API_SetBackpackCapacity
• 其他插件可以使用backpack.addsize和backpack.setsize命令，但具体设置不同，这可能会导致玩家在已达到最大容量的情况下，有效浪费资源购买升级。推荐使用API进行更精确的集成，因为其他插件可以查询Backpacks插件，以在向玩家收费之前确定是否可以进行升级。

项目限制权限

如果您希望允许特定玩家或组的背包接受默认情况下不同的物品（Item restrictions -> Default ruleset），则可以通过权限进行设置。 Item restrictions -> Rulesets by permission 配置选项中定义的每个规则集都会导致插件生成一个格式为 backpacks.restrictions.<name>. 授予该权限将为相应的玩家或组分配该规则集。

以下权限随插件的默认配置一起提供。可以在配置中定义额外的物品限制规则集，这将生成额外的权限。

• backpacks.restrictions.allowall— 允许玩家背包中的所有物品。只有在你定制了默认规则集以限制物品时才会有用。

注意： 如果一个玩家被授予多个 backpacks.restrictions.* 权限，根据配置中规则集的顺序，最后一个将生效。

继续清除权限

如果您希望允许特定玩家或组的背包在每次清空时保留不同的物品，而不是默认的 (Clear on wipe > Default ruleset)，那么您可以使用权限来实现。在 Clear on wipe > Rulesets by permission 配置选项中定义的每个规则集将导致插件生成一个格式为 backpacks.keeponwipe.<name>. 授予该权限将为相应的玩家或组分配该规则集。

以下权限随插件的默认配置一起提供。可以在配置中定义额外的保留规则集，这将生成额外的权限。

• backpacks.keeponwipe.all— 允许在重置时保留所有物品。

注意： 如果一个玩家被授予多个 backpacks.keeponwipe.* 权限，根据配置中规则集的顺序，最后一个将生效。

遗留权限

以下权限仍然由插件支持以保持向后兼容，但建议使用更新的权限。

• backpacks.use.1 - 8 — 像 backpacks.size.* 但分配指定的行数而不是插槽数。
  • 这些权限将在 "Backpack size" > "Enable legacy backpacks.use.1-8 row permissions": true 配置选项被设置时生成，如果在升级到插件的以前版本时您已设置 "Backpack Size (1-8 Rows)" 配置选项，这些权限将自动添加到您的配置中。
  • 推荐的替代方案：backpacks.size.6 通过 backpacks.size.48 （在默认配置中存在，但根据您如何修改配置，可能不存在）
• backpacks.noblacklist— 免除玩家的物品限制，允许将任何物品放入他们的背包。
  • 此权限在 "Item restrictions" > "Enable legacy noblacklist permission": true 配置选项设置时存在，当从插件的以前版本升级时，如果当时您已设置 "Use Whitelist (true/false)": true 或 "Use Blacklist (true/false)": true 配置选项，此配置选项将自动添加到您的配置中。
  • 推荐的替代方案：backpacks.restrictions.allowall（在默认配置中存在，但根据您如何修改配置，可能不存在）
• backpacks.keeponwipe— 免除玩家在地图重置时清空背包内容。
  • 此权限在 "Clear on wipe" > "Enable legacy keeponwipe permission": true 配置选项设置时存在，当从插件的以前版本升级时，如果那时您已设置 "Clear Backpacks on Map-Wipe (true/false)": true 配置选项，此配置选项将自动添加到您的配置中。
  • 推荐的替代方案：backpacks.keeponwipe.all（在默认配置中存在，但根据您如何修改配置，可能不存在）