宠物+

宠物+

召唤宠物并肩作战,获取经验值,解锁成长型增益——或仅保留其装饰功能。从怪物掉落物中寻找宠物蛋。通过简洁的用户界面全面配置,管理、重命名及交易宠物。

游戏玩法

Pets+

支持服务器 – https://discord.gg/DRxwt8Qg2W

一个为 Hytale 服务器或单人游戏设计的进阶宠物系统,包含经验、升级、战斗和可配置的特长。宠物会跟随主人,当主人攻击生物时它们会进行反击,并提供随等级成长的属性加成。玩家可以通过管理员指令或从生物掉落中获取宠物蛋来获得宠物。

您可以使用我们的 Pets+ 掉落 模组轻松编辑掉落物!


概述

Pets+ 让玩家获得可收集的宠物,它们会跟随你、与你并肩作战并提供被动加成。Hytale 中的任何实体都可以成为宠物,从狼、熊等标准动物到龙等大型或自定义实体,所有内容均可通过配置定义。当你攻击一个生物时,你的当前激活宠物会锁定并攻击它,获得经验并最终升级。每种宠物类型可以拥有一个或多个特长(生命、耐力、法力、防御、伤害、生命恢复、耐力恢复、法力恢复、暴击、生命偷取、火焰免疫、跌落免疫、幸运、挖掘速度、速度、拾取磁力),这些特长会随等级成长,所有内容均可在 config.json 中为每种宠物单独配置。

玩家可以通过两种方式获得宠物:管理员可以通过指令/界面直接给予,或者玩家可以在特定生物的掉落中找到宠物蛋(通过战利品表配置)。当玩家获得一个蛋后,只需手持并右键点击充能即可兑换宠物,将一个 1 级宠物添加到他们的收藏中。

管理员可以定义宠物类型(任何实体:狼、北极熊、龙等),分配特性和稀有度,控制特性成长,并配置哪些生物会掉落宠物蛋。玩家通过自定义界面管理宠物:召唤/收回、重命名、查看属性和特性,以及将宠物转移给其他玩家(转移时可选择减少等级)。


核心功能

宠物收藏与管理

  • 任何实体皆可为宠物 – 将任何实体添加为可配置的宠物类型(狼、熊、龙等)
  • 宠物蛋 – 为所有宠物类型自动生成的蛋物品,管理员可将其添加到生物战利品表中
  • 宠物兑换 – 玩家手持宠物蛋并右键点击充能来兑换宠物
  • 宠物收藏 – 玩家可以拥有多个相同或不同类型的宠物
  • 宠物命名 – 通过界面自定义宠物名称

战斗与行为

  • 跟随系统 – 宠物自动跟随其主人
  • 战斗系统 – 当主人攻击一个生物时,宠物会瞄准并攻击它
  • 攻击动画 – 每种宠物类型可配置的动画持续时间(默认:0.8 秒)
  • 伤害冷却 – 固定为 1.5 秒以保持战斗平衡
  • PVP 开关 – 每种宠物可配置是否攻击生物或仅为装饰
  • 大型宠物支持 – 可配置的跟随偏移量,防止大型宠物穿模到玩家身上

经验与升级系统

  • 获取经验 – 宠物通过对生物造成伤害来获得经验
  • 升级 – 宠物在获得足够经验后自动升级
  • 名牌显示 – 在宠物上方显示宠物名称和等级
  • 经验计算 – 可配置每次攻击获得经验或基于伤害获得经验
  • 经验黑名单 – 阻止宠物从特定实体类型获得经验(默认:Test_Dummy, Test_Dummy_Stationary)
  • 经验来源选项:
    • 每次攻击模式(默认):宠物每次击中生物时获得经验
    • 基于击杀模式:宠物仅在实体被击杀时获得经验(可通过 xpOnlyOnKill 配置)
  • 主人攻击经验模式:可选择当主人攻击生物时给予经验,而非宠物攻击时(通过 xpFromOwnerHit 配置)

特性系统

  • 16 种可用特性:生命、耐力、法力、防御、伤害、生命恢复、耐力恢复、法力恢复、暴击、生命偷取、火焰免疫、跌落免疫、幸运、挖掘速度、速度、拾取磁力
  • 每级成长 – Config.json 定义每个特性每级增加多少(例如,生命 +2/级,防御 +0.5%/级)
  • 多重特性 – 管理员可以为每种宠物类型分配一个或多个特性
  • 成长加成 – 特性随宠物等级成长,随着宠物升级提供更强的加成

稀有度与成长

  • 稀有度系统 – 普通、罕见、稀有、史诗、传说
  • 可配置最高等级 – 为不同稀有度设置不同最高等级(例如,普通:10,传说:50)
  • 基于等级的成长 – 宠物体型和伤害可随等级成长(每种宠物类型可配置)

