Inventory Weight - 背包重量 [Inventory Weight]

💡简介

本插件用于追踪玩家背包中的物品数量，并允许你根据材料、物品名称或物品描述（Lore）来配置物品的重量。你的背包越重，移动速度就越慢。插件提供了丰富的配置选项，确保它能完美适配你的服务器需求。这是一个非常适合硬核服务器或为角色扮演服务器增添真实感的绝佳机制。

• Discord 服务器：获取社区支持
• 配置示例：查看预设配置
• 消息配置：自定义插件提示
• 文档：详细使用说明

✨功能特性

• 玩家移动速度随背包总重量增加而降低。
• 可自定义移动速度的变化范围。
• 设置开始降低速度的重量百分比阈值。
• 可通过材料、物品显示名称或特定的 Lore 标签来配置每个物品的重量。
• 完全自定义插件消息，支持多语言。
• 达到最大重量时可完全冻结玩家移动。
• 通过权限为不同玩家设置不同的重量上限（参见权限节点 inventoryweight.maxweight）。
• 支持 PlaceholderAPI，可在其他插件中显示重量信息。
• 可配置插件在哪些世界生效。
• 支持自定义模型数据（Custom Model ID），兼容其他自定义物品插件。

🎮命令

• /iw help - 显示帮助信息，内容可在 messages.yml 文件中配置。
• /iw weight - 显示你当前的重量和速度。注意：如果玩家拥有 inventoryweight.off 权限、处于创造模式或在已禁用此插件的世界中，此命令将不会生效。
• /iw get - 返回你主手上物品的重量。
• /iw get [材料名称] - 返回指定材料的默认重量。
• /iw reload - 重载 config.yml 配置文件，允许你在服务器运行时应用配置更改。

🔧权限

• inventoryweight.reload - 允许玩家重载插件配置。
• inventoryweight.off - 拥有此权限的玩家将完全不受插件重量系统影响。
• inventoryweight.maxweight.[数值] - 设置玩家的最大重量上限。例如，若玩家拥有 inventoryweight.maxweight.100 权限，则其最大重量为 100，此设置会覆盖配置文件中的默认值。

⭐占位符

支持 PlaceholderAPI，可用占位符如下：

• %inventoryweight_weight% - 当前重量
• %inventoryweight_maxweight% - 最大重量上限
• %inventoryweight_speed% - 当前速度
• %inventoryweight_inventorybar% - 背包重量进度条
• %inventoryweight_weightPercentage% - 当前重量百分比

❓配置说明

config.yml 文件用于调整插件的工作方式。

核心设置

• 使用 min walk speed 和 max walk speed 控制玩家在最大重量和零重量时的移动速度。
• max weight limit 为所有玩家设置默认重量上限（可通过权限节点为不同玩家设置多个上限）。
• 达到重量上限时，玩家将降至最低速度或完全无法移动（可在配置文件中切换此行为）。
• 将 disable movement 标志设为 true，玩家在达到最大容量时将无法移动。

物品重量设置

物品重量可在配置中通过以下方式设置，优先级从高到低：

• Lore 标签：最高优先级。
• 物品显示名称。
• 材料类型。

如果物品未设置特定重量，则将采用 default weight（默认重量）。

速度变化起点

beginSlowdown 值允许你设置一个重量上限的百分比，当达到此百分比时，速度惩罚才开始生效。

Lore 标签详解

配置中的 loreTag 值是一个重要功能，它允许你通过物品 Lore 直接控制物品重量，非常适合用于自定义物品。

• 重量标签：例如，在配置中设置 loreTag 为 "Weight:"。若物品 Lore 中包含一行如 "Weight: 17.8"，则该物品重量即为 17.8。插件会在标签所在行寻找数字，且数字前必须有一个空格。
• 容量标签：配置中的 capacityTag 用法类似。此标签用于增加持有该物品玩家的最大重量上限。

配置文件示例

• 默认 config.yml：https://pastebin.com/u1Hp29GF
• 无速度变化的 config.yml：https://pastebin.com/FwjPhyfb
• 默认 messages.yml：https://pastebin.com/D6uBcK8F

🔧支持与反馈

如果你喜欢使用这个插件，请留下评论，并告诉我你希望未来添加什么功能！

请将所有错误/问题报告至讨论帖，或通过站内私信、Discord (wonka19) 直接联系我。我很乐意制作免费插件，如果你愿意支持并激励我继续开发，欢迎使用我的捐赠链接。

计划中的功能

• 为特定用例提供预设的 config.yml 文件（例如：仅计算盔甲和武器）。
• 更多自定义选项。
• 在达到一定重量后，禁止玩家拾取更多物品的功能。

非常感谢至今收到的所有反馈。在努力提升插件质量的过程中，我期待收到更多关于新功能的创意。