Companions - 自定义伙伴插件

Companions 是一款允许你为玩家创建自定义伙伴的插件。激活后，伙伴会跟随在玩家身边，并提供各种特殊能力。本插件高度可配置，支持自定义外观、能力、物品等，并包含商店、交易、升级等丰富系统。

💡版本与支持

本插件提供免费版与高级版。

• 免费版：版本更新通常会滞后于稳定版。
• 高级版：获得最新的稳定版本以及开发者支持。

**当前版本支持**

• Companions V1.9.1 - 支持 < 1.17.1
• Companions V1.9.2 (当前免费版) - 支持 < 1.18.1
• Companions V1.9.3 (当前高级版) - 支持 < 1.18.2
• Companions V1.9.5 - 支持 < 1.19.2

开源地址：https://github.com/Aster0/Companions-Open-Sourced

> 请注意：请勿在评论区域报告漏洞。若发现漏洞，请先检查高级版是否已修复。开发者始终提供支持，大量一星评价会令人沮丧。

🎮核心特性

Companions 插件功能强大，以下是一些主要特性：

自定义与创造

• 完全可配置：可自定义伙伴的外观、倾斜角度、手持物品、名称、GUI 和能力。
• 调整身体部件：通过调整身体部件，打造服务器独有的伙伴外观。
• 自定义模型：支持导入自定义模型（如 3D 末影龙），创造无限可能。
• 混合动画：可为单个伙伴组合多种动画，创造独特的自定义动画。
• 玩家自定义：玩家可更改伙伴的武器、名称，并升级能力等级。

系统与功能

• 内置货币系统：可选择不使用经济插件，而使用内置的 Companion Coins 或完全免费。
• MySQL 数据库支持：跨多服务器同步玩家的伙伴数据。
• 神秘盒子系统：玩家可通过“神秘盒子”获得随机伙伴。
• 交易系统：允许玩家之间相互交易伙伴。
• 能力系统：提供多达 50 种能力可供选择，包括 PVP 效果、药水效果、飞行、火球等。命令能力允许每隔 X 分钟以一定概率执行命令，实现高度自定义。
• 预置伙伴：提供多达 15 个预加载的伙伴，供修改、复制或获取灵感。
• 易于配置：即使配置了错误的声音或材料名称，插件也不会崩溃，仅在控制台给出友好提示。支持低至 Spigot 1.8。

扩展与社区

• Companions API：允许开发者添加新功能，如新能力。
• 社区市场：设有社区市场，供用户买卖自定义创建的伙伴。

🔧可选依赖

以下插件非必需，但为了最佳体验，建议安装：

• Vault 及一款经济插件（用于商店交易）
• PlaceholderAPI（用于支持占位符）

❓玩家命令与权限

所有玩家命令均以 /companions 或别名 /c 开头。<> 内为必填参数，() 内为可选参数。

主要命令

• /companions
• 打开主菜单 GUI。
• 权限节点：companions.player.menu
• /companions shop
• 打开伙伴商店 GUI。
• 权限节点：companions.player.shop
• /companions upgrade
• 打开伙伴升级 GUI。
• 权限节点：companions.player.upgrade
• /companions owned
• 查看已拥有的伙伴 GUI。
• 权限节点：companions.player.owned
• /companions toggle
• 切换当前激活伙伴的显示/隐藏。
• 权限节点：companions.player.toggle
• /companions details <player>
• 查看指定在线玩家的伙伴详情。
• 权限节点：companions.player.details

升级命令（快捷方式）

• /companions upgrade ability (true/false)
• 购买（true）/降级（false）能力等级。未指定布尔值时默认为升级。
• 权限节点：companions.upgrade.ability
• /companions upgrade rename
• 购买重命名升级。
• 权限节点：companions.upgrade.rename
• /companions upgrade hidename
• 购买隐藏名称升级。
• 权限节点：companions.upgrade.hidename
• /companions upgrade changeweapon
• 购买更换武器升级。
• 权限节点：companions.upgrade.changeweapon

其他玩家命令

• /tradecompanion <player> <companion> 或 /tradec
• 将指定伙伴交易给指定玩家。
• 权限节点：companions.player.trade
• /companioncoin 或 /ccoin 或 /cc
• 显示你拥有的 Companion Coins 总数。
• 权限节点：companions.player.coin
• /companions particle
• Patreon 用户专用：切换粒子效果开关。

⭐管理员命令与权限

管理员命令拥有独立权限节点：companions.admin.<command>。

管理命令

• /givecompanion <player> <companion> (true) 或 /givec
• 给予指定玩家指定伙伴。设为 true 则直接激活。
• 权限：companions.admin.give
• /removecompanion <player> <companion> 或 /removec
• 从指定玩家处移除指定伙伴。
• 权限：companions.admin.remove
• /forceactive <player> <companion>
• 强制为指定玩家激活一个已拥有的伙伴。
• 权限：companions.admin.forceactive
• /forcedeactive <player>
• 强制移除指定玩家的激活伙伴。
• 权限：companions.admin.forcedeactive
• /forceupgrade <player> <upgrade> (true/false)
• 强制为指定玩家进行升级（无需支付费用）。对于能力升级，未指定布尔值时默认为升级。
• 权限：companions.admin.forceupgrade
• /givecompanionitem <player> <item> <amount> 或 /givecitem
• 给予玩家指定的插件物品。有效物品：companiontoken。
• 权限：companions.admin.item
• /clearcompanionsdata <player/all> 或 /ccdata
• 清除数据。指定玩家则清除该玩家数据，输入 all 则清除所有人的数据（谨慎使用，不可恢复）。
• 权限：companions.admin.cleardata
• /companioncoin <give/remove> <player> <amount> 或 /coin 或 /cc
• 给予或移除指定玩家的 Companion Coins。
• 权限：companions.admin.coin
• /companions reload
• 重载插件配置。
• 权限：companions.admin.reload

其他权限节点

• companions.buy.companionname
• 允许玩家购买指定名称的伙伴。
• companions.bypass.cooldown
• 允许玩家绕过能力冷却时间。
• companions.admin.blacklist
• 允许绕过名称黑名单系统。

✨PlaceholderAPI 占位符

安装 PlaceholderAPI 后，可使用以下占位符：

• %companions_activecompanion% - 显示玩家当前激活的伙伴。
• %companions_companionname% - 显示玩家激活伙伴的名称。
• %companions_companionlevel% - 显示玩家激活伙伴的等级。
• %companions_companioncoin% - 显示玩家的 Companion Coins 总数。

🔧附加信息

Patreon 支持者福利

• 在插件版本 1.6.1 之后，支持者列表每 24 小时更新一次。
• 前五名 Patreon 支持者可获得特殊的伙伴粒子轨迹，该效果在所有安装了 Companions 的服务器上生效。
• 更多支持等级信息请访问：https://www.patreon.com/astero

学习与支持

• 创建自定义伙伴：请查阅官方 Wiki 获取全面指南。
• API 与集成：插件提供 API，方便其他插件集成。文档请参考 Wiki。
• 支持与社区：如需帮助，请加入 Discord 支持频道：https://discord.gg/E3YXn4x

条款与条件

下载即表示您同意以下条款

• 不得分发插件代码。
• 不得修改插件代码后重新发布并声称是自己的作品。
• 由于购买的是数字副本，概不退款。
• 开发者保留在发现泄露插件行为时撤销使用权的权利。
• 插件价格可能随时变更。