宠物自定义

  • 体型配置:
    • 每种宠物类型的默认体型
    • 可选的每级体型(复选框)
    • 每级体型值(每级增加多少)
  • 伤害配置:
    • 每种宠物类型的基础伤害
    • 可选的每级伤害(复选框)
    • 每级伤害值(每级增加多少)
  • 跟随偏移量 – 可配置的偏移量,防止大型宠物穿模
  • 名牌选项 – 配置每种宠物类型是否在名牌中显示等级

死亡与冷却系统

  • 死亡冷却 – 每种宠物类型可配置的死亡后重新召唤冷却时间
  • 冷却显示 – 玩家尝试召唤宠物时会看到剩余冷却时间
  • 每种宠物类型的冷却 – 每种宠物类型可以有自己的死亡冷却持续时间

宠物转移系统

  • 转移宠物 – 玩家可以通过界面或 /pets transfer 指令将宠物转移给其他玩家
  • 等级降低 – 转移时可选的等级倍率(可配置,默认:1.0 = 无变化)
  • 转移开关 – 管理员可以全局启用/禁用宠物转移
  • 权限检查 – 转移尊重宠物类型权限

玩家功能

宠物管理界面

  • 宠物列表 – 查看所有拥有的宠物及其属性和信息
  • 召唤/收回 – 一键激活或停用宠物
  • 重命名宠物 – 自定义宠物名称
  • 查看属性 – 查看等级、经验、特性及其数值加成(例如,防御 (25%),生命恢复 (1.2/秒))
  • 宠物详情 – 显示所有宠物统计信息的详细面板
  • 转移界面 – 易于使用的转移系统,可输入玩家名称

宠物兑换

  • 蛋兑换 – 手持宠物蛋并右键点击充能和兑换
  • 自动添加 – 兑换的宠物以 1 级添加到收藏中

管理员功能

管理员界面

  • 管理员面板 – 通过 /pets admin 指令访问
  • 添加宠物 – 输入玩家名称,通过配置键选择宠物(例如,Bear_Polar1),一键添加宠物
  • 查看玩家宠物 – 使用 /pets view 以只读模式查看任何玩家的宠物
  • 宠物创建 – 完整的界面用于创建和编辑宠物类型

管理员指令

  • /pets add <pet_type> – 给玩家一个宠物(需要 pets.admin 权限)
  • /pets view – 查看任何玩家的宠物(需要 pets.admin 权限)
  • /pets admin – 打开宠物管理管理界面(需要 pets.admin 权限)
  • /pets create – 打开创建/编辑宠物类型界面(需要 pets.admin 权限)

宠物类型配置

  • 创建宠物类型 – 通过管理员界面或 config.json 定义新的宠物类型
  • 配置特性 – 为每种宠物类型分配一个或多个特性
  • 设置稀有度 – 分配稀有度等级(普通、罕见、稀有、史诗、传说)
  • 设置最高等级 – 配置每种宠物类型的最高等级
  • 配置体型 – 设置默认体型和可选的基于等级的成长
  • 配置伤害 – 设置基础伤害和可选的基于等级的伤害成长
  • 设置跟随偏移量 – 为大型宠物配置偏移量
  • PVP 开关 – 为每种宠物类型启用/禁用战斗
  • 名牌选项 – 配置名牌中的等级显示
  • 死亡冷却 – 设置宠物死亡后的冷却时间
  • 每次攻击经验 – 配置每次攻击的自定义经验值(可选)

战利品表集成

  • 宠物蛋掉落 – 将宠物蛋添加到任何生物的战利品表中
  • 自动生成蛋 – 为所有配置的宠物类型自动生成蛋
  • 掉率配置 – 通过战利品表权重控制掉率
  • Pets+ 掉落模组 – 使用我们的配套模组轻松配置掉落

监控与日志

  • Discord Webhook 集成 – 宠物操作(兑换、删除、转移)的实时通知
  • 颜色编码事件 – 绿色表示兑换,红色表示删除,橙色表示转移
  • 详细日志记录 – Webhook 消息包含玩家和宠物信息
  • 可配置 – 通过 discordWebhookUrl 和 showLogs 设置启用/禁用

高级配置

  • 经验黑名单 – 阻止从特定实体类型获得经验(实体名称数组)
  • 经验来源模式 – 选择宠物攻击经验或主人攻击经验(xpFromOwnerHit)
  • 经验奖励模式 – 选择每次攻击经验或基于击杀经验(xpOnlyOnKill)
  • 转移设置 – 配置等级倍率和启用/禁用转移
  • 特性成长 – 微调每个特性每级增长多少
  • 稀有度最高等级 – 为每个稀有度等级设置不同的最高等级

指令

