Quality Armory - 优质枪械插件

简介

QualityArmory 为 Minecraft 添加了枪支系统，且不影响原版游戏体验。本插件新增了超过 100 种物品，并内置了资源包分发功能，玩家无需手动更改服务器资源包即可正常显示所有枪械模型。

请注意，开发者不会在评论区处理任何漏洞修复请求。如果您在使用中遇到问题，请在 Discussions 板块或 GitHub 页面提交报告，并注明是否在纯净服务器（未安装其他插件）上测试过。

💡核心特性

• 新增超过 80 种武器 和 7 种以上弹药类型。
• 不会替换游戏内的任何现有物品。
• 内置资源包分发器，玩家加入服务器或使用特定命令时会自动获取。
• 提供 API，允许其他插件基于此添加自定义枪械。
• 支持 1.8 版本（部分支持）：由于该版本纹理处理方式的限制，目前仅支持 15 种枪械。
• 若安装 LightAPI，枪支将拥有开火时的枪口闪光效果。
• 可选功能：可在配置文件中启用武器耐久度系统 (EnableWeaponDurability)。
• 内置商店和合成台系统。
• 所有内容均可通过配置文件自定义，点击此处查看详细配置 Wiki。

资源包配置

资源包已集成在核心插件中，可通过配置文件调整

• 默认情况下，当玩家使用 /qa 命令或与自定义物品互动时，资源包会自动发送。
• 可禁用资源包 (useDefaultResourcepack)。
• 可设置为玩家加入时自动发送 (sendOnJoin)。
• 可覆盖为自定义资源包：将 DefaultResourcepackOverride 设为 true，并在 DefaultResourcepack 中填入资源包的 URL。

🎮兼容性与支持

CrackShot 转换支持

QualityArmory 现已支持转换 CrackShot 的武器配置。只需将 CrackShot 的武器配置文件放入 /newguns/ 目录并重载插件，QA 便会自动将其转换为对应的 YML 配置文件。

ViaVersion / 1.8 版本支持

由于 1.8 版本不支持单个物品的多种模型，每个枪械需要替换一个原版物品来显示。为此，当检测到服务器运行 1.8 版本或安装了 ViaVersion 时，QA 会启用一套特殊系统以兼容，但这会限制可用武器的数量。

默认情况下，1.9+ 的玩家可以看到所有枪械，而 1.8 玩家的可见枪械会受到限制。有时，1.8 玩家可能只看到一个通用模型，或者武器被转换为 1.8 版本可用的物品。

若希望所有版本玩家看到的 1.8 武器保持一致，请在配置中将 ManuallyOverrideTo_1_8_systems 设为 true，并删除 /newguns/、/armor/、/ammo/、/misc/ 和 /attachments/ 目录。

已知冲突

与 EssentialsX 存在已知冲突：其配置中有一项设置会使玩家传送后获得短暂无敌，但这也会导致玩家在被射击时免受伤害。

修复方法：在 EssentialsX 的配置文件中，将 teleport_vulnerability 的值从 4 改为 0。

🔧命令列表

• /qa give <枪械/弹药> - 给予玩家指定物品。需要权限 qualityarmory.give。
• /qa craft - 允许玩家打开枪械合成界面。需要权限 qualityarmory.craft。
• /qa shop - 允许玩家打开枪械商店。需要权限 qualityarmory.shop。
• /qa reload - 重载插件的所有配置与数据。

✨创建与编辑枪械

创建自定义枪械和 CrackShot 一样简单。要学习如何创建新枪械，请访问 Wiki 页面。

完整 Wiki 请访问：点击此处。

⭐支持的插件

QualityArmory 与以下插件兼容良好

• Battle Royale
• BattleGrounds
• Withered
• Robbery
• ChestShop
• QuickShop
• WorldGuard
• CoreProtect
• 几乎所有的反作弊插件

如需支持其他插件，可向开发者提出请求。

软依赖插件（非必需）

• LightAPI：用于实现枪口闪光效果。
• Parties：用于禁用友军伤害。
• ProtocolLib：用于在开枪时平滑改变玩家视角（后坐力模拟）。
• Vault：用于武器商店的经济系统。
• ViaVersion：用于支持不同版本客户端显示相同模型。
• ItemBridge：允许其他插件通过此插件访问 QualityArmory 的物品。

❓权限节点

• qualityarmory.*

-   继承 `qualityarmory.admin` 的所有权限。

• qualityarmory.admin

-   `qualityarmory.give`

-   `qualityarmory.create`

-   `qualityarmory.reload`

-   `qualityarmory.createnewitem`

-   `qualityarmory.getmaterialused`

-   `qualityarmory.debugmessages`

-   `qualityarmory.getopengunslot`

• qualityarmory.default

-   `qualityarmory.craft`

-   `qualityarmory.shop`

-   `qualityarmory.usegun`

🔧API 与安装

API：您可以在此处查看 API 文档及使用方式：API 文档链接。

**安装步骤**

• 将插件文件放入服务器的 plugins 文件夹。
• 确保有一个插件可以让你进入游戏世界（如 Multiverse-Core）。
• 重启服务器。

🔧支持与捐赠

如果您想支持开发者维护此插件，可以通过 Ko-fi 进行捐赠。

加入 Discord 社区以获取帮助和交流

https://discord.gg/HT47UQXBqG