精灵仓库

一、精灵管理

使用 /cpp open 打开仓库，点击某个精灵进入管理界面，可选用、升级、改名、显示/隐藏名称、更换装备、洗炼品质或放生。

3.0.0 支持持有多个同种精灵，每个实例的等级、品质、随机属性、名称与装备独立保存；同一时间只能选用一个精灵。管理操作只作用于点击的实例。

• 仓库界面：gui/open.yml。
• 精灵管理界面：gui/upgrade.yml，各按钮可通过 enable 开关。
• 品质洗炼：会重新抽取品质及随机属性，详见精灵属性。
• 更换装备：先由管理员发放装备，详见精灵装备。

二、仓库容量

主配置 config.yml 默认不限制数量，需要时开启：

companionLimitEnable: true
companionLimit:
  default: 10
  vip: 20

default 为默认容量。给玩家 CompanionsPlus.companionLimit.vip 权限后，使用对应的 vip 容量；可按此方式增加其他权限等级，0 表示不限制。

容量按精灵实例计数，同种精灵分别占用空间。已达到上限时，需放生精灵或提高容量后才能继续获取。当前版本针对在线玩家检查容量，给离线玩家发放精灵时不检查其权限容量。

启用限制且玩家有效上限大于 0 时，仓库标题可追加数量信息，在 gui/open.yml 配置：

titleLimit: " &7(&a${count}&7/&a${limit}&7)"

${count} 为当前实例数量，${limit} 为当前上限。

三、精灵放生

gui/upgrade.yml 中的 release.enable 控制放生按钮，默认开启。点击后进入 gui/confirm.yml 的二次确认界面。

确认放生会永久删除选中的精灵实例；如果它正在使用，会一并收回。其绑定装备会解除绑定并保留在玩家的精灵装备仓库中。

四、名称与召唤指令

主配置 config.yml 可统一设置已拥有精灵的名称格式：

companionNameFormat: "${quality} ${name} &fLv.${level}"
settings:
  maxNameLength: 10
  blacklistedNames:
    - "禁用名称"
  show:
    perms: companionsPlus.show
    commands: /s
  vanish:
    perms: companionsPlus.vanish
    commands: /v

${name} 为精灵名称，${quality} 为品质文案，${level} 为实例等级。改名在支持的高版本使用 Dialog 输入，其他情况使用聊天输入；输入 T 或 cancel 取消，companions.admin.blacklist 可绕过命名黑名单。

commands 支持英文逗号分隔多个指令，修改配置后重载生效。/s 重新显示已选用的精灵；/v 收回精灵并取消选用，之后需在仓库重新选用才能再次召唤。权限节点由对应的 perms 配置决定。