指令 描述 权限
/pets 打开宠物管理界面
/pets add <pet_type> 给玩家一个宠物(配置键,例如 Bear_Polar1) pets.admin
/pets transfer 将您的其中一个宠物转移给另一个玩家 仅限主人
/pets view 查看任何玩家的宠物(只读) pets.admin
/pets admin 打开宠物管理管理界面 pets.admin
/pets create 打开创建/编辑宠物类型界面(仅管理员) pets.admin

将宠物蛋添加到生物掉落物

管理员可以通过编辑实体战利品表来配置生物掉落宠物蛋。

您可以使用我们的 Pets+ 掉落 模组轻松编辑掉落物!

手动配置

每种宠物类型会自动生成一个 ID 为 Egg_PetsPlus_<宠物类型> 的蛋物品。

步骤 1:找到实体的战利品表

  • 导航到您服务器的 assets 目录
  • Assets\Server\Drops\NPCs\ 中找到实体的战利品表文件

步骤 2:将蛋添加到战利品条目

示例:将狼蛋添加到狼生物掉落物中:

{
  "Container": {
    "Type": "Multiple",
    "Containers": [
      {
        "Type": "Choice",
        "Weight": 100,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Food_Wildmeat_Raw",
              "QuantityMin": 1,
              "QuantityMax": 1
            }
          }
        ]
      },
      {
        "Type": "Choice",
        "Weight": 50,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Egg_PetsPlus_Wolf",
              "QuantityMin": 1,
              "QuantityMax": 1
            }
          }
        ]
      }
    ]
  }
}

步骤 3:配置掉率

掉落几率计算方式为:(物品权重) / (所有物品总权重) × 100%

推荐权重:

  • 普通宠物:权重 10-20(10-20% 几率)
  • 罕见宠物:权重 5-10(5-10% 几率)
  • 稀有宠物:权重 1-5(1-5% 几率)
  • 极稀有宠物:权重 1(1% 几率或更低)

步骤 4:重启服务器

  • 战利品表更改需要重启服务器
  • 通过击杀生物并检查蛋掉落来测试

步骤 5:玩家兑换蛋

  • 玩家手持蛋
  • 右键长按以给蛋充能
  • 蛋被消耗,一个 1 级宠物被添加

可用蛋物品:

所有蛋物品都会根据您的 config.json 中的宠物类型自动生成:

  • 格式:Egg_PetsPlus_<宠物类型>
  • 示例:Egg_PetsPlus_WolfEgg_PetsPlus_Bear_PolarEgg_PetsPlus_Dragon
  • 位置:Server/Item/Items/Egg_PetsPlus_<宠物类型>.json

配置选项

全局设置

  • xpBlacklist:实体类型名称数组,宠物不能从这些实体获得经验(默认:["Test_Dummy", "Test_Dummy_Stationary"])
  • xpFromOwnerHit:布尔值 - 若为 true,宠物在主人攻击时获得经验;若为 false,宠物在自身攻击时获得经验(默认:false)
  • xpOnlyOnKill:布尔值 - 若为 true,仅在击杀时奖励经验;若为 false,每次攻击奖励经验(默认:false)
  • transferLevelMultiplier:双精度浮点数 - 转移时的等级倍率(默认:1.0)
  • enableTransfers:布尔值 - 启用/禁用宠物转移(默认:true)
  • discordWebhookUrl:字符串 - 用于日志记录的 Discord webhook URL(默认:"")
  • showLogs:布尔值 - 启用 Discord webhook 日志记录(默认:false)

每种宠物设置

  • entityType:实体类型名称(例如 "Wolf"、"Bear_Polar")
  • displayName:宠物的显示名称
  • rarity:稀有度等级(普通、罕见、稀有、史诗、传说)
  • maxLevel:该宠物类型的最高等级
  • perks:特性名称数组
  • defaultScale:默认体型(默认:1.0)
  • scalePerLevel:布尔值 - 体型随等级增加(默认:false)
  • scalePerLevelValue:每级体型增加量(默认:0.01)
  • damage:基础伤害(默认:10.0)
  • damagePerLevel:布尔值 - 伤害随等级增加(默认:false)
  • damagePerLevelValue:每级伤害增加量(默认:0.5)
  • followOffset:大型宠物的跟随偏移量(默认:0.0)
  • pvpEnabled:布尔值 - 可以攻击生物(默认:true)
  • showLevelInNameplate:布尔值 - 在名牌中显示等级(默认:true)
  • deathCooldown:死亡后的冷却时间(秒)(默认:0)
  • xpPerHit:每次攻击的自定义经验值(可选,若未设置则使用基于伤害的计算)
  • animationDuration:攻击动画持续时间(秒)(默认:0.8)

分发声明

未经明确注明归属 Hyronix Studios 和模组名称,不得重新分发或与第三方设置捆绑。否则,不允许重新分发。