跳到主要内容

快速上手

装好插件、填好授权码并重启后（见 安装与授权），跟着下面做一遍。

1. 看看示例宠物​

首次启动会在 plugins/CloudPet/pets/示例/ 放七只示例宠物，全部是原版生物，不需要其他插件：

文件宠物特点
小狐狸.yml小狐狸写了全部选项的范例：等级名称、升级奖励、进化、皮肤
小狼.yml小狼会帮你打架，背包随等级变大
鹦鹉.yml鹦鹉在肩膀旁边飞，两个皮肤（权限 / 金币）
小蜜蜂.yml小蜜蜂飞行宠物，也可以骑着飞
战马.yml战马地面坐骑，有一列背包
雪狐.yml雪狐小狐狸进化后的样子（隐藏，靠进化或管理员给予）
模型宠物示例.yml模型宠物示例模型与 MythicMobs 的写法说明（隐藏）

2. 让玩家拥有宠物​

示例宠物默认要有权限 cloudpet.pet.<宠物编号> 才会拥有（config.yml 的 pets.permission-unlock: true，玩家第一次打开菜单时自动建立）。例如用 LuckPerms：

/lp user Steve permission set cloudpet.pet.小狐狸 true

也可以直接给（玩家不在线也可以）：

/cp admin give Steve 小狐狸
用权限得到的宠物

靠权限得到的宠物是「权限宠物」：权限被拿掉后不能召唤，也不能打包成宠物蛋或放生。用 /cp admin give、购买、宠物蛋、解锁道具、驯服得到的宠物没有这个限制。

3. 召唤​

玩家输入 /cp 打开宠物菜单，左键点宠物召唤（或输入 /cp summon 小狐狸）。宠物会跟着你跑，走远了会传送过来，卡住 3 秒也会自己传送。

  • 右键宠物：打开这只宠物的菜单（召唤 / 收回、骑乘、跟随 / 待命、战斗方式、改名、背包、皮肤、喂食、进化）。
  • 蹲下 + 右键：骑上去（宠物要能骑）。
  • /cp stay 让它在原地待命，/cp follow 再跟上。

4. 喂食与战斗​

手拿骨头右键自己的宠物：回 6 点血、加 10 经验（foods.yml 的「骨头」）。等级到了会显示升级消息，数值跟着变强。

宠物默认是「防卫」：会打你正在打的目标，也会打攻击你的生物。切换战斗方式：

/cp mode aggressive

assist 协助、defend 防卫、aggressive 主动（攻击附近的怪物）、passive 被动。见 战斗与技能。

5. 骑上战马​

/cp admin give Steve 战马

召唤战马后蹲下 + 右键骑上去，蹲下就下来。1.21.3 以后的服务端用 WASD 移动、空格跳、疾跑加速；更早的版本朝你看的方向前进。见 骑乘。

6. 写一只自己的宠物​

在 pets/ 里新建 小猫.yml（文件名就是宠物编号）：

plugins/CloudPet/pets/小猫.yml
name: '&e小猫'
description:
  - '&7爱睡觉的小猫'
category: 陆地
icon: COD
entity:
  type: CAT
  baby: true
  looks:
    cat-type: BLACK       # 黑猫（对应 setCatType）
stats:
  health: '12 + level * 2'
  damage: '1 + level * 0.2'
levels:
  max: 20
backpack: 1

执行 /cp admin reload，然后 /cp admin give Steve 小猫。全部写法见 宠物文件。

7. 下一步​

最后于 更新