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 与以下插件兼容良好
如需支持其他插件，可向开发者提出请求。
软依赖插件（非必需）
- 